Guía de casos de uso de las API de adquisición minorista de proveedores v1

Cómo ayudar a los proveedores a gestionar sus operaciones empresariales minoristas de forma programática a través de la integración de servicios web.

Las API del colaborador comercial para proveedores minoristas ayudan a los proveedores a gestionar sus operaciones empresariales minoristas de manera programática a través de la integración de servicios web. La integración automatizada con Amazon puede ayudar a los proveedores a mejorar y mantener su rendimiento a escala y expandir su empresa con 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.

Los proveedores pueden utilizar estas API para crear aplicaciones que aumenten la eficacia operativa, reduzcan el esfuerzo, disminuyan los errores y mejoren el rendimiento.

For authentication and authorization information, refer to Authorizing Selling Partner API applications.

Procesos empresariales que puede gestionar mediante las API de compras minoristas de proveedores

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.

Proceso empresarial Caso de uso Operación
Gestión de órdenes de compra
Obtenga cambios o cancelaciones de órdenes de compra getPurchaseOrders
Returns a list of purchase orders created or changed during the time frame that you specify.
Verificar el estado de la orden de compra getPurchaseOrdersStatus
Returns purchase order statuses based on the filters that you specify.
Enviar confirmación de pedido de compra submitAcknowledgement
Submits acknowledgements for one or more purchase orders.
Comprueba el estado de la transacción de confirmación del pedido getTransaction
Returns the status of the transaction that you specify.
Envíos
Envía solicitudes de envío SubmitShipments
Submits one or more shipment request for vendor Orders.
Obtenga el estado del envío o las etiquetas de envío/transporte 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.
Enviar o actualizar la notificación anticipada de envío (ASN) o las confirmaciones de envío SubmitShipmentConfirmations
Submits one or more shipment confirmations for vendor orders.
Verificar el estado de la transacción de confirmación de envío getTransaction
Returns the status of the transaction that you specify.
Obtenga etiquetas de envío GetShipmentLabels
Returns small parcel shipment labels based on the filters that you specify.
Facturas y notas de crédito
Enviar facturas de proveedores submitInvoices
Submit new invoices to Amazon.

¿Qué es la API de pedidos de proveedores?

You can use the Vendor Orders API (Orders API) to receive purchase orders and to send order acknowledgements to accept or reject order fulfillment.

La API de pedidos de proveedores incluye las siguientes operaciones:

Operación Método HTTP Path Descripción
getPurchaseOrders GET /vendor/orders/v1/purchaseOrders Devuelve una lista de los pedidos de compra creados o modificados durante el periodo especificado. La obtención de datos es posible durante un máximo de seis meses a partir de la fecha en que se realizó la llamada POST original.
getPurchaseOrder GET /vendor/orders/v1/purchaseOrders /{purchaseOrderNumber} Devuelve una orden de compra (PO) basada en la purchaseOrderNumber valor que especifiques. La recuperación de datos es posible durante un período máximo de seis meses a partir de la fecha en que se realiza la llamada POST original.
submitAcknowledgement POST /vendor/orders/v1/acknowledgements Confirma (acepta o rechaza) uno o varios pedidos de compra.
getPurchaseOrdersStatus GET /vendor/orders/v1/purchaseOrdersStatus Devuelve el estado de los pedidos de compra en función de los filtros especificados. La obtención de datos es posible durante un máximo de seis meses a partir de la fecha en que se realizó la llamada POST original.

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.

📘

Nota

Puede devolver los detalles completos de la orden de compra llamando al getPurchaseOrders operación, o devuelva solo los números de orden de compra con el includeDetails filtro. El valor predeterminado de este parámetro es verdadero, por lo que si no incluye este parámetro de consulta, devolverá los detalles completos de los pedidos de compra. Si usas includeDetails=false, la respuesta incluirá solo una lista de números de órdenes de compra y el estado actual de cada orden de compra.

En el siguiente diagrama se muestra el proceso al utilizar la API de pedidos de proveedores.

The Vendor orders workflow.

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.

Debes utilizar esta API para obtener los pedidos disponibles para su gestión logística. Amazon recomienda que los proveedores comprueben los pedidos al menos una vez cada hora durante el horario comercial. En función del volumen empresarial, puedes optar por realizar comprobaciones con mayor frecuencia. Puedes obtener hasta 100 pedidos en una llamada a la API. Si hay más de 100 pedidos, puedes utilizar nextToken para obtener el siguiente conjunto.

Modificaciones y anulaciones de pedidos

Puedes devolver cambios y cancelaciones de pedidos utilizando la operación getPurchaseOrders.

Cambios en el pedido: debido a un cambio en los requisitos, Amazon a veces cambia los datos del pedido después de que se haya creado. Los proveedores pueden utilizar la API getPurchaseOrders para obtener pedidos actualizados. Si Amazon cambia un pedido, este tendrá un campo purchaseOrderChangedDate que es la fecha y la hora en que Amazon lo ha actualizado. Si este campo no existe, significa que el pedido nunca se modificó después de su creación.

📘

Nota

Amazon también puede cambiar el pedido de compra después de que lo hayas confirmado.

Los proveedores pueden obtener una lista de los pedidos que se han modificado en un intervalo de fechas especificado utilizando los parámetros de consulta changedAfter y changedBefore. Esto devolverá los pedidos que Amazon ha modificado dentro del intervalo de fechas, y los proveedores deberán gestionar el pedido actualizado. De forma alternativa, los proveedores pueden utilizar isPOChanged=true para filtrar y obtener todos los pedidos modificados.

Amazon recomienda realizar una llamada a la API por separado, con el intervalo de fechas modificado, varias veces al día para recibir los pedidos modificados durante un día. Por ejemplo, puedes llamar cuatro veces al día a la operación de obtención de pedidos para ver si los pedidos se han modificado en las últimas seis horas.

La siguiente es una lista de cambios que pueden contribuir a los cambios en los pedidos. Para realizar estos cambios, debes retirar el pedido modificado y enviar el pedido de compra correcto:

  • Cambio de ventana de envío o entrega
  • Actualizaciones de artículos de pedido, como cambios de cantidad, cancelación de artículos, cambios de coste de artículo
  • Se ha añadido un nuevo artículo en el pedido
  • PO cancelado/no cancelado
  • Se ha cambiado el tipo de pedido
  • Cambio del destino de entrega de la orden de compra (centro logístico)
  • Se ha modificado la información del porte del pedido

Cancelación del artículo: También puedes usar la API de pedidos de proveedores, con el filtro poItemState=Cancelled, para devolver pedidos con uno o más artículos cancelados. Se devolverán todos los pedidos en los que Amazon haya cancelado uno o más artículos tras la creación de la orden de compra. Esto te ayudará a recibir solo los pedidos que tengan artículos cancelados (la cantidad pedida es cero) y a asegurarte de que no envías los artículos cancelados.

📘

Nota

La cancelación de un artículo se considera un cambio de pedido, por lo que también devolverás estos pedidos con la lista de pedidos modificados.

Estado de la orden de compra y código de proveedor: El esquema de pedidos de compra incluye el estado actual del pedido de compra y la hora de actualización del estado. Puede usar el filtro purchaseOrderState para filtrar los pedidos en función del estado actual.

Por ejemplo, los proveedores pueden obtener todos los pedidos que aún no se han confirmado o gestionado utilizando purchaseOrderState=New.

