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 avecincludeDetails
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 utilisezincludeDetails=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.
getPurchaseOrders
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 :
getPurchaseOrder
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 :
Exigences commerciales
-
Commande basée sur le poids
Pour les commandes contenant des articles vendus au poids,
unitOfMeasure
champ (souslistPrice
etnetCost
) reflète l'unité de mesure du poids réel. L'unité de poids des valeurs de mesure comprendPOUNDS
,OUNCES
,GRAMS
, etKILOGRAMS
. -
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é | Inde | Europe | Amérique du Nord |
---|---|---|---|
Coût net | Conditionnel. Coût net ou prix catalogue. | Conditionnel. Coût net ou prix catalogue. | Conditionnel. Coût net ou prix catalogue. |
Prix catalogue | Conditionnel. Coût net ou prix catalogue. | Conditionnel. Coût net ou prix catalogue. | Conditionnel. Coût net ou prix catalogue. |
Commande en cours | Non applicable | Pris en charge | Pris en charge |
Acheteur | L'adresse de l'entité d'achat Amazon | L'identifiant attribué à l'acheteur | Non applicable |
Vendeur | Le code vendeur Amazon attribué au fournisseur. | Le code vendeur Amazon attribué au fournisseur. | Le code vendeur Amazon attribué au fournisseur. |
Destinataire de l'envoi | L'adresse du destinataire de l'envoi | L'identifiant attribué au destinataire de l'envoi. | Non applicable |
Partie à facturer | L'adresse du client facturé | L'adresse du client facturé | Non applicable |
submitAcknowledgement
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.
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 indiquentrejected
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
esttrue
). Amazon vous recommande d'indiquer une boucle d'accusé de réception à l'aide du codeaccepted
avec la date correspondante et une autre boucle d'accusé de réception utilisant le codebackordered
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é | Inde | Europe | Amérique du Nord |
---|---|---|---|
Date d'expédition prévue | Conditionnelle. Dépend des conditions de fret et de l'accord commercial actuel avec le fournisseur. | Facultatif | Facultatif |
Date de livraison prévue | Conditionnelle. Dépend des conditions de fret et de l'accord commercial actuel avec le fournisseur. | Facultatif | Facultatif |
Prix catalogue | Nécessaire uniquement pour les fournisseurs de livres | Pris en charge | Né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
etcreatedAfter
), soit la date de mise à jour du bon de commande (updatedBefore
etupdatedAfter
), ainsi quepurchaseOrderStatus=OPEN
. -
Vous pouvez utiliser le
getPurchaseOrdersStatus
opération pour filtrer l'état des PoS. Par exemple, siitemConfirmationStatus=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 incluantpurchaseOrderStatus=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 danscreatedBefore
etcreatedAfter
.
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
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
etsellingParty.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.
Exigences commerciales
-
Lorsqu'un vendeur expédie des articles vendus au poids, il doit fournir
totalWeight
champ. LetotalWeight
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 comprendPOUNDS
,OUNCES
,GRAMS
, etKILOGRAMS
. -
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
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
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
, etsellingParty.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
andFailure
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.
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
, etsellingParty.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
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.
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
GetShipmentDetails
requisTo 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 (
|
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
GetShipmentDetails
requisExemple 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
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.
Exigences commerciales
- Appelez le
GetShipmentLabels
uniquement après l'attribution d'un transporteur. - If
GetShipmentLabels
does not return a label or returnsResource Not Found
, verify that a carrier has been assigned. Alternatively, you can callGetShipmentDetails
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 (
|
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ération | Méthode HTTP | Path | Description |
---|---|---|---|
submitInvoices | POST | /vendor/payments/v1/invoices | Soumission 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.
Exigences commerciales
-
Pour les articles dont le prix est calculé au poids, vous devez fournir
totalWeight
champ. LetotalWeight
Ce champ contient le poids total de l'article facturé. En outre, lenetCostUnitOfMeasure
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 incluentPOUNDS
,OUNCES
,GRAMS
, etKILOGRAMS
. -
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 :
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é |
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
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ération | Méthode HTTP | Path | Description | |
---|---|---|---|---|
getTransaction | GET | /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 transaction | Définition |
---|---|
Traitement | La 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éussite | This 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. |
Échec | La 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."
}
]
}
}
}
Updated 23 days ago