Guide des cas d'utilisation de l'API Paiements Expédition directe par le fournisseur v1

How to help vendors in the direct fulfillment (DF) program use the Payments API to manage their direct fulfillment operations.

Version de l'API : v1

Qu'est-ce que l'API Paiements pour l'expédition directe ?

Les fournisseurs peuvent utiliser l'API Paiements pour l'expédition directe afin d'échanger des documents relatifs aux paiements avec Amazon. L'opération submitInvoice permet aux fournisseurs d'envoyer des factures fournisseurs à Amazon pour les commandes confirmées et expédiées.

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

OpérationMéthode HTTPPathDescription
submitInvoicePOST/vendor/directFulfillment/payments/v1/invoicesSoumet une ou plusieurs factures pour les commandes d'expédition directe d'un fournisseur.

submitInvoice

L'opération submitInvoice permet aux fournisseurs de soumettre des factures de fournisseur pour demander le paiement d'Amazon pour les articles expédiés. À l'aide de cette API, les fournisseurs peuvent soumettre plusieurs factures en un seul appel d'API.

Items should be invoiced only after they are confirmed and shipped to Amazon. Otherwise, the invoice will be rejected. An invoice with correct information will be processed by Amazon without any human interaction, which means that the vendor receives payment more quickly. Invoices with incorrect information will be rejected in Amazon's payee system, so sending correct information is very important. Refer to the business requirements section to learn how to create invoices with correct information.

Test parallèle de la soumission des factures

After you complete the API invoice integration, our Accounts Payable (AP) department requires you to send one successful API invoice in production before considering you as live. If there are any issues with your initial production invoice, our AP team will contact you. After the API invoice is integrated into production, you must send invoices via API only. If you want to return to using just the Vendor Central option, contact us to update your account. Before finalizing your API invoice integration, submit all invoices with a "Non-submitted" status in your account under the Payments tab in the Direct Fulfillment invoices section. Existing invoices with the "Non-submitted" status might be rejected and not paid if sent via API.

Vérification des factures soumises avec succès

The Transaction Status API doesn't show the actual status of invoice processing, it only shows the status of the semantic validations of the submitted invoices. Vendors can verify the actual status of the original/updated version of the invoices via Vendor Central > Payments > Direct Fulfillment Invoices. For more information on how to use the Transaction Status API, refer to the business use case documentation for Transaction Status. Allow the system to take up to 15 minutes to show the original/updated version after submission. If Vendor Central is not showing the correct values for the updated invoice, open a Contact Us case in Vendor Central.

Le schéma suivant montre le workflow d'intégration pour la soumission de factures pour les commandes confirmées et expédiées par expédition directe :

The Direct Fulfillment integration workflow for submitting invoices for direct fulfillment confirmed and shipped orders.

Exigences commerciales

Invoice numbers must be unique, and they should never be reused (even after one year).

Si une facture envoyée à l'aide de l'API a échoué en raison de données incorrectes, mais qu'une facture papier contient les données correctes, le fournisseur doit alors mettre à jour la facture via l'API avec les données correctes en utilisant le même Invoice ID.

If an invoice has incorrect data (both paper and API) then the invoice is canceled and a new invoice should be sent with a new Invoice ID.

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

Amazon a besoin de l'adresse complète dans les segments d'adresse pour des raisons de conformité fiscale. Ceci est particulièrement important pour l'opération bill to party. Pour ce segment, le système de paiement d'Amazon exige une correspondance exacte. Pour obtenir une liste complète des adresses de facturation d'Amazon et des exemples de code JSON, consultez la rubrique Adresses de facturation SP-API. Si vous ne connaissez pas l'identifiant fiscal Amazon pour un lieu de facturation, accédez à Vendor Central et, à partir de la page Assistance, sélectionnez le bouton Nous contacter pour créer un dossier.

La valeur Payment terms envoyée dans une facture doit correspondre aux conditions de paiement convenues avec l'acheteur Amazon.

La valeur Item product identifier doit correspondre à l'identifiant du produit de l'article de commande qui a été envoyé au fournisseur dans le bon de commande correspondant.

The invoice total amount should be equal to the total sum of the items, charges, and allowances.

Le total de tax amount pour chaque niveau de ligne doit être égal au total du montant de la taxe au niveau de l'en-tête.

La valeur total quantity de la facture doit correspondre à la somme de la quantité de tous les articles.

Every different charge and allowance must be itemized on the header level (for example, freight charge, package charge, small ordering charge).

Exigences commerciales spécifiques à chaque pays

Les factures pour l'expédition directe ne sont pas prises en charge en Inde via l'API.