Los proveedores también pueden obtener pedidos para un código de proveedor específico si indican uno de los códigos de proveedor autorizados en el filtro orderingVendorCode. Este filtro solo devolverá los pedidos generados para el código de proveedor mencionado en el filtro.

For details about all the available filters, refer to the Vendor Orders API Reference.

En el siguiente diagrama se muestra el proceso de integración cuando se recuperan pedidos de compra:

The Vendor orders workflow when retrieving purchase orders.

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.

Utilice esta operación para obtener los detalles de los pedidos específicos devueltos por el getPurchaseOrders operación.

El siguiente diagrama muestra el flujo de trabajo de integración al recuperar un pedido de compra específico:

The Vendor orders workflow when retrieving a specific purchase order.

Requisitos empresariales

  • Pedidos basados en el peso

    Para los pedidos que contienen artículos que se venden por peso, el unitOfMeasure campo (debajo) listPrice y netCost) refleja la unidad de medida del peso real. Los valores de la unidad de medida del peso incluyen POUNDS, OUNCES, GRAMS, y KILOGRAMS.

  • Uso de la ventana de envío o la ventana de entrega

    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.

  • ¿Se aceptan pedidos pendientes para una línea de pedido?

    Debes leer el valor del campo isBackOrderAllowed. Cuando es True, el pedido puede procesarse como un pedido retrasado. Cuando es False, los pedidos retrasados no están permitidos.

  • Códigos de ofertas

    Los códigos de oferta son códigos promocionales introducidos en el campo dealCode del pedido. Cualquier información relativa al código promocional, descuentos especiales o precios estará presente en este campo.

  • Política de cancelación de pedidos retrasados

    Tu representante empresarial de Amazon determina la política de pedidos pendientes. Consulta los detalles con tu gerente de proveedores.

📘

Nota

Es posible que las fechas de cancelación de pedidos pendientes no se indiquen en el pedido. Debes configurar la política de pedidos pendientes a nivel de cuenta.

  • Usa la API para cambiar un pedido

    Por el momento, no es posible realizar cambios en un pedido mediante la API. Una vez realizado un pedido, cambiarlo es un proceso manual a través de Vendor Central.

Requisitos empresariales específicos de país

FuncionalidadIndiaEuropaNorteamérica
Coste netoCondicional. Coste neto o precio de venta.Condicional. Coste neto o precio de venta.Condicional. Coste neto o precio de venta.
Precio de ventaCondicional. Coste neto o precio de venta.Condicional. Coste neto o precio de venta.Condicional. Coste neto o precio de venta.
Pedido retrasadoNo aplicableCompatibleCompatible
Parte compradoraLa dirección de la entidad compradora de AmazonEl ID de parte asignado a la parte compradoraNo aplicable
Parte vendedoraEl código de proveedor de Amazon asignado al proveedorEl código de proveedor de Amazon asignado al proveedorEl código de proveedor de Amazon asignado al proveedor
Destinatario de mercancíasLa dirección de la entidad destinatariaEl ID de parte asignado a la parte destinataria de las mercancíasNo aplicable
Destinatario de la facturaLa dirección de la entidad de facturaciónLa dirección de la entidad de facturaciónNo aplicable

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 espera que envíes el acuse de recibo lo antes posible, en un plazo máximo de 24 horas. El acuse de recibo debe reflejar con precisión las cantidades y fechas reales del envío.

En el caso de cualquier cambio en la cantidad, el precio, las fechas de envío o las fechas de entrega, Amazon espera una actualización de la confirmación de pedido enviada por el proveedor en un plazo de 48 horas. El proveedor puede enviar una confirmación completa o solo la actualización de una línea de pedido específica. Amazon siempre trata la actualización como una sustitución de las confirmaciones de pedido anteriores de la línea de pedido. Después de 48 horas, solo esperamos recibir actualizaciones sobre las fechas de envío o de entrega.

Si el primer código de acuse de recibo para una línea de pedido específica fue rejected, tampoco puedes cambiarlo con tu actualización a accepted o backordered.

Comprobación de las confirmaciones de pedido enviadas correctamente

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.

En el siguiente diagrama se muestra el proceso de integración al confirmar pedidos.

The Vendor orders workflow when acknowledging orders.

Requisitos empresariales

  • ¿Puede un proveedor aumentar la cantidad original enviada en el pedido de compra al confirmar un pedido?

    No, no puedes enviar una cantidad mayor en el acuse de recibo que la que se envió en el pedido de compra.

  • ¿Es obligatorio enviar una confirmación de pedido para cada pedido?

    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.

  • ¿Es obligatorio proporcionar todas las partidas del pedido en la confirmación de pedido correspondiente?

    Sí, de esta forma Amazon puede actualizar el estado del pedido correctamente.

  • Si una línea de pedido cuenta con retraso, ¿es necesario facilitar la cantidad en la confirmación de pedido?

    Sí, para que el sistema de Amazon pueda actualizar correctamente el estado de la línea de pedido.

  • ¿Cómo deben notificarse los artículos no válidos u obsoletos en un pedido utilizando la confirmación de pedido?

    No proceses ni envíes un artículo que haya llegado con un número de artículo no válido en el pedido. Devuelve el número de artículo no válido que aparece en el acuse de recibo y acéptalo como invalid. Los siguientes códigos de confirmación indican rejected debido a que el artículo está obsoleto:

    Rechazado: Amazon interpreta que la cantidad indicada con este código no se entregará a Amazon como parte de este pedido de compra. Debes enviar el motivo de rechazo correspondiente a obsolete en el reconocimiento. Esto indica que, debido a que el artículo está obsoleto, ya no se debe pedir. La nomenclatura de Amazon para esto es «rechazo forzoso», lo que significa que este artículo no se debe volver a pedir. Si este código se recibe dos veces consecutivas para el mismo proyecto (separadas por un intervalo de tiempo de al menos 48 horas), el artículo no se volverá a pedir.

📘

Nota

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.

  • ¿Debo devolver en la confirmación de pedido el mismo identificador de producto que recibí en la transacción del pedido?

    Las confirmaciones de pedido deben devolver exactamente el mismo identificador de producto que se envió en el pedido de compra.

  • ¿Es obligatorio indicar el precio en la confirmación de pedido?

    Sí, los proveedores deben indicar el precio de coste por unidad en la confirmación de pedido. El precio de coste debe coincidir con el precio de coste por unidad que se facturará. Los proveedores de libros deben proporcionar un precio de lista y un multiplicador de descuento.

  • ¿Se puede simplemente devolver el precio del pedido en la confirmación de pedido?

    No. Independientemente del precio enviado en el pedido, Amazon exige el precio de coste en la confirmación de pedido. El precio de coste enviado en la confirmación de pedido debe coincidir con el precio de coste enviado en la factura. Los sistemas de pago de Amazon los compararán y pueden retrasar el pago si no coinciden.

  • ¿Qué exige Amazon.com si el precio y/o la disponibilidad cambian después del envío de la confirmación de pedido inicial?

    Envía una notificación manual sobre cualquier cambio en los pedidos de Amazon una vez que se haya enviado la confirmación inicial. Tu representante comercial de Amazon.com puede asesorarte sobre cuándo, cómo y a quién enviar la notificación.

  • ¿Es necesario facilitar los datos de precios de los artículos retrasados?

    Sí, es obligatorio para que Amazon pueda actualizar correctamente el estado del pedido. Si se omite el precio, se rechazará la confirmación.

  • ¿Cómo puedo saber si se permiten o no los pedidos retrasados?

    Debe leer el valor en el isBackOrderAllowed campo de la orden de compra. Un valor verdadero indica que se permiten los pedidos pendientes. Un valor falso indica que no se permiten los pedidos pendientes.

  • ¿Es obligatorio proporcionar un código de confirmación de pedido para todas las líneas de pedido, independientemente del estado?

    Sí, es obligatorio para que podamos actualizar correctamente el estado del pedido. Si se omite el código de confirmación, se rechazará la confirmación.

  • ¿Cuál es la política de Amazon en cuanto a los envíos parciales? ¿Cómo deben comunicarse los envíos parciales al enviar una confirmación de pedido?

    Se permiten los envíos parciales si el pedido de compra admite pedidos pendientes (cuando isBackOrderAllowed es true). Amazon recomienda que indiques un bucle de confirmación mediante el código accepted con la fecha correspondiente y otro bucle de acuse de recibo utilizando el código backordered y la fecha correspondiente.

    Aceptado: para los artículos que pueden entregarse inmediatamente.

    Pedido retrasado: para la cantidad restante que no puede gestionarse inmediatamente. La cantidad restante (cantidad pedida menos toda la cantidad confirmada) se entregará en una fecha posterior (pedido retrasado).

  • ¿Cuándo debo utilizar el segmento listPrice?

    El segmento listPrice solo es necesario si un proveedor vende libros con un precio de venta.

