Guide des cas d'utilisation des API d'approvisionnement au détail pour les fournisseurs v1

Comment aider les fournisseurs à gérer leurs opérations commerciales de détail de manière programmatique grâce à l'intégration de services Web.

Les API partenaire de vente pour les fournisseurs du commerce de détail aident les fournisseurs à gérer leurs activités de commerce de détail de manière programmatique par le biais de l'intégration de services Web. L'intégration automatisée avec Amazon peut aider les fournisseurs à améliorer et à maintenir leurs performances au niveau requis et à développer leur activité avec Amazon.

Vendors in the direct fulfillment program should refer to the Vendor Direct Fulfillment APIs v1 Use Case Guide to learn about APIs specific to direct fulfillment.

Les fournisseurs peuvent utiliser ces API pour créer des applications permettant d'accroître l'efficacité opérationnelle, de réduire les efforts, de diminuer les erreurs et d'améliorer les performances.

For authentication and authorization information, refer to Authorizing Selling Partner API applications.

Processus commerciaux que vous pouvez exécuter à l'aide des API Vendor Retail Procurement

You can use the Vendor Orders API to manage purchase orders, the Vendor Shipments API to send shipment confirmations, the Vendor Invoices API to submit invoices, and the Vendor Transaction Status API to determine the status of your order acknowledgements and shipment confirmations.

Processus métier Cas d'utilisation Opération
Gestion des bons de commande
Obtenir des modifications ou des annulations de bons de commande getPurchaseOrders
Returns a list of purchase orders created or changed during the time frame that you specify.
Vérifier l'état du bon de commande getPurchaseOrdersStatus
Returns purchase order statuses based on the filters that you specify.
Soumettre un accusé de réception de commande submitAcknowledgement
Submits acknowledgements for one or more purchase orders.
Vérifier l'état de la transaction de confirmation de commande getTransaction
Returns the status of the transaction that you specify.
Expéditions
Soumet les demandes d'expédition SubmitShipments
Submits one or more shipment request for vendor Orders.
Obtenir le statut de l'expédition ou les étiquettes d'expédition/de transport GetShipmentDetails
Returns the Details about Shipment, Carrier Details, status of the shipment, container details and other details related to shipment based on the filter parameters value that you specify.
Soumettre ou mettre à jour les notifications d'expédition anticipées (ASN) /les confirmations d'expédition SubmitShipmentConfirmations
Submits one or more shipment confirmations for vendor orders.
Vérifier l'état de la transaction de confirmation d'expédition getTransaction
Returns the status of the transaction that you specify.
Obtenez des étiquettes d'expédition GetShipmentLabels
Returns small parcel shipment labels based on the filters that you specify.
Factures et notes de crédit
Soumettre les factures des fournisseurs submitInvoices
Submit new invoices to Amazon.

Qu'est-ce que l'API Commandes fournisseurs ?

You can use the Vendor Orders API (Orders API) to receive purchase orders and to send order acknowledgements to accept or reject order fulfillment.

L'API Vendor Orders inclut les opérations suivantes :

Opération Méthode HTTP Path Description
getPurchaseOrders GET /vendor/orders/v1/purchaseOrders Renvoie une liste des bons de commande créés ou modifiés pendant la période que vous avez indiquée. Les données peuvent être récupérées pendant une période maximale de six mois à compter de la date de l'appel POST initial.
getPurchaseOrder GET /vendor/orders/v1/purchaseOrders /{purchaseOrderNumber} Renvoie un bon de commande (PO) basé sur purchaseOrderNumber valeur que vous spécifiez. La récupération des données est possible pendant une période maximale de six mois à compter de la date à laquelle l'appel POST initial a été effectué.
submitAcknowledgement POST /vendor/orders/v1/acknowledgements Accuse réception (acceptation ou rejet) des commandes.
getPurchaseOrdersStatus GET /vendor/orders/v1/purchaseOrdersStatus Renvoie les statuts des bons de commande en fonction des filtres que vous avez indiqués. La récupération des données est possible pendant une période maximale de six mois à compter de la date de l'appel POST initial.

You can use the getPurchaseOrders operation to access orders created or changed during a specified time period (within a rolling window of the last six months, after June 2020). To optimize response time, we recommend that you limit the time range to no more than seven days.

You can use the getPurchaseOrder operation to get detailed order information for a specific order. You can then use the submitAcknowledgement operation to accept or reject the order.

After you accept or reject your orders, you can use the getPurchaseOrdersStatus operation to return the acknowledgement status of one or more purchase orders.

📘

Remarque

Vous pouvez retourner les détails complets du bon de commande en appelant le getPurchaseOrders opération, ou renvoyez uniquement les numéros de bon de commande avec includeDetails filtre. La valeur par défaut de ce paramètre est true. Par conséquent, si vous n'incluez pas ce paramètre de requête, vous renverrez les détails complets des bons de commande. Si vous utilisez includeDetails=false, la réponse comprendra uniquement une liste des numéros de commande et l'état actuel de chaque bon de commande.

Le schéma suivant illustre le workflow utilisant l'API Commandes fournisseurs.

The Vendor orders workflow.

getPurchaseOrders

The getPurchaseOrders operation returns either a list of order references (purchase order numbers and status) or complete order details, for all orders that meet the criteria specified in the request. If you are returning only order references, they can be used later with the getPurchaseOrder operation to get order details for a specific order.

Nous vous recommandons d'utiliser cette API pour obtenir les bons de commande dont vous disposez pour l'expédition. Amazon recommande aux fournisseurs de vérifier les commandes au moins une fois par heure pendant les heures ouvrées. En fonction de votre volume de ventes, vous pouvez choisir de vérifier plus fréquemment. Vous pouvez obtenir jusqu'à 100 commandes en un seul appel API. S'il y a plus de 100 commandes, vous pouvez utiliser nextToken pour obtenir le jeu de commande suivant.

Modifications et annulations de commandes

Vous pouvez retourner les modifications et annulations de commandes en utilisant l'opération getPurchaseOrders.

Modifications de commande : Amazon modifie parfois les données des bons de commande après la création de la commande en raison d'une modification des exigences. Les fournisseurs peuvent utiliser l'API getPurchaseOrders pour obtenir des bons de commande mis à jour. Si Amazon modifie un bon de commande, celui-ci aura un champ purchaseOrderChangedDate qui correspond à l'horodatage de la mise à jour de la commande par Amazon. Si ce champ n'existe pas, la commande n'a jamais été modifiée après sa création.

📘

Remarque

Amazon peut également modifier le bon de commande une fois que vous l'avez accusé réception.

Les fournisseurs peuvent obtenir une liste des commandes qui ont changé au cours d'une plage de dates spécifiques en utilisant les paramètres de requête changedAfter et changedBefore. Cela renverra les commandes qui ont été modifiées par Amazon au cours de la période indiquée, et les fournisseurs devront expédier la commande mise à jour. Les fournisseurs peuvent également filtrer à l'aide de isPOChanged=true pour obtenir tous les bons de commande modifiés.

Amazon recommande de lancer un appel d'API distinct, avec la plage de dates modifiée, plusieurs fois par jour pour obtenir les commandes modifiées pendant une journée. Par exemple, quatre fois par jour, vous pouvez appeler l'opération de réception des bons de commande pour faire modifier les commandes au cours des six dernières heures.

La liste suivante répertorie les modifications qui peuvent contribuer à modifier les commandes. Pour ces modifications, vous devez extraire la commande modifiée et expédier le bon de commande correct :

  • Changement de fenêtre d'expédition ou de livraison
  • Mise à jour des articles du bon de commande (modification de la quantité, annulation d'un article, modification du coût d'un article, etc.)
  • Nouvel article ajouté dans le bon de commande
  • PO annulé/non annulé
  • Modification du type du bon de commande
  • Modification de la destination de livraison des bons de commande (centre de distribution)
  • Modification des informations relatives au fret du bon de commande

Annulation de l'article : Vous pouvez également utiliser l'API Vendor Orders, avec le filtre poItemState=Cancelled, pour retourner les commandes contenant un ou plusieurs articles annulés. Toutes les commandes pour lesquelles un ou plusieurs articles ont été annulés par Amazon après la création du bon de commande seront renvoyées. Cela vous aidera à ne recevoir que les commandes pour lesquelles des articles ont été annulés (la quantité commandée est nulle) et à vous assurer de ne pas expédier les articles annulés.

📘

Remarque

L'annulation d'un article est considérée comme un changement de commande et vous retournerez donc également ces commandes avec la liste des commandes modifiées.

État du bon de commande et code du fournisseur : Le schéma du bon de commande inclut l'état actuel du bon de commande et l'heure de mise à jour de l'état. Vous pouvez utiliser le filtre purchaseOrderState pour filtrer les commandes en fonction de l'état actuel.

Par exemple, les fournisseurs peuvent obtenir tous les bons de commande qui n'ont pas encore fait l'objet d'un accusé de réception ou d'une expédition en utilisant purchaseOrderState=New.

Les fournisseurs peuvent également obtenir des bons de commande pour un code fournisseur spécifique en fournissant l'un des codes fournisseurs autorisés dans le filtre orderingVendorCode. Ce filtre ne renverra que les bons de commande émis pour le code fournisseur indiqué dans le filtre.

For details about all the available filters, refer to the Vendor Orders API Reference.

Le schéma suivant illustre le workflow d'intégration lors de la récupération des bons de commande :

The Vendor orders workflow when retrieving purchase orders.

getPurchaseOrder

The getPurchaseOrder operation uses the purchase order number to return information you specify about the purchase order. The response includes complete purchase order information, including line item details, quantity, and cost.

Utilisez cette opération pour obtenir les détails des commandes spécifiques renvoyées par le getPurchaseOrders opération.

Le schéma suivant montre le flux de travail d'intégration lors de la récupération d'un bon de commande spécifique :

The Vendor orders workflow when retrieving a specific purchase order.

Exigences commerciales

  • Commande basée sur le poids

    Pour les commandes contenant des articles vendus au poids, unitOfMeasure champ (sous listPrice et netCost) reflète l'unité de mesure du poids réel. L'unité de poids des valeurs de mesure comprend POUNDS, OUNCES, GRAMS, et KILOGRAMS.

  • Utilisation de la fenêtre d'expédition ou de livraison

    For vendor paid freights, the delivery window information should be used. Dates are represented in date time interval format in accordance with ISO 8601. The format is the start and end date separated by double hyphen (--). The start date field represents the earliest date that Amazon expects the freight to be delivered to the Amazon fulfillment center listed on the purchase order. The end date field represents the latest date that Amazon expects the freight to be delivered to the Amazon fulfillment center listed on the purchase order.

    Use the ship window information for Amazon-paid freights. The date is represented in date/time interval format according to ISO 8601. The format is start and end date separated by double hyphen (--). The start date field represents the earliest date that Amazon expects to pick up the freight. The end date represents the latest date that Amazon expects to pick up the freight. If the same date is listed in the start date and end date fields, then read that date as the date that Amazon expects to pick up the freight.

  • Les commandes en réapprovisionnement sont-elles acceptables pour un article ?

    La lecture de la valeur du champ isBackOrderAllowed est obligatoire. Si la valeur est vraie, la commande peut être traitée en tant que réapprovisionnement. Lorsqu'elle est fausse, les réapprovisionnements ne sont pas autorisés.

  • Codes promo

    Les codes promo sont des codes promotionnels indiqués dans le champ dealCode de la commande. Toute information relative à un code promo, à des remises spéciales ou à des prix sera présente dans ce champ.

  • Politique d'annulation des réapprovisionnements

    Votre représentant commercial Amazon détermine la politique de réapprovisionnement. Discutez des détails avec votre responsable des fournisseurs.

📘

Remarque

Les dates d'annulation des commandes en rupture de stock peuvent ne pas être indiquées dans la commande. Vous devez configurer la politique de réapprovisionnement au niveau du compte.

  • Utiliser l'API pour modifier une commande

    Il n'est pas possible de soumettre une modification à une commande à l'aide de l'API pour le moment. Une fois qu'une commande a été passée, sa modification est un processus manuel via Vendor Central.

Exigences commerciales spécifiques à chaque pays

FonctionnalitéIndeEuropeAmérique du Nord
Coût netConditionnel. Coût net ou prix catalogue.Conditionnel. Coût net ou prix catalogue.Conditionnel. Coût net ou prix catalogue.
Prix catalogueConditionnel. Coût net ou prix catalogue.Conditionnel. Coût net ou prix catalogue.Conditionnel. Coût net ou prix catalogue.
Commande en coursNon applicablePris en chargePris en charge
AcheteurL'adresse de l'entité d'achat AmazonL'identifiant attribué à l'acheteurNon applicable
VendeurLe code vendeur Amazon attribué au fournisseur.Le code vendeur Amazon attribué au fournisseur.Le code vendeur Amazon attribué au fournisseur.
Destinataire de l'envoiL'adresse du destinataire de l'envoiL'identifiant attribué au destinataire de l'envoi.Non applicable
Partie à facturerL'adresse du client facturéL'adresse du client facturéNon applicable

submitAcknowledgement

You can use the submitAcknowledgement operation to accept or reject a purchase order for fulfillment. Amazon expects a complete acknowledgement, including all purchase order line items for the purchase order. If you do not provide all line items for the purchase order in the acknowledgement, Amazon will implicitly reject the missing line items.

Amazon attend de vous que vous soumettiez l'accusé de réception le plus rapidement possible, au plus tard dans les 24 heures. L'accusé de réception doit donner une image précise des quantités et des dates d'expédition réelles.

Pour tout changement de quantité, de prix, de date d'expédition ou de livraison, Amazon attend une mise à jour de l'accusé de réception soumis par le fournisseur sous 48 heures. Le fournisseur peut soumettre une mise à jour complète de l'accusé de réception ou ne mettre à jour qu'un article en particulier. Amazon traite toujours la mise à jour comme un remplacement des accusés de réception précédents pour l'article en question. Après 48 heures, nous ne nous attendons à recevoir que des mises à jour des dates d'expédition ou de livraison.

Si le premier code d'accusé de réception pour un élément de ligne spécifique était rejected, vous n'êtes pas autorisé à modifier cela lors de votre mise à jour vers accepted ou backordered.

Vérification des accusés de réception de commande soumis avec succès

You can verify the status of the original or updated version of the order acknowledgement using Vendor Central or using the Transaction Status API. If the original or updated version doesn't appear after 30 minutes, submit a support case in Vendor Central by navigating to Vendor Central > Support > Contact Us > API Integration.

Le schéma suivant illustre le workflow d'intégration lors de l'accusé de réception d'une commande.

The Vendor orders workflow when acknowledging orders.

