Bereiten Sie die Eingabedaten für die Mutation vor
Die orderCreate
-Mutation erfordert spezifische Eingabedaten. Während zusätzliche Felder verfügbar sind, sind die folgenden Felder erforderlich:
productId
odersku
: Die Produkt-ID oder SKU, die Sie verwenden, um Artikel in der Bestellung zu identifizieren (Der Wert, den Sie verwenden, um Produkte in Ihrem System zu identifizieren).accountOrderNumber
: Die Bestellnummer, die Sie der Bestellung zugewiesen haben (oft die Bestellnummer der Plattform).
Sie können Artikel aus einer Bestellung nur entfernen, wenn sie noch nicht versendet wurden.
Senden Sie die Mutation
Sobald Sie die erforderlichen Eingabedaten haben, senden Sie die GraphQL-Mutation an den API-Endpunkt unter Verwendung Ihrer gewählten Client-Bibliothek oder -Werkzeugs. Hier ist ein Beispiel, wie Sie die Mutation strukturieren können:
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
}
}
}
Antwort
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"
}
}
}
}
Bestellungen erstellen
Erfahren Sie, wie Sie Artikel in einer Bestellung aktualisieren.
Bald verfügbar
Wenn Sie eine Bestellung erstellt haben, aber feststellen, dass nicht alle Artikel aufgrund von Lieferengpässen oder anderen unvorhergesehenen Umständen erfüllt werden können, können Sie die
orderItemUpdate
-Mutation verwenden, um Artikel aus der Bestellung zu entfernen. Sobald ein Artikel entfernt wurde, führen wir eine neuelandedCost
-Berechnung durch und aktualisieren die Rechnung für diese Bestellung, um den neuen Betrag widerzuspiegeln, der Ihnen in Rechnung gestellt wird. Wenn Ihnen bereits ein Betrag in Rechnung gestellt wurde, fügen wir diesen Betrag als Gutschrift auf Ihrer kommenden Rechnung hinzu.