Requisitos empresariales específicos de país

FuncionalidadIndiaEuropaNorteamérica
Fecha de envío programadaCondicional. Depende de las condiciones de flete y del acuerdo empresarial vigente con el proveedor.OpcionalOpcional
Fecha de entrega programadaCondicional. Depende de las condiciones de flete y del acuerdo empresarial vigente con el proveedor.OpcionalOpcional
Precio de ventaNecesario solo para proveedores de librosCompatibleNecesario solo para proveedores de libros

Obtener el estado del pedido

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.

Puedes devolver hasta 100 pedidos en una sola llamada a la API. Si hay más de 100 pedidos, puedes usar nextToken para obtener el siguiente conjunto de pedidos.

A continuación se muestran algunos ejemplos de cómo puedes utilizar la operación getPurchaseOrdersStatus con diferentes parámetros de consulta:

  • Puedes obtener el estado de todos los pedidos abiertos en un intervalo de fechas especificado utilizando la fecha de creación del pedido (createdBefore y createdAfter) o la fecha de actualización del pedido (updatedBefore y updatedAfter) junto con purchaseOrderStatus=OPEN.

  • Puedes usar el getPurchaseOrdersStatus operación para filtrar el estado de las PoS. Por ejemplo, si itemConfirmationStatus=REJECTED, la respuesta devolverá como rechazados todos los pedidos que tengan uno o más artículos en estado de rechazo.

  • Puedes comprobar el estado de un pedido específico proporcionando el número de pedido en el parámetro de consulta purchaseOrderNumber.

  • Puedes obtener el estado de todos los pedidos abiertos generados para un código de proveedor específico si proporcionas el valor del código de proveedor en orderingVendorCode e incluyes purchaseOrderStatus=OPEN.

  • Puedes obtener el estado de todos los pedidos creados en un intervalo de tiempo que deban enviarse a un centro logístico de Amazon específico si proporcionas el código del centro logístico (FC) en shipToPartyId y el intervalo de tiempo en createdBefore y createdAfter.

Casos de uso de pedidos de compra y confirmaciones de pedido

Línea de pedido no válida en el pedido de compra

Si recibes un identificador de producto no válido en el pedido de compra, debes rechazar el artículo con un código de confirmación Rejected y el rejectionReason tan InvalidProductIdentifier:

Pedido de compra

{ "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" } } ] } } }

Confirmación de pedido de compra

{ "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" } ] } ] } ] }

Estado del pedido de compra

{ "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 } } ] } } ] } ] } }

Línea de pedido obsoleta en el pedido de compra

Si recibes un producto obsoleto en la orden de compra, debes rechazar el artículo con un código de confirmación Rejected y el rejectionReason tan ObsoleteProduct.

Pedido de compra

{ "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" } } ] } } }

Confirmación de pedido de compra

{ "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" } ] } ] } ] }

Confirmar la cantidad parcial del artículo y retrasar la cantidad restante

Amazon ha pedido 10 cantidades de artículos. El vendedor planea dividir los envíos y, por lo tanto, envía un Accepted cantidad de artículos de seis y un BackOrdered cantidad de cuatro artículos para indicar que se enviarán seis unidades en el primer envío y cuatro unidades en el segundo.

Pedido de compra — (Importar pedido de compra)

{ "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" } } ] } } }

Confirmación de pedido de compra

{ "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" } ] } ] } ] }

Tras enviar la primera parte del pedido, el proveedor indica a Amazon una fecha más precisa para el segundo envío utilizando scheduledShipDate para los artículos retrasados. Ten en cuenta que los proveedores siempre deben enviar actualizaciones completas con la cantidad total pedida para las líneas de pedido individuales. Las actualizaciones completas proporcionan una visibilidad explícita de las cantidades.

Estado del pedido de compra

{ "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 } } ] } } ] } ] } }

Varias confirmaciones para cancelar cantidades inicialmente aceptadas

Puedes usarla cuando descubras que no puedes gestionar algunas o todas las unidades de un pedido que se aceptaron inicialmente y quieres informar a Amazon de que estas unidades no se enviarán.

Pedido de compra

{ "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" } } ] } } }

Confirmación de pedido de compra

El proveedor aceptó inicialmente la cantidad.

{ "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" } ] } ] } ] }

Posteriormente, el proveedor no puede gestionar la cantidad aceptada y envía una cancelación total o parcial mediante otra solicitud de confirmación de pedido.

Cancelación total

{ "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" } ] } ] } ] }

Cancelación parcial

{ "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" } ] } ] } ] }

Estado del pedido de compra tras la cancelación parcial posterior

{ "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é es la API de envíos de proveedores?

You can use the Vendor Shipments API (Shipments API) to exchange shipment related documents with Amazon.

Las siguientes operaciones están incluidas en la API de envíos:

Operación Método HTTP Path Descripción
SubmitShipmentConfirmations POST /vendor/shipping/v1/shipmentConfirmations Enviar una o varias confirmaciones de envío a Amazon.
GetShipmentDetails GET /vendor/shipping/v1/shipments Obtén los detalles del envío de la solicitud de transporte enviada a Amazon. La recuperación de datos es posible durante un período máximo de seis meses a partir de la fecha en que se creó la solicitud de envío.
SubmitShipments POST /vendor/shipping/v1/shipments Envía una o varias solicitudes de transporte a Amazon.

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).

Al recibir una confirmación de envío válida y oportuna, podemos anticipar correctamente los envíos que nos envías. Algunas de las ventajas de enviar confirmaciones de envío incluyen:

  • Amazon puede colaborar de forma más eficaz con los transportistas en el seguimiento y la recepción de tus envíos. Esto nos permite planificar de forma eficaz nuestros recursos laborales y nos ayuda a garantizar una recepción más rápida y eficiente de tu envío, lo que significa que puedes facturar tus órdenes de compra con mayor rapidez.

  • Amazon puede realizar un seguimiento del inventario entrante y crear pedidos automatizados para garantizar que los artículos no se agoten.

  • Mayor visibilidad de los productos en tránsito, lo que nos permite reflejar con mayor precisión la disponibilidad de los artículos (entrega por período) para los clientes finales.

  • Con las políticas de cancelación de órdenes de compra de Amazon, se pueden cancelar los envíos pendientes de compra. Sin embargo, las órdenes de compra con una confirmación de envío precisa avisan a nuestros sistemas internos de que están en tránsito. Esto puede ayudar a evitar cancelaciones innecesarias de órdenes de compra, devoluciones de cargos y rechazos de fletes.