Exigences commerciales

  • Un fournisseur peut-il augmenter la quantité initiale indiquée dans la commande lorsqu'il accuse réception d'une commande ?

    Non, vous ne pouvez pas envoyer dans l'accusé de réception une quantité supérieure à celle qui a été soumise dans le bon de commande.

  • Est-il obligatoire d'envoyer un accusé de réception pour chaque bon de commande ?

    Yes, in order to update the status of an order in the Amazon system correctly, Amazon requires PO confirmation using the API or Vendor Central. If you are unable to meet our order acknowledgement requirements using the API, you must confirm your purchase orders using Vendor Central. Contact your Amazon business representative if you do not have a Vendor Central account.

  • Est-il obligatoire de fournir chaque élément de la ligne de commande dans l'accusé de réception de commande correspondant ?

    Oui, pour permettre à Amazon de mettre à jour correctement le statut de la commande.

  • Si un article est en réapprovisionnement, est-il nécessaire d'indiquer la quantité dans l'accusé de réception de commande ?

    Oui, afin que le système d'Amazon puisse mettre à jour correctement le statut de l'article.

  • Comment signaler les articles obsolètes d'une commande à l'aide de l'accusé de réception de commande ?

    Ne traitez ni n'expédiez un article arrivé avec un numéro d'article non valide sur la commande. Renvoie le numéro d'article non valide figurant sur l'accusé de réception et confirmez-le comme invalid. Les codes d'accusé de réception suivants indiquent rejected en raison de l'obsolescence de l'article :

    Rejeté : selon l'interprétation d'Amazon, la quantité indiquée avec ce code ne sera pas livrée à Amazon dans le cadre de ce bon de commande. Vous devez envoyer le motif de rejet approprié à obsolete dans l'accusé de réception. Cela indique qu'en raison de l'obsolescence de l'article, celui-ci ne doit plus être commandé. Selon la nomenclature d'Amazon, cet article ne doit pas être commandé à nouveau. Si ce code est reçu deux fois de suite pour le même projet (séparées par un intervalle de temps d'au moins 48 heures), l'article ne sera pas réorganisé.

📘

Remarque

Amazon expects an acknowledgement even if all the line items on the purchase order were invalid and did not produce an order or invoice. If a corresponding acknowledgement cannot be sent for a purchase order, Amazon requires manual notification of invalid items. You can notify your buying team through the Vendor Central Contact Us link.

  • Dois-je renvoyer le même identifiant de produit dans l'accusé de réception que j'ai reçu lors de la transaction de commande ?

    Les accusés de réception doivent renseigner exactement le même identifiant de produit que celui envoyé dans le bon de commande.

  • Est-il nécessaire d'indiquer le prix dans l'accusé de réception ?

    Oui, les fournisseurs sont tenus de renvoyer le prix de revient unitaire dans l'accusé de réception. Le prix de revient doit correspondre au prix de revient unitaire qui sera facturé. Les fournisseurs de livres sont tenus de fournir un prix catalogue et un multiplicateur de réduction.

  • Le prix figurant sur le bon de commande peut-il être simplement renvoyé sur l'accusé de réception ?

    Non. Quel que soit le prix indiqué sur le bon de commande, Amazon exige que le prix de revient figure sur l'accusé de réception. Le prix de revient indiqué sur l'accusé de réception doit correspondre au prix de revient indiqué sur la facture. Les systèmes de paiement d'Amazon comparent les deux et peuvent retarder le paiement s'ils ne correspondent pas.

  • Quelle est la procédure à suivre pour Amazon.com si le prix et/ou la disponibilité changent après la transmission de l'accusé de réception initial ?

    Il convient de prévenir manuellement de toute modification apportée aux commandes Amazon après la transmission de l'accusé de réception initial. Votre représentant commercial Amazon.com peut vous indiquer quand, comment et qui prévenir.

  • Est-il obligatoire de fournir des données de prix pour les articles en réapprovisionnement ?

    Oui, cela est nécessaire pour qu'Amazon puisse mettre à jour correctement le statut de la commande. Si le prix est omis, cela entraînera le rejet de l'accusé de réception.

  • Comment puis-je savoir si les réapprovisionnements sont autorisés ou non ?

    Vous devez lire la valeur dans isBackOrderAllowed champ du bon de commande. La valeur true indique que les commandes en attente sont autorisées. La valeur false indique que les commandes en attente ne sont pas autorisées.

  • Est-il obligatoire de fournir un code d'accusé de réception pour tous les articles, quel que soit leur statut ?

    Oui, cela est nécessaire pour que nous puissions mettre à jour correctement le statut de la commande. Si le code d'accusé de réception est omis, l'accusé de réception sera rejeté.

  • Quelle est la politique d'Amazon en matière d'expéditions partielles ? Comment les expéditions partielles doivent-elles être signalées lors de la soumission d'un accusé de réception de commande ?

    Les expéditions partielles sont autorisées si le bon de commande autorise les commandes en attente (lorsque isBackOrderAllowed est true). Amazon vous recommande d'indiquer une boucle d'accusé de réception à l'aide du code accepted avec la date correspondante et une autre boucle d'accusé de réception utilisant le code backordered et la date correspondante.

    Accepté : pour les articles pouvant faire l'objet d'une expédition immédiate.

    En réapprovisionnement : pour la quantité restante qui ne peut pas être expédiée immédiatement. La quantité restante (quantité commandée moins la quantité confirmée) sera livrée plus tard (en réapprovisionnement).

  • Quand dois-je utiliser le segment listPrice ?

    Le segment listPrice n'est requis que si un fournisseur vend des livres avec un prix catalogue.

Exigences commerciales spécifiques à chaque pays

FonctionnalitéIndeEuropeAmérique du Nord
Date d'expédition prévueConditionnelle. Dépend des conditions de fret et de l'accord commercial actuel avec le fournisseur.FacultatifFacultatif
Date de livraison prévueConditionnelle. Dépend des conditions de fret et de l'accord commercial actuel avec le fournisseur.FacultatifFacultatif
Prix catalogueNécessaire uniquement pour les fournisseurs de livresPris en chargeNécessaire uniquement pour les fournisseurs de livres

Obtenir le statut des bons de commande

The getPurchaseOrdersStatus operation returns the status for the list of purchase orders that meet the criteria specified in the request. You can use this operation to get the acknowledgement status of the items in purchase orders available to you for fulfillment. This operation returns the history for ordered quantity and acknowledgements of an item. You can view details of all the acknowledgements processed for an item in a purchase order. We have provided a wide range of query parameters to filter the list of POs as per your requirement.

Vous pouvez renvoyer jusqu'à 100 commandes en un seul appel API. S'il y a plus de 100 commandes, vous pouvez utiliser nextToken pour obtenir le prochain ensemble de commandes.

Voici quelques exemples d'utilisation de l'opération getPurchaseOrdersStatus avec différents paramètres de requête :

  • Vous pouvez obtenir le statut de tous les bons de commande ouverts dans une plage de dates déterminée en utilisant soit la date de création du bon de commande (createdBefore et createdAfter), soit la date de mise à jour du bon de commande (updatedBefore et updatedAfter), ainsi que purchaseOrderStatus=OPEN.

  • Vous pouvez utiliser le getPurchaseOrdersStatus opération pour filtrer l'état des PoS. Par exemple, si itemConfirmationStatus=REJECTED, la réponse renverra toutes les commandes dont un ou plusieurs articles sont considérés comme rejetés.

  • Vous pouvez vérifier le statut d'un bon de commande spécifique en indiquant son numéro dans le paramètre de la requête purchaseOrderNumber.

  • Vous pouvez obtenir le statut de tous les bons de commande ouverts pour un code fournisseur spécifique en indiquant la valeur du code fournisseur dans orderingVendorCode et en incluant purchaseOrderStatus=OPEN.

  • Vous pouvez obtenir le statut de tous les bons de commande créés dans une période donnée qui doivent être expédiés à un centre de distribution Amazon spécifique en indiquant le code du centre de distribution dans shipToPartyId et la période de temps dans createdBefore et createdAfter.

Cas d'utilisation des bons de commande et des accusés de réception

Article non valide dans le bon de commande

Si vous recevez un identifiant de produit non valide dans le bon de commande, vous devez rejeter l'article avec un code de confirmation Rejected et le rejectionReason comme InvalidProductIdentifier:

Bon de commande

{ "order": { "purchaseOrderNumber": " L8266355", "purchaseOrderState": "New", "orderDetails": { "purchaseOrderDate": "2019-07-16T19:17:34.304Z", "purchaseOrderStateChangedDate": "2019-07-16T19:17:34.304Z", "purchaseOrderType": "RegularOrder", "paymentMethod": "Invoice", "buyingParty": { "partyId": "NAG1" }, "sellingParty": { "partyId": "999US" }, "shipToParty": { "partyId": "NAG1" }, "billToParty": { "partyId": "NAG1" }, "items": [ { "itemSequenceNumber": "1", "amazonProductIdentifier": " ABC123434", "vendorProductIdentifier": "028877454078", "orderedQuantity": { "amount": "10", "unitOfMeasure": "Cases", "unitSize": "5" }, "isBackOrderAllowed": false, "netCost": { "amount": "10.2", "currencyCode": "USD" }, "listPrice": { "amount": "10.2", "currencyCode": "USD" } } ] } } }

Accusé de réception du bon de commande

{ "acknowledgements": [ { "purchaseOrderNumber": "L8266355", "sellingParty": { "partyId": "999US" }, "acknowledgementDate": "2019-07-17T19:17:34.304Z", "items": [ { "itemSequenceNumber": "1", "amazonProductIdentifier": " ABC123434", "vendorProductIdentifier": "028877454078", "orderedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": 5 }, "netCost": { "currencyCode": "USD", "amount": "10.2" }, "itemAcknowledgements": [ { "acknowledgementCode": "Rejected", "acknowledgedQuantity": { "amount": 10 }, "rejectionReason": "InvalidProductIdentifier" } ] } ] } ] }

Statut du bon de commande

{ "payload": { "ordersStatus": [ { "purchaseOrderNumber": "L8266355", "purchaseOrderStatus": "CLOSED", "purchaseOrderDate": "2019-07-16T19:17:34.304Z", "lastUpdatedDate": "2019-07-17T19:17:34.304Z", "sellingParty": { "partyId": "999US" }, "shipToParty": { "partyId": "NAG1" }, "itemStatus": [ { "itemSequenceNumber": "1", "buyerProductIdentifier": "ABC123434", "vendorProductIdentifier": "028877454078", "netCost": { "amount": "10.2", "currencyCode": "USD" }, "listPrice": { "amount": "10.2", "currencyCode": "USD" }, "orderedQuantity": { "orderedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": 5 }, "orderedQuantityDetails": [ { "updatedDate": "2019-07-16T19:17:34.304Z", "orderedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": 5 } } ] }, "acknowledgementStatus": { "confirmationStatus": "REJECTED", "acceptedQuantity": { "amount": 0, "unitOfMeasure": "Cases", "unitSize": 5 }, "rejectedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": 5 }, "acknowledgementStatusDetails": [ { "acknowledgementDate": "2019-07-17T19:17:34.304Z", "acceptedQuantity": { "amount": 0, "unitOfMeasure": "Cases", "unitSize": 5 }, "rejectedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": 5 } } ] } } ] } ] } }

Article obsolète dans le bon de commande

Si vous recevez un produit obsolète dans le bon de commande, vous devez rejeter l'article avec un code de confirmation Rejected et le rejectionReason comme ObsoleteProduct.

Bon de commande

{ "order": { "purchaseOrderNumber": " L8266355", "purchaseOrderState": "New", "orderDetails": { "purchaseOrderDate": "2019-07-16T19:17:34.304Z", "purchaseOrderStateChangedDate": "2019-07-16T19:17:34.304Z", "purchaseOrderType": "RegularOrder", "paymentMethod": "Invoice", "buyingParty": { "partyId": "NAG1" }, "sellingParty": { "partyId": "999US" }, "shipToParty": { "partyId": "NAG1" }, "billToParty": { "partyId": "NAG1" }, "items": [ { "itemSequenceNumber": "1", "amazonProductIdentifier": " ABC123434", "vendorProductIdentifier": "028877454078", "orderedQuantity": { "amount": "10", "unitOfMeasure": "Cases", "unitSize": "5" }, "isBackOrderAllowed": false, "netCost": { "amount": "10.2", "currencyCode": "USD" } } ] } } }

Accusé de réception du bon de commande

{ "acknowledgements": [ { "purchaseOrderNumber": "L8266356", "sellingParty": { "partyId": "999US" }, "acknowledgementDate": "2019-07-17T19:17:34.304Z", "items": [ { "itemSequenceNumber": "1", "amazonProductIdentifier": "ABC123438", "vendorProductIdentifier": "028877454079", "orderedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": "5" }, "netCost": { "currencyCode": "IN", "amount": "100.20" }, "itemAcknowledgements": [ { "acknowledgementCode": "Rejected", "acknowledgedQuantity": { "amount": 10 }, "rejectionReason": " ObsoleteProduct" } ] } ] } ] }

Confirmation d'une quantité partielle d'articles et réapprovisionnement du reste de la quantité

Amazon a commandé 10 quantités d'articles. Le fournisseur prévoit de fractionner les envois et envoie donc un Accepted quantité d'articles de six et un BackOrdered quantité d'articles de quatre pour indiquer que six unités seront expédiées dans le premier envoi et quatre unités dans le second.

Bon de commande — (Importer un bon de commande)

{ "order": { "purchaseOrderNumber": " L8266357", "purchaseOrderState": "Acknowledged", "orderDetails": { "purchaseOrderDate": "2019-07-16T19:17:34.304Z", "purchaseOrderChangedDate": "2019-07-18T16:05:00Z", "purchaseOrderStateChangedDate": "2019-07-17T10:00:34.304Z", "purchaseOrderType": "RegularOrder", "importDetails": { "importContainers": "2-20'HC,1-45',1-45'HC", "internationalCommercialTerms": "FreeOnBoard", "methodOfPayment": "PrepaidBySeller", "portOfDelivery": "USA", "shippingInstructions": "PREFERENCE IS PALLET-LOAD, BUT IF CONTAINERS ARE FLOOR-LOADED" }, "paymentMethod": "Invoice", "buyingParty": { "partyId": "XYZ1" }, "sellingParty": { "partyId": "999US" }, "shipToParty": { "partyId": "XYZ1" }, "billToParty": { "partyId": "XYZ1", "taxInfo": { "taxRegistrationNumber": "12AAXYZ4259Z123", "taxRegistrationType": "VAT" } }, "items": [ { "itemSequenceNumber": "1", "amazonProductIdentifier": " ABC123434", "vendorProductIdentifier": "028877454078", "orderedQuantity": { "amount": "10", "unitOfMeasure": "Eaches" }, "isBackOrderAllowed": true, "netCost": { "amount": "10.2", "currencyCode": "USD" }, "listPrice": { "amount": "10.2", "currencyCode": "USD" } } ] } } }

Accusé de réception du bon de commande

{ "acknowledgements": [ { "purchaseOrderNumber": "L8266355", "sellingParty": { "partyId": "999US" }, "acknowledgementDate": "2019-07-17T19:17:34.304Z", "items": [ { "itemSequenceNumber": "1", "amazonProductIdentifier": " ABC123434", "vendorProductIdentifier": "028877454078", "orderedQuantity": { "amount": 10, "unitOfMeasure": "Eaches" }, "netCost": { "currencyCode": "USD", "amount": "10.2" }, "itemAcknowledgements": [ { "acknowledgementCode": "Accepted", "acknowledgedQuantity": { "amount": 6 }, "scheduledShipDate": "2019-07-17T19:17:34.304Z" }, { "acknowledgementCode": "Backordered", "acknowledgedQuantity": { "amount": 4 }, "scheduledShipDate": "2019-07-25T19:17:34.304Z" } ] } ] } ] }

