DOCS

Update orders

/

Opret ordrer

Lær hvordan du opdaterer varer på en ordre.

GraphQL

KOMMER SNART

Hvis du har oprettet en ordre, men indser, at ikke alle varer kan opfyldes på grund af kortskibe eller andre uforudsete omstændigheder, kan du bruge orderItemUpdate mutation til at fjerne varer fra ordren. Når en vare er fjernet, vil vi køre en ny landedCost beregning og opdatere fakturaen for denne ordre for at afspejle det nye beløb, du vil blive opkrævet. Hvis du allerede er blevet opkrævet, vil vi tilføje det beløb som en kredit på din kommende faktura.

Forbered mutationsinput 

orderCreate mutation kræver specifikke inputdata. Mens yderligere felter er tilgængelige, er følgende felter påkrævet:

  • productId eller sku: Produkt-ID'et eller SKU'en, som du bruger til at identificere varer på ordren (den værdi, du bruger til at identificere produkter i dit system).
  • accountOrderNumber: Ordrenummeret, du har tildelt ordren (ofte platformens ordrenummer).

Du kan kun fjerne varer fra en ordre, hvis de ikke er blevet sendt.

Send mutation 

Når du har de nødvendige inputdata, skal du sende GraphQL-mutation til API-endepunktet ved hjælp af dit valgte klientbibliotek eller værktøj. Her er et eksempel på, hvordan du kan strukturere mutation:

Mutation

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
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
    }
  }
}

Svar

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
  "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"
      }
    }
  }
}

Var denne side nyttig?