La falta de confirmaciones de envío válidas puede dar lugar a:

  • Visibilidad inadecuada de los envíos entrantes.
  • Errores al conciliar los envíos físicos con los pedidos de compra.
  • Seguimiento manual para resolver discrepancias.
  • La necesidad de proporcionar un comprobante de entrega (POD) para la facturación.

Sustitución de confirmación de envío

Cuando una confirmación de envío tiene un shipmentConfirmationType de Replace, puedes corregir las confirmaciones de envío enviadas anteriormente enviando una versión actualizada. La segunda llamada de confirmación de envío sobrescribirá por completo los datos de confirmación del primer envío.

La principal ventaja es mejorar la precisión de las reservas actualizando las confirmaciones de envío erróneas después del envío inicial.

¿Cómo funciona?

Para reemplazar una confirmación de envío enviada anteriormente, se puede enviar una segunda confirmación de envío. El shipmentIdentifier y sellingParty.partyId deben ser idénticas para ambas transmisiones para que podamos sobrescribir correctamente la versión anterior de la confirmación de envío.

Alcance de la confirmación del envío: reemplazar

  • Todos los valores de confirmación de envío se pueden editar, excepto el shipmentIdentifier y sellingParty.partyId, que deben permanecer idénticos para que la confirmación del envío: el reemplazo se realice correctamente.

  • La cantidad de palés, cajas y artículos enviados no se pueden aumentar, pero sí reducir. Para aumentar los volúmenes, debes enviar una segunda confirmación de envío con un nuevo shipmentIdentifier. Puedes utilizar la misma referencia de número de conocimiento de embarque (BOL) si las unidades adicionales se entregan con el mismo envío.

  • 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.

  • La sustitución de una confirmación de envío solo es posible dentro de los 7 días siguientes a la confirmación inicial del envío y solo si el envío aún no ha llegado al centro logístico de Amazon.

Comprobación de confirmaciones de envío enviadas correctamente

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.

En el siguiente diagrama se muestra el proceso de integración al enviar confirmaciones de envío.

The Vendor shipments workflow when submitting shipment confirmations.

Requisitos empresariales

  • Cuando un proveedor envía artículos que se venden por peso, debe proporcionar la totalWeight campo. El totalWeight El campo contiene el peso de los artículos que envía el proveedor y la unidad de medida del peso. Los valores de la unidad de medida del peso incluyen POUNDS, OUNCES, GRAMS, y KILOGRAMS.

  • Existe un límite de 100 confirmaciones de envío para cada envío llevado a cabo con un camión como medio de transporte. Esto significa que solo puedes enviar una confirmación de envío por separado a nivel de pedido o de caja si el número total de confirmaciones de envío individuales es inferior o igual a 100 para un envío de carga completa (TL) o inferior para un envío con carga parcial del camión (LTL). Te recomendamos que envíes una única confirmación de envío para todo el envío de tipo Carga parcial del camión/Carga completa, incluidos todos los detalles del pedido y del embalaje.

  • Amazon debe recibir la confirmación de envío antes de que el producto se reciba en el centro logístico de Amazon. Una confirmación de envío omitida o retrasada dará lugar a reversiones de cargo.

  • En el caso de envíos de paquetes pequeños, se requiere una confirmación de envío para cada paquete/caja.

  • Amazon exige la siguiente información que se utiliza para realizar un seguimiento del cumplimiento:

    • En el caso de los envíos paletizados, debes enviar una confirmación de envío antes de solicitar una franja de entrega en el centro logístico de Amazon, ya que solo se ofrecen citas si se encuentra una confirmación de envío válida en los sistemas de Amazon. Para ver las excepciones, consulta la confirmación de envío local Ayuda páginas para entender las opciones disponibles. En el caso de los paquetes, la confirmación de envío debe enviarse antes de enviar los artículos. La confirmación de envío faltante o retrasada provocará la devolución de cargos.
    • La confirmación de envío debe ser para una entrega, de un solo proveedor y para un solo camión. Los envíos en varios camiones, a varios centros logísticos de Amazon, desde varias cuentas de proveedor o con llegadas en varios días requieren varias confirmaciones de envío.
    • Si varios envíos más pequeños de la misma cuenta de proveedor se combinan en un envío más grande y se requieren varias confirmaciones de envío, puedes usar la opción BOL general, como se muestra en el siguiente ejemplo:

Confirmación de envío 1

"billOfLadingNumber": "BOL1" "shipmentIdentifier": "SHIPMENT CONFIRMATION_ID1"

Confirmación de envío 2

"billOfLadingNumber": "BOL1" "shipmentIdentifier": "SHIPMENT CONFIRMATION_ID2"

Requisitos empresariales específicos de país

Funcionalidad Definición empresarial India Europa Norteamérica
Número de conocimiento de embarque / oferta de entrega

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.

El número de cotización de entrega es una alternativa al BOL como número de referencia para un envío.

Condicional