Après avoir expédié la première partie de la commande, le fournisseur fournit à Amazon une date plus précise pour la deuxième expédition en utilisant scheduledShipDate pour les articles en réapprovisionnement. Remarque : les fournisseurs doivent toujours envoyer des mises à jour complètes indiquant la quantité totale commandée pour chaque article. Les mises à jour complètes fournissent une visibilité explicite sur les quantités.

Statut du bon de commande

{ "payload": { "ordersStatus": [ { "purchaseOrderNumber": "L8266355", "purchaseOrderStatus": "OPEN", "purchaseOrderDate": "2019-07-16T19:17:34.304Z", "lastUpdatedDate": "2019-07-18T16:05:00Z", "sellingParty": { "partyId": "999US" }, "shipToParty": { "partyId": "XYZ1" }, "itemStatus": [ { "itemSequenceNumber": "1", "buyerProductIdentifier": "ABC123434", "vendorProductIdentifier": "028877454078", "netCost": { "amount": "10.2", "currencyCode": "USD" }, "listPrice": { "amount": "10.2", "currencyCode": "USD" }, "orderedQuantity": { "orderedQuantity": { "amount": 10, "unitOfMeasure": "Eaches", "unitSize": 1 }, "orderedQuantityDetails": [ { "updatedDate": "2019-07-16T19:17:34.304Z", "orderedQuantity": { "amount": 10, "unitOfMeasure": "Eaches", "unitSize": 1 } } ] }, "acknowledgementStatus": { "confirmationStatus": "ACCEPTED", "acceptedQuantity": { "amount": 10, "unitOfMeasure": "Eaches", "unitSize": 1 }, "acknowledgementStatusDetails": [ { "acknowledgementDate": "2019-07-17T19:17:34.304Z", "acceptedQuantity": { "amount": 10, "unitOfMeasure": "Eaches", "unitSize": 1 }, "rejectedQuantity": { "amount": 0, "unitOfMeasure": "Eaches", "unitSize": 1 } } ] } } ] } ] } }

Accusés de réception multiples pour annuler les quantités initialement acceptées

Vous pouvez l'utiliser lorsque vous découvrez que vous ne pouvez pas traiter certaines ou toutes les unités d'une commande initialement acceptée et que vous souhaitez informer Amazon que ces unités ne seront pas expédiées.

Bon de commande

{ "order": { "purchaseOrderNumber": " L8266355", "purchaseOrderState": "New", "orderDetails": { "purchaseOrderDate": "2019-07-16T19:17:34.304Z", "purchaseOrderStateChangedDate": "2019-07-16T19:17:34.304Z", "purchaseOrderType": "RegularOrder", "paymentMethod": "Invoice", "buyingParty": { "partyId": "NAG1" }, "sellingParty": { "partyId": "999US" }, "shipToParty": { "partyId": "NAG1" }, "billToParty": { "partyId": "NAG1" }, "items": [ { "itemSequenceNumber": "1", "amazonProductIdentifier": "ABC123434", "vendorProductIdentifier": "028877454078", "orderedQuantity": { "amount": "10", "unitOfMeasure": "Cases", "unitSize": "5" }, "isBackOrderAllowed": false, "netCost": { "amount": "10.2", "currencyCode": "USD" }, "listPrice": { "amount": "10.2", "currencyCode": "USD" } } ] } } }

Accusé de réception du bon de commande

Le fournisseur a initialement accepté la quantité.

{ "acknowledgements": [ { "purchaseOrderNumber": "L8266355", "sellingParty": { "partyId": "999US" }, "acknowledgementDate": "2019-07-17T19:17:34.304Z", "items": [ { "itemSequenceNumber": "1", "amazonProductIdentifier": "ABC123434", "vendorProductIdentifier": "028877454078", "orderedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": "5" }, "netCost": { "currencyCode": "USD", "amount": "10.2" }, "itemAcknowledgements": [ { "acknowledgementCode": "Accepted", "acknowledgedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": "5" }, "scheduledShipDate": "2019-07-17T19:17:34.304Z" } ] } ] } ] }

Par la suite, le fournisseur n'est pas en mesure d'assurer l'expédition de la quantité acceptée et envoie une annulation totale ou partielle par le biais d'une autre demande d'accusé de réception de commande.

Annulation totale

{ "acknowledgements": [ { "purchaseOrderNumber": "L8266355", "sellingParty": { "partyId": "999US" }, "acknowledgementDate": "2019-07-17T19:17:34.304Z", "items": [ { "itemSequenceNumber": "1", "amazonProductIdentifier": "ABC123434", "vendorProductIdentifier": "028877454078", "orderedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": "5" }, "netCost": { "currencyCode": "USD", "amount": "10.2" }, "itemAcknowledgements": [ { "acknowledgementCode": "Rejected", "acknowledgedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": "5" }, "rejectionReason": "TemporarilyUnavailable" } ] } ] } ] }

Annulation partielle

{ "acknowledgements": [ { "purchaseOrderNumber": "L8266355", "sellingParty": { "partyId": "999US" }, "acknowledgementDate": "2019-07-17T20:10:34.304Z", "items": [ { "itemSequenceNumber": "1", "amazonProductIdentifier": "ABC123434", "vendorProductIdentifier": "028877454078", "orderedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": "5" }, "netCost": { "currencyCode": "USD", "amount": "10.2" }, "itemAcknowledgements": [ { "acknowledgementCode": "Accepted", "acknowledgedQuantity": { "amount": 3, "unitOfMeasure": "Cases", "unitSize": "5" }, "scheduledShipDate": "2019-07-17T19:17:34.304Z" }, { "acknowledgementCode": "Rejected", "acknowledgedQuantity": { "amount": 7, "unitOfMeasure": "Cases", "unitSize": "5" }, "rejectionReason": "TemporarilyUnavailable" } ] } ] } ] }

Statut du bon de commande après une annulation partielle ultérieure

{ "payload": { "ordersStatus": [ { "purchaseOrderNumber": "L8266355", "purchaseOrderStatus": "OPEN", "purchaseOrderDate": "2019-07-16T19:17:34.304Z", "lastUpdatedDate": "2019-07-17T19:17:34.304Z", "sellingParty": { "partyId": "999US" }, "shipToParty": { "partyId": "NAG1" }, "itemStatus": [ { "itemSequenceNumber": "1", "buyerProductIdentifier": "ABC123434", "vendorProductIdentifier": "028877454078", "netCost": { "amount": "10.2", "currencyCode": "USD" }, "listPrice": { "amount": "10.2", "currencyCode": "USD" }, "orderedQuantity": { "orderedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": 5 }, "orderedQuantityDetails": [ { "updatedDate": "2019-07-16T19:17:34.304Z", "orderedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": 5 } } ] }, "acknowledgementStatus": { "confirmationStatus": "PARTIALLY_ACCEPTED", "acceptedQuantity": { "amount": 3, "unitOfMeasure": "Cases", "unitSize": 5 }, "rejectedQuantity": { "amount": 7, "unitOfMeasure": "Cases", "unitSize": 5 }, "acknowledgementStatusDetails": [ { "acknowledgementDate": "2019-07-17T19:17:34.304Z", "acceptedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": 5 }, "rejectedQuantity": { "amount": 0, "unitOfMeasure": "Cases", "unitSize": 5 } }, { "acknowledgementDate": "2019-07-17T20:10:34.304Z", "acceptedQuantity": { "amount": 3, "unitOfMeasure": "Cases", "unitSize": 5 }, "rejectedQuantity": { "amount": 7, "unitOfMeasure": "Cases", "unitSize": 5 } } ] } } ] } ] } }

Qu'est-ce que l'API Expéditions fournisseur ?

You can use the Vendor Shipments API (Shipments API) to exchange shipment related documents with Amazon.

Les opérations suivantes sont incluses dans l'API Expéditions :

Opération Méthode HTTP Path Description
SubmitShipmentConfirmations POST /vendor/shipping/v1/shipmentConfirmations Soumettez des confirmations d'expédition à Amazon.
GetShipmentDetails GET /vendor/shipping/v1/shipments Obtenez les détails d'expédition de la demande de transport soumise à Amazon. La récupération des données est possible pendant une période maximale de six mois à compter de la date de création de la demande d'expédition.
SubmitShipments POST /vendor/shipping/v1/shipments Soumettez une ou plusieurs demandes de transport à Amazon.

SubmitShipmentConfirmations

You can use the SubmitShipmentConfirmations operation to submit shipment confirmations to Amazon. With your shipment confirmation we can efficiently receive and process your shipments. It contains information about the items being shipped, including purchase order number, ship date, estimated delivery date, lot number, expiration date, and the Serial Shipping Container Code (SSCC).

En recevant une confirmation d'expédition valide et en temps opportun, nous pouvons anticiper correctement les envois que vous nous envoyez. La soumission de confirmations d'expédition présente certains avantages, notamment :

  • Amazon peut collaborer plus efficacement avec les transporteurs pour le suivi et la réception de vos envois. Cela nous permet de planifier efficacement nos ressources en main-d'œuvre et de garantir une réception plus rapide et plus efficace de votre envoi, ce qui signifie que vous pouvez facturer vos bons de commande plus rapidement.

  • Amazon peut suivre les stocks entrants et créer des commandes automatisées pour s'assurer que les articles ne soient pas en rupture de stock.

  • Une meilleure visibilité sur les produits en transit, ce qui nous permet de refléter plus précisément la disponibilité des articles (livraison par période) pour les clients finaux.

  • Les politiques d'annulation des bons de commande d'Amazon permettent d'annuler les envois en attente. Cependant, les bons de commande dotés d'une confirmation d'expédition précise alertent nos systèmes internes de l'état du transit. Cela peut contribuer à éviter les annulations de bon de commande, les rétrofacturations et les refus de transport inutiles.

L'absence de confirmation d'expédition valide peut avoir les conséquences suivantes :

  • Visibilité insuffisante pour les expéditions entrantes.
  • Erreurs lors de la comparaison des expéditions physiques avec les bons de commande.
  • Suivis manuels pour résoudre les incohérences.
  • La nécessité de fournir une preuve de livraison (POD) pour la facturation.

Confirmation d'expédition - Remplacer

Lorsqu'une confirmation d'expédition comporte un shipmentConfirmationType de Replace, vous pouvez corriger les confirmations d'expédition soumises précédemment en envoyant une version mise à jour. Le deuxième appel de confirmation d'expédition remplacera complètement les données de confirmation de la première expédition.

Le principal avantage est l'amélioration de la précision des réservations grâce à la mise à jour des confirmations d'expédition erronées après la soumission initiale.

Comment ça marche ?

Afin de remplacer une confirmation d'expédition soumise précédemment, une deuxième confirmation d'expédition peut être envoyée. Le shipmentIdentifier et sellingParty.partyId doivent être identiques pour les deux transmissions, afin que nous puissions remplacer avec succès la version précédente de la confirmation d'expédition.

Étendue de la confirmation d'expédition - Remplacer

  • Toutes les valeurs de confirmation d'expédition peuvent être modifiées, à l'exception de shipmentIdentifier et sellingParty.partyId, qui doivent rester identiques pour une confirmation d'expédition réussie - Remplacer.

  • Les quantités de palettes, de colis et d'expéditions ne peuvent pas être augmentées, mais seulement réduites. Pour augmenter les volumes, vous devez envoyer une deuxième confirmation d'expédition avec une nouvelle valeur shipmentIdentifier. Vous pouvez utiliser la même référence de lettre de transport si les unités supplémentaires doivent être livrées avec le même envoi.

  • A shipment confirmation submitted using the API can only be edited by submitting another shipment confirmation using the API. A shipment confirmation created in Vendor Central cannot be edited using the API.

  • Remplacer une confirmation d'expédition n'est possible que dans un délai de 7 jours après la confirmation d'expédition initiale, et uniquement si l'expédition n'a pas encore atteint le centre de distribution Amazon.

Vérification des confirmations d'expédition réussies

You can verify the status of your original or replaced shipment confirmations via Vendor Central > Orders > Shipments or by using the Transaction Status API. It can take the system up to 30 min to show the original/replaced version after submission. If Vendor Central is not showing the correct values for the replaced shipment confirmation, open a Contact Us case in Vendor Central.

Le schéma suivant montre le workflow d'intégration lors de la soumission des confirmations d'expéditions.

The Vendor shipments workflow when submitting shipment confirmations.

Exigences commerciales

  • Lorsqu'un vendeur expédie des articles vendus au poids, il doit fournir totalWeight champ. Le totalWeight Ce champ contient le poids des articles expédiés par le fournisseur et l'unité de mesure du poids. L'unité de poids des valeurs de mesure comprend POUNDS, OUNCES, GRAMS, et KILOGRAMS.

  • Il y a une limite de 100 confirmations d'expédition pour chaque expédition par camion. Cela signifie que vous ne pouvez envoyer une confirmation d'expédition distincte au niveau du bon de commande ou du colis que si le nombre total de confirmations d'expédition individuelles est inférieur ou égal à 100 pour ce chargement par camion (TL) ou inférieur à une expédition par camion (LTL). Nous vous recommandons d'envoyer une seule confirmation d'expédition pour l'ensemble de l'expédition TL/LTL, y compris toutes les informations relatives au bon de commande et au colis.

  • Amazon doit recevoir la confirmation d'expédition avant la réception du produit dans le centre de distribution Amazon. Une confirmation d'expédition manquante ou tardive entraînera une rétrofacturation.

  • Pour les expéditions de petits colis, une confirmation d'expédition est requise pour chaque colis/carton.

  • Les éléments suivants sont exigés par Amazon et sont mesurés pour assurer la conformité :

    • Pour les livraisons palettisées, vous devez envoyer une confirmation d'expédition avant de demander un créneau de livraison au centre de distribution Amazon, car les rendez-vous ne sont pris que si une confirmation d'expédition valide est trouvée dans les systèmes Amazon. Pour les exceptions, reportez-vous à la confirmation d'expédition locale Aide pages pour comprendre les options disponibles. Pour les colis, la confirmation d'expédition doit être soumise avant l'expédition des articles. Une confirmation d'expédition manquante ou retardée entraînera des rétrofacturations.
    • Une confirmation d'expédition doit porter sur une seule livraison, auprès d'un seul fournisseur et pour un seul camion. Les expéditions effectuées dans plusieurs camions, vers plusieurs centres de distribution Amazon, depuis plusieurs comptes fournisseurs ou dont l'arrivée est prévue pour plusieurs jours nécessitent plusieurs confirmations d'expédition.
    • Si plusieurs petits envois pour le même compte fournisseur sont combinés dans un envoi plus important et que plusieurs confirmations d'expédition sont requises, vous pouvez utiliser l'option BOL parapluie, comme indiqué dans l'exemple suivant :

Confirmation d'expédition 1

"billOfLadingNumber": "BOL1" "shipmentIdentifier": "SHIPMENT CONFIRMATION_ID1"

Confirmation d'expédition 2

"billOfLadingNumber": "BOL1" "shipmentIdentifier": "SHIPMENT CONFIRMATION_ID2"

Exigences commerciales spécifiques à chaque pays

Fonctionnalité Définition de l'entreprise Inde Europe Amérique du Nord
Numéro de la lettre de transport/Devis de livraison

BOL number is the unique number assigned by the vendor. The BOL present in the shipment confirmation ideally matches the paper BOL provided with the shipment, but that is not required. Refer to Additional field explanations for more information. The BOL reference is used for appointment booking and shipment label creation.

