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
ousku
: 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
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
}
}
}
Réponse
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"
}
}
}
}
Créer des commandes
Apprenez à mettre à jour les articles d'une commande.ARRIVÉE PROCHAINE
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 delandedCost
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.