Obligatorio para todas las confirmaciones de envío. Obligatorio para envíos FTL o LTL.
Número de referencia de envío del transportista (PRO#) El número PRO (número de referencia de envío del transportista) es un número único asignado por el transportista. Se utiliza para identificar y realizar el seguimiento del envío que sale para su entrega. Obligatorio para todas las confirmaciones de envío. Opcional Obligatorio para todas las confirmaciones de envío.
Fecha de envío Fecha en la que el envío sale del almacén del proveedor.

Obligatorio para todas las confirmaciones de envío.

Obligatorio para todas las confirmaciones de envío. Obligatorio para todas las confirmaciones de envío.
Fecha de entrega prevista

Fecha en la que se espera que el envío llegue al centro logístico de Amazon. Debe ser una estimación basada en el tiempo medio de tránsito entre el lugar de origen del envío y el de destino. La hora exacta la facilitará Amazon y puede que no se sepa en el momento de crear el envío.

Obligatorio para todas las confirmaciones de envío.

Obligatorio para todas las confirmaciones de envío. Obligatorio para todas las confirmaciones de envío.
Recuento de cajas Número de cajas presentes en el envío. Las unidades apiladas en el palé sin el embalaje exterior se cuentan como 1 unidad = 1 caja. El recuento de cajas se requiere a nivel de envío. Obligatorio para todas las confirmaciones de envío. Obligatorio para todas las confirmaciones de envío. Obligatorio para todas las confirmaciones de envío.
Recuento de palés Número de palés del envío. Para los envíos de paquetes puros, debe indicarse el valor 0. Todos los paquetes que llegan al centro logístico en un palé deben tener un mínimo de 1 indicado en este segmento. La información es obligatoria a nivel de envío. Obligatorio para todas las confirmaciones de envío de entregas paletizadas. Obligatorio para todas las confirmaciones de envío. Obligatorio para envíos FTL y LTL.
Código alfa del transportista estándar (SCAC) Código que identifica al transportista del envío. El código alfa del transportista estándar (SCAC) es un código único de dos a cuatro letras que se utiliza para identificar a un transportista. La NMFTA (National Motor Freight Association) es la encargada de asignar y mantener los códigos SCAC del transportista. Opcional Opcional Obligatorio para todas las confirmaciones de envío.
Ubicación de envío (enviar a) ID de parte / código de almacén del lugar al que se envían los productos. El nombre del campo del esquema de la API es "shipToParty" Obligatorio para todas las confirmaciones de envío. Obligatorio para todas las confirmaciones de envío. Obligatorio para todas las confirmaciones de envío.
Identificación de proveedor Identificación del proveedor que envía los productos a Amazon. El nombre del campo del esquema de la API es "sellingParty". Obligatorio para todas las confirmaciones de envío. Obligatorio para todas las confirmaciones de envío. Opcional
Origen de envío Dirección (código postal) y referencia de país de la ubicación desde la que se envían físicamente los productos. Obligatorio para todas las confirmaciones de envío. Obligatorio para todas las confirmaciones de envío. Obligatorio para todas las confirmaciones de envío.
Número de referencia de Amazon (solo para envíos WePay). Número de referencia de Amazon tal como se recibió en las instrucciones de enrutamiento (GetShipmentDetails respuesta) para un envío de WePay. Obligatorio solo para las confirmaciones de envío

(para envíos WePay).

Obligatorio solo para las confirmaciones de envío

(para envíos WePay).

Obligatorio para envíos a portes debidos.
Número de pedido de compra Número de pedido de compra de Amazon. Autorización por escrito para que un proveedor envíe productos a un precio determinado, que se convierte en un contrato legalmente vinculante cuando el proveedor lo acepta. Obligatorio a nivel de encabezado o de línea de pedido. Obligatorio a nivel de encabezado o de línea de pedido. Obligatorio a nivel de encabezado o de línea de pedido.
Código de contenedor de envío en serie (SSCC) Código único de 18 dígitos del contenedor de envío en serie (SSCC) que debe incluirse para definir un palé/caja. Recomendado para todas las confirmaciones de envío dentro de la unidad de embalaje. Obligatorio para todas las confirmaciones de envío dentro de la unidad de embalaje. Obligatorio para todas las confirmaciones de envío dentro de la unidad de embalaje.
Identificación del artículo SKU del proveedor del producto. Obligatorio para todas las confirmaciones de envío. Obligatorio para todas las confirmaciones de envío. Obligatorio para todas las confirmaciones de envío.
Número de lote El lote o número de lote asocia a un artículo la información que el fabricante considera pertinente para la trazabilidad del artículo comercial al que se aplica la cadena de elementos. Los datos pueden referirse al propio artículo comercial o a los elementos que contiene. Obligatorio para artículos perecederos. Obligatorio para artículos perecederos. Obligatorio para artículos perecederos.
Fecha de caducidad Fecha que determina el límite de consumo o utilización de un producto. Su significado se determina en función del contexto del artículo comercial. Obligatorio para artículos perecederos. Obligatorio para artículos perecederos. Es necesario disponer de la fecha de caducidad o de la fecha del fabricante y la fecha de caducidad máxima del almacén.
Fecha de fabricación Fecha de producción, embalaje o montaje determinada por el fabricante. Su significado se determina en función del contexto del artículo comercial. Opcional Opcional Es necesario disponer de la fecha de caducidad o de la fecha del fabricante y la fecha de caducidad máxima del almacén.
Cantidad Número de unidades enviadas de un artículo específico. Obligatorio para todas las confirmaciones de envío. Obligatorio para todas las confirmaciones de envío. Obligatorio para todas las confirmaciones de envío.

Explicación de los campos adicionales

Número de conocimiento de embarque

El número de conocimiento de embarque (BOL#) es el número de referencia necesario para reservar una cita en Amazon. Esta referencia debe proporcionarse cuando Amazon solicite una confirmación de envío válida. Es el número de referencia predeterminado del documento que acompaña al envío físico. El número de registro de envío de la confirmación de envío debe coincidir con el número de registro proporcionado en la documentación del envío.

Cuando defina el número de BOL, asegúrese de que sea único para cada envío. Tu número de BOL puede ser la referencia física del BOL, pero si optas por un número diferente:

  • Usa un mínimo de ocho dígitos.
  • Utiliza el código de proveedor de Amazon como prefijo (por ejemplo: ABCD1939393).
  • No utilices una fecha ni una hora.
Identificación del envío

Este campo es un identificador único (la exclusividad se define en el contexto del proveedor) que representa esta confirmación de envío. No proporcionar un Shipment Identification provocará el rechazo de la confirmación de envío. Asegúrese de que el identificador que se está enviando no se haya utilizado en los últimos 365 días.

Fecha de envío

Este campo indica la fecha de salida del envío de la ubicación del proveedor. Se solicita a los vendedores que envíen las confirmaciones de envío antes de que la carga llegue a Amazon FC.

Fecha de entrega prevista

Se trata de una estimación aproximada, basada en la experiencia, de cuándo se espera que se entregue un envío en el centro logístico de Amazon. Los proveedores deben determinarlo basándose en el tiempo medio de tránsito del transportista. Esta información nos ayuda a planificar el envío si no obtenemos una fecha de entrega prevista del transportista.

Esta fecha debe especificarse para cada envío, aunque es posible que no se conozca una fecha en este momento.

Código de contenedor de envío en serie (SSCC)

Amazon procesa los recibos mediante un enfoque altamente automatizado denominado recepción de matrículas o LP, y este proceso requiere que proporciones los detalles del contenido de la caja en los mensajes de confirmación de envío. Este proceso de recepción obligatorio escanea el código de barras del contenedor de envío en serie (SSCC) que se encuentra en la parte exterior de una caja o palé de los productos recibidos, lo que elimina la necesidad de escanear cada uno de los artículos que se encuentran dentro de la caja o palé. Este proceso tiene una serie de ventajas importantes, como una mayor eficiencia, una mayor precisión en la recepción, un pago más preciso y un ciclo de pago más rápido.

Puede elegir una solución técnica, ya que Amazon decidió no seguir estrictamente la solución GS1-128. Para cumplir con los requisitos de matrícula de Amazon, el SSCC debe ser un código único de 18 dígitos que defina un palé o una caja de cartón, no puede repetirse en un plazo de 365 días y debe incluir un código de barras tanto en la etiqueta de la caja como en el mensaje de confirmación del envío. Además, el código de barras de la etiqueta física debe coincidir al 100% con el SSCC de la confirmación del envío. A los proveedores que desean implementar el GS1-128 se les pide que añadan un 00 al principio de su SSCC dentro de la confirmación de envío.

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.

Fecha de caducidad

La fecha de caducidad es la que indica el límite de consumo o uso de un producto. Se determina en función del contexto del artículo comercial (por ejemplo, en el caso de los alimentos, esto indica la posibilidad de un riesgo directo para la salud derivado del consumo después de la fecha; en el caso de los productos farmacéuticos, indica la posibilidad de un riesgo indirecto para la salud derivado de la ineficacia del producto después de esa fecha). Suele denominarse "fecha de caducidad" o "fecha de máxima durabilidad".

Fecha de fabricación

La fecha en la que se envasaron o fabricaron los artículos. Este campo debe proporcionarse si un artículo es perecedero o tiene una vida útil definida.

Número de lote

El número de lote o lote asocia un artículo con la información que el fabricante considera relevante para la trazabilidad del propio artículo o de los ingredientes que contiene. El número puede indicar un lote de producción, un turno de trabajo, una máquina, una hora o un código de producción interno.

Uso de la fecha de caducidad / fecha de fabricación / números de lote en la confirmación de envío

Estos campos son obligatorios solo para los artículos perecederos, es decir, para aquellos artículos en los que is expiration dated product el atributo es Yes en el formulario de configuración de nuevos artículos (NIS).

Al definir las fechas de caducidad, las fechas de fabricación o los números de lote en la confirmación de envío:

  • Las fechas de caducidad, las fechas de fabricación o los números de lote deben enviarse por artículo.

  • Una caja/palé puede contener varios artículos (ASIN), cada uno con fechas de caducidad, fechas de fabricación o números de lote individuales.

  • Un artículo (ASIN) no debe tener varias fechas de caducidad, fechas de fabricación o números de lote en la misma caja o palé.

Los proveedores deben proporcionar la fecha de caducidad y la fecha de fabricación en la confirmación de envío en formato AAAAMMDD.

Casos de uso de la confirmación de envío

Estuche estándar para paquetes pequeños con números de lote y caducidad

{ "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 } } ] } ] } ] }

Pequeña LooseAssortmentCase paquete con caducidad y números de lote

{ "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 } } ] } ] } ] }

Carga de camión paletizada con varios artículos

{ "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" ] } } ] } ] }

