Uppdatera beställningar

Om du har skapat en beställning men inser att inte alla artiklar kan uppfyllas på grund av korta leveranser eller andra oförutsedda omständigheter, kan du använda orderItemUpdate mutation för att ta bort artiklar från beställningen. När en artikel har tagits bort kommer vi att köra en ny landedCost beräkning och uppdatera fakturan för denna beställning för att återspegla det nya beloppet du kommer att debiteras. Om du redan har blivit debiterad kommer vi att lägga till det beloppet som en kredit på din kommande faktura.

Förbered mutationsinmatningen 

orderCreate mutation kräver specifik indata. Medan ytterligare fält är tillgängliga, är följande fält obligatoriska:

• productId eller sku: Produkt-ID eller SKU som du använder för att identifiera artiklar på beställningen (Det värde du använder för att identifiera produkter i ditt system).
• accountOrderNumber: Beställningsnumret du tilldelade beställningen (ofta plattformens beställningsnummer).

Du kan endast ta bort artiklar från en beställning om de inte har skickats.

Skicka mutation 

När du har den nödvändiga indata, skicka GraphQL-mutation till API-slutpunkten med hjälp av ditt valda klientbibliotek eller verktyg. Här är ett exempel på hur du kan strukturera mutation:

mutation {
  orderItemUpdate(
    orderId: "order_4f52ec0e-3467-11ed-b878-0242ac120002"
    accountOrderNumber: "AO-67890"
    itemId: "item_8659ec0e-3467-11ed-b878-0242ac120002"
    itemSku: "T123-BLUE"
    quantity: 1
  ) {
    order {
      accountOrderNumber
      createdAt
      createdBy
      currencyCode
      id
      items {
        id
        name
        quantity
        amount
        currencyCode
      }
      status
      updatedAt
      updatedBy
    }
  }
}

{
  "data": {
    "orderItemUpdate": {
      "order": {
        "accountOrderNumber": "AO-67890",
        "createdAt": "2024-06-01T12:00:00Z",
        "createdBy": "user_3258ec0e-3467-11ed-b878-0242ac120002",
        "currencyCode": "USD",
        "id": "order_4f52ec0e-3467-11ed-b878-0242ac120002",
        "items": [
          {
            "id": "item_8659ec0e-3467-11ed-b878-0242ac120002",
            "name": "T-Shirt",
            "quantity": 0,
            "amount": 19.99,
            "currencyCode": "USD"
          }
        ],
        "status": "OPEN",
        "updatedAt": "2024-07-09T12:20:00Z",
        "updatedBy": "user_4258ec0e-3467-11ed-b878-0242ac120002"
      }
    }
  }
}