Le numéro de devis de livraison est une alternative au numéro BOL comme numéro de référence pour un envoi.

Conditionnel

Obligatoire pour toutes les confirmations d'expédition. Obligatoire pour les envois FTL ou LTL.
Numéro de référence de l'expédition du transporteur (PRO#) Le numéro PRO (numéro Pro) est un numéro unique attribué par le transporteur. Il est utilisé pour identifier et suivre l'expédition qui doit être livrée. Obligatoire pour toutes les confirmations d'expédition. Facultatif Obligatoire pour toutes les confirmations d'expédition.
Date d'expédition Date à laquelle l'expédition quitte l'entrepôt du fournisseur.

Obligatoire pour toutes les confirmations d'expédition.

Obligatoire pour toutes les confirmations d'expédition. Obligatoire pour toutes les confirmations d'expédition.
Date de livraison estimée

Date à laquelle l'expédition devrait atteindre le centre de distribution Amazon. Il doit s'agir d'une estimation basée sur le temps d'acheminement moyen entre le lieu d'expédition et la destination. L'heure exacte du rendez-vous sera communiquée par Amazon et peut ne pas être connue lors de la création de l'expédition.

Obligatoire pour toutes les confirmations d'expédition.

Obligatoire pour toutes les confirmations d'expédition. Obligatoire pour toutes les confirmations d'expédition.
Nombre de cartons Nombre de cartons présents dans l'expédition. Les unités empilées sur la palette sans le carton extérieur sont comptées comme 1 unité = 1 carton. Le nombre de cartons est requis pour l'expédition. Obligatoire pour toutes les confirmations d'expédition. Obligatoire pour toutes les confirmations d'expédition. Obligatoire pour toutes les confirmations d'expédition.
Nombre de palettes Nombre de palettes présentes dans l'expédition. Pour les expéditions de colis purs, la valeur 0 doit être indiquée. Tous les volumes atteignant le centre de distribution sur une palette doivent avoir un minimum de 1 indiqué dans ce segment. Les informations sont requises pour l'expédition. Obligatoire pour toutes les confirmations d'expédition pour les livraisons sur palettes. Obligatoire pour toutes les confirmations d'expédition. Obligatoire pour les envois FTL et LTL.
Code alpha du support standard (SCAC) Code qui identifie le transporteur de l'expédition. Le code alpha standard du transporteur (SCAC) est un code unique de deux à quatre lettres utilisé pour identifier un transporteur. Les codes SCAC des transporteurs sont attribués et mis à jour par la NMFTA (National Motor Freight Association, association nationale de transport de marchandises). Facultatif Facultatif Obligatoire pour toutes les confirmations d'expédition.
Lieu de livraison (adresse de livraison) Code d'identification de la partie ou de l'entrepôt où les produits sont expédiés. Le nom du champ du schéma de l'API est “shipToParty” Obligatoire pour toutes les confirmations d'expédition. Obligatoire pour toutes les confirmations d'expédition. Obligatoire pour toutes les confirmations d'expédition.
Identification des fournisseurs Identification du fournisseur qui expédie les produits à Amazon. Le nom du champ du schéma de l'API est “sellingParty”. Obligatoire pour toutes les confirmations d'expédition. Obligatoire pour toutes les confirmations d'expédition. Facultatif
Expédier depuis Adresse (code postal) et pays de référence de l'endroit d'où les produits sont physiquement expédiés. Obligatoire pour toutes les confirmations d'expédition. Obligatoire pour toutes les confirmations d'expédition. Obligatoire pour toutes les confirmations d'expédition.
Numéro de référence Amazon (uniquement pour les expéditions WePay). Numéro de référence Amazon tel qu'il a été reçu dans les instructions de routage (GetShipmentDetails réponse) pour un envoi WePay. Obligatoire uniquement pour les confirmations d'expédition

(pour les expéditions WePay).

Obligatoire uniquement pour les confirmations d'expédition

(pour les expéditions WePay).

Obligatoire pour la collecte des expéditions.
Numéro de bon de commande Le numéro de commande Amazon. Autorisation écrite pour un fournisseur d'expédier des produits à un prix déterminé, qui devient un contrat juridiquement contraignant une fois que le fournisseur l'a accepté. Obligatoire au niveau de l'en-tête ou de l'article. Obligatoire au niveau de l'en-tête ou de l'article. Obligatoire au niveau de l'en-tête ou de l'article.
Code de conteneur d'expédition en série (SSCC) Code de conteneur d'expédition en série (SSCC) unique à 18 chiffres à inclure pour désigner une palette/un carton. Recommandé pour toutes les confirmations d'expédition à l'intérieur de l'unité d'emballage. Obligatoire pour toutes les confirmations d'expédition à l'intérieur de l'unité d'emballage. Obligatoire pour toutes les confirmations d'expédition à l'intérieur de l'unité d'emballage.
Identification de l'article SKU du fournisseur du produit. Obligatoire pour toutes les confirmations d'expédition. Obligatoire pour toutes les confirmations d'expédition. Obligatoire pour toutes les confirmations d'expédition.
Numéro de lot Le numéro de lot associe un article à des informations que le fabricant juge pertinentes pour la traçabilité de l'article commercial auquel la chaîne d'éléments est appliquée. Les données peuvent se référer à l'article commercial lui-même ou à des articles qu'il contient. Obligatoire pour les denrées périssables. Obligatoire pour les denrées périssables. Obligatoire pour les denrées périssables.
Date d'expiration Date qui détermine la limite de consommation ou d'utilisation d'un produit. Sa signification est déterminée en fonction de l'article commercial. Obligatoire pour les denrées périssables. Obligatoire pour les denrées périssables. La date d'expiration ou la date de fabrication et la durée de conservation sont requises.
Date de fabrication Date de production, d'emballage ou d'assemblage déterminée par le fabricant. Sa signification est déterminée en fonction de l'article commercial. Facultatif Facultatif La date d'expiration ou la date de fabrication et la durée de conservation sont requises.
Quantité Nombre d'unités expédiées pour un article spécifique. Obligatoire pour toutes les confirmations d'expédition. Obligatoire pour toutes les confirmations d'expédition. Obligatoire pour toutes les confirmations d'expédition.

Explications supplémentaires sur les champs

Numéro du connaissement

Le numéro de connaissement (BOL#) est le numéro de référence requis pour la prise de rendez-vous sur Amazon. Cette référence doit être fournie lorsqu'Amazon demande une confirmation d'expédition valide. Il s'agit du numéro de référence par défaut pour le document accompagnant l'envoi physique. Le numéro BOL figurant dans la confirmation d'expédition doit correspondre au numéro BOL indiqué dans la documentation d'expédition.

Lorsque vous définissez le numéro BOL, assurez-vous qu'il est unique pour chaque envoi. Votre numéro BOL# peut être la référence physique du BOL, mais si vous optez pour un autre numéro :

  • Utilisez un minimum de huit chiffres.
  • En utilisant le code fournisseur Amazon comme préfixe (par exemple : ABCD193939393).
  • N'utilisez pas de date ni d'heure.
Identification de l'expédition

Ce champ est un identifiant unique (l'unicité est définie dans le contexte du fournisseur) qui représente cette confirmation d'expédition. Défaut de fournir un Shipment Identification entraînera le rejet de la confirmation d'expédition. Assurez-vous que l'identifiant envoyé n'a pas été utilisé au cours des 365 derniers jours.

Date d'expédition

Ce champ indique la date de départ de l'expédition depuis le lieu de résidence du fournisseur. Les fournisseurs sont invités à envoyer les confirmations d'expédition avant que le fret n'arrive à Amazon FC.

Date de livraison estimée

Il s'agit d'une estimation grossière, reposant sur la pratique, du moment où une expédition est censée être livrée au centre de distribution Amazon. Les fournisseurs sont tenus de déterminer ce délai en fonction de la durée moyenne d'acheminement par le transporteur. Cette information nous aide à planifier l'expédition si nous n'obtenons pas de date de livraison estimée de la part du transporteur.

Cette date doit être fournie pour chaque expédition, même si la date de rendez-vous est potentiellement inconnue à ce stade.

Code de conteneur d'expédition en série (SSCC)

Amazon traite les reçus à l'aide d'une approche hautement automatisée appelée License Plate ou LP Receive. Ce processus nécessite que vous fournissiez des informations sur le contenu du carton dans vos messages de confirmation d'expédition. Ce processus de réception obligatoire permet de scanner un code-barres SSCC (Serial Shipment Container Code) situé à l'extérieur d'un carton ou d'une palette d'articles reçus, éliminant ainsi le besoin de scanner chaque article contenu dans le carton ou la palette. Ce processus présente de nombreux avantages importants, notamment une efficacité accrue, une meilleure précision de réception, un paiement plus précis et un cycle de paiement plus rapide.

Vous pouvez choisir une solution technique, Amazon ayant décidé de ne pas suivre strictement la solution GS1-128. Pour être conforme aux exigences relatives aux plaques d'immatriculation d'Amazon, un SSCC doit être un code unique à 18 chiffres qui définit une palette ou un carton, il ne peut pas être répété dans les 365 jours et doit inclure un code-barres à la fois sur l'étiquette du carton et dans le message de confirmation d'expédition. De plus, le code-barres sur l'étiquette physique doit correspondre à 100 % au SSCC dans la confirmation d'expédition. Les fournisseurs qui souhaitent implémenter le GS1-128 sont invités à ajouter un 00 au début de leur SSCC dans la confirmation d'expédition.

For more information about generating an SSCC and the requirements for the physical shipment, refer to Vendor Central. To locate the Vendor Manual with labelling requirements, select Shipping, then License Plate label and receiving requirements.

Date d'expiration

La date d'expiration est la date qui détermine la limite de consommation ou d'utilisation d'un produit. Elle est déterminée en fonction de l'article commercial (par exemple, pour les denrées alimentaires, elle indique la possibilité d'un risque direct pour la santé en cas de consommation du produit après la date, pour les produits pharmaceutiques, elle indique la possibilité d'un risque indirect pour la santé en raison de l'inefficacité du produit après la date). Elle est souvent appelée “Date limite de consommation”.

Date de fabrication

Il s'agit de la date à laquelle les marchandises ont été emballées ou fabriquées. Ce champ doit être renseigné si un article est périssable ou a une durée de conservation définie.

Numéro de lot

Le numéro de lot ou de lot associe un article à des informations que le fabricant juge pertinentes pour la traçabilité de l'article lui-même ou des ingrédients qu'il contient. Le numéro peut indiquer un lot de production, une équipe de travail, une machine, une heure ou un code de production interne.

Utilisation de la date d'expiration, de la date de fabrication et des numéros de lot dans la confirmation d'expédition

Ces champs sont obligatoires uniquement pour les denrées périssables, c'est-à-dire pour les articles dont le is expiration dated product l'attribut est Yes sur le formulaire de configuration des nouveaux articles (NIS).

Lorsque vous définissez les dates d'expiration, les dates de fabrication ou les numéros de lot dans la confirmation d'expédition :

  • Les dates d'expiration/dates de fabrication/numéros de lot doivent être transmis par article.

  • Une caisse/palette peut contenir plusieurs articles (ASIN), chacun avec des dates d'expiration/dates de fabrication/numéros de lot individuels.

  • Un article (ASIN) ne doit pas avoir plusieurs dates d'expiration/dates de fabrication/numéros de lot au sein d'une même caisse/palette.

Les fournisseurs sont tenus d'indiquer la date d'expiration et la date de fabrication dans la confirmation d'expédition au format AAAAMMJJ.

Cas d'utilisation de la confirmation d'expédition

Étui standard pour petits colis avec numéros de péremption et de lot

{ "shipmentConfirmations": [ { "shipmentIdentifier": "00050003", "shipmentConfirmationType": "Original", "shipmentType": "TruckLoad", "shipmentStructure": "LooseStandardCase", "transportationDetails": { "carrierScac": "UPSN", "billOfLadingNumber": "02440000" }, "amazonReferenceNumber": "ARN_Number", "shipmentConfirmationDate": "2019-07-29T21:56:18.575Z", "shippedDate": "2019-07-29T21:56:18.575Z", "estimatedDeliveryDate": "2019-07-29T21:56:18.575Z", "sellingParty": { "partyId": "VENDORCODE" }, "shipFromParty": { "address": { "name": "ABC electronics warehouse", "addressLine1": "DEF 1st street", "city": "Lisses", "stateOrRegion": "abcland", "postalCode": "91090", "countryCode": "DE" }, "partyId": "ABCED" }, "shipToParty": { "partyId": "AMZWAREHOUSECODE" }, "shipmentMeasurements": { "grossShipmentWeight": { "unitOfMeasure": "Kg", "value": "120.45" }, "shipmentVolume": { "unitOfMeasure": "CuFt", "value": "2.4" }, "cartonCount": 2 }, "shippedItems": [ { "itemSequenceNumber": "001", "amazonProductIdentifier": "AB1234233", "vendorProductIdentifier": "VN24343334", "shippedQuantity": { "amount": 50, "unitOfMeasure": "Eaches", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "PO1234BD", "lotNumber": " 12345", "expiry": { "expiryDate": "2019-11-29T21:56:18.575Z" } } } ], "cartons": [ { "cartonIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567666698888" } ], "cartonSequenceNumber": " 001", "trackingNumber": "UPS TRACKING NUMBER", "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 25, "unitOfMeasure": "Eaches", "unitSize": 1 } } ] }, { "cartonIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567666698889" } ], "cartonSequenceNumber": " 002", "trackingNumber": "UPS TRACKING NUMBER", "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 25, "unitOfMeasure": "Eaches", "unitSize": 1 } } ] } ] } ] }

Petit LooseAssortmentCase colis avec numéro de péremption et numéro de lot

{ "shipmentConfirmations": [ { "shipmentIdentifier": "00050003", "shipmentConfirmationType": "Original", "shipmentType": "TruckLoad", "shipmentStructure": "LooseAssortmentCase", "transportationDetails": { "carrierScac": "UPSN", "billOfLadingNumber": "02440000" }, "amazonReferenceNumber": "ARN_Number", "shipmentConfirmationDate": "2019-07-29T21:56:18.575Z", "shippedDate": "2019-07-29T21:56:18.575Z", "estimatedDeliveryDate": "2019-07-29T21:56:18.575Z", "sellingParty": { "partyId": "VENDORCODE" }, "shipFromParty": { "address": { "name": "ABC electronics warehouse", "addressLine1": "DEF 1st street", "city": "Lisses", "stateOrRegion": "abcland", "postalCode": "91090", "countryCode": "DE" }, "partyId": "ABCED" }, "shipToParty": { "partyId": "AMZWAREHOUSECODE" }, "shipmentMeasurements": { "grossShipmentWeight": { "unitOfMeasure": "Kg", "value": "120.45" }, "shipmentVolume": { "unitOfMeasure": "CuFt", "value": "2.4" }, "cartonCount": 2 }, "shippedItems": [ { "itemSequenceNumber": "001", "amazonProductIdentifier": "AB1234233", "vendorProductIdentifier": "VN24343334", "shippedQuantity": { "amount": 50, "unitOfMeasure": "Eaches", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "PO1234BD", "lotNumber": " 12345", "expiry": { "expiryDate": "2019-11-29T21:56:18.575Z" } } }, { "itemSequenceNumber": "002", "amazonProductIdentifier": "AB1234235", "vendorProductIdentifier": "VN24343370", "shippedQuantity": { "amount": 50, "unitOfMeasure": "Eaches", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "PO1234BD", "lotNumber": " 12345", "expiry": { "expiryDate": "2019-11-29T21:56:18.575Z" } } } ], "cartons": [ { "cartonIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567666698888" } ], "cartonSequenceNumber": " 001", "trackingNumber": "UPS TRACKING NUMBER", "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": 1 } }, { "itemReference": "002", "shippedQuantity": { "amount": 10, "unitOfMeasure": "Cases", "unitSize": 1 } } ] } ] } ] }