Envío de carga parcial de un camión con cajas estándar paletizadas

{ "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" ] } } ] } ] }

Envío de palets de un solo ASIN con carga inferior a la de un camión

{ "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

🚧

Importante

SubmitShipments solo está disponible en los sitios web de Norteamérica y la 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.

📘

Nota

El SubmitShipments la operación no admite la presentación de solicitudes de envío de palés no estándar.

Crear o actualizar un envío
Cuando el transactionType para una solicitud de envío es New, puedes crear una nueva solicitud o actualizar una solicitud de envío enviada anteriormente. Las actualizaciones de una solicitud de envío existente se realizan en función del identificador de envío del proveedor. Si ya existe un envío con el identificador de envío del proveedor proporcionado, se realizará una operación de actualización; de lo contrario, se creará un nuevo envío.

Alcance del envío de la actualización:

  • Todos los valores de las solicitudes de envío se pueden editar, excepto vendorShipmentIdentifier,buyerReferenceNumber, y sellingParty.partyId que deben permanecer idénticos para que la actualización se realice correctamente. Tienes la flexibilidad de modificar todos los demás campos de la solicitud de envío antes de que se asigne el transportista.
  • La fecha de recogida solicitada en la solicitud de envío solo se puede modificar una vez que se haya asignado el transportista.

Cancelar el envío
Una solicitud de envío con transactionType tan Cancel te permite cancelar una solicitud de envío enviada anteriormente. Para cancelar una solicitud de envío enviada anteriormente, debes proporcionar vendorShipmentIdentifier, buyerReferenceNumber, sellingParty.partyId, shipFromParty.partyId, shipToParty.partyId y transactionType tan Cancel.

Alcance de la cancelación del envío:

  • La cancelación de una solicitud de envío es posible tanto antes como después de que se haya asignado un transportista y se haya programado la ruta.

Verificación de las solicitudes de envío enviadas correctamente

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.

📘

Nota

The Transaction Status API only supports Processing and Failure status values for submitted Cancel Shipment requests.

El siguiente diagrama muestra el flujo de trabajo de integración al enviar solicitudes de envío.

The Vendor Submit shipment workflow.

Requisitos empresariales

  • La solicitud de envío solo debe enviarse cuando la orden de compra correspondiente esté completamente confirmada. Si la orden de compra aún no se ha confirmado, la solicitud de envío no se procesará.
  • El requestedPickUp en la solicitud de envío, debe ser como mínimo dos días hábiles después de la fecha actual.
  • Todos los valores de las solicitudes de envío se pueden editar, excepto vendorShipmentIdentifier, buyerReferenceNumber, y sellingParty.partyId, que deben permanecer idénticos para que la actualización se realice correctamente. Tienes la flexibilidad de modificar todos los demás campos de la solicitud de envío antes de que se asigne el transportista.
  • Solo puedes modificar la fecha de recogida solicitada en la solicitud de envío después de que se haya asignado un transportista.
  • La cancelación de una solicitud de envío es posible tanto antes como después de que se haya asignado un transportista y se haya programado la ruta.

Explicación de los campos adicionales

Identificador de envío del proveedor

Este campo es un identificador único (la unicidad se define en el contexto del proveedor) que representa esta solicitud de transporte. No proporcionar un vendorShipmentIdentifier provocará que se rechace la solicitud de transporte. Asegúrese de que la identificación que se envía no se haya utilizado en los últimos 365 días.

Fecha de recogida solicitada

Este campo también se llama Freight Ready Date, se usa para especificar la fecha más temprana de recogida del envío en la ubicación del vendedor. Se le solicita que envíe la solicitud de transporte cuando los artículos estén listos para ser retirados.

Enviar ejemplos de solicitudes de envío

Crear o actualizar una solicitud de envío

{ "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" } ] } ] }

Cancelar solicitud de envío

