Guide du flux de travail d'expédition directe pour les fournisseurs
Intégrez et utilisez des API prenant en charge le programme Direct Fulfillment.
Amazon fournit aux fournisseurs plusieurs API pour le programme commercial Direct Fulfillment. Ce guide résume les étapes que vous pouvez suivre pour intégrer ces API Selling Partner (SP-API).
Présentation de l'intégration de Direct Fulfillment
L'intégration aux API Direct Fulfillment commence par le retrait des commandes par le fournisseur à l'aide du API v1 pour les commandes d'exécution directe des fournisseurs, puis en envoyant un accusé de réception pour la commande.
Une fois la commande emballée et prête à être expédiée, le vendeur utilise createShippingLabels
opération permettant d'imprimer une étiquette d'expédition et d'expédier la commande. Une fois la commande expédiée, une confirmation d'expédition est envoyée par le vendeur à Amazon.
Pour effectuer le paiement des articles expédiés, le vendeur envoie la facture à l'aide du submitInvoice
opération.
Versions de l'API
Terminologie
- Fournisseur : Fournit le stock vendu par Amazon sur le site Web de vente au détail d'Amazon.
- Expédition directe : Un fournisseur de distribution directe expédie les commandes aux clients pour le compte d'Amazon. Une fois qu'un client a effectué un achat auprès d'Amazon sur le site Web de vente au détail d'Amazon, le fournisseur Direct Fulfillment expédie la commande directement au client.
- Bon de commande : Document commercial délivré par Amazon à un vendeur/fournisseur, autorisant l'achat de biens ou de services.
- Accusé de réception de commande : Lorsqu'un fournisseur accepte ou rejette un bon de commande envoyé par Amazon pour traitement.
- Étiquette d'expédition : Étiquette fournie par Amazon que les fournisseurs utilisent lorsqu'ils expédient des commandes directement aux clients. L'étiquette contient l'adresse de livraison du client, les détails de la commande et toutes les instructions de manipulation spéciales fournies par Amazon.
- Confirmation d'expédition : La confirmation d'expédition permet à Amazon de suivre efficacement les expéditions des fournisseurs et d'informer les clients. Il permet de collaborer plus efficacement avec les transporteurs pour suivre les expéditions des fournisseurs. Il contient des informations sur les articles expédiés, notamment le numéro de bon de commande, la date d'expédition, la date de livraison estimée et le numéro de suivi.
- Facture : Document de facturation que les fournisseurs fournissent à Amazon pour les produits qu'ils fournissent. Pour chaque bon de commande que les fournisseurs traitent en expédiant des produits aux clients, ils génèrent et soumettent des factures à Amazon. La facture comprend généralement des informations telles que le numéro de commande, les détails de l'article, les prix, les taxes et le montant total dû.
Conditions préalables
To complete the following tutorials, you must:
- Register yourself as a developer with the Direct-to-Consumer Shipping role
- Enregistrez votre candidature
- Autorisez votre application SP-API
- Testez votre application avec des points de terminaison sandbox
Remarque
Les API Direct Fulfillment prennent en charge le sandbox dynamique. Reportez-vous à Guide du Vendor Direct Fulfillment Dynamic Sandbox et vidéo de démonstration pour plus de détails.
Tutoriel : récupérer la liste des commandes de distribution directe à traiter et accuser réception des commandes
Étape 1. Récupérez la liste des commandes de distribution directe à traiter
Appelez le getOrders
opération permettant de récupérer une liste des nouveaux bons de commande de Direct Fulfillment qui n'ont pas encore été traités. Utiliser les paramètres createdBefore
et createdAfter
pour obtenir les commandes créées au cours des dernières 24 heures. Le statut de la commande doit être NEW
pour récupérer des éléments non reconnus.
Exemple de code
Étape 2 Accusez réception de la commande
À l'aide du submitAcknowledgement
opération, accuser réception des commandes. Le bon de commande peut être accepté ou refusé. Les fournisseurs doivent soumettre des accusés de réception exacts le plus rapidement possible, dans un délai maximum de 24 heures.
Exemple de code
Vous devez envoyer un accusé de réception complet, y compris toutes les rubriques du bon de commande. Les accusés de réception partiels ne sont pas acceptés.
Étape 3 Vérifier l'état de la transaction avec accusé de réception de commande
À l'aide du getTransactionStatus
opération, vérifiez l'état de la transaction submitAcknowledgment
opération.
Exemple de code
Après avoir accusé réception de la commande, attendez 15 minutes pour que le système affiche le statut.
Tutoriel 2 : Générer une étiquette d'expédition et envoyer des confirmations
Étape 1. Obtenez l'étiquette d'expédition
Obtenez l'étiquette d'expédition de la commande en utilisant le createShippingLabel
opération. Il s'agit d'une opération synchrone qui crée puis renvoie les étiquettes d'expédition pour un bon de commande.
Exemple de code
Vous pouvez générer une ou plusieurs étiquettes d'expédition pour chaque bon de commande. Plusieurs bons de commande en une seule demande ne sont pas pris en charge.
Étape 2 Confirmez l'expédition
Utilisez le shipmentConfirmations
opération pour confirmer l'expédition d'une commande de distribution directe avec les informations d'expédition. Les confirmations d'expédition permettent à Amazon de collaborer plus efficacement avec les transporteurs pour le suivi des envois.
Exemple de code
Étape 3 Vérifier l'état de la transaction de confirmation d'expédition
Utilisez le getTransactionStatus
opération pour vérifier l'état de la transaction du Confirmations de soumission et d'expédition opération.
Après avoir envoyé la confirmation d'expédition, laissez le système prendre jusqu'à 10 minutes pour afficher le statut.
Pour plus d'informations sur ces API, consultez Guide de cas d'utilisation de l'API d'expédition directe pour les fournisseurs.
Tutoriel 3. Demander des paiements à Amazon
Étape 1. Soumettre des factures
À l'aide du submitInvoice
opération, le fournisseur envoie la facture à Direct Fulfillment pour obtenir le paiement des articles expédiés.
Important
Les articles ne doivent être facturés qu'après avoir été confirmés et expédiés. Dans le cas contraire, la facture sera rejetée, auquel cas le fournisseur devra examiner la raison du rejet et soumettre une nouvelle facture.
Étape 2 Vérifier l'état de la transaction de facturation
À l'aide du getTransactionStatus
opération, vérifiez l'état de la transaction submitInvoice
opération. L'API Transaction Status indique l'état des validations sémantiques des factures soumises ; elle n'indique pas l'état réel du traitement des factures.
Après avoir envoyé la facture à Amazon, attendez 15 minutes pour que le statut soit mis à jour.
Remarque
En complément de ce guide, le Exemple d'application d'expédition directe SP-API fournit un code complet de bout en bout et des instructions pour créer et exécuter les exemples de codes donnés à l'aide des services AWS.
Updated 23 days ago