Crea ordini

Se hai creato un ordine ma ti rendi conto che non tutti gli articoli possono essere evasi a causa di spedizioni incomplete o altre circostanze impreviste, puoi utilizzare la mutazione orderItemUpdate per rimuovere articoli dall'ordine. Una volta rimosso un articolo, eseguiremo un nuovo calcolo del landedCost e aggiorneremo la fattura per questo ordine per riflettere il nuovo importo che ti verrà addebitato. Se sei già stato addebitato, aggiungeremo quell'importo come credito sulla tua prossima fattura.

Prepara l'input della mutazione 

La mutazione orderCreate richiede dati di input specifici. Sebbene siano disponibili campi aggiuntivi, i seguenti campi sono obbligatori:

• productId o sku: L'ID prodotto o SKU che utilizzi per identificare gli articoli nell'ordine (Il valore che utilizzi per identificare i prodotti nel tuo sistema).
• accountOrderNumber: Il numero d'ordine che hai assegnato all'ordine (spesso il numero d'ordine della piattaforma).

Puoi rimuovere articoli da un ordine solo se non sono stati spediti.

Invia la mutazione 

Una volta che hai i dati di input richiesti, invia la mutazione GraphQL all'endpoint API utilizzando la libreria o lo strumento client scelto. Ecco un esempio di come puoi strutturare la mutazione:

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