Guía de casos de uso de la API de pagos de gestión logística directa del proveedor V1
How to help vendors in the direct fulfillment (DF) program use the Payments API to manage their direct fulfillment operations.
Versión de API: v1
¿Qué es la API de pagos de gestión logística directa?
Los proveedores pueden utilizar la API de pagos de gestión logística directa para intercambiar documentos relacionados con los pagos con Amazon. La operación submitInvoice
permite a los proveedores enviar facturas de proveedor a Amazon para pedidos confirmados y enviados.
La API de pagos incluye las siguientes operaciones:
Operación | Método HTTP | Path | Descripción |
---|---|---|---|
submitInvoice | POST | /vendor/directFulfillment/payments/v1/invoices | Envía una o varias facturas de pedidos de gestión logística directa de un proveedor. |
submitInvoice
La operación submitInvoice
permite a los proveedores enviar facturas de proveedores para solicitar a Amazon el pago de artículos enviados. Mediante esta API, los proveedores pueden enviar varias facturas en una sola llamada a la 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.
Pruebas paralelas de envío de facturas
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.
Comprobación de las facturas enviadas correctamente
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.
En el siguiente diagrama se muestra el proceso de integración para el envío de facturas de pedidos confirmados y enviados mediante gestión logística directa:
Requisitos empresariales
Invoice numbers
must be unique, and they should never be reused (even after one year).
Si una factura enviada a través de la API falla debido a datos incorrectos, pero una factura impresa tiene los datos correctos, el proveedor debe actualizar la factura a través de la API con los datos correctos utilizando el mismo 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
.
No debe enviarse una factura con total amount
= 0, ya que esto provocaría un error en la factura.
Amazon requiere los detalles completos de la dirección en los segmentos de dirección por motivos de cumplimiento tributario. Esto es especialmente importante para bill to party
. Para este segmento, el sistema Amazon Payee requiere una coincidencia exacta. Para obtener una lista completa de las direcciones de facturación de Amazon a terceros y ejemplos de códigos JSON, consulta Direcciones de destinatarios de facturación de la SP-API. Si no conoces el número de identificación fiscal de Amazon para enviar la factura, ve a Vendor Central y desde la página Asistencia, haz clic en Ponte en contacto con nosotros.
El Payment terms
enviado en una factura debe coincidir con las condiciones de pago acordadas con el comprador de Amazon.
El Item product identifier
debe coincidir con el identificador de producto del artículo del pedido que se ha enviado al proveedor en el pedido de compra correspondiente.
The invoice total amount
should be equal to the total sum of the items, charges, and allowances.
El total de tax amount
para cada nivel de línea debe ser igual al total del importe del impuesto en el nivel de cabecera.
El total quantity
de la factura debe corresponder a la suma de la cantidad de todos los artículos.
Every different charge and allowance
must be itemized on the header level (for example, freight charge, package charge, small ordering charge).
Requisitos empresariales específicos de país
En la India no se aceptan facturas de gestión logística directa a través de la API.
Funcionalidad | India | Europa | Norteamérica |
---|---|---|---|
Invoice Type |
No compatible | El tipo de factura debe ser siempre "Factura". | El tipo de factura debe ser siempre "Factura". |
Date |
No compatible | Debe ser "ahora" o antes. | Debe ser "ahora" o antes. |
HSN Number |
No compatible | No se utiliza | No se utiliza |
Tax Type at line and header level |
No compatible | Tipo de impuesto que se debe enviar. | No se utiliza |
Tax Registration Number |
No compatible | Número de IVA | Número de IVA |
Tax Details at line and header level |
No compatible |
Si se aplican varios impuestos a un artículo, la sección Detalles de impuestos debe enviarse varias veces con el tipo de impuesto adecuado para ese artículo. Lo mismo se aplica al importe total de la factura. También existe un tipo de impuesto adicional denominado "DomesticVAT", que puede utilizarse para enviar el importe del impuesto en la divisa local. Para procesar el IVA nacional, debes utilizar el mismo TaxRate que para el tipo impositivo "IVA". |
Si se aplican varios impuestos a un artículo, la sección Detalles de impuestos debe enviarse varias veces con el tipo de impuesto adecuado para ese artículo. Lo mismo se aplica al importe total de la factura. |
Remit To Party |
No compatible | Detalles fiscales y de dirección de la parte (proveedor) que recibirá el pago de los artículos enviados. Son datos obligatorios. | Detalles fiscales y de dirección de la parte (proveedor) que recibirá el pago de los artículos enviados. Son datos obligatorios. |
Ship From Party |
No compatible | Código de proveedor o código de almacén y dirección de la parte desde la que se van a enviar los artículos. | Código de proveedor o código de almacén y dirección de la parte desde la que se van a enviar los artículos. |
Ship To Party |
No compatible | ID de Amazon o código de almacén y dirección de la parte a la que se van a enviar los artículos. | ID de Amazon o código de almacén y dirección de la parte a la que se van a enviar los artículos. |
Bill To Party |
No compatible |
Datos fiscales y dirección de la parte (Amazon) a la que se cobrarán los artículos enviados. Este campo es obligatorio. |
Datos fiscales y dirección de la parte (Amazon) a la que se cobrarán los artículos enviados. Este campo es obligatorio. |
Amazon Product Identifier and External Product Identifier |
No compatible | Al menos uno de esos valores es obligatorio. El identificador debe ser el mismo que el que se recibe en el pedido. | Al menos uno de esos valores es obligatorio. El identificador debe ser el mismo que el que se recibe en el pedido. |
Net Cost |
No compatible | Este campo es obligatorio. | Este campo es obligatorio. |
Purchase Order Number |
No compatible |
Una factura puede contener información de varios pedidos. El número de pedido debe enviarse de forma adecuada para cada línea de pedido. Obligatorio. |
Una factura puede contener información de varios pedidos. El número de pedido debe enviarse de forma adecuada para cada línea de pedido. Obligatorio. |
Additional Details |
No compatible | Este campo se utiliza cuando la parte vendedora debe enviar detalles adicionales para fines especiales. Por ejemplo, en el caso de facturas polacas con pago fraccionado, la parte vendedora debe indicar "mechanizm podzielonej płatności" del tipo "SUR" y el languageCode "PL". | No se utiliza |
referenceNumber |
No compatible | No se utiliza | No se utiliza |
Solicitud submitInvoice
Para enviar una o más facturas, llama a la operación submitInvoice
y utiliza el siguiente parámetro:
Parámetro del cuerpo:
Nombre | Descripción | Obligatorio |
---|---|---|
invoices |
El esquema de solicitud para la operación submitInvoice . Tipo: matriz < |
Sí |
Ejemplo de solicitud
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"
}
}
]
}
]
}
Respuesta de submitInvoice
Una respuesta correcta incluye lo siguiente:
Nombre | Descripción | Obligatorio |
---|---|---|
transactionId |
GUID para identificar esta transacción. Este valor puede utilizarse con la API de estado de transacciones para obtener el estado de esta transacción. Tipo: cadena |
No |
Ejemplo de respuesta
{
"transactionId": "20190905010908-8a3b6901-ef20-412f-9270-21c021796605"
}
Updated 23 days ago