Créer des commandes

Si vous avez créé une commande mais réalisez que tous les articles ne peuvent pas être expédiés en raison de livraisons incomplètes ou d'autres circonstances imprévues, vous pouvez utiliser la mutation orderItemUpdate pour retirer des articles de la commande. Une fois un article retiré, nous effectuerons un nouveau calcul de landedCost et mettrons à jour la facture pour cette commande afin de refléter le nouveau montant qui vous sera facturé. Si vous avez déjà été facturé, nous ajouterons ce montant en tant que crédit sur votre prochaine facture.

Préparer l'entrée de la mutation 

La mutation orderCreate nécessite des données d'entrée spécifiques. Bien que des champs supplémentaires soient disponibles, les champs suivants sont requis :

• productId ou sku : L'ID du produit ou le SKU que vous utilisez pour identifier les articles de la commande (La valeur que vous utilisez pour identifier les produits dans votre système).
• accountOrderNumber : Le numéro de commande que vous avez attribué à la commande (souvent le numéro de commande de la plateforme).

Vous ne pouvez retirer des articles d'une commande que s'ils n'ont pas été expédiés.

Envoyer la mutation 

Une fois que vous avez les données d'entrée requises, envoyez la mutation GraphQL à l'API en utilisant votre bibliothèque ou outil client choisi. Voici un exemple de la façon dont vous pouvez structurer la 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"
      }
    }
  }
}