Guía de flujo de trabajo de cumplimiento directo del proveedor
Integre y use las API que respaldan el Programa de Cumplimiento Directo.
Amazon proporciona a los proveedores varias API para el programa empresarial de Direct Fulfillment. En esta guía se resumen los pasos que puedes seguir para integrarte con estas API de socios vendedores (SP-API).
Descripción de la integración de Direct Fulfillment
Integrating with the Direct Fulfillment APIs starts with the vendor pulling the orders for fulfillment using the Vendor Direct Fulfillment Orders API v1, then sending an acknowledgement for the order.
After the order is packed and ready to be shipped, the vendor uses the createShippingLabels
operation to print a shipping label, and ships the order. After the order is shipped, a shipment confirmation is sent from the vendor to Amazon.
To release payment for the shipped items, the vendor sends the invoice using the submitInvoice
operation.
Versiones de la API
Terminología
- Vendedor: Suministra el inventario vendido por Amazon en el sitio web minorista de Amazon.
- Cumplimiento directo: Un proveedor de Logística Directa envía los pedidos a los clientes en nombre de Amazon. Cuando un cliente realiza una compra en Amazon en el sitio web minorista de Amazon, el proveedor de Logística Directa envía el pedido directamente al cliente.
- Orden de compra: Un documento comercial emitido por Amazon a un vendedor/proveedor en el que se autoriza la compra de bienes o servicios.
- Reconocimiento del pedido: Cuando un vendedor acepta o rechaza un pedido de compra enviado por Amazon para su gestión logística.
- Etiqueta de envío: Una etiqueta proporcionada por Amazon que los vendedores utilizan cuando envían los pedidos directamente a los clientes. La etiqueta contiene la dirección de envío del cliente, los detalles del pedido y cualquier instrucción de manipulación especial proporcionada por Amazon.
- Confirmación de envío: La confirmación de envíos permite a Amazon rastrear de manera eficiente los envíos de los proveedores e informar a los clientes. Ayuda a colaborar de forma más eficaz con los transportistas en el seguimiento de los envíos de los proveedores. Contiene información sobre los artículos que se envían, incluido el número de pedido de compra, la fecha de envío, la fecha de entrega estimada y el número de seguimiento.
- Factura: Un documento de facturación que los vendedores proporcionan a Amazon por los productos que suministran. Para cada pedido de compra que los vendedores tramitan enviando productos a los clientes, generan y envían facturas a Amazon. La factura suele incluir información como el número de pedido de compra, los detalles del artículo, los precios, los impuestos y el importe total adeudado.
Requisitos
To complete the following tutorials, you must:
- Register yourself as a developer with the Direct-to-Consumer Shipping role
- Registra tu solicitud
- Autoriza tu aplicación SP-API
- Pruebe su aplicación con puntos finales de sandbox
Nota
Direct Fulfillment APIs support dynamic sandbox. Refer to the Vendor Direct Fulfillment Dynamic Sandbox guide and demo video for more details.
Tutorial: Obtén la lista de pedidos de Logística Directa para gestionar y confirmar los pedidos
Paso 1. Recupera la lista de pedidos de Logística Directa que debes gestionar
Call the getOrders
operation to retrieve a list of new Direct Fulfillment purchase orders yet to be fulfilled. Use the parameters createdBefore
and createdAfter
to get the orders created within last 24 hours. The order status should be NEW
to fetch un-acknowledged items.
Ejemplo de código
Paso 2. Confirma el pedido
Using the submitAcknowledgement
operation, acknowledge the orders. The purchase order can be accepted or rejected. Vendors should submit accurate acknowledgements as fast as possible, within at most 24 hours.
Ejemplo de código
Debe enviar un acuse de recibo completo, que incluya todas las líneas del pedido de compra del pedido de compra. No se aceptan confirmaciones parciales.
Paso 3. Comprueba el estado de la transacción de acuse de recibo del pedido
Using the getTransactionStatus
operation, check the transaction status of the submitAcknowledgment
operation.
Ejemplo de código
Después de confirmar el pedido, espere al sistema hasta 15 minutos para mostrar el estado.
Tutorial 2: Generar etiquetas de envío y enviar confirmaciones
Paso 1. Obtenga la etiqueta de envío
Get the shipping label for the order by using the createShippingLabel
operation. This is a synchronous operation that creates and then returns the shipping labels for a purchase order.
Ejemplo de código
Puedes generar una o más etiquetas de envío para cada pedido de compra. No se admiten varios pedidos de compra en una sola solicitud.
Paso 2. Confirma el envío
Use the shipmentConfirmations
operation to confirm the shipment of a Direct Fulfillment order with the shipping information. Shipment confirmations allow Amazon to collaborate more effectively with carriers in tracking shipments.
Ejemplo de código
Paso 3. Comprueba el estado de la transacción de confirmación de envío
Use the getTransactionStatus
operation to check the transaction status of the submitShipmentConfirmations operation.
Tras enviar la confirmación del envío, deja que el sistema tarde hasta 10 minutos en mostrar el estado.
For more information about these APIs, refer to the Vendor Direct Fulfillment Shipping API Use Case Guide.
Tutorial 3. Solicita pagos de Amazon
Paso 1. Presentar las facturas
Using the submitInvoice
operation, the vendor sends the invoice to Direct Fulfillment to get payment released for the shipped items.
Importante
Los artículos deben facturarse solo después de que se hayan confirmado y enviado. De lo contrario, se rechazará la factura, en cuyo caso el vendedor deberá revisar el motivo del rechazo y enviar una nueva factura.
Paso 2. Comprueba el estado de la transacción de la factura
Using the getTransactionStatus
operation, check the transaction status of the submitInvoice
operation. The Transaction Status API shows the status of the semantic validations of the submitted invoices; it doesn't show the actual status of invoice processing.
Tras enviar la factura a Amazon, espera 15 minutos para que se actualice el estado.
Nota
As a supplement to this guide, the SP-API Direct Fulfillment Sample Application provides complete end-to-end code and instructions to build and run the given sample codes using AWS services.
Updated 23 days ago