Aufträge erstellen

Wenn Sie einen Auftrag erstellt haben, aber feststellen, dass nicht alle Artikel aufgrund von Teillieferungen oder anderen unvorhergesehenen Umständen erfüllt werden können, können Sie die orderItemUpdate-Mutation verwenden, um Artikel aus dem Auftrag zu entfernen. Sobald ein Artikel entfernt wurde, führen wir eine neue landedCost-Berechnung durch und aktualisieren die Rechnung für diesen Auftrag, um den neuen Betrag widerzuspiegeln, der Ihnen in Rechnung gestellt wird. Wenn Sie bereits belastet wurden, werden wir diesen Betrag als Gutschrift auf Ihrer nächsten Rechnung hinzufügen.

Vorbereiten der Mutations-Eingabe 

Die orderCreate-Mutation erfordert spezifische Eingabedaten. Obwohl zusätzliche Felder verfügbar sind, sind die folgenden Felder erforderlich:

• productId oder sku: Die Produkt-ID oder SKU, die Sie zur Identifizierung von Artikeln im Auftrag verwenden (Der Wert, den Sie zur Identifizierung von Produkten in Ihrem System verwenden).
• accountOrderNumber: Die Auftragsnummer, die Sie dem Auftrag zugewiesen haben (oft die Auftragsnummer der Plattform).

Sie können nur Artikel aus einem Auftrag entfernen, wenn sie noch nicht versandt wurden.

Senden der Mutation 

Sobald Sie die erforderlichen Eingabedaten haben, senden Sie die GraphQL-Mutation an den API-Endpunkt mit Ihrer gewählten Client-Bibliothek oder Ihrem Tool. Hier ist ein Beispiel, wie Sie die Mutation strukturieren können:

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"
      }
    }
  }
}