{ "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

🚧

Importante

GetShipmentDetails es solo para pedidos de WePay y Collect en los sitios web de Norteamérica y la 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.

Los detalles devueltos en la respuesta te ayudan a ejecutar el proceso de envío de forma eficiente, a asegurarte de que el pedido esté empaquetado y de que esté listo para que el transportista lo recoja en la fecha de recogida asignada. Puedes usar esta operación para ver el estado y los detalles del envío en cualquier momento del ciclo de vida del envío. Esta operación la utilizan principalmente los proveedores de WePay.

El siguiente diagrama muestra el flujo de trabajo de integración de envíos de Vendor Get.

The Vendor Get shipment workflow.

Requisitos empresariales

  • 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 obligatorio

To return a list of shipments, call the GetShipmentDetails operation and pass the following parameters:

Parámetros de consulta:

Nombre Descripción Obligatorio
limit El límite del número de registros devueltos.

Tipo: número entero

No
sortOrder Ordena la lista por fecha de creación del envío en orden ascendente o descendente.

Tipo: cadena

Type: enum ( SortOrder )

No
nextToken Se utiliza para la paginación cuando hay más etiquetas de envío que el límite de tamaño de resultado especificado. El valor del token se devuelve en la llamada anterior a la API.

Tipo: cadena

No
createdAfter Shipments created after this time will be included in the result. This field must be in ISO 8601 date/time format.

Tipo: cadena (fecha-hora)

No
createdBefore Shipments created before this time will be included in the result. This field must be in ISO 8601 date/time format.

Tipo: cadena (fecha-hora)

No
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.

Tipo: cadena (fecha-hora)

No
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.

Tipo: cadena (fecha-hora)

No
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.

Tipo: cadena (booleana)

No
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.

Tipo: cadena (fecha-hora)

No
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.

Tipo: cadena (fecha-hora)

No
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.

Tipo: cadena (fecha-hora)

No
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.

Tipo: cadena (fecha-hora)

No
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.

Tipo: cadena (fecha-hora)

No
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.

Tipo: cadena (fecha-hora)

No
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.

Tipo: cadena (fecha-hora)

No
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.

Tipo: cadena (fecha-hora)

No
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.

Tipo: cadena (fecha-hora)

No
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.

Tipo: cadena (fecha-hora)

No
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.

Tipo: cadena (fecha-hora)

No
currentShipmentStatus Obtenga los detalles del envío pasando el estado actual del envío.

Tipo: cadena

No
vendorShipmentIdentifier Obtenga los detalles del envío pasando el identificador de envío del proveedor.

Tipo: cadena

No
buyerReferenceNumber Obtén los detalles del envío pasando el identificador de referencia del comprador.

Tipo: cadena

No
buyerWarehouseCode Obtén los detalles de envío según el código de almacén del comprador. Este valor debe ser el mismo que el shipToParty.partyId en el envío.

Tipo: cadena

No
sellerWarehouseCode Obtenga los detalles de envío según el código de almacén del proveedor. Este valor debe ser el mismo que el sellingParty.partyId en el envío.

Tipo: cadena

No

Ejemplo de solicitud:

GET https://sellingpartnerapi-na.amazon.com/vendor/shipping/v1/shipments?vendorShipmentIdentifier=00050003

Valores GetShipmentDetails:

Ejemplo de respuesta:

{ "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

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.

El siguiente diagrama muestra el flujo de trabajo de integración del proveedor para obtener etiquetas de envío.

The workflow for getting a shipment label

Requisitos empresariales

  • Llama al GetShipmentLabels solo después de asignar un transportista.
  • If GetShipmentLabels does not return a label or returns Resource Not Found, verify that a carrier has been assigned. Alternatively, you can call GetShipmentDetails to confirm whether the carrier has been assigned.
  • Si se ha asignado un transportista y la operación sigue sin devolver ninguna etiqueta, abre el caso «Ponte en contacto con nosotros» en el portal de Vendor Central.
  • Una vez que se utiliza una etiqueta para el envío, no se puede volver a utilizar.

Requisitos empresariales específicos de país

Esta operación de API solo está disponible en la región NA.

Solicitud de consulta

To return a list of shipment labels, call the GetShipmentLabels operation and pass the following parameters:

Nombre Descripción Obligatorio
limit El límite del número de registros devueltos.

Tipo: número entero

No
sortOrder Ordena la lista por fecha de creación de la etiqueta de envío en orden ascendente o descendente.

Tipo: cadena

Type: enum ( SortOrder )

No
nextToken Se utiliza para la paginación cuando hay más pedidos que el límite de tamaño de resultado especificado. El valor del token se devuelve en la llamada anterior a la API.

Tipo: cadena

No
labelCreatedAfter Las etiquetas de envío creadas después de este tiempo se incluirán en el resultado. Este campo debe tener el formato de fecha/hora ISO 8601.

Tipo: cadena (fecha-hora)

No
labelCreatedBefore Las etiquetas de envío creadas antes de esta hora se incluirán en el resultado. Este campo debe tener el formato de fecha/hora ISO 8601.

Tipo: cadena (fecha-hora)

No
buyerReferenceNumber Obtén las etiquetas de envío pasando el identificador de referencia del comprador.

Tipo: cadena

No
vendorShipmentIdentifier Obtenga las etiquetas de envío pasando el identificador de envío del proveedor.

Tipo: cadena

No
sellerWarehouseCode Obtenga etiquetas de envío basadas en el código de almacén del proveedor. Este valor debe ser el mismo que el sellingParty.partyId en el envío.

Tipo: cadena

No

Ejemplo de solicitud

GET /vendor/shipping/v1/transportLabels?vendorShipmentIdentifier=7822

Respuesta 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é es la API de facturas de proveedores?

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.

Se incluyen las siguientes operaciones:

OperaciónMétodo HTTPPathDescripción
submitInvoicesPOST/vendor/payments/v1/invoicesEnvía una o más facturas de proveedores a Amazon

📘

Nota

El submitInvoices La operación se puede utilizar para enviar notas de crédito en Europa.

Enviar facturas

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.

Los artículos solo deben facturarse una vez que hayan sido confirmados y enviados a Amazon. De lo contrario, la factura será rechazada.

Amazon procesará una factura con la información correcta sin ninguna interacción humana, lo que significa que el proveedor recibirá el pago con más rapidez.

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.

Pruebas paralelas de envío de facturas

You need to complete parallel testing with our payments system before you can start using the submitInvoices operation for payment processing.

Cuando comienzas a enviar facturas mediante la API, comienza la fase de pruebas paralelas. Durante la fase de pruebas paralelas, envías a Vendor Central y a la API las facturas de todos los pedidos enviados. Debes realizar pruebas paralelas hasta que se valide el contenido de al menos cinco a 10 archivos de facturas. Las pruebas paralelas se realizan con las órdenes de compra y las facturas de producción.

El equipo de cuentas por pagar (AP) de Amazon se pondrá en contacto contigo cuando finalicen las pruebas paralelas o si hay alguna discrepancia en el contenido de tus facturas.

Cuando recibes un correo electrónico en el que se indica que se han completado las pruebas paralelas, ya no necesitas enviar facturas a Vender Central; puedes usar la API para enviar facturas.

Verificación de las facturas enviadas correctamente

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.

El siguiente diagrama muestra el proceso de integración al enviar una factura de un pedido confirmado y enviado.

The Vendor invoices workflow when submitting an invoice for a confirmed and shipped order.

Requisitos empresariales

  • Para los artículos cuyos precios se calculan por peso, debes proporcionar el totalWeight campo. El totalWeight el campo contiene el peso total del artículo que se factura. Además, el netCostUnitOfMeasure El campo debe reflejar la unidad de medida de los artículos a los que pones precio por peso. Los valores de la unidad de medida incluyen POUNDS, OUNCES, GRAMS, y KILOGRAMS.

  • Los números de factura deben ser únicos y nunca deben reutilizarse (ni siquiera después de un año).

  • Si una factura enviada por la API falla debido a datos incorrectos, pero una factura de Vendor Central contiene los datos correctos, debes actualizar la factura a través de la API con los datos correctos utilizando los mismos Invoice ID.

  • Si una factura contiene datos incorrectos (tanto en Vendor Central como en la API), se cancela y se debe enviar una nueva factura con una nueva Invoice ID.

  • No debe enviarse una factura con total amount = 0 = 0, ya que esto provocaría un error en la factura.

  • 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.

  • Las condiciones de pago enviadas en una factura deben coincidir con las condiciones de pago acordadas con el comprador de Amazon.

  • El identificador del producto debe coincidir con el identificador del producto del pedido que se envió al proveedor en el pedido de compra correspondiente.

  • El importe total de la factura debe ser igual a la suma total de los artículos, cargos y descuentos.

  • El importe total del impuesto para cada nivel de línea debe ser igual al importe total del impuesto en el nivel de encabezado.

  • La cantidad total de la factura debe coincidir con la suma de la cantidad de todos los artículos.

  • Cada uno de los diferentes cargos y descuentos debe desglosarse en el encabezado (por ejemplo, cargos por transporte, cargos por embalaje, cargos por pedidos pequeños, etc.)

Advertencia

La dirección de envío debe coincidir con la dirección que Amazon tiene registrada. Si la dirección no coincide, la factura fallará.

Requisitos empresariales específicos de país

Funcionalidad India Europa Norteamérica
Tipo de factura Tipo de factura CreditNote no es compatible. El tipo de factura siempre debe ser Invoice. Tipos de factura Invoice y CreditNote son compatibles. Los proveedores deben enviar el tipo de factura correspondiente. Tipo de factura CreditNote no es compatible. El tipo de factura siempre debe ser Invoice.
Referencias de notas de crédito No se utiliza Los proveedores deben enviar estas referencias a nivel de artículo si el tipo de factura es CreditNote. No se utiliza
Fecha Debe ser now o antes. Debe ser now o antes. Debe ser now o antes.
Número HSN El código del Sistema Armonizado de Nomenclatura (HSN) es obligatorio para las facturas que cumplen con los requisitos fiscales. La longitud máxima permitida es de ocho caracteres. No se utiliza No se utiliza
Tipo de impuesto en el nivel de línea y encabezado Se permite lo siguiente para el tipo de impuesto:
  • SGST y CGST
  • SGST, CGST y CESS
  • UTGST y CGST
  • UTGST, CGST y CESS
  • IGST
  • IGST y CESS

Si no se proporciona información fiscal, se rechaza la factura.

Tipo de impuesto que se debe enviar. No se utiliza
Número de registro fiscal Se debe proporcionar un identificador de GST de 15 caracteres. Número de IVA Número de IVA
Detalles fiscales en el nivel de línea y encabezado 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.

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 hay un tipo de impuesto adicional llamado DomesticVAT, que se puede usar para enviar el importe del impuesto en la moneda local. Para procesar el IVA nacional, debes usar el mismo tipo impositivo utilizado para el tipo de impuesto VAT.

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.

Destinatario del cobro La entidad que suministra productos a Amazon y recibirá el pago. También se denomina Proveedor. Detalles fiscales y de dirección de la entidad (proveedor) que recibirá el pago de los artículos enviados (si se trata de una factura) o de los artículos devueltos (si se trata de una nota de crédito). Son datos obligatorios. Detalles fiscales y de dirección de la entidad (proveedor) que recibirá el pago de los artículos enviados. Son datos obligatorios.
Remitente del envío Detalles de la dirección de procedencia del envío, junto con el código ISO del estado.

El identificador de GST debe enviarse con el número de registro fiscal. La información del remitente del envío es obligatoria. Los valores deben coincidir con los valores en los sistemas de Amazon.

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.
Destinatario de mercancías Detalles de la dirección de destino junto con el código ISO del estado. La información del destinatario de mercancías es obligatoria.

Los valores deben coincidir con los valores en los sistemas de Amazon.

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.
Destinatario de la factura El destinatario de la factura es obligatorio. Puede ser el mismo que el destinatario de mercancías. Si es así, el proveedor debe enviar la misma información en ambos segmentos. 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.

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.

Identificador de producto de Amazon e identificador de producto externo Al menos uno de estos 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. Al menos uno de esos valores es obligatorio. El identificador debe ser el mismo que el que se recibe en el pedido.
Coste neto Este campo es obligatorio. Este campo es obligatorio. Este campo es obligatorio.
Número de pedido de compra Una factura solo puede contener información sobre un pedido. Por lo tanto, el número de pedido de compra debe ser el mismo para todas las líneas de pedido de una factura.

Obligatorio.

Una factura puede contener información para varios pedidos. El número de pedido debe enviarse en consecuencia para las diferentes líneas de pedido. Este campo es requerido si el tipo de factura es Invoice y no se usa cuando el tipo de factura es CreditNote. 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.

Detalles adicionales No se utiliza Este campo se utiliza cuando la parte vendedora tiene que enviar detalles adicionales para fines especiales. Por ejemplo, en el caso de las facturas de pago fraccionado en Polonia, la parte vendedora debe enviar la información detallada»mechanizm podzielonej płatności«de tipo SUR y languageCode »PL». No se utiliza
referenceNumber Un número de referencia de factura único generado por el Gobierno de la India para cada factura. Este campo solo es obligatorio para las facturas en la India. No se utiliza No se utiliza

Direcciones de destinatario de la factura

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.

Nota de crédito

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.

Notas de crédito admitidas por Amazon

NOTAS DE CRÉDITO de cuentas por pagar (AP) NOTAS DE CRÉDITO de cuentas por cobrar (AR)
Crédito PPV

Crédito por artículos facturados pero no recibidos, o crédito por pagos duplicados.

Devoluciones

Crédito por los artículos devueltos al vendedor debido, por ejemplo, a productos dañados, productos enviados incorrectamente y exceso de existencias.

Crédito PPV

Abono por artículos facturados a un coste mayor o menor.

COOP (por ejemplo, protección de precios, indemnización por daños)

Créditos COOP pagados por el proveedor a Amazon para vender su producto o para un acuerdo de protección de precios.


📘

Nota

Las notas de crédito no se admiten en todas las ubicaciones.

Clase submitInvoices

Factura con varios artículos sin impuestos

{ "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" } ] } ] }