Fonctionnalité Inde Europe Amérique du Nord
Invoice Type Non prise en charge Le type de facture doit toujours être “Facture”. Le type de facture doit toujours être “Facture”.
Date Non prise en charge Doit être “aujourd'hui” ou une date antérieure. Doit être “aujourd'hui” ou une date antérieure.
HSN Number Non prise en charge Non utilisé Non utilisé
Tax Type at line and header level Non prise en charge Type de taxe à envoyer. Non utilisé
Tax Registration Number Non prise en charge Numéro de TVA Numéro de TVA
Tax Details at line and header level Non prise en charge

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

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

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

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.

Remit To Party Non prise en charge Informations fiscales et adresse de la partie (fournisseur) qui recevra le paiement des articles expédiés. Informations obligatoires. Informations fiscales et adresse de la partie (fournisseur) qui recevra le paiement des articles expédiés. Informations obligatoires.
Ship From Party Non prise en charge 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.
Ship To Party Non prise en charge 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.
Bill To Party Non prise en charge

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

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.

Amazon Product Identifier and External Product Identifier Non prise en charge 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.
Net Cost Non prise en charge Ce champ est obligatoire. Ce champ est obligatoire.
Purchase Order Number Non prise en charge

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.

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.

Additional Details Non prise en charge Ce champ est utilisé lorsque le vendeur doit fournir des informations supplémentaires à des fins bien précises. Par exemple, dans le cas de factures de paiement fractionné polonaises, le vendeur doit envoyer le détail “mechanizm podzielonej płatności” de type “SUR” et le code de langue “PL”. Non utilisé
referenceNumber Non prise en charge Non utilisé Non utilisé

Demande submitInvoice

Pour soumettre une ou plusieurs facture(s) , appelez l'opération submitInvoice et transmettez le paramètre suivant :

Paramètres du corps :

Nom Description Obligatoire
invoices Le schéma de demande pour l'opération submitInvoice.

Type : tableau < InvoiceDetail >

Oui

Exemple de demande

POST https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/payments/v1/invoices { "invoiceNumber": "0092590411", "invoiceDate": "2020-03-13T11:16:24Z", "remitToParty": { "partyId": "YourVendorCode", "address": { "name": "Jane Doe", "addressLine1": "123 Any Street", "addressLine2": "123 Any Street", "addressLine3": "123 Any Street", "city": "Any Town", "county": "Schwabing", "district": "München", "stateOrRegion": "Bayern", "postalCode": "DEPostCode", "countryCode": "DE" }, "taxRegistrationDetails": [ { "taxRegistrationType": "VAT", "taxRegistrationNumber": "DE123456789" } ] }, "shipFromParty": { "partyId": "ABCD" }, "billToParty": { "partyId": "5450534005838", "address": { "name": "John Doe", "addressLine1": "100 Main Street", "city": "Anytown", "county": "Schwabing", "district": "München", "stateOrRegion": "Bayern", "postalCode": "80807", "countryCode": "DE" }, "taxRegistrationDetails": [ { "taxRegistrationType": "VAT", "taxRegistrationNumber": "DE814584193", "taxRegistrationAddress": { "name": "John Doe", "addressLine1": "100 Main Street", "city": "Anytown", "postalCode": "80807", "countryCode": "DE" }, "taxRegistrationMessage": "txmessage" } ] }, "shipToCountryCode": "DE", "paymentTermsCode": "Basic", "invoiceTotal": { "currencyCode": "EUR", "amount": "1428.00" }, "taxTotals": [ { "taxType": "CGST", "taxRate": "0.19", "taxAmount": { "currencyCode": "EUR", "amount": "228.00" }, "taxableAmount": { "currencyCode": "EUR", "amount": "1200.00" } } ], "items": [ { "itemSequenceNumber": "1", "buyerProductIdentifier": "B00IVLAABC", "invoicedQuantity": { "amount": 1, "unitOfMeasure": "Each" }, "netCost": { "currencyCode": "EUR", "amount": "1200.00" }, "purchaseOrderNumber": "D3rC3KTxG", "vendorOrderNumber": "0092590411", "hsnCode": "76.06.92.99.00", "taxDetails": [ { "taxType": "CGST", "taxRate": "0.19", "taxAmount": { "currencyCode": "EUR", "amount": "228.00" }, "taxableAmount": { "currencyCode": "EUR", "amount": "1200.00" } } ] } ] }

Réponse submitInvoice

Une réponse réussie comprend les éléments suivants :

Nom Description Obligatoire
transactionId GUID pour identifier cette transaction. Cette valeur peut être utilisée avec l'API Statut des transactions pour renvoyer le statut de cette transaction.

Type : chaîne

Non

Exemple de réponse

{ "transactionId": "20190905010908-8a3b6901-ef20-412f-9270-21c021796605" }

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