Créer des commandes

Si vous avez créé une commande mais que vous réalisez que tous les articles ne peuvent pas être livrés en raison de livraisons partielles ou d'autres circonstances imprévues, vous pouvez utiliser la mutation orderItemUpdate pour supprimer des articles de la commande. Une fois qu'un article est supprimé, nous exécuterons un nouveau calcul de coût d'atterrissage et mettrons à jour la facture de cette commande pour 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 les données d'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 supprimer 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'endpoint de l'API en utilisant votre bibliothèque client ou outil choisi. Voici un exemple de comment 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"
      }
    }
  }
}