Factura con un solo impuesto sobre un artículo

{ "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" } } ] } ] } ] }

Factura con varios impuestos sobre un artículo

{ "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" } } ] } ] } ] }

Factura con detalles de cargo o descuento en el nivel de encabezado y línea con impuestos

{ "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" } } ] } ] } ] }

Nota de crédito de la UE con impuestos

{ "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é es la API de estado de transacciones de proveedores?

You can use the Vendor Transaction Status API to check the transaction status of your POST transactions.

Se incluyen las siguientes operaciones:

.
OperaciónMétodo HTTPPathDescripción
getTransactionGET/vendor/transactions/v1/transactionStatus/{transactionId}Obtén el estado de una solicitud posterior a la transacción. Devuelve un pedido de compra (PO) basado en el valor de purchaseOrderNumber que se especifique. El estado de las transacciones puede comprobarse para datos de hasta cuatro meses a partir de la fecha en que se realizó la llamada POST original.

Obtener el estado de la transacción

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 ofrece el estado de procesamiento final de las transacciones de la API POST, como la confirmación de envío y la confirmación de pedidos, a través de esta API. Recomendamos encarecidamente a los proveedores que comprueben el estado mediante esta API para asegurarse de que sus transacciones se han procesado correctamente. Si se produce un error, la respuesta contendrá información sobre el error. Después, se puede corregir la transacción y volver a enviarla.

Estado de la transacciónDefinición
En procesoAmazon recibió la transacción de la API y aún se está procesando. Consulta el acuerdo de nivel de servicio de cada operación de la API para conocer el tiempo previsto para que finalice el procesamiento.
CorrectoThis 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.
ErrorLa transacción de la API no se ha procesado correctamente. Los detalles del error se proporcionarán en el cuerpo de respuesta sobre el estado de la transacción.

📘

Nota

El estado de la transacción es compatible con las siguientes operaciones de API:

El estado de la transacción solo admite Processing y Failure valores de estado. Si el estado de la transacción es Processing, y no está actualizado a Failure después de 15 minutos, eso indica que la transacción se ha procesado correctamente en nuestros sistemas.

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.

Casos de uso del estado de transacciones

La transacción está en proceso

{ "payload": { "transactionStatus": { "transactionId": "20190905193800-0c6b76cb-9662-4f3a-be03-1686c1e21477", "status": "Processing" } } }

La transacción se ha procesado correctamente

La transacción ha estado en proceso durante 15 minutos después de publicarla.

{ "payload": { "transactionStatus": { "transactionId": "20190905193800-0c6b76cb-9662-4f3a-be03-1686c1e21477", "status": "Processing" } } }

La transacción no se ha procesado correctamente en Amazon

{ "payload": { "transactionStatus": { "transactionId": "20190908091302-6ca0ac50-d06e-45f5-a1e2-eb448eadac50", "status": "Failure", "errors": [ { "code": "INVALID_ORDER_ID", "message": "Invalid order ID." } ] } } }

¿Te ha ayudado esta página?