Chargement de camion avec pallette pour plusieurs articles

{ "shipmentConfirmations": [ { "shipmentIdentifier": "00050003", "shipmentConfirmationType": "Original", "shipmentType": "TruckLoad", "shipmentStructure": "PalletizedAssortmentCase", "transportationDetails": { "transportationMode": "Road", "billOfLadingNumber": "02440000" }, "shipmentConfirmationDate": "2019-08-07T19:56:45.632Z", "shippedDate": "2019-08-07T19:56:45.632Z", "estimatedDeliveryDate": "2019-08-07T19:56:45.632Z", "sellingParty": { "partyId": "VENDORCODE" }, "shipFromParty": { "address": { "name": "ABC electronics warehouse", "addressLine1": "DEF 1st street", "city": "Lisses", "stateOrRegion": "abcland", "postalCode": "91090", "countryCode": "DE" }, "partyId": "VENDORWAREHOUSECODE" }, "shipToParty": { "partyId": "AMZWAREHOUSECODE" }, "shipmentMeasurements": { "grossShipmentWeight": { "unitOfMeasure": "Kg", "value": "250" }, "shipmentVolume": { "unitOfMeasure": "CuFt", "value": "2.4" }, "palletCount": 2 }, "shippedItems": [ { "itemSequenceNumber": "001", "vendorProductIdentifier": "9782700001659", "shippedQuantity": { "amount": 100, "unitOfMeasure": "Eaches", "unitSize": 1 } }, { "itemSequenceNumber": "002", "vendorProductIdentifier": "9782700001000", "shippedQuantity": { "amount": 400, "unitOfMeasure": "Eaches", "unitSize": 1 } } ], "cartons": [ { "cartonIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567666698888" } ], "cartonSequenceNumber": "001", "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 25, "unitOfMeasure": "Eaches", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "1BBBAAAA", "lotNumber": "1045", "maximumRetailPrice": { "currencyCode": "EUR", "amount": "89.00" }, "handlingCode": "Oversized" } }, { "itemReference": "002", "shippedQuantity": { "amount": 100, "unitOfMeasure": "Eaches", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "1BBBAACC", "lotNumber": "1087", "maximumRetailPrice": { "currencyCode": "EUR", "amount": "120.00" }, "handlingCode": "Oversized" } } ] }, { "cartonIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567666698999" } ], "cartonSequenceNumber": "002", "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 25, "unitOfMeasure": "Eaches", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "1BBBAACD", "lotNumber": "1045", "maximumRetailPrice": { "currencyCode": "EUR", "amount": "89.00" }, "handlingCode": "Oversized" } }, { "itemReference": "002", "shippedQuantity": { "amount": 100, "unitOfMeasure": "Eaches", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "1BBBAADD", "lotNumber": "1087", "maximumRetailPrice": { "currencyCode": "EUR", "amount": "120.00" }, "handlingCode": "Oversized" } } ] }, { "cartonIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567666698669" } ], "cartonSequenceNumber": "003", "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 25, "unitOfMeasure": "Eaches", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "1BBBAACD", "lotNumber": "1045", "maximumRetailPrice": { "currencyCode": "EUR", "amount": "89.00" }, "handlingCode": "Oversized" } }, { "itemReference": "002", "shippedQuantity": { "amount": 100, "unitOfMeasure": "Eaches", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "1BBBAADD", "lotNumber": "1087", "maximumRetailPrice": { "currencyCode": "EUR", "amount": "120.00" }, "handlingCode": "Oversized" } } ] }, { "cartonIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567666697799" } ], "cartonSequenceNumber": "004", "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 25, "unitOfMeasure": "Eaches", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "1BBBAACD", "lotNumber": "1045", "maximumRetailPrice": { "currencyCode": "EUR", "amount": "89.00" }, "handlingCode": "Oversized" } }, { "itemReference": "002", "shippedQuantity": { "amount": 100, "unitOfMeasure": "Eaches", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "1BBBAADD", "lotNumber": "1087", "maximumRetailPrice": { "currencyCode": "EUR", "amount": "120.00" }, "handlingCode": "Oversized" } } ] } ], "pallets": [ { "palletIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567898098745" } ], "tier": 1, "block": 2, "dimensions": { "length": "1.2", "width": "0.8", "height": "1", "unitOfMeasure": "In" }, "weight": { "unitOfMeasure": "Kg", "value": "55" }, "cartonReferenceDetails": { "cartonCount": 2, "cartonReferenceNumbers": [ "001", "002" ] } }, { "palletIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567898098700" } ], "tier": 1, "block": 2, "dimensions": { "length": "1.2", "width": "0.8", "height": "1", "unitOfMeasure": "In" }, "weight": { "unitOfMeasure": "Kg", "value": "55" }, "cartonReferenceDetails": { "cartonCount": 2, "cartonReferenceNumbers": [ "003", "004" ] } } ] } ] }

Envoi d'un chargement inférieur à une expédition par camion avec des caisses standard sur palettes

{ "shipmentConfirmations": [ { "shipmentIdentifier": "00050003", "shipmentConfirmationType": "Original", "shipmentType": "LessThanTruckLoad", "shipmentStructure": "PalletizedStandardCase", "transportationDetails": { "transportationMode": "Road", "billOfLadingNumber": "02440000" }, "shipmentConfirmationDate": "2019-08-07T19:56:45.632Z", "shippedDate": "2019-08-07T19:56:45.632Z", "estimatedDeliveryDate": "2019-08-07T19:56:45.632Z", "sellingParty": { "partyId": "VENDORCODE" }, "shipFromParty": { "address": { "name": "ABC electronics warehouse", "addressLine1": "DEF 1st street", "city": "Lisses", "stateOrRegion": "abcland", "postalCode": "91090", "countryCode": "DE" }, "partyId": "VENDORWAREHOUSECODE" }, "shipToParty": { "partyId": "AMZWAREHOUSECODE" }, "shipmentMeasurements": { "grossShipmentWeight": { "unitOfMeasure": "Kg", "value": "120.45" }, "shipmentVolume": { "unitOfMeasure": "CuFt", "value": "2.4" }, "palletCount": 1 }, "shippedItems": [ { "itemSequenceNumber": "001", "vendorProductIdentifier": "9782700001659", "shippedQuantity": { "amount": 100, "unitOfMeasure": "Eaches", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "1BBBAAAA", "lotNumber": "1045", "maximumRetailPrice": { "currencyCode": "EUR", "amount": "299.00" }, "handlingCode": "Oversized" } } ], "cartons": [ { "cartonIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567666698888" } ], "cartonSequenceNumber": "001", "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 25, "unitOfMeasure": "Eaches", "unitSize": 1 } } ] }, { "cartonIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567666699999" } ], "cartonSequenceNumber": "002", "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 25, "unitOfMeasure": "Eaches", "unitSize": 1 } } ] }, { "cartonIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567666696666" } ], "cartonSequenceNumber": "003", "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 25, "unitOfMeasure": "Eaches", "unitSize": 1 } } ] }, { "cartonIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567666697777" } ], "cartonSequenceNumber": "004", "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 25, "unitOfMeasure": "Eaches", "unitSize": 1 } } ] } ], "pallets": [ { "palletIdentifiers": [ { "containerIdentificationType": "SSCC", "containerIdentificationNumber": "00102234567898098745" } ], "tier": 2, "block": 2, "dimensions": { "length": "1.2", "width": "0.8", "height": "1", "unitOfMeasure": "In" }, "weight": { "unitOfMeasure": "Kg", "value": "120.45" }, "cartonReferenceDetails": { "cartonCount": 4, "cartonReferenceNumbers": [ "001", "002", "003", "004" ] } } ] } ] }

Expédition d'une seule palette ASIN dans un volume inférieur à un chargement par camion

{ "shipmentConfirmations": [ { "shipmentIdentifier": "5013088794", "shipmentConfirmationType": "Original", "shipmentType": "LessThanTruckLoad", "shipmentStructure": "PalletOfItems", "transportationDetails": { "carrierShipmentReferenceNumber": "1021396377", "billOfLadingNumber": "501308879400010001", "transportationMode": "Road" }, "shipmentConfirmationDate": "2023-04-21T22:31:43Z", "shippedDate": "2023-04-21T22:31:43Z", "estimatedDeliveryDate": "2023-04-21T22:31:43Z", "sellingParty": { "partyId": "VENDORCODE" }, "shipFromParty": { "address": { "name": "ABC electronics warehouse", "addressLine1": "DEF 1st street", "city": "Lisses", "stateOrRegion": "abcland", "postalCode": "91090", "countryCode": "DE" }, "partyId": "ABCED" }, "shipToParty": { "partyId": "AMZWAREHOUSECODE" }, "shipmentMeasurements": { "shipmentVolume": { "unitOfMeasure": "CuFt", "value": "181.656" }, "palletCount": 3, "grossShipmentWeight": { "unitOfMeasure": "Lb", "value": "3315.744" } }, "shippedItems": [ { "itemSequenceNumber": "001", "vendorProductIdentifier": "VN24343334", "shippedQuantity": { "amount": 315, "unitOfMeasure": "Cases", "unitSize": 1 }, "itemDetails": { "purchaseOrderNumber": "PO1234BD", "lotNumber": " 12345", "expiry": { "expiryDate": "2024-11-29T21:56:18.575Z" } } } ], "pallets": [ { "tier": 10, "palletIdentifiers": [ { "containerIdentificationNumber": "108195730651297459", "containerIdentificationType": "SSCC" } ], "weight": { "unitOfMeasure": "Lb", "value": "828.936" }, "block": 15, "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 105, "unitOfMeasure": "Cases", "unitSize": 1 } } ], "dimensions": { "unitOfMeasure": "In", "length": "44.375", "width": "39.750", "height": "40.500" } }, { "tier": 10, "palletIdentifiers": [ { "containerIdentificationNumber": "108195730651297589", "containerIdentificationType": "SSCC" } ], "weight": { "unitOfMeasure": "Lb", "value": "828.936" }, "block": 15, "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 105, "unitOfMeasure": "Cases", "unitSize": 1 } } ], "dimensions": { "unitOfMeasure": "In", "length": "44.375", "width": "39.750", "height": "40.500" } }, { "tier": 10, "palletIdentifiers": [ { "containerIdentificationNumber": "108195730651297595", "containerIdentificationType": "SSCC" } ], "weight": { "unitOfMeasure": "Lb", "value": "828.936" }, "block": 15, "items": [ { "itemReference": "001", "shippedQuantity": { "amount": 105, "unitOfMeasure": "Cases", "unitSize": 1 } } ], "dimensions": { "unitOfMeasure": "In", "length": "44.375", "width": "39.750", "height": "40.500" } } ] } ] }

SubmitShipments

🚧

Important

SubmitShipments est uniquement disponible sur les sites de vente d'Amérique du Nord et de l'UE.

The SubmitShipments operation is designed for Collect or WePay vendors to submit requests for the pickup of their shipments by Amazon. With this operation they can also update or cancel submitted requests. You can consolidate multiple orders that are ready to be shipped and request transportation through a single shipment request, thus saving time and lowering costs. When submitting a shipment request, the requested pickup date must be a minimum of two business days after the current date.

📘

Remarque

Le SubmitShipments L'opération ne permet pas de soumettre des demandes d'expédition pour des palettes non standard.

Créer ou mettre à jour une expédition
Quand le transactionType pour une demande d'expédition, c'est New, vous pouvez créer une nouvelle demande ou mettre à jour une demande d'expédition soumise précédemment. Les mises à jour d'une demande d'expédition existante sont effectuées en fonction du numéro d'expédition du fournisseur. Si une expédition portant le numéro d'expédition du fournisseur fourni existe déjà, une opération de mise à jour est effectuée ; sinon, une nouvelle expédition est créée.

Étendue de l'expédition des mises à jour :

  • Toutes les valeurs des demandes d'expédition sont modifiables, sauf vendorShipmentIdentifier,buyerReferenceNumber, et sellingParty.partyId qui doit rester identique pour une mise à jour réussie. Vous avez la possibilité de modifier tous les autres champs de la demande d'expédition avant que le transporteur ne soit désigné.
  • La date d'enlèvement demandée dans la demande d'expédition ne peut être modifiée qu'une fois que le transporteur a été désigné.

Annuler l'expédition
Une demande d'expédition avec transactionType comme Cancel vous permet d'annuler une demande d'expédition soumise précédemment. Pour annuler une demande d'expédition soumise précédemment, vous devez fournir vendorShipmentIdentifier, buyerReferenceNumber, sellingParty.partyId, shipFromParty.partyId, shipToParty.partyId et transactionType comme Cancel.

Étendue de l'annulation de l'expédition :

  • L'annulation d'une demande d'expédition est possible avant et après l'attribution d'un transporteur et la planification de l'itinéraire.

Vérification des demandes d'expédition soumises avec succès

You use Vendor Central or the Vendor Transaction Status API to verify the status of your shipment request. If the status of the posted request doesn't appear after 30 minutes, submit a support case in Vendor Central by navigating to Vendor Central > Support > Contact Us > API Integration.

📘

Remarque

The Transaction Status API only supports Processing and Failure status values for submitted Cancel Shipment requests.

Le schéma suivant montre le flux de travail d'intégration lors de la soumission des demandes d'expédition.

The Vendor Submit shipment workflow.

Exigences commerciales

  • La demande d'expédition ne doit être soumise que lorsque le bon de commande correspondant est complètement confirmé. Si le bon de commande n'a pas encore été confirmé, la demande d'expédition ne sera pas traitée.
  • Le requestedPickUp dans la demande d'expédition, doit se situer au moins deux jours ouvrables après la date en cours.
  • Toutes les valeurs des demandes d'expédition sont modifiables, sauf vendorShipmentIdentifier, buyerReferenceNumber, et sellingParty.partyId, qui doit rester identique pour une mise à jour réussie. Vous avez la possibilité de modifier tous les autres champs de la demande d'expédition avant que le transporteur ne soit désigné.
  • Vous ne pouvez modifier la date d'enlèvement demandée dans la demande d'expédition qu'après avoir désigné un transporteur.
  • L'annulation d'une demande d'expédition est possible avant et après l'attribution d'un transporteur et la planification de l'itinéraire.

Explications supplémentaires sur les champs

Identifiant d'expédition du fournisseur

Ce champ est un identifiant unique (l'unicité est définie dans le contexte du fournisseur), qui représente cette demande de transport. Défaut de fournir un vendorShipmentIdentifier entraînera le rejet de la demande de transport. Assurez-vous que l'identifiant envoyé n'a pas été utilisé au cours des 365 derniers jours.

Date de retrait demandée

Ce champ est également appelé Freight Ready Date, est utilisé pour spécifier la date de retrait la plus proche de l'expédition sur le site du fournisseur. Il vous est demandé d'envoyer la demande de transport lorsque les articles sont prêts à être ramassés.

Soumettre des exemples de demandes d'expédition

Créer ou mettre à jour une demande d'expédition

{ "shipments": [ { "vendorShipmentIdentifier": "00050003", "transactionType": "New", "transactionDate": "2019-08-07T19:56:45.632", "shipmentFreightTerm": "Collect", "sellingParty": { "partyId": "PQRSS" }, "shipFromParty": { "address": { "name": "ABC electronics warehouse", "addressLine1": "DEF 1st street", "city": "Lisses", "stateOrRegion": "abcland", "postalCode": "91090", "countryCode": "DE" }, "partyId": "999US" }, "shipToParty": { "partyId": "ABCDF" }, "shipmentMeasurements": { "totalCartonCount": 30, "totalPalletStackable": 30, "totalPalletNonStackable": 30, "shipmentWeight": { "unitOfMeasure": "Kg", "value": "120.45" }, "shipmentVolume": { "unitOfMeasure": "CuFt", "value": "2.4" } }, "collectFreightPickupDetails": { "requestedPickUp": "2019-08-07T19:56:45.632" }, "purchaseOrders": [ { "purchaseOrderNumber": "1BBBAAAA" }, { "purchaseOrderNumber": "1BBBACCC" } ] } ] }

Annuler la demande d'expédition

{ "shipments": [ { "vendorShipmentIdentifier": "00050003", "buyerReferenceNumber": "1234567", "transactionType": "Cancel", "transactionDate": "2019-08-07T19:56:45.632", "shipmentFreightTerm": "Collect", "sellingParty": { "partyId": "PQRSS" }, "shipFromParty": { "address": { "name": "ABC electronics warehouse", "addressLine1": "DEF 1st street", "city": "Lisses", "stateOrRegion": "abcland", "postalCode": "91090", "countryCode": "DE" }, "partyId": "999US" }, "shipToParty": { "partyId": "ABCDF" } } ] }

GetShipmentDetails

🚧

Important

GetShipmentDetails est uniquement destiné à WePay et aux commandes à retrait sur les sites de vente en Amérique du Nord et dans l'UE.

You can use the GetShipmentDetails operation to retrieve scheduled pickup and carrier assignment information. You must use SubmitShipments or a routing request before shipment details are available. GetShipmentDetails only returns a response after carrier assignment, which occurs either on the same day as the scheduled pickup or one day prior to the pickup date.

Les informations renvoyées dans la réponse vous aident à gérer efficacement votre processus d'expédition, à vous assurer que la commande est emballée et qu'elle est prête à être récupérée par le transporteur à la date de retrait attribuée. À tout moment pendant le cycle de vie de l'expédition, vous pouvez utiliser cette opération pour consulter le statut et les détails de l'expédition. Cette opération est principalement utilisée par les fournisseurs WePay.

Le schéma suivant montre le flux de travail d'intégration de Vendor Get Shipment.

The Vendor Get shipment workflow.

Exigences commerciales

  • The GetShipmentDetails operation only provides a response if shipment creation is successful. The response contains the Amazon Reference Number (ARN) and other shipment details. The carrier assignment details are available only after the carrier assignment for the shipment. Carrier assignment occurs on the same day as the scheduled pickup or one day prior to the pickup date.

  • The GetShipmentDetails operation will not provide details for shipments submitted through Vendor Central.

GetShipmentDetails requis

To return a list of shipments, call the GetShipmentDetails operation and pass the following parameters:

Paramètres de requête :

Nom Description Obligatoire
limit La limite du nombre d'enregistrements renvoyés.

Type : int

Non
sortOrder Triez la liste par date de création d'expédition dans l'ordre croissant ou décroissant.

Type : chaîne

Type: enum ( SortOrder )

Non
nextToken Utilisé pour la pagination lorsque le nombre d'étiquettes d'expédition est supérieur à la limite de taille de résultat spécifiée. La valeur du jeton est renvoyée lors de l'appel API précédent.

Type : chaîne

Non
createdAfter Shipments created after this time will be included in the result. This field must be in ISO 8601 date/time format.

Type : chaîne (date-heure)

Non
createdBefore Shipments created before this time will be included in the result. This field must be in ISO 8601 date/time format.

Type : chaîne (date-heure)

Non
shipmentConfirmedBefore Use to provide the date to retrieve Shipment Details of all shipments confirmed before this date. This field must be in ISO 8601 date/time format.

Type : chaîne (date-heure)

Non
shipmentConfirmedAfter Use to provide the date to retrieve Shipment Details of all shipments confirmed after this date. This field must be in ISO 8601 date/time format.

Type : chaîne (date-heure)

Non
packageLabelCreatedBefore Use to provide the date to fetch Shipment Details of all shipments for which package labels were created before this date. This field must be in ISO 8601 date/time format.

Type : chaîne (booléenne)

Non
packageLabelCreatedAfter Use to provide the date to retrieve Shipment Details of all shipments for which package labels were created after this date. This field must be in ISO 8601 date/time format.

Type : chaîne (date-heure)

Non
shippedBefore Use to provide the date to retrieve Shipment Details of all shipments for which shipped date is before this date. This field must be in ISO 8601 date/time format.

Type : chaîne (date-heure)

Non
shippedAfter Use to provide the date to retrieve Shipment Details of all shipments for which the shipped date is after this date. This field must be in ISO 8601 date/time format.

Type : chaîne (date-heure)

Non
estimatedDeliveryBefore Use to provide the date to retrieve Shipment Details of all shipments for which estimated delivery date is before this date. This field must be in ISO 8601 date/time format.

Type : chaîne (date-heure)

Non
estimatedDeliveryAfter Use to provide the date to retrieve Shipment Details of all shipments with estimated delivery date after this date. This field must be in ISO 8601 date/time format.

Type : chaîne (date-heure)

Non
shipmentDeliveryBefore Use to provide the date to retrieve Shipment Details of all shipments with shipment delivery date before this date. This field must be in ISO 8601 date/time format.

Type : chaîne (date-heure)

Non
shipmentDeliveryAfter Use to provide the date to retrieve Shipment Details of all shipments for which shipment delivery date is after this date. This field must be in ISO 8601 date/time format.

Type : chaîne (date-heure)

Non
requestedPickUpBefore Use to provide the date to retrieve Shipment Details of all shipments for which requested pickup date is before this date. This field must be in ISO 8601 date/time format.

Type : chaîne (date-heure)

Non
requestedPickUpAfter Use to provide the date to retrieve Shipment Details of all shipments for which requested pickup date is after this date. This field must be in ISO 8601 date/time format.

Type : chaîne (date-heure)

Non
scheduledPickUpBefore Use to provide the date to retrieve Shipment Details of all shipments for which scheduled pickup date is before this date. This field must be in ISO 8601 date/time format.

Type : chaîne (date-heure)

Non
scheduledPickUpAfter Use to provide the date to retrieve Shipment Details of all shipments for which scheduled pickup date is after this date. This field must be in ISO 8601 date/time format.

Type : chaîne (date-heure)

Non
currentShipmentStatus Obtenez les détails de l'expédition en passant Statut actuel de l'expédition.

Type : chaîne

Non
vendorShipmentIdentifier Obtenez les détails de l'expédition en communiquant le numéro d'expédition du fournisseur.

Type : chaîne

Non
buyerReferenceNumber Obtenez les détails de l'expédition en transmettant le numéro de référence de l'acheteur.

Type : chaîne

Non
buyerWarehouseCode Obtenez les détails d'expédition en fonction du code d'entrepôt de l'acheteur. Cette valeur doit être la même que shipToParty.partyId dans l'expédition.

Type : chaîne

Non
sellerWarehouseCode Obtenez les détails d'expédition en fonction du code d'entrepôt du fournisseur. Cette valeur doit être la même que sellingParty.partyId dans l'expédition.

Type : chaîne

Non

Exemple de demande :

GET https://sellingpartnerapi-na.amazon.com/vendor/shipping/v1/shipments?vendorShipmentIdentifier=00050003

GetShipmentDetails requis

Exemple de réponse :

{ "payload": { "pagination": { "nextToken": "MDAwMDAwMDAwMQ==" }, "shipments": [ { "vendorShipmentIdentifier": "00050003", "buyerReferenceNumber": "1234567", "currentShipmentStatus": "CarrierAssigned", "currentshipmentStatusDate": "2019-08-09T19:56:45.632", "shipmentStatusDetails": [ { "shipmentStatus": "CarrierAssigned", "shipmentStatusDate": "2019-08-09T19:56:45.632" }, { "shipmentStatus": "TransportationRequested", "shipmentStatusDate": "2019-07-07T19:56:45.632" }, { "shipmentStatus": "Created", "shipmentStatusDate": "2019-07-06T19:56:45.632" } ], "shipmentCreateDate": "2019-07-06T19:56:45.632", "shipmentFreightTerm": "Collect", "sellingParty": { "partyId": "998US" }, "shipFromParty": { "address": { "name": "ABC electronics warehouse", "addressLine1": "DEF 1st street", "city": "Lisses", "stateOrRegion": "abcland", "postalCode": "91090", "countryCode": "DE" }, "partyId": "ABCD12" }, "shipToParty": { "partyId": "999US" }, "shipmentMeasurements": { "totalCartonCount": 30, "totalPalletStackable": 30, "totalPalletNonStackable": 30, "shipmentWeight": { "unitOfMeasure": "Kg", "value": "120.45" }, "shipmentVolume": { "unitOfMeasure": "CuFt", "value": "2.4" } }, "collectFreightPickupDetails": { "requestedPickUp": "2019-08-10T19:56:45.632", "scheduledPickUp": "2019-08-10T19:56:45.632", "carrierAssignmentDate": "2019-08-09T19:56:45.632", }, "purchaseOrders": [ { "purchaseOrderNumber": "1BBBAAAA" } ], "transportationDetails": { "shipMode": "LessThanTruckLoad", "transportationMode": "Road", "shippedDate": "2019-08-07T19:56:45.632", "estimatedDeliveryDate": "2019-08-07T19:56:45.632", "shipmentDeliveryDate": "2019-08-07T19:56:45.632", "carrierDetails": { "name": "UPS", "phone": "1234567890", "email": "abc@xyz.com", "code": "string", "shipmentReferenceNumber": "TRACK001" }, "billOfLadingNumber": "string" } } ] } }

GetShipmentLabels

You can use the GetShipmentLabels operation to obtain shipping labels from Amazon exclusively for small parcel shipments on behalf of Collect/WePay vendors. This operation helps vendors retrieve shipping labels for confirmed orders that require shipment from the vendor's warehouse to Amazon's warehouse. Vendors can retrieve labels through a single API call or multiple API calls. Labels are generated once the shipment request is finalized and a carrier is assigned. Vendors have the option to filter Amazon-generated labels based on various parameters, such as buyer reference numbers (also known as Amazon reference numbers), seller warehouse codes, and other values.

Le schéma suivant illustre le flux de travail d'intégration des étiquettes d'expédition par le fournisseur.

The workflow for getting a shipment label

Exigences commerciales

  • Appelez le GetShipmentLabels uniquement après l'attribution d'un transporteur.
  • If GetShipmentLabels does not return a label or returns Resource Not Found, verify that a carrier has been assigned. Alternatively, you can call GetShipmentDetails to confirm whether the carrier has been assigned.
  • Si un transporteur a été désigné et que l'opération ne renvoie toujours aucune étiquette, ouvrez une case « Contactez-nous » sur le portail Vendor Central.
  • Une fois qu'une étiquette est utilisée pour l'expédition, elle ne peut jamais être réutilisée.

Exigences commerciales spécifiques à chaque pays

Cette opération d'API n'est disponible que dans la région NA.

Demande de requête

To return a list of shipment labels, call the GetShipmentLabels operation and pass the following parameters:

Nom Description Obligatoire
limit La limite du nombre d'enregistrements renvoyés.

Type : int

Non
sortOrder Triez la liste par date de création de l'étiquette d'expédition dans l'ordre croissant ou décroissant.

Type : chaîne

Type: enum ( SortOrder )

Non
nextToken Utilisé pour la pagination lorsque le nombre de commandes est supérieur à la limite de taille de résultat spécifiée. La valeur du jeton est renvoyée lors de l'appel API précédent.

Type : chaîne

Non
labelCreatedAfter Les étiquettes d'expédition créées après cette période seront incluses dans le résultat. Ce champ doit être au format date/heure ISO 8601.

Type : chaîne (date-heure)

Non
labelCreatedBefore Les étiquettes d'expédition créées avant cette date seront incluses dans le résultat. Ce champ doit être au format date/heure ISO 8601.

Type : chaîne (date-heure)

Non
buyerReferenceNumber Obtenez des étiquettes d'expédition en transmettant le numéro de référence de l'acheteur.

Type : chaîne

Non
vendorShipmentIdentifier Obtenez des étiquettes d'expédition en transmettant le numéro d'expédition du fournisseur.

Type : chaîne

Non
sellerWarehouseCode Obtenez des étiquettes d'expédition en fonction du code d'entrepôt du fournisseur. Cette valeur doit être la même que sellingParty.partyId dans l'expédition.

Type : chaîne

Non

Exemple de demande

GET /vendor/shipping/v1/transportLabels?vendorShipmentIdentifier=7822

Réponse de GetShipmentLabels

{ "payload": { "pagination": { "nextToken": "MDAwMDAwMDAwMQ==" }, "transportLabels": [ { "labelCreateDateTime": "2024-10-23T17:10:35Z", "shipmentInformation": { "vendorDetails": { "sellingParty": { "partyId": "WAD47" }, "vendorShipmentIdentifier": "7822" }, "buyerReferenceNumber": "14511336331", "shipToParty": { "partyId": "LAX9" }, "shipFromParty": { "partyId": "0-55767831", "address": { "name": "Wheeler Bros., Inc. HQ", "addressLine1": "384 Drum Ave", "addressLine2": "Suite 123", "addressLine3": "DOOR 1", "city": "Somerset", "stateOrRegion": "PA", "postalCode": "15501", "countryCode": "US" } }, "masterTrackingId": "1ZR873R70319165935", "totalLabelCount": 1, "shipMode": "SmallParcel" }, "labelData": [ { "labelSequenceNumber": 1, "labelFormat": "PDF", "carrierCode": "UPSN", "trackingId": "1ZR873R70319165935", "label": "Base 64 encoded string goes here." } ] } ] } }

Qu'est-ce que l'API Vendor Invoices ?

You can use the Vendor Invoices API, to exchange payment related documents with Amazon. With the Submit Invoices operation, you can send vendor invoices to Amazon for confirmed and shipped orders.

Les opérations suivantes sont incluses :

OpérationMéthode HTTPPathDescription
submitInvoicesPOST/vendor/payments/v1/invoicesSoumission d'une ou plusieurs facture(s) fournisseur à Amazon

📘

Remarque

Le submitInvoices L'opération peut être utilisée pour soumettre des notes de crédit en Europe.

Soumettre des factures

You can use the submitInvoices operation to request payment from Amazon for items shipped. You can use this operation to submit multiple invoices in a single API call.

Les articles ne doivent être facturés qu'après avoir été confirmés et expédiés à Amazon. Dans le cas contraire, la facture sera rejetée.

Une facture contenant des informations correctes sera traitée par Amazon sans aucune interaction humaine, ce qui signifie que le fournisseur reçoit le paiement plus rapidement.

Invoices with incorrect information will be rejected in Amazon's payee system, so sending correct information is important. Refer to the business requirements section to learn how to create invoices with correct information.

Test parallèle de la soumission des factures

You need to complete parallel testing with our payments system before you can start using the submitInvoices operation for payment processing.

Lorsque vous commencez à envoyer des factures à l'aide de l'API, la phase de test parallèle commence. Pendant la phase de test parallèle, vous envoyez des factures à Vendor Central et à l'API pour toutes les commandes expédiées. Vous devez effectuer des tests en parallèle jusqu'à ce que le contenu d'au moins cinq à dix fichiers de factures soit validé. Des tests sont effectués en parallèle avec les bons de commande et les factures de production.

L'équipe Amazon Accounts Payable (AP) vous contactera lorsque les tests parallèles seront terminés ou s'il y a des divergences dans le contenu de vos factures.

Lorsque vous recevez un e-mail indiquant que les tests parallèles sont terminés, vous n'avez plus besoin d'envoyer de factures à Vender Central ; vous pouvez utiliser l'API pour envoyer des factures.

Vérification des factures soumises avec succès

The Transaction Status API shows the status of the semantic validations for submitted invoices, but not the actual status of invoice processing. You can verify the actual status of the original or updated version of the invoices via Vendor Central > Payments > Invoices. For more information on how to use the Transaction Status API, refer to the business use case documentation for Transaction Status. If the original or updated version with the correct values for the updated invoice isn't present after 30 minutes, submit a support case in Vendor Central by navigating to Vendor Central > Support > Contact Us > API Integration.

Le schéma suivant montre le workflow d'intégration lors de la soumission d'une facture pour une commande confirmée et expédiée.

The Vendor invoices workflow when submitting an invoice for a confirmed and shipped order.

Exigences commerciales

  • Pour les articles dont le prix est calculé au poids, vous devez fournir totalWeight champ. Le totalWeight Ce champ contient le poids total de l'article facturé. En outre, le netCostUnitOfMeasure Ce champ doit refléter l'unité de mesure des articles dont vous fixez le prix au poids. Les valeurs des unités de mesure incluent POUNDS, OUNCES, GRAMS, et KILOGRAMS.

  • Les numéros de facture doivent être uniques et ne doivent jamais être réutilisés (même après un an).

  • Si une facture envoyée par API échoue en raison de données incorrectes, mais qu'une facture Vendor Central contient les données correctes, vous devez mettre à jour la facture via l'API avec les données correctes en utilisant les mêmes Invoice ID.

  • Si une facture contient des données incorrectes (à la fois Vendor Central et API), elle est annulée et une nouvelle facture doit être envoyée avec un nouveau Invoice ID.

  • Une facture avec une valeur total amount = 0 = 0 ne doit pas être envoyée, car cela entraînerait l'échec de la facture.

  • Amazon requires the full address details in the address segments for tax compliance reasons. This is especially important for bill to party. For this segment the Amazon Payee system requires an exact match. For the list of addresses, refer to SP-API Bill to Party Addresses.

  • Les conditions de paiement envoyées sur une facture doivent correspondre aux conditions de paiement convenues avec l'acheteur Amazon.

  • L'identifiant du produit doit correspondre à l'identifiant de produit de la commande envoyé au fournisseur dans le bon de commande correspondant.

  • Le montant total de la facture doit être égal à la somme totale des articles, des frais et des indemnités.

  • Le montant total des taxes pour chaque ligne doit être égal au montant total des taxes indiqué dans l'en-tête.

  • La quantité totale de la facture doit correspondre à la somme des quantités de tous les articles.

  • Tous les frais et indemnités doivent être détaillés dans l'en-tête (par exemple, frais de transport, frais d'emballage, frais de petite commande, etc.).

Avertissement

L'adresse de remise doit correspondre à l'adresse enregistrée par Amazon. Si l'adresse ne correspond pas, la facture échoue.

Exigences commerciales spécifiques à chaque pays

Fonctionnalité Inde Europe Amérique du Nord
Type de facture Type de facture CreditNote n'est pas pris en charge. Le type de facture doit toujours être Invoice. Types de factures Invoice et CreditNote sont pris en charge. Les fournisseurs doivent envoyer le type de facture en conséquence. Type de facture CreditNote n'est pas pris en charge. Le type de facture doit toujours être Invoice.
Références relatives aux notes de crédit Non utilisé Les fournisseurs sont tenus d'envoyer ces références au niveau de l'article si le type de facture est CreditNote. Non utilisé
Date Doit être now ou avant. Doit être now ou avant. Doit être now ou avant.
Numéro HSN Le code du Système harmonisé de nomenclature (HSN) est obligatoire pour les factures conformes aux normes fiscales. La longueur maximale autorisée est de huit caractères. Non utilisé Non utilisé
Type de taxe au niveau de la ligne et de l'en-tête Les types de taxe suivants sont autorisés :
  • SGST & CGST
  • SGST & CGST & CESS
  • UTGST & CGST
  • UTGST & CGST & CESS
  • IGST
  • IGST & CESS

Si aucune information fiscale n'est fournie, la facture est rejetée.

Type de taxe à envoyer. Non utilisé
Numéro d'immatriculation fiscale Un numéro de TVA à 15 caractères doit être fourni. Numéro de TVA Numéro de TVA
Informations fiscales au niveau de la ligne et de l'en-tête Si plusieurs taxes sont applicables à un article, la section Informations fiscales doit être envoyée plusieurs fois avec le type de taxe approprié pour cet article.

Il en va de même pour le montant total de la facture.

Si plusieurs taxes sont applicables à un article, la section Informations fiscales doit être envoyée plusieurs fois avec le type de taxe approprié pour cet article.

Il en va de même pour le montant total de la facture.

Il existe également un type de taxe supplémentaire appelé DomesticVAT, qui peut être utilisée pour soumettre le montant de la taxe dans la devise locale. Pour traiter la TVA nationale, vous devez utiliser le même taux d'imposition que celui utilisé pour le type de taxe VAT.

Si plusieurs taxes sont applicables à un article, la section Informations fiscales doit être envoyée plusieurs fois avec le type de taxe approprié pour cet article.

Il en va de même pour le montant total de la facture.

Remise à la partie La partie qui fournit les marchandises à Amazon et qui recevra le paiement. Également appelé fournisseur. Informations fiscales et adresse de la partie (fournisseur) qui recevra le paiement des articles expédiés (dans le cas d'une facture) ou des articles retournés (dans le cas d'une note de crédit). Informations obligatoires. Informations fiscales et adresse de la partie (fournisseur) qui recevra le paiement des articles expédiés. Informations obligatoires.
Expéditeur de l'envoi Détails de l'adresse de l'expéditeur, ainsi que le code ISO de l'État.

L'identifiant TPS doit être envoyé dans le numéro d'enregistrement fiscal. Le champ Expéditeur de l'envoi est obligatoire. Les valeurs doivent correspondre à celles des systèmes d'Amazon.

Code du fournisseur ou code de l'entrepôt et adresse de la partie à partir de laquelle les articles seront expédiés. Code du fournisseur ou code de l'entrepôt et adresse de la partie à partir de laquelle les articles seront expédiés.
Destinataire de l'envoi Détails de l'adresse d'expédition avec le code ISO de l'État. L'adresse du destinataire est obligatoire.

Les valeurs doivent correspondre à celles des systèmes d'Amazon.

Identifiant Amazon ou code d'entrepôt et adresse de la partie à laquelle les articles seront expédiés. Identifiant Amazon ou code d'entrepôt et adresse de la partie à laquelle les articles seront expédiés.
Partie à facturer La mention Partie à facturer est obligatoire. Le Destinataire de l'envoi peut être le même que le Client facturé. Dans ce cas, le fournisseur doit renseigner les mêmes informations dans les deux segments. Tax and Address details of the party (Amazon) who will be billed for the shipped items (in case of an Invoice) or the returned items (in case of a credit note). For a complete list of Amazon bill to party addresses and JSON code examples, refer to SP-API bill to party addresses.

Ce champ est obligatoire.

Informations fiscales et adresse de la partie (Amazon) à laquelle les articles expédiés seront facturés.

Ce champ est obligatoire.

Identifiant de produit Amazon et identifiant de produit externe Au moins l'une de ces valeurs est obligatoire. L'identifiant doit être le même que celui reçu dans la commande. Au moins l'une de ces valeurs est obligatoire. L'identifiant doit être le même que celui reçu dans la commande. Au moins l'une de ces valeurs est obligatoire. L'identifiant doit être le même que celui reçu dans la commande.
Coût net Ce champ est obligatoire. Ce champ est obligatoire. Ce champ est obligatoire.
Numéro de bon de commande Une facture ne peut contenir des informations que pour une seule commande. Par conséquent, le numéro du bon de commande doit être le même pour tous les articles d'une même facture.

Obligatoire.

Une facture peut contenir des informations pour plusieurs commandes. Le numéro de commande doit être envoyé en conséquence pour les différentes lignes. Ce champ est requis si le type de facture est Invoice et n'est pas utilisé lorsque le type de facture est CreditNote. Une facture peut contenir des informations pour plusieurs commandes. Le numéro de commande doit être envoyé en conséquence pour les différents articles.

Obligatoire.

Informations supplémentaires Non utilisé Ce champ est utilisé lorsque le vendeur doit fournir des informations supplémentaires à des fins spéciales. Par exemple, dans le cas de factures polonaises à paiement fractionné, le vendeur doit envoyer le « détail »mechanizm podzielonej płatności« de type SUR et languageCode «PL«. Non utilisé
referenceNumber Numéro de référence unique généré par le gouvernement indien pour chaque facture. Ce champ n'est obligatoire que pour les factures établies en Inde. Non utilisé Non utilisé

Adresses de facturation

When submitting an invoice, bill to party address details must be complete and formatted correctly, or the API call will fail. If you do not know the Amazon Tax ID for a bill to location, refer to the Vendor Central help pages.

For a complete list of Amazon bill to party addresses and JSON code examples, refer to SP-API bill to party addresses. You can also find this list, including Amazon's tax IDs, on the EDI Resources help page in your Vendor Central account.

Note de crédit

You can use the Vendor Invoices API to send credit notes to Amazon. A credit note lists the products, quantities, and agreed prices for products or services that you provided to Amazon, but Amazon returned or did not receive. A credit note can be issued in the case of damaged goods or errors in price when allowances or rebates are agreed on beforehand between Amazon and the vendor.

Notes de crédit prises en charge par Amazon

NOTES DE CRÉDIT Comptes fournisseurs NOTES DE CRÉDIT Comptes clients
Crédit PPV

Crédit pour les articles facturés mais non reçus, ou crédit pour les paiements en double.

Retours

Crédit pour les articles retournés au vendeur en raison, par exemple, de marchandises endommagées, de marchandises expédiées par erreur ou de surstock.

Crédit PPV

Crédit pour les articles facturés à un coût plus élevé ou inférieur.

COOP (par exemple, protection des prix, indemnité de dommages)

Crédits COOP payés par le fournisseur à Amazon pour vendre son produit ou dans le cadre d'un contrat de protection des prix.


📘

Remarque

Les notes de crédit ne sont pas prises en charge dans tous les pays.

Classe submitInvoices

Facture avec plusieurs articles sans taxe

{ "invoices": [ { "invoiceType": "Invoice", "id": "I5599913", "date": "2019-07-24T21:17:59.821Z", "remitToParty": { "partyId": "VENDORID", "address": { "name": "VENDORNAME", "addressLine1": "PO BOX 1234", "city": "SAN RAFAEL", "stateOrRegion": "CA", "postalOrZipCode": "60693", "countryCode": "US" } }, "shipToParty": { "partyId": "AMAZON", "address": { "name": "AMAZON.COM", "addressLine1": "500 MCCARTHY DR", "addressLine2": "FAIRVIEW BUSINESS PARK", "city": "LEWISBERRY", "stateOrRegion": "PA", "postalOrZipCode": "17339", "countryCode": "US" } }, "billToParty": { "partyId": "AMAZON", "address": { "name": "AMAZON.COM", "addressLine1": "500 MCCARTHY DR", "addressLine2": "FAIRVIEW BUSINESS PARK", "addressLine3": "string", "city": "LEWISBERRY", "stateOrRegion": "PA", "postalOrZipCode": "17339", "countryCode": "US" } }, "paymentTerms": { "type": "Basic", "discountPercent": "2.00", "discountDueDays": 30, "netDueDays": 31 }, "invoiceTotal": { "currencyCode": "USD", "amount": "1295" }, "items": [ { "itemSequenceNumber": 1, "amazonProductIdentifier": "ABC123434", "vendorProductIdentifier": "040YP0U", "invoicedQuantity": { "amount": 2, "unitOfMeasure": "Cases", "unitSize": "10" }, "netCost": { "currencyCode": "USD", "amount": "140" }, "purchaseOrderNumber": "S8672793" }, { "itemSequenceNumber": 2, "amazonProductIdentifier": "ABC123435", "vendorProductIdentifier": "0264CBS", "invoicedQuantity": { "amount": 5, "unitOfMeasure": "Cases", "unitSize": "10" }, "netCost": { "currencyCode": "USD", "amount": "125" }, "purchaseOrderNumber": "S8672793" }, { "itemSequenceNumber": 3, "amazonProductIdentifier": "ABC123436", "vendorProductIdentifier": "040YP0K", "invoicedQuantity": { "amount": 3, "unitOfMeasure": "Cases", "unitSize": "5" }, "netCost": { "currencyCode": "USD", "amount": "130" }, "purchaseOrderNumber": "S8672793" } ] } ] }

Facture avec une seule taxe sur un article

{ "invoices": [ { "invoiceType": "Invoice", "id": "5002841638", "date": "2019-07-24T21:17:59.821Z", "remitToParty": { "partyId": "VENDORID", "address": { "name": "VENDORNAME", "addressLine1": "PO BOX 1234", "city": "TORONTO", "stateOrRegion": "ON", "postalOrZipCode": "M5W 5M5", "countryCode": "CA" }, "taxRegistrationDetails": [ { "taxRegistrationType": "VAT", "taxRegistrationNumber": "VENDORTAXID" } ] }, "shipToParty": { "partyId": "AMAZONCA", "address": { "name": "AMAZON CANADA", "addressLine1": "500 MCCARTHY DR", "addressLine2": "FAIRVIEW BUSINESS PARK", "city": "MISSISSAUGA", "stateOrRegion": "ON", "postalOrZipCode": "M5W 5M5", "countryCode": "CA" } }, "billToParty": { "partyId": "AMAZONCA", "address": { "name": "AMAZON CANADA", "addressLine1": "500 MCCARTHY DR", "addressLine2": "FAIRVIEW BUSINESS PARK", "addressLine3": "string", "city": "MISSISSAUGA", "stateOrRegion": "ON", "postalOrZipCode": "M5W 5M5", "countryCode": "CA" }, "taxRegistrationDetails": [ { "taxRegistrationType": "VAT", "taxRegistrationNumber": "AMAZONTAXID" } ] }, "paymentTerms": { "type": "Basic", "netDueDays": 31 }, "invoiceTotal": { "currencyCode": "CAD", "amount": "1950" }, "taxDetails": [ { "taxType": "GS", "taxRate": "5", "taxAmount": { "currencyCode": "CAD", "amount": "97.5" }, "taxableAmount": { "currencyCode": "CAD", "amount": "1950" } } ], "items": [ { "itemSequenceNumber": 1, "amazonProductIdentifier": "ABC123434", "vendorProductIdentifier": "1012380100000", "invoicedQuantity": { "amount": 4, "unitOfMeasure": "Eaches" }, "netCost": { "currencyCode": "CAD", "amount": "20.00" }, "purchaseOrderNumber": "Q6515853", "taxDetails": [ { "taxType": "GS", "taxRate": "5", "taxAmount": { "currencyCode": "CAD", "amount": "1.00" } } ] }, { "itemSequenceNumber": 2, "amazonProductIdentifier": "ABC123435", "vendorProductIdentifier": "1000570100000", "invoicedQuantity": { "amount": 30, "unitOfMeasure": "Eaches" }, "netCost": { "currencyCode": "CAD", "amount": "50.00" }, "purchaseOrderNumber": "Q6515853", "taxDetails": [ { "taxType": "GS", "taxRate": "5", "taxAmount": { "currencyCode": "CAD", "amount": "2.50" } } ] }, { "itemSequenceNumber": 3, "amazonProductIdentifier": "ABC123436", "vendorProductIdentifier": "0543900100000", "invoicedQuantity": { "amount": 3, "unitOfMeasure": "Eaches" }, "netCost": { "currencyCode": "CAD", "amount": "90" }, "purchaseOrderNumber": "Q6515853", "taxDetails": [ { "taxType": "GS", "taxRate": "5", "taxAmount": { "currencyCode": "CAD", "amount": "4.50" } } ] }, { "itemSequenceNumber": 4, "amazonProductIdentifier": "ABC123437", "vendorProductIdentifier": "1000570200000", "invoicedQuantity": { "amount": 5, "unitOfMeasure": "Eaches" }, "netCost": { "currencyCode": "CAD", "amount": "20.00" }, "purchaseOrderNumber": "Q6515853", "taxDetails": [ { "taxType": "GS", "taxRate": "5", "taxAmount": { "currencyCode": "CAD", "amount": "1.00" } } ] } ] } ] }

Facture avec plusieurs taxes sur un article

{ "invoices": [ { "invoiceType": "Invoice", "id": "8900000001234", "date": "2019-07-24T21:17:59.821Z", "remitToParty": { "partyId": "XYZ123", "address": { "name": "XYZ INDIA PRIVATE LIMITED", "addressLine1": "4TH FLOOR", "city": "GURUGRAM", "stateOrRegion": "HR", "postalOrZipCode": "122002", "countryCode": "IN" }, "taxRegistrationDetails": [ { "taxRegistrationType": "VAT", "taxRegistrationNumber": "VENDORTAXID" } ] }, "shipToParty": { "partyId": "AMAZONIN", "address": { "name": "AMAZON INDIA", "addressLine1": "Chowranghee Mansion JN Road", "city": "Kolkata", "stateOrRegion": "WB", "countryCode": "IN" } }, "shipFromParty": { "partyId": "XYZ123", "address": { "name": "XYZ RETAIL PVT LTD", "addressLine1": "Chowranghee Mansion JN Road", "city": "Kolkata", "stateOrRegion": "WB", "postalOrZipCode": "700016", "countryCode": "IN" } }, "billToParty": { "partyId": "AMAZONIN", "address": { "name": "AMAZON INDIA", "addressLine1": "Arrjaw Industrial & Warehouse Park", "addressLine2": "Near Coal India Complex", "city": "Hooghly", "stateOrRegion": "WB", "postalOrZipCode": "712310", "countryCode": "IN" }, "taxRegistrationDetails": [ { "taxRegistrationType": "VAT", "taxRegistrationNumber": "AMAZONTAXID" } ] }, "paymentTerms": { "type": "Basic", "netDueDays": 30 }, "invoiceTotal": { "currencyCode": "INR", "amount": "258262.39" }, "taxDetails": [ { "taxType": "SGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "19697.98" }, "taxableAmount": { "currencyCode": "INR", "amount": "218866.43" } }, { "taxType": "CGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "19697.98" }, "taxableAmount": { "currencyCode": "INR", "amount": "218866.43" } } ], "items": [ { "itemSequenceNumber": 1, "amazonProductIdentifier": "ABC123434", "vendorProductIdentifier": "809000-0000", "invoicedQuantity": { "amount": 2, "unitOfMeasure": "Eaches" }, "netCost": { "currencyCode": "INR", "amount": "21060.34" }, "purchaseOrderNumber": "3DY3TK6T", "hsnCode": "76.06.92.90", "taxDetails": [ { "taxType": "SGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "1895.43" }, "taxableAmount": { "currencyCode": "INR", "amount": "21060.34" } }, { "taxType": "CGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "1895.43" }, "taxableAmount": { "currencyCode": "INR", "amount": "21060.34" } } ] }, { "itemSequenceNumber": 2, "amazonProductIdentifier": "ABC123435", "vendorProductIdentifier": "795000-0001", "invoicedQuantity": { "amount": 3, "unitOfMeasure": "Eaches" }, "netCost": { "currencyCode": "INR", "amount": "58915.25" }, "purchaseOrderNumber": "3DY3TK6T", "hsnCode": "76.06.92.91", "taxDetails": [ { "taxType": "SGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "5302.37" }, "taxableAmount": { "currencyCode": "INR", "amount": "58915.25" } }, { "taxType": "CGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "5302.37" }, "taxableAmount": { "currencyCode": "INR", "amount": "58915.25" } } ] } ] } ] }

Facture comportant les détails de l'allocation et de l'imputation des taxes au niveau de l'en-tête et de la ligne

{ "invoices": [ { "invoiceType": "Invoice", "id": "0136981234", "date": "2019-07-24T21:17:59.821Z", "remitToParty": { "partyId": "XYZ12345", "address": { "name": "XYZ INDIA PRIVATE LIMITED", "addressLine1": "4TH FLOOR", "city": "GURUGRAM", "stateOrRegion": "HR", "postalOrZipCode": "122002", "countryCode": "IN" }, "taxRegistrationDetails": [ { "taxRegistrationType": "VAT", "taxRegistrationNumber": "VENDORVATID" } ] }, "shipToParty": { "partyId": "AMAZONIN", "address": { "name": "AMAZON INDIA", "addressLine1": "Chowranghee Mansion JN Road", "city": "Kolkata", "stateOrRegion": "WB", "countryCode": "IN" } }, "shipFromParty": { "partyId": "XYZ12345", "address": { "name": "XYZ RETAIL PVT LTD", "addressLine1": "Chowranghee Mansion JN Road", "city": "Kolkata", "stateOrRegion": "WB", "postalOrZipCode": "700016", "countryCode": "IN" } }, "billToParty": { "partyId": "AMAZONIN", "address": { "name": "AMAZON INDIA", "addressLine1": "Arrjaw Industrial & Warehouse Park", "addressLine2": "Near Coal India Complex", "city": "Hooghly", "stateOrRegion": "WB", "postalOrZipCode": "712310", "countryCode": "IN" }, "taxRegistrationDetails": [ { "taxRegistrationType": "VAT", "taxRegistrationNumber": "AMAZONVATID" } ] }, "paymentTerms": { "type": "Basic", "discountPercent": "5", "discountDueDays": 15, "netDueDays": 30 }, "invoiceTotal": { "currencyCode": "INR", "amount": "259678.39" }, "taxDetails": [ { "taxType": "SGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "19697.98" }, "taxableAmount": { "currencyCode": "INR", "amount": "218866.43" } }, { "taxType": "CGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "19697.98" }, "taxableAmount": { "currencyCode": "INR", "amount": "218866.43" } } ], "chargeDetails": [ { "type": "Freight", "description": "Freight Charges", "chargeAmount": { "currencyCode": "INR", "amount": "1200.00" }, "taxDetails": [ { "taxType": "CGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "108.00" }, "taxableAmount": { "currencyCode": "string", "amount": "string" } }, { "taxType": "SGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "108.00" }, "taxableAmount": { "currencyCode": "string", "amount": "string" } } ] } ], "items": [ { "itemSequenceNumber": 1, "amazonProductIdentifier": "ABC123434", "vendorProductIdentifier": "809281-5100", "invoicedQuantity": { "amount": 2, "unitOfMeasure": "Eaches" }, "netCost": { "currencyCode": "INR", "amount": "21060.34" }, "purchaseOrderNumber": "3DY3TK6T", "hsnCode": "76.06.92.93", "taxDetails": [ { "taxType": "SGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "1895.43" }, "taxableAmount": { "currencyCode": "INR", "amount": "21060.34" } }, { "taxType": "CGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "1895.43" }, "taxableAmount": { "currencyCode": "INR", "amount": "21060.34" } } ], "chargeDetails": [ { "type": "Freight", "description": "Freight Charges", "chargeAmount": { "currencyCode": "INR", "amount": "600.00" } } ] }, { "itemSequenceNumber": 2, "amazonProductIdentifier": "ABC123435", "vendorProductIdentifier": "795000-0001", "invoicedQuantity": { "amount": 3, "unitOfMeasure": "Eaches" }, "netCost": { "currencyCode": "INR", "amount": "58915.25" }, "purchaseOrderNumber": "3DY3TK6T", "taxDetails": [ { "taxType": "SGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "5302.37" }, "taxableAmount": { "currencyCode": "INR", "amount": "58915.25" } }, { "taxType": "CGST", "taxRate": "9", "taxAmount": { "currencyCode": "INR", "amount": "5302.37" }, "taxableAmount": { "currencyCode": "INR", "amount": "58915.25" } } ], "chargeDetails": [ { "type": "Freight", "description": "Freight Charges", "chargeAmount": { "currencyCode": "INR", "amount": "600.00" } } ] } ] } ] }

Note de crédit de l'UE avec taxe

{ "invoices": [ { "invoiceType": "CreditNote", "id": "BasicCredit", "date": "2019-07-24T21:17:59.821Z", "remitToParty": { "partyId": "AMAZON", "address": { "name": "AMAZON EU SARL, UK BRANCH", "addressLine1": "1 PRINCIPAL PLACE WORSHIP STREET", "city": "LONDON", "postalOrZipCode": "EC2A 2FA", "countryCode": "GB" } }, "billToParty": { "partyId": "VendorCode", "address": { "name": "Vendor Name", "addressLine1": "Vendor Address", "city": "Vendor City", "stateOrRegion": "Vendor State", "postalOrZipCode": "Vendor ZIP Code", "countryCode": "Vendor Country" } }, "invoiceTotal": { "currencyCode": "GBP", "amount": "100" }, "taxDetails": [ { "taxType": "VAT", "taxRate": "10", "taxAmount": { "currencyCode": "GBP", "amount": "10.00" }, "taxableAmount": { "currencyCode": "GBP", "amount": "100.00" } } ], "items": [ { "itemSequenceNumber": 1, "amazonProductIdentifier": "ABC123434", "vendorProductIdentifier": "TESTSKU", "invoicedQuantity": { "amount": 1, "unitOfMeasure": "Cases", "unitSize": "10" }, "netCost": { "currencyCode": "GBP", "amount": "100" }, "creditNoteDetails": { "referenceInvoiceNumber": "test-basic-ref", "debitNoteNumber": "debit-ref", "returnsReferenceNumber": "return-ref", "goodsReturnDate": "2019-07-24T21:17:59.821Z", "rmaId": "rma-ref", "consignorsReferenceNumber": "VRET-ref" } } ] } ] }

Qu'est-ce que l'API Statut des transactions fournisseur ?

You can use the Vendor Transaction Status API to check the transaction status of your POST transactions.

Les opérations suivantes sont incluses :

.
OpérationMéthode HTTPPathDescription
getTransactionGET/vendor/transactions/v1/transactionStatus/{transactionId}Obtenir le statut d'une demande après la transaction. Renvoie un bon de commande sur la base de la valeur purchaseOrderNumber que vous indiquez. Le statut des transactions peut être vérifié pour les données jusqu'à quatre mois à partir de la date de l'appel POST d'origine.

Obtenir le statut des transactions

You can use the Vendor Transaction Status API to check the status of a POST transaction. When a transaction such as an Order Acknowledgement or Shipment Confirmation is posted to Amazon using an API, the response includes a transaction identifier that uniquely identifies the transaction. Amazon will process the transaction asynchronously and the final response will be available via the getTransaction operation. Refer to the corresponding integration workflow diagrams in the individual API sections (for example, Vendor Orders and Vendor Shipments) to understand when to call this API to get the transaction status.

Amazon propose le statut de traitement final pour les transactions POST API telles que l'accusé de réception de commande et la confirmation d'expédition via cette API. Nous recommandons vivement aux fournisseurs de vérifier le statut à l'aide de cette API pour s'assurer que leurs transactions ont été traitées avec succès. En cas d'erreur, la réponse contiendra des informations sur celle-ci. Vous pouvez alors corriger la transaction et la soumettre à nouveau.

Statut de la transactionDéfinition
TraitementLa transaction API a été reçue par Amazon et est en cours de traitement. Le traitement n'est pas encore terminé. Vérifiez l'Accord de niveau de service pour chaque opération d'API pendant la durée prévue pour terminer le traitement.
RéussiteThis status is supported only for Submit Shipment Confirmations and Submit Shipment in NA and EU only. Success is not supported for the submitAcknowledgement and submitInvoices operations.
ÉchecLa transaction API a échoué pendant le traitement. Les détails de l'erreur seront fournis dans le corps de réponse du statut de la transaction.

📘

Remarque

L'état des transactions est pris en charge pour les opérations d'API suivantes :

Le statut de la transaction ne prend en charge que Processing et Failure valeurs d'état. Si le statut de la transaction est Processing, et non mis à jour pour Failure au bout de 15 minutes, cela indique que la transaction a été traitée avec succès dans nos systèmes.

A transaction is generally considered to be successfully delivered on our end when the status is Processing. If for any reason, Vendor Central status is not updated within 30 minutes of sending the message, open a support case using Vendor Central by providing the transaction ID returned in the POST call. Ensure data submitted is in the correct format before opening the case.

You can't use this API for Invoice messages as they are not supported and status will be always Processing. For any payment related queries, first check in Vendor Central, and then create a Contact Us case in Vendor Central and select the relevant queue.

Cas d'utilisation du statut des transactions

La transaction est en cours de traitement

{ "payload": { "transactionStatus": { "transactionId": "20190905193800-0c6b76cb-9662-4f3a-be03-1686c1e21477", "status": "Processing" } } }

La transaction a été traitée avec succès.

La transaction est en cours de traitement depuis 15 minutes.

{ "payload": { "transactionStatus": { "transactionId": "20190905193800-0c6b76cb-9662-4f3a-be03-1686c1e21477", "status": "Processing" } } }

La transaction a échoué sur Amazon

{ "payload": { "transactionStatus": { "transactionId": "20190908091302-6ca0ac50-d06e-45f5-a1e2-eb448eadac50", "status": "Failure", "errors": [ { "code": "INVALID_ORDER_ID", "message": "Invalid order ID." } ] } } }

Cette page vous a-t-elle été utile ?