Guia de casos de uso das APIs de compras de varejo do fornecedor v1

Como ajudar os fornecedores a gerenciar suas operações comerciais de varejo de forma programática por meio da integração de serviços Web.

As APIs de parceiros de vendas para fornecedores de varejo ajudam os fornecedores a gerenciar suas operações comerciais de varejo de forma programática por meio da integração de serviços Web. A integração automatizada com a Amazon pode ajudar os fornecedores a melhorar e manter seu desempenho em grande escala e expandir seus negócios com a Amazon.

Os fornecedores do programa de atendimento direto devem consultar o Guia de casos de uso das APIs de atendimento direto do fornecedor v1 para saber mais sobre APIs específicas para atendimento direto.

Os fornecedores podem usar essas APIs para criar aplicativos para aumentar a eficiência operacional, reduzir o esforço, reduzir os erros e melhorar o desempenho.

Para obter informações sobre autenticação e autorização, consulte Autorizando aplicativos da API do parceiro de vendas.

Processos de negócios que você pode cumprir usando as APIs de compras de varejo de fornecedores

Você pode usar o API de pedidos de fornecedores para gerenciar pedidos de compra, o API de remessas de fornecedores para enviar confirmações de envio, o API de faturas de fornecedores para enviar faturas e o API de status de transação do fornecedor para determinar o status das confirmações de seus pedidos e confirmações de remessa.

Processo de negócios Caso de uso Operação
Gerenciamento de pedidos de compra
Receba alterações ou cancelamentos de pedidos de compra getPurchaseOrders
Retorna uma lista de pedidos de compra criados ou alterados durante o período que você especificar.
Verifique o status do pedido de compra getPurchaseOrdersStatus
Retorna os status da ordem de compra com base nos filtros que você especificar.
Enviar confirmação de pedido de compra submitAcknowledgement
Envia confirmações para um ou mais pedidos de compra.
Verifique o status da transação de confirmação do pedido getTransaction
Retorna o status da transação que você especificar.
Remessas
Envia solicitações de remessa SubmitShipments
Envia uma ou mais solicitações de remessa para pedidos de fornecedores.
Obtenha o status da remessa ou as etiquetas de remessa/transporte GetShipmentDetails
Retorna os detalhes sobre a remessa, detalhes da transportadora, status da remessa, detalhes do contêiner e outros detalhes relacionados à remessa com base no valor dos parâmetros de filtro que você especificar.
Enviar ou atualizar a notificação antecipada de remessa (ASN) /confirmações de remessa SubmitShipmentConfirmations
Envia uma ou mais confirmações de envio para pedidos de fornecedores.
Verifique o status da transação de confirmação de envio getTransaction
Retorna o status da transação que você especificar.
Obtenha etiquetas de remessa GetShipmentLabels
Retorna etiquetas de remessa de pacotes pequenos com base nos filtros que você especificar.
Faturas e notas de crédito
Envie faturas de fornecedores submitInvoices
Envie novas faturas para a Amazon.

O que é a API de pedidos de fornecedores?

Você pode usar o API de pedidos de fornecedores (API de pedidos) para receber pedidos de compra e enviar confirmações de pedidos para aceitar ou rejeitar o atendimento de pedidos.

A API de pedidos de fornecedores inclui as seguintes operações:

Operação Método HTTP Path Descrição
getPurchaseOrders GET /vendor/orders/v1/purchaseOrders Retorna uma lista de pedidos de compra criados ou alterados durante o período especificado por você. A recuperação de dados é possível por um período máximo de seis meses a partir da data em que a chamada POST original foi feita.
getPurchaseOrder GET /vendor/orders/v1/purchaseOrders /{purchaseOrderNumber} Retorna uma ordem de compra (PO) com base na purchaseOrderNumber valor que você especificar. A recuperação de dados é possível por um período máximo de seis meses a partir da data em que a chamada POST original foi feita.
submitAcknowledgement POST /vendor/orders/v1/acknowledgements Confirma (aceita ou rejeita) uma ou mais ordens de compra.
getPurchaseOrdersStatus GET /vendor/orders/v1/purchaseOrdersStatus Retorna os status da ordem de compra com base nos filtros que você especificar. A recuperação de dados é possível por um período máximo de seis meses a partir da data em que a chamada POST original foi feita.

Você pode usar o getPurchaseOrders operação para acessar pedidos criados ou alterados durante um período de tempo especificado (dentro de uma janela contínua dos últimos seis meses, após junho de 2020). Para otimizar o tempo de resposta, recomendamos que você limite o intervalo de tempo a no máximo sete dias.

Você pode usar o getPurchaseOrder operação para obter informações detalhadas do pedido para um pedido específico. Em seguida, você pode usar o submitAcknowledgement operação para aceitar ou rejeitar o pedido.

Depois de aceitar ou rejeitar seus pedidos, você pode usar o getPurchaseOrdersStatus operação para retornar o status de confirmação de uma ou mais ordens de compra.

📘

Observação

Você pode devolver os detalhes completos do pedido de compra ligando para o getPurchaseOrders operação ou devolva somente os números da ordem de compra com o includeDetails filtrar. O valor padrão desse parâmetro é verdadeiro, portanto, se você não incluir esse parâmetro de consulta, retornará os detalhes completos das ordens de compra. Se você usa includeDetails=false, a resposta incluirá somente uma lista dos números da ordem de compra e o estado atual de cada ordem de compra.

O diagrama a seguir mostra o fluxo de trabalho usando a API de pedidos de fornecedores.

The Vendor orders workflow.

getPurchaseOrders

O getPurchaseOrders A operação retorna uma lista de referências de pedidos (números e status do pedido de compra) ou detalhes completos do pedido, para todos os pedidos que atendem aos critérios especificados na solicitação. Se você estiver devolvendo somente referências de pedidos, elas poderão ser usadas posteriormente com o getPurchaseOrder operação para obter detalhes do pedido para um pedido específico.

Você deve usar essa API para disponibilizar pedidos de compra para atendimento. A Amazon recomenda que os fornecedores verifiquem os pedidos pelo menos uma vez por hora durante o horário comercial. Dependendo do volume de negócios, você pode optar por verificar com mais frequência. Você pode receber até 100 pedidos em uma chamada de API. Se houver mais de 100 pedidos, você pode usar nextToken para obter o próximo conjunto de pedidos.

Alterações e cancelamento de pedidos

Você pode devolver alterações e cancelamentos de pedidos usando a operação getPurchaseOrders.

Alterações no pedido: às vezes, a Amazon altera os dados do pedido de compra após a criação do pedido devido a uma mudança no requisito. Os fornecedores podem usar a API getPurchaseOrders para obter pedidos atualizados. Se a Amazon alterar um pedido de compra, o pedido terá um campo purchaseOrderChangedDate que é a data e hora em que a Amazon atualizou o pedido. Se esse campo não existir, o pedido nunca foi alterado após a criação.

📘

Observação

A Amazon também pode alterar o pedido de compra após você confirmá-lo.

Os fornecedores podem obter uma lista de pedidos que foram alterados dentro de um intervalo de datas especificado usando os parâmetros de consulta changedAfter e changedBefore. Isso retornará os pedidos que foram alterados pela Amazon dentro do intervalo de datas, e os fornecedores devem atender ao pedido de compra atualizado. Como alternativa, os fornecedores podem filtrar usando isPOChanged=true para obter todos os pedidos de compra alterados.

A Amazon recomenda executar uma chamada de API separada, com o intervalo de datas alterado, algumas vezes ao dia para receber os pedidos alterados por um dia. Por exemplo, quatro vezes por dia, você pode ligar para a operação de obtenção de pedidos de compra para que os pedidos sejam alterados nas últimas seis horas.

A seguir está uma lista de alterações que podem contribuir para alterações no pedido. Para essas alterações, você deve retirar o pedido alterado e enviar o pedido de compra correto:

  • Alteração da janela de entrega ou entrega
  • Atualizações de itens da ordem de compra, como alteração de quantidade, cancelamento de item, alteração de custo do item
  • Novo item adicionado na PO
  • PO cancelado/não cancelado
  • Tipo de PO alterada
  • Alteração no destino de entrega do pedido (centro de distribuição)
  • As informações da PO Freight foram alteradas

Cancelamento do item: Você também pode usar a API Vendor Orders, com o filtro poItemState=Cancelled, para devolver pedidos com um ou mais itens cancelados. Isso retornará todos os pedidos que tiveram um ou mais itens cancelados pela Amazon após a criação do pedido de compra. Isso ajudará você a receber somente os pedidos com itens cancelados (a quantidade solicitada é zero) e a garantir que você não envie os itens cancelados.

📘

Observação

O cancelamento do item se qualifica como uma alteração no pedido e, portanto, você também devolverá esses pedidos com a lista de pedidos alterados.

Estado do pedido de compra e código do fornecedor: O esquema da ordem de compra inclui o estado atual da ordem de compra e a hora da atualização do estado. Você pode usar o filtro purchaseOrderState para filtrar pedidos com base no estado atual.

Por exemplo, os fornecedores podem obter todos os pedidos de compra que ainda não foram reconhecidos ou atendidos usando purchaseOrderState=New.

Os fornecedores também podem obter pedidos de compra para um código de fornecedor específico fornecendo um dos códigos de fornecedor autorizado no filtro orderingVendorCode. Esse filtro retornará somente pedidos de compra gerados para o código do fornecedor mencionado no filtro.

Para obter detalhes sobre todos os filtros disponíveis, consulte a Referência da API de pedidos de fornecedores.

O diagrama a seguir mostra o fluxo de trabalho de integração ao recuperar uma ordem de compra:

The Vendor orders workflow when retrieving purchase orders.

getPurchaseOrder

O getPurchaseOrder A operação usa o número da ordem de compra para retornar as informações que você especifica sobre a ordem de compra. A resposta inclui informações completas da ordem de compra, incluindo detalhes, quantidade e custo do item de linha.

Use essa operação para obter os detalhes de pedidos específicos retornados pelo getPurchaseOrders operação.

O diagrama a seguir mostra o fluxo de trabalho de integração ao recuperar uma ordem de compra específica:

The Vendor orders workflow when retrieving a specific purchase order.

Requisitos comerciais

  • Pedidos com base no peso

    Para pedidos que contêm itens vendidos por peso, o unitOfMeasure campo (abaixo) listPrice e netCost) reflete a unidade de medida de peso real. Os valores da unidade de medida de peso incluem POUNDS, OUNCES, GRAMS, e KILOGRAMS.

  • Uso da janela de entrega ou janela de entrega

    Para fretes pagos pelo fornecedor, as informações da janela de entrega devem ser usadas. As datas são representadas no formato de intervalo de data e hora de acordo com ISO 8601. O formato é a data de início e término separadas por um hífen duplo (--). O campo de data de início representa a data mais próxima em que a Amazon espera que o frete seja entregue ao centro de distribuição da Amazon listado no pedido de compra. O campo de data de término representa a última data em que a Amazon espera que o frete seja entregue ao centro de distribuição da Amazon listado no pedido de compra.

    Use as informações da janela de envio para fretes pagos pela Amazon. A data é representada no formato de intervalo de data/hora de acordo com ISO 8601. O formato é a data de início e término separadas por um hífen duplo (--). O campo de data de início representa a data mais próxima em que a Amazon espera retirar o frete. A data de término representa a última data em que a Amazon espera retirar o frete. Se a mesma data estiver listada nos campos de data de início e data de término, leia essa data como a data em que a Amazon espera retirar o frete.

  • Pedidos pendentes são aceitáveis para um item de linha?

    Você deve ler o valor no campo isBackOrderAllowed. Quando verdadeiro, o pedido pode ser processado como um pedido pendente. Quando falso, pedidos pendentes não são permitidos.

  • Códigos de negócios

    Os códigos de oferta são códigos promocionais informados no campo do pedido dealCode. Qualquer informação relacionada ao código promocional, descontos especiais ou preços estará presente nesse campo.

  • Política de cancelamento de ordens pendentes

    Seu representante comercial da Amazon determina a política de pedidos pendentes. Discuta os detalhes com seu gerente de fornecedores.

📘

Observação

As datas de cancelamento do pedido pendente não podem ser enviadas no pedido. Você deve configurar a política de pedidos pendentes no nível da conta.

  • Use a API para alterar um pedido

    No momento, não é possível enviar uma alteração em um pedido usando a API. Depois que um pedido é feito, alterá-lo é um processo manual por meio da Central de Fornecedores.

Requisitos comerciais específicos do país

FuncionalidadeÍndiaEuropaAmérica do Norte
Custo líquidoCondicional. Custo líquido ou preço sugerido.Condicional. Custo líquido ou preço sugerido.Condicional. Custo líquido ou preço sugerido.
Preço sugeridoCondicional. Custo líquido ou preço sugerido.Condicional. Custo líquido ou preço sugerido.Condicional. Custo líquido ou preço sugerido.
Pedido pendenteNão aplicávelCompatívelCompatível
Parte compradoraO endereço da entidade compradora da AmazonO ID da parte atribuída para a parte compradoraNão aplicável
Parte vendedoraO Código do Fornecedor da Amazon atribuído ao fornecedorO Código do Fornecedor da Amazon atribuído ao fornecedorO Código do Fornecedor da Amazon atribuído ao fornecedor
Enviar para a parteO endereço da entidade de destinoO ID do grupo atribuído ao envio para a parteNão aplicável
Parte de cobrançaO endereço da entidade de cobrançaO endereço da entidade de cobrançaNão aplicável

submitAcknowledgement

Você pode usar o submitAcknowledgement operação para aceitar ou rejeitar uma ordem de compra para atendimento. A Amazon espera uma confirmação completa, incluindo todos os itens da linha da ordem de compra da ordem de compra. Se você não fornecer todos os itens de linha para o pedido de compra na confirmação, a Amazon rejeitará implicitamente os itens de linha que faltam.

A Amazon espera que você envie a confirmação o mais rápido possível; dentro de 24 horas, no máximo. A confirmação deve ser uma visão precisa das quantidades e datas reais da remessa.

Para qualquer alteração na quantidade, preço, datas de envio ou datas de entrega, a Amazon espera uma atualização da confirmação enviada pelo fornecedor dentro de 48 horas. O fornecedor pode enviar uma atualização de confirmação completa ou atualizar somente um item de linha específico. A Amazon sempre trata a atualização como uma substituição das confirmações anteriores do item de linha. Depois de 48 horas, esperamos receber apenas atualizações das datas de envio ou de entrega.

Se o primeiro código de confirmação para um item de linha específico fosse rejected, você não tem permissão para alterar isso com sua atualização para accepted ou backordered.

Verificação de confirmações de pedido enviadas com sucesso

Você pode verificar o status da versão original ou atualizada da confirmação do pedido usando Central de fornecedores ou usando o API de status da transação. Se a versão original ou atualizada não aparecer após 30 minutos, envie um caso de suporte na Central de Fornecedores navegando até Vendor Central > Support > Contact Us > API Integration.

O diagrama a seguir mostra o fluxo de trabalho de integração ao confirmar pedidos.

The Vendor orders workflow when acknowledging orders.

Requisitos comerciais

  • Um fornecedor pode aumentar a quantidade original enviada na ordem de compra ao confirmar um pedido?

    Não, você não pode enviar uma quantidade maior na confirmação do que a que foi enviada na ordem de compra.

  • É obrigatório enviar uma confirmação do pedido para cada pedido de compra?

    Sim, para atualizar o status de um pedido no sistema da Amazon corretamente, a Amazon exige a confirmação do pedido usando a API ou Central de fornecedores. Se você não conseguir atender aos nossos requisitos de confirmação de pedidos usando a API, deverá confirmar seus pedidos de compra usando Central de fornecedores. Entre em contato com seu representante comercial da Amazon se você não tiver um Central de fornecedores conta.

  • É obrigatório fornecer todos os itens da linha de pedido na confirmação do pedido correspondente?

    Sim, para que a Amazon possa atualizar o status do pedido corretamente.

  • Se um item de linha for colocado em espera, é necessário fornecer a quantidade na confirmação do pedido?

    Sim, para que o sistema Amazon possa atualizar o status do item de linha corretamente.

  • Como os itens inválidos ou obsoletos em um pedido devem ser relatados usando a confirmação do pedido?

    Não processe nem envie um item que chegou com um número de item inválido no pedido. Devolva o número do item inválido na confirmação e reconheça-o como invalid. Os seguintes códigos de confirmação indicam rejected devido ao item estar obsoleto:

    Rejeitado: a interpretação da Amazon é que a quantidade indicada com esse código não será entregue à Amazon como parte desse pedido de compra. Você deve enviar o motivo de rejeição apropriado como obsolete no reconhecimento. Isso indica que, devido ao item estar obsoleto, ele não deve mais ser pedido. A nomenclatura da Amazon para isso é “rejeição forçada”, o que significa que esse item não deve ser encomendado novamente. Se esse código for recebido duas vezes consecutivas para o mesmo projeto (separado por um intervalo de tempo de pelo menos 48 horas), o item não será pedido novamente.

📘

Observação

A Amazon espera uma confirmação mesmo que todos os itens de linha do pedido de compra sejam inválidos e não tenham produzido um pedido ou fatura. Se uma confirmação correspondente não puder ser enviada para um pedido de compra, a Amazon exigirá a notificação manual de itens inválidos. Você pode notificar sua equipe de compras por meio do Central de fornecedores Contact Us link.

  • Preciso devolver o mesmo identificador do produto na confirmação que recebi na transação do pedido?

    As confirmações devem retornar exatamente o mesmo identificador do produto que foi enviado na ordem de compra.

  • É necessário fornecer o preço na confirmação?

    Sim, os fornecedores devem devolver o preço de custo unitário na confirmação. O preço de custo deve corresponder ao preço de custo unitário que será faturado. Os vendedores de livros devem fornecer um preço sugerido e um multiplicador de descontos.

  • O preço da ordem de compra pode ser simplesmente devolvido na confirmação?

    Não. Independentemente do preço enviado no pedido de compra, a Amazon exige o preço de custo na confirmação. O preço de custo enviado na confirmação deve corresponder ao preço de custo enviado na fatura. Os sistemas de pagamento da Amazon compararão os dois e poderão atrasar o pagamento se eles não corresponderem.

  • O que a Amazon.com exige se o preço e/ou a disponibilidade mudarem após a transmissão da confirmação inicial?

    Forneça uma notificação manual sobre quaisquer alterações nos pedidos da Amazon após a transmissão da confirmação inicial. Seu representante Amazon.com Business pode aconselhar você sobre quando, como e a quem notificar.

  • É necessário fornecer dados de preços para itens em espera?

    Sim, isso é necessário para que a Amazon possa atualizar o status do pedido corretamente. Se o preço for omitido, isso fará com que a confirmação seja rejeitada.

  • Como saberei se pedidos pendentes são permitidos ou não?

    Você deve ler o valor no isBackOrderAllowed campo na ordem de compra. Um valor verdadeiro indica que pedidos pendentes são permitidos. Um valor falso indica que pedidos pendentes não são permitidos.

  • É necessário fornecer um código de confirmação para todos os itens de linha, independentemente do status?

    Sim, é necessário para que possamos atualizar corretamente o status do pedido. Se o código de confirmação for omitido, a confirmação será rejeitada.

  • Qual é a política da Amazon sobre remessas parciais? Como as remessas parciais devem ser relatadas ao enviar uma confirmação do pedido?

    Remessas parciais são permitidas se a ordem de compra permitir pedidos pendentes (quando isBackOrderAllowed é true). A Amazon recomenda que você indique um ciclo de confirmação usando o código accepted com a data correspondente e outro ciclo de confirmação usando o código backordered e a data correspondente.

    Aceito: para os itens que podem ser entregues imediatamente.

    Pedido pendente: para a quantidade restante que não pode ser processada imediatamente. A quantidade restante (quantidade solicitada menos toda a quantidade confirmada) será entregue posteriormente (pedido pendente).

  • Quando devo usar o segmentolistPrice?

    O segmento listPrice só é necessário se um fornecedor vender livros com um preço sugerido.

Requisitos comerciais específicos do país

FuncionalidadeÍndiaEuropaAmérica do Norte
Data de envio programadaCondicional. Depende dos termos do frete e do acordo comercial atual com o fornecedor.OpcionalOpcional
Data de entrega programadaCondicional. Depende dos termos do frete e do acordo comercial atual com o fornecedor.OpcionalOpcional
Preço sugeridoNecessário apenas para vendedores de livrosCompatívelNecessário apenas para vendedores de livros

Obter status de pedidos de compra

O getPurchaseOrdersStatus a operação retorna o status da lista de pedidos de compra que atendem aos critérios especificados na solicitação. Você pode usar essa operação para obter o status de confirmação dos itens em pedidos de compra disponíveis para processamento. Essa operação retorna o histórico da quantidade solicitada e das confirmações de um item. Você pode ver os detalhes de todas as confirmações processadas para um item em uma ordem de compra. Fornecemos uma ampla variedade de parâmetros de consulta para filtrar a lista de PoS de acordo com sua necessidade.

Você pode devolver até 100 pedidos em uma chamada de API. Se houver mais de 100 pedidos, você pode usar nextToken para obter o próximo conjunto de pedidos.

Aqui estão alguns exemplos de como você pode usar a operação getPurchaseOrdersStatus com diferentes parâmetros de consulta:

  • Você pode obter o status de todas as ordens de compra abertas dentro de um intervalo de datas especificado usando a data de criação da PO (createdBefore e createdAfter) ou a data de atualização da PO (updatedBefore e updatedAfter) junto com purchaseOrderStatus=OPEN.

  • Você pode usar o getPurchaseOrdersStatus operação para filtrar o status do PoS. Por exemplo, se itemConfirmationStatus=REJECTED, a resposta retornará todos os pedidos que tenham um ou mais itens como rejeitados.

  • Você pode verificar o status de uma PO específica fornecendo o número da PO no parâmetro de consulta purchaseOrderNumber.

  • Você pode obter o status de todas as POs abertas geradas para um código de fornecedor específico fornecendo o valor do código do fornecedor em orderingVendorCode e incluindo purchaseOrderStatus=OPEN.

  • Você pode obter o status de todas as POs criadas em um intervalo de tempo que precisam ser enviadas para um Centro de Distribuição da Amazon específico fornecendo o código do centro de distribuição (FC) em shipToPartyId e o intervalo de tempo em createdBefore e createdAfter.

Casos de uso de pedido de compra e confirmação

Item de linha inválido na ordem de compra

Se você receber um identificador de produto inválido no pedido de compra, rejeite o item com um código de confirmação Rejected e o rejectionReason como InvalidProductIdentifier:

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

Confirmação da ordem 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" } ] } ] } ] }

Status da ordem 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 } } ] } } ] } ] } }

Item de linha obsoleto na ordem de compra

Se você receber um produto obsoleto no pedido de compra, você deve rejeitar o item com um código de confirmação Rejected e o rejectionReason como ObsoleteProduct.

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

Confirmação da ordem 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" } ] } ] } ] }

Confirme a quantidade parcial do item e solicite o restante da quantidade

A Amazon encomendou 10 quantidades de itens. O fornecedor planeja dividir as remessas e, portanto, envia um Accepted quantidade de itens de seis e um BackOrdered quantidade de itens de quatro para indicar que seis unidades serão enviadas na primeira remessa e quatro unidades na segunda.

Ordem de compra — (Importar ordem 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" } } ] } } }

Confirmação da ordem 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" } ] } ] } ] }

Depois de enviar a primeira parte do pedido, o fornecedor informa a Amazon uma data mais precisa da segunda remessa usando scheduledShipDate para os itens em espera. Observe que os fornecedores devem sempre enviar atualizações completas com a quantidade total solicitada para itens de linha individuais. As atualizações completas fornecem visibilidade explícita das quantidades.

Status da ordem 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 } } ] } } ] } ] } }

Várias confirmações para cancelar quantidades inicialmente aceitas

Você pode usar isso quando descobrir que não pode atender algumas ou todas as unidades de um pedido que foram inicialmente aceitas e quiser informar à Amazon que essas unidades não serão enviadas.

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

Confirmação da ordem de compra

O fornecedor inicialmente aceitou a quantidade.

{ "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, o fornecedor não consegue atender à quantidade aceita e envia um cancelamento total ou parcial por meio de outra solicitação de confirmação do ordem de compra.

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

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

Status do pedido de compra após o cancelamento parcial subsequente

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

O que é a API de envios do fornecedor?

Você pode usar o API de remessas de fornecedores (API de remessas) para trocar documentos relacionados à remessa com a Amazon.

As seguintes operações estão incluídas na API de envios:

Operação Método HTTP Path Descrição
SubmitShipmentConfirmations POST /vendor/shipping/v1/shipmentConfirmations Envie uma ou mais confirmações de envio para a Amazon.
GetShipmentDetails GET /vendor/shipping/v1/shipments Obtenha os detalhes da remessa da solicitação de transporte enviada à Amazon. A recuperação de dados é possível por um período máximo de seis meses a partir da data em que a solicitação de remessa foi criada.
SubmitShipments POST /vendor/shipping/v1/shipments Envie solicitações de transporte únicas ou múltiplas para a Amazon.

SubmitShipmentConfirmations

Você pode usar o SubmitShipmentConfirmations operação para enviar confirmações de envio para a Amazon. Com a confirmação de sua remessa, podemos receber e processar suas remessas com eficiência. Ele contém informações sobre os itens que estão sendo enviados, incluindo número do pedido de compra, data de envio, data estimada de entrega, número do lote, data de validade e o Serial Shipping Container Code (SSCC).

Ao receber uma confirmação de envio válida e oportuna, podemos antecipar corretamente as remessas que você nos envia. Algumas vantagens de enviar confirmações de envio incluem:

  • A Amazon pode colaborar de forma mais eficaz com as transportadoras no rastreamento e recebimento de suas remessas. Isso nos permite planejar com eficácia nossos recursos de mão de obra e ajuda a garantir um recebimento mais rápido e eficiente de sua remessa, o que significa que você pode faturar seu PoS com mais rapidez.

  • A Amazon pode acompanhar o estoque recebido e criar pedidos automatizados para garantir que os itens não fiquem esgotados.

  • Maior visibilidade dos produtos em trânsito, o que nos permite refletir com mais precisão a disponibilidade do item (entrega por período) para os clientes finais.

  • Com as políticas de cancelamento de pedidos de compra da Amazon, remessas pendentes de pedidos de compra podem ser canceladas. No entanto, os PoS com confirmação precisa da remessa alertam nossos sistemas internos sobre o status em trânsito. Isso pode ajudar a evitar cancelamentos desnecessários de pedidos de compra, estornos e recusas de frete.

A falta de confirmações de envio válidas pode resultar em:

  • Visibilidade inadequada para remessas recebidas.
  • Erros na reconciliação das remessas físicas com os pedidos de compra.
  • Acompanhamento manual para resolver discrepâncias.
  • A necessidade de fornecer comprovante de entrega (PODs) para faturamento.

Confirmação de envio - Substituir

Quando uma confirmação de remessa tem um shipmentConfirmationType do Replace, você pode corrigir as confirmações de envio enviadas anteriormente enviando uma versão atualizada. A segunda chamada de confirmação de remessa substituirá completamente os dados de confirmação da primeira remessa.

A principal vantagem é melhorar a precisão da reserva atualizando as confirmações de envio erradas após o envio inicial.

Como isso funciona?

Para substituir uma confirmação de remessa enviada anteriormente, uma segunda confirmação de remessa pode ser enviada. O shipmentIdentifier e sellingParty.partyId precisam ser idênticos para ambas as transmissões, para que possamos substituir com êxito a versão anterior da confirmação de envio.

Escopo da confirmação de envio - Substituir

  • Todos os valores de confirmação de remessa podem ser editados, exceto o shipmentIdentifier e sellingParty.partyId, que precisam permanecer idênticos para uma confirmação de envio bem-sucedida - Substituir.

  • O palete, a caixa e a quantidade enviada não podem ser aumentados, apenas reduzidos. Para aumentar os volumes, você precisa enviar uma segunda confirmação de remessa com um novo shipmentIdentifier. Você pode usar a mesma referência BOL se as unidades adicionais forem entregues com a mesma remessa.

  • Uma confirmação de remessa enviada usando a API só pode ser editada enviando outra confirmação de remessa usando a API. Uma confirmação de envio criada em Central de fornecedores não pode ser editado usando a API.

  • A substituição de uma confirmação de remessa só é possível dentro de 7 dias após a confirmação inicial da remessa e somente se a remessa ainda não tiver chegado ao centro de distribuição da Amazon.

Verificação das confirmações de envio enviadas com sucesso

Você pode verificar o status de suas confirmações de remessa originais ou substituídas por meio de Central de fornecedores > Ordens > Remessas ou usando a API de status da transação. O sistema pode levar até 30 minutos para mostrar a versão original/substituída após o envio. Se Central de fornecedores não está mostrando os valores corretos para a confirmação da remessa substituída, abra um Contact Us caso em Central de fornecedores.

O diagrama a seguir mostra o fluxo de trabalho de integração ao enviar confirmações de remessa.

The Vendor shipments workflow when submitting shipment confirmations.

Requisitos comerciais

  • Quando um fornecedor envia itens vendidos por peso, ele deve fornecer a totalWeight campo. O totalWeight O campo contém o peso dos itens que o fornecedor envia e a unidade de medida de peso. Os valores da unidade de medida de peso incluem POUNDS, OUNCES, GRAMS, e KILOGRAMS.

  • Há um limite de 100 confirmações de remessa para cada remessa de carga de caminhão. Isso significa que você pode enviar uma confirmação de remessa separada no nível do pedido ou da caixa somente se o número total de confirmações de remessa individuais for menor ou igual a 100 para aquela remessa de carga de caminhão (TL) /menor que a carga de caminhão (LTL). Recomendamos que você envie uma única confirmação de remessa para toda a remessa TL/envio de carga fracionada, incluindo todos os detalhes do pedido e da embalagem.

  • A Amazon deve receber a confirmação do envio antes que o produto seja recebido no centro de distribuição da Amazon. A confirmação da remessa perdida ou atrasada resultará em estornos.

  • Para remessas de pacotes pequenos, é necessária uma confirmação de envio para cada pacote/caixa.

  • O seguinte é exigido pela Amazon e é medido para monitorar a conformidade:

    • Para entregas paletizadas, você deve enviar uma confirmação de envio antes de solicitar um horário de entrega no centro de distribuição da Amazon, pois os agendamentos só são fornecidos se uma confirmação de remessa válida for encontrada nos sistemas da Amazon. Para exceções, consulte a confirmação de remessa local Socorro páginas para entender as opções disponíveis. Para pacotes, a confirmação da remessa precisa ser enviada antes do envio dos itens. A confirmação de envio ausente ou atrasada resultará em estornos.
    • A confirmação da remessa deve ser para uma entrega, de um fornecedor e para apenas um caminhão. Remessas em vários caminhões, para vários centros de distribuição da Amazon, de várias contas de fornecedores ou com chegadas em vários dias exigem várias confirmações de remessa.
    • Se várias remessas menores para a mesma conta de fornecedor forem combinadas em uma remessa maior e várias confirmações de remessa forem necessárias, você poderá usar a opção abrangente BOL conforme mostrado no exemplo a seguir:

Confirmação de envio 1

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

Confirmação de envio 2

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

Requisitos comerciais específicos do país

Funcionalidade Definição de negócios Índia Europa América do Norte
Número de conhecimento de carga eletrônico/cotação de entrega

O número BOL é o número exclusivo atribuído pelo fornecedor. O BOL presente na confirmação da remessa corresponde idealmente ao BOL em papel fornecido com a remessa, mas isso não é obrigatório. Consulte Explicações adicionais de campo para obter mais informações. A referência BOL é usada para agendamento de consultas e criação de etiquetas de remessa.

O número da cotação de entrega é uma alternativa a um BOL como número de referência para uma remessa.

Condicional

Obrigatório para todas as confirmações de envio. Obrigatório para remessas FTL ou LTL.
Número de referência da remessa da transportadora (PRO#) O número de referência da remessa da transportadora (Número Pro) é um número exclusivo atribuído pela operadora. Ele é usado para identificar e rastrear a remessa que sai para entrega. Obrigatório para todas as confirmações de envio. Opcional Obrigatório para todas as confirmações de envio.
Data de envio Data em que a remessa sai do depósito do fornecedor.

Obrigatório para todas as confirmações de envio.

Obrigatório para todas as confirmações de envio. Obrigatório para todas as confirmações de envio.
Data de entrega prevista

Data em que se espera que a remessa chegue ao centro de distribuição da Amazon. Precisa ser uma estimativa baseada no tempo médio de trânsito entre o local de origem da remessa e o destino. A hora exata do compromisso será fornecida pela Amazon e pode não ser conhecida ao criar a remessa.

Obrigatório para todas as confirmações de envio.

Obrigatório para todas as confirmações de envio. Obrigatório para todas as confirmações de envio.
Contagem de caixas Número de caixas presentes na remessa. As unidades empilhadas no palete sem a embalagem externa são contadas como 1 unidade = 1 caixa. A contagem de caixas é exigida no nível da remessa. Obrigatório para todas as confirmações de envio. Obrigatório para todas as confirmações de envio. Obrigatório para todas as confirmações de envio.
Contagem de paletes Número de paletes presentes na remessa. Para remessas de pacotes puros, o valor 0 precisa ser indicado. Todos os volumes que atingem o CD em um palete precisam ter um mínimo de 1 indicado neste segmento. As informações são necessárias no nível da remessa. Obrigatório para todas as confirmações de envio para entregas paletizadas. Obrigatório para todas as confirmações de envio. Obrigatório para remessas FTL e LTL.
Código alfa da operadora padrão (SCAC) Código que identifica a transportadora da remessa. O Código alfa padrão da operadora (SCAC) é um código exclusivo de duas a quatro letras usado para identificar uma operadora. Os códigos SCAC da transportadora são atribuídos e mantidos pela NMFTA (National Motor Freight Association). Opcional Opcional Obrigatório para todas as confirmações de envio.
Local de envio (enviar para) ID da parte/código do armazém do local para onde os produtos estão sendo enviados. O nome do campo do esquema da API é “ShipToParty” Obrigatório para todas as confirmações de envio. Obrigatório para todas as confirmações de envio. Obrigatório para todas as confirmações de envio.
Identificação do fornecedor Identificação do fornecedor que envia as mercadorias para a Amazon. O nome do campo do esquema da API é “SellingParty”. Obrigatório para todas as confirmações de envio. Obrigatório para todas as confirmações de envio. Opcional
Enviar de Endereço (CEP) e referência do país do local de onde os produtos são enviados fisicamente. Obrigatório para todas as confirmações de envio. Obrigatório para todas as confirmações de envio. Obrigatório para todas as confirmações de envio.
Número de referência da Amazon (somente para remessas WePay). Número de referência da Amazon conforme recebido nas instruções de roteamento (GetShipmentDetails resposta) para uma remessa WePay. Obrigatório somente para confirmações de envio

(para remessas WePay).

Obrigatório somente para confirmações de envio

(para remessas WePay).

Obrigatório para remessas a cobrar.
Número da ordem de compra Número da ordem de compra da Amazon. Autorização por escrito para um fornecedor enviar produtos a um preço especificado, que se torna um contrato legalmente vinculativo quando o fornecedor o aceita. Obrigatório no nível do cabeçalho ou do item de linha. Obrigatório no nível do cabeçalho ou do item de linha. Obrigatório no nível do cabeçalho ou do item de linha.
Código de contêiner de remessa serial (SSCC) Código de contêiner de remessa serial (SSCC) exclusivo de 18 dígitos a ser incluído para definir um palete/caixa. Recomendado para todas as confirmações de envio dentro da unidade de embalagem. Obrigatório para todas as confirmações de envio dentro da unidade de embalagem. Obrigatório para todas as confirmações de envio dentro da unidade de embalagem.
Identificação do item Código SKU do fornecedor do produto. Obrigatório para todas as confirmações de envio. Obrigatório para todas as confirmações de envio. Obrigatório para todas as confirmações de envio.
Número do lote O número do lote ou lote associa um item às informações que o fabricante considera relevantes para a rastreabilidade do item comercial ao qual a cadeia de elementos é aplicada. Os dados podem se referir ao item comercial em si ou aos itens contidos. Obrigatório para itens perecíveis. Obrigatório para itens perecíveis. Obrigatório para itens perecíveis.
Data de expiração A data que determina o limite de consumo ou o uso de um produto. Seu significado é determinado com base no contexto do item comercial. Obrigatório para itens perecíveis. Obrigatório para itens perecíveis. É necessário ter a data de validade ou a data do fabricante e o prazo de validade.
Data de fabricação Data de produção, embalagem ou montagem determinada pelo fabricante. Seu significado é determinado com base no contexto do item comercial. Opcional Opcional É necessário ter a data de validade ou a data do fabricante e o prazo de validade.
Quantidade Número de unidades enviadas para um item específico. Obrigatório para todas as confirmações de envio. Obrigatório para todas as confirmações de envio. Obrigatório para todas as confirmações de envio.

Explicações adicionais de campo

Número do Conhecimento de Embarque

O número do Conhecimento de Embarque (BOL#) é o número de referência necessário para a reserva de consultas na Amazon. Essa referência deve ser fornecida quando a Amazon solicitar uma confirmação de envio válida. É o número de referência padrão do documento que acompanha a remessa física. O BOL# na confirmação da remessa deve corresponder ao BOL# fornecido na documentação da remessa.

Ao definir o BOL#, certifique-se de que ele seja exclusivo para cada remessa. Seu BOL# pode ser a referência física do BOL, mas se você optar por um número diferente:

  • Use no mínimo oito dígitos.
  • Usar o código do fornecedor da Amazon como prefixo (por exemplo: ABCD193939393).
  • Não use uma data ou hora.
Identificação da remessa

Esse campo é uma ID exclusiva (a exclusividade é definida dentro do contexto do fornecedor) que representa essa confirmação de remessa. Falha em fornecer um Shipment Identification resultará na rejeição da confirmação da remessa. Certifique-se de que a ID enviada não tenha sido usada nos últimos 365 dias.

Data de envio

Esse campo indica a data de partida da remessa do local do fornecedor. Solicita-se que os fornecedores enviem as confirmações de remessa antes que o frete chegue ao Amazon FC.

Data de entrega prevista

Essa é uma estimativa aproximada, com base na experiência, de quando se espera que uma remessa seja entregue ao centro de distribuição da Amazon. Os fornecedores devem determiná-la com base no tempo médio de trânsito da transportadora. Essas informações nos ajudam a planejar a remessa se não obtivermos uma data de entrega prevista da transportadora.

Essa data precisa ser fornecida para cada remessa, mesmo que a data do agendamento seja potencialmente desconhecida neste estágio.

Código de contêiner de remessa em série (SSCC)

A Amazon processa recibos usando uma abordagem altamente automatizada chamada License Plate ou LP Receive, e esse processo exige que você forneça detalhes do conteúdo da embalagem em suas mensagens de confirmação de envio. Esse processo de recebimento obrigatório digitaliza um código de barras do Serial Shipment Container Code (SSCC) na parte externa de uma caixa ou palete de itens recebidos, eliminando a necessidade de escanear cada item dentro da caixa ou palete. Esse processo tem várias vantagens significativas, incluindo maior eficiência, maior precisão de recebimento, pagamento mais preciso e tempo de ciclo de pagamento mais rápido.

Você pode escolher uma solução técnica, pois a Amazon decidiu não seguir rigorosamente a solução GS1-128. Para estar em conformidade com os requisitos de matrícula da Amazon, um SSCC deve ser um código exclusivo de 18 dígitos que define um palete ou caixa, não pode ser repetido em 365 dias e deve incluir um código de barras na etiqueta da embalagem e na mensagem de confirmação da remessa. Além disso, o código de barras na etiqueta física deve corresponder 100% ao SSCC na confirmação da remessa. Os fornecedores que desejam implementar o GS1-128 devem adicionar um 00 no início do SSCC, dentro da confirmação da remessa.

Para obter mais informações sobre como gerar um SSCC e os requisitos para a remessa física, consulte Central de fornecedores. Para localizar o Manual do Fornecedor com os requisitos de rotulagem, selecione Remessa, então Etiqueta da placa de licença e requisitos de recebimento.

Data de expiração

A data de validade é a data que determina o limite de consumo ou uso de um produto. É determinado com base no contexto do item comercial (por exemplo, para alimentos, isso indica a possibilidade de um risco direto à saúde resultante do uso do produto após a data; para produtos farmacêuticos, indica a possibilidade de um risco indireto à saúde resultante da ineficácia do produto após a data). Geralmente é chamada de “data de validade” ou “data máxima de durabilidade”.

Data de fabricação

Esta é a data em que as mercadorias foram embaladas ou fabricadas. Esse campo deve ser fornecido se um item for perecível ou tiver um prazo de validade definido.

Número do lote

O número do lote ou lote associa um item às informações que o fabricante considera relevantes para a rastreabilidade do próprio item ou dos ingredientes contidos no item. O número pode indicar um lote de produção, um turno de trabalho, uma máquina, um horário ou um código de produção interno.

Uso da data de vencimento/data de fabricação/números de lote na confirmação da remessa

Esses campos são obrigatórios somente para itens perecíveis, ou seja, para aqueles itens em que o is expiration dated product atributo é Yes no formulário de configuração do novo item (NIS).

Quando você define as datas de vencimento, as datas de fabricação ou os números de lote na confirmação da remessa:

  • Datas de expiração/datas de fabricação/números de lote devem ser enviados no nível do item.

  • Uma caixa/palete pode ter vários itens (ASINs), cada um com datas de vencimento/datas de fabricação/números de lote individuais.

  • Um item (ASIN) não deve ter várias datas de vencimento/datas de fabricação/números de lote na mesma caixa/palete.

Os fornecedores devem informar a data de validade e a data de fabricação na confirmação da remessa no formato AAAAMMDD.

Casos de uso de confirmação de envio

Estojo padrão para pacotes pequenos com vencimento e números de lote

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

Pequeno LooseAssortmentCase pacote com vencimento e 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 caminhão paletizada com vários itens

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

Remessa com menos de uma carga de caminhão com caixas padrão 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" ] } } ] } ] }

Envio de menos de carga por caminhão de paletes ASIN únicos

{ "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 está disponível somente nos mercados da América do Norte e da UE.

O SubmitShipments A operação foi projetada para que os fornecedores Collect ou WePay enviem solicitações para a coleta de suas remessas pela Amazon. Com essa operação, eles também podem atualizar ou cancelar solicitações enviadas. Você pode consolidar vários pedidos que estão prontos para serem enviados e solicitar transporte por meio de uma única solicitação de remessa, economizando tempo e reduzindo custos. Ao enviar uma solicitação de remessa, a data de coleta solicitada deve ser no mínimo dois dias úteis após a data atual.

📘

Observação

O SubmitShipments A operação não suporta o envio de solicitações de remessa para paletes não padrão.

Criar ou atualizar a remessa
Quando o transactionType para uma solicitação de remessa é New, você pode criar uma nova solicitação ou atualizar uma solicitação de remessa enviada anteriormente. As atualizações em uma solicitação de remessa existente são feitas com base na ID de remessa do fornecedor. Se uma remessa com a ID de remessa do fornecedor fornecida já existir, uma operação de atualização ocorrerá; caso contrário, uma nova remessa será criada.

Escopo da remessa de atualização:

  • Todos os valores da solicitação de remessa são editáveis, exceto vendorShipmentIdentifier,buyerReferenceNumber, e sellingParty.partyId que devem permanecer idênticos para uma atualização bem-sucedida. Você tem a flexibilidade de modificar todos os outros campos na solicitação de remessa antes que a transportadora seja designada.
  • A data de coleta solicitada na solicitação de remessa só pode ser modificada após a designação da transportadora.

Cancelar envio
Uma solicitação de remessa com transactionType como Cancel permite que você cancele uma solicitação de remessa enviada anteriormente. Para cancelar uma solicitação de remessa enviada anteriormente, você deve fornecer vendorShipmentIdentifier, buyerReferenceNumber, sellingParty.partyId, shipFromParty.partyId, shipToParty.partyId e transactionType como Cancel.

Escopo do cancelamento de envio:

  • O cancelamento de uma solicitação de remessa é possível antes e depois de uma transportadora ter sido designada e o roteamento ser agendado.

Verificação de solicitações de remessa enviadas com sucesso

Você usa Central de fornecedores ou o API de status de transação do fornecedor para verificar o status da sua solicitação de remessa. Se o status da solicitação publicada não aparecer após 30 minutos, envie um caso de suporte na Central de Fornecedores navegando até Vendor Central > Support > Contact Us > API Integration.

📘

Observação

A API Transaction Status suporta apenas Processing e Failure valores de status para envio Cancelar envio solicitações.

O diagrama a seguir mostra o fluxo de trabalho de integração ao enviar solicitações de remessa.

The Vendor Submit shipment workflow.

Requisitos comerciais

  • A solicitação de remessa deve ser enviada somente quando o PO correspondente for completamente confirmado. Se o pedido de compra ainda não tiver sido confirmado, a solicitação de remessa não será processada.
  • O requestedPickUp na solicitação de envio, deve ser no mínimo dois dias úteis após a data atual.
  • Todos os valores da solicitação de remessa são editáveis, exceto vendorShipmentIdentifier, buyerReferenceNumber, e sellingParty.partyId, que devem permanecer idênticos para uma atualização bem-sucedida. Você tem a flexibilidade de modificar todos os outros campos na solicitação de remessa antes que a transportadora seja designada.
  • Você só pode modificar a data de coleta solicitada na solicitação de envio após a atribuição de uma transportadora.
  • O cancelamento de uma solicitação de remessa é possível antes e depois de uma transportadora ter sido designada e o roteamento ser agendado.

Explicações adicionais de campo

Identificador de remessa do fornecedor

Esse campo é uma ID exclusiva (a exclusividade é definida dentro do contexto do fornecedor), que representa essa Solicitação de Transporte. Falha em fornecer um vendorShipmentIdentifier resultará na rejeição da Solicitação de Transporte. Certifique-se de que a ID enviada não tenha sido usada nos últimos 365 dias.

Data de coleta solicitada

Esse campo também é chamado Freight Ready Date, é usado para especificar a primeira data de coleta da remessa no local do fornecedor. Você deverá enviar a Solicitação de Transporte quando os itens estiverem prontos para serem retirados.

Envie exemplos de solicitações de remessa

Criar ou atualizar a solicitação de remessa

{ "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 solicitação de envio

{ "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 é apenas para WePay e coleta pedidos nos mercados da América do Norte e da UE.

Você pode usar o GetShipmentDetails operação para recuperar informações de coleta programada e atribuição da transportadora. Você deve usar SubmitShipments ou uma solicitação de roteamento antes que os detalhes da remessa estejam disponíveis. GetShipmentDetails só retorna uma resposta após a atribuição da transportadora, que ocorre no mesmo dia da coleta programada ou um dia antes da data de coleta.

Os detalhes retornados na resposta ajudam você a executar seu processo de envio com eficiência, garantir que o pedido seja embalado e que esteja pronto para ser retirado pela transportadora na data de coleta designada. A qualquer momento durante o ciclo de vida da remessa, você pode usar essa operação para visualizar o status e os detalhes da remessa. Essa operação é usada principalmente pelos fornecedores do WePay.

O diagrama a seguir mostra o fluxo de trabalho de integração do Vendor Get Shipping.

The Vendor Get shipment workflow.

Requisitos comerciais

  • O GetShipmentDetails A operação só fornecerá uma resposta se a criação da remessa for bem-sucedida. A resposta contém o Número de Referência da Amazon (ARN) e outros detalhes da remessa. Os detalhes da atribuição da transportadora estão disponíveis somente após a atribuição da remessa pela transportadora. A atribuição da transportadora ocorre no mesmo dia da coleta programada ou um dia antes da data de coleta.

  • O GetShipmentDetails a operação não fornecerá detalhes para remessas enviadas por meio de Central de fornecedores.

GetShipmentDetails obrigatório

Para devolver uma fatura do cliente, chame a operação GetShipmentDetails e passe o seguinte parâmetro:

Parâmetros de consulta:

Nome Descrição Obrigatório
limit O limite do número de registros retornados.

Tipo: int

Não
sortOrder Classifique a lista por data de criação da remessa em ordem crescente ou decrescente.

Tipo: string

Tipo: enum ( SortOrder )

Não
nextToken Usado para paginação quando há mais etiquetas de endereço do que o limite de tamanho de resultado especificado. O valor do token é retornado na chamada anterior da API.

Tipo: string

Não
createdAfter As remessas criadas após esse período serão incluídas no resultado. Esse campo deve estar em ISO 8601 formato de data/hora.

Tipo: string (data e hora)

Não
createdBefore As remessas criadas antes dessa data serão incluídas no resultado. Esse campo deve estar em ISO 8601 formato de data/hora.

Tipo: string (data e hora)

Não
shipmentConfirmedBefore Use para fornecer a data para recuperar os detalhes da remessa de todas as remessas confirmadas antes dessa data. Esse campo deve estar em ISO 8601 formato de data/hora.

Tipo: string (data e hora)

Não
shipmentConfirmedAfter Use para fornecer a data para recuperar os detalhes da remessa de todas as remessas confirmadas após essa data. Esse campo deve estar em ISO 8601 formato de data/hora.

Tipo: string (data e hora)

Não
packageLabelCreatedBefore Use para fornecer a data para obter os detalhes da remessa de todas as remessas para as quais as etiquetas de embalagem foram criadas antes dessa data. Esse campo deve estar em ISO 8601 formato de data/hora.

Tipo: string (booleano)

Não
packageLabelCreatedAfter Use para fornecer a data para recuperar os detalhes da remessa de todas as remessas para as quais as etiquetas de embalagem foram criadas após essa data. Esse campo deve estar em ISO 8601 formato de data/hora.

Tipo: string (data e hora)

Não
shippedBefore Use para fornecer a data para recuperar os detalhes da remessa de todas as remessas cuja data de envio é anterior a essa data. Esse campo deve estar em ISO 8601 formato de data/hora.

Tipo: string (data e hora)

Não
shippedAfter Use para fornecer a data para recuperar os detalhes da remessa de todas as remessas cuja data de envio seja posterior a essa data. Esse campo deve estar em ISO 8601 formato de data/hora.

Tipo: string (data e hora)

Não
estimatedDeliveryBefore Use para fornecer a data para recuperar os detalhes da remessa de todas as remessas cuja data de entrega estimada seja anterior a essa data. Esse campo deve estar em ISO 8601 formato de data/hora.

Tipo: string (data e hora)

Não
estimatedDeliveryAfter Use para fornecer a data para recuperar os detalhes da remessa de todas as remessas com data estimada de entrega após essa data. Esse campo deve estar em ISO 8601 formato de data/hora.

Tipo: string (data e hora)

Não
shipmentDeliveryBefore Use para fornecer a data para recuperar os detalhes da remessa de todas as remessas com data de entrega da remessa antes dessa data. Esse campo deve estar em ISO 8601 formato de data/hora.

Tipo: string (data e hora)

Não
shipmentDeliveryAfter Use para fornecer a data para recuperar os detalhes da remessa de todas as remessas para as quais a data de entrega da remessa é posterior a essa data. Esse campo deve estar em ISO 8601 formato de data/hora.

Tipo: string (data e hora)

Não
requestedPickUpBefore Use para fornecer a data para recuperar os detalhes da remessa de todas as remessas para as quais a data de coleta solicitada é anterior a essa data. Esse campo deve estar em ISO 8601 formato de data/hora.

Tipo: string (data e hora)

Não
requestedPickUpAfter Use para fornecer a data para recuperar os detalhes da remessa de todas as remessas para as quais a data de coleta solicitada é posterior a essa data. Esse campo deve estar em ISO 8601 formato de data/hora.

Tipo: string (data e hora)

Não
scheduledPickUpBefore Use para fornecer a data para recuperar os detalhes da remessa de todas as remessas para as quais a data de coleta programada é anterior a essa data. Esse campo deve estar em ISO 8601 formato de data/hora.

Tipo: string (data e hora)

Não
scheduledPickUpAfter Use para fornecer a data para recuperar os detalhes da remessa de todas as remessas para as quais a data de coleta programada é posterior a essa data. Esse campo deve estar em ISO 8601 formato de data/hora.

Tipo: string (data e hora)

Não
currentShipmentStatus Obtenha os detalhes da remessa informando o status atual da remessa.

Tipo: string

Não
vendorShipmentIdentifier Obtenha os detalhes da remessa passando o ID de remessa do fornecedor.

Tipo: string

Não
buyerReferenceNumber Obtenha os detalhes da remessa passando o ID de referência do comprador.

Tipo: string

Não
buyerWarehouseCode Obtenha detalhes de envio com base no código do depósito do comprador. Esse valor deve ser igual ao shipToParty.partyId na remessa.

Tipo: string

Não
sellerWarehouseCode Obtenha detalhes de envio com base no código do depósito do fornecedor. Esse valor deve ser igual ao sellingParty.partyId na remessa.

Tipo: string

Não

Exemplo de solicitação:

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

Script GetShipmentDetails

Exemplo de resposta:

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

Você pode usar o GetShipmentLabels operação para obter etiquetas de remessa da Amazon exclusivamente para remessas de pequenos pacotes em nome dos fornecedores da Collect/WePay. Essa operação ajuda os fornecedores a recuperar etiquetas de remessa para pedidos confirmados que exigem envio do depósito do fornecedor para o depósito da Amazon. Os fornecedores podem recuperar rótulos por meio de uma única chamada de API ou de várias chamadas de API. As etiquetas são geradas quando a solicitação de remessa é finalizada e uma transportadora é designada. Os fornecedores têm a opção de filtrar as etiquetas geradas pela Amazon com base em vários parâmetros, como números de referência do comprador (também conhecidos como números de referência da Amazon), códigos de depósito do vendedor e outros valores.

O diagrama a seguir mostra o fluxo de trabalho de integração de etiquetas de remessa do fornecedor.

The workflow for getting a shipment label

Requisitos comerciais

  • Ligue para o GetShipmentLabels somente após a atribuição de uma transportadora.
  • Se GetShipmentLabels não devolve uma etiqueta nem devolve Resource Not Found, verifique se uma transportadora foi designada. Como alternativa, você pode ligar GetShipmentDetails para confirmar se a transportadora foi designada.
  • Se uma transportadora tiver sido designada e a operação ainda não retornar nenhuma etiqueta, abra uma caixa “Fale conosco” no portal da Central de Fornecedores.
  • Uma vez que uma etiqueta é usada para envio, ela nunca pode ser reutilizada.

Requisitos comerciais específicos do país

Essa operação de API está disponível somente na região NA.

Solicitação de consulta

Para recuperar uma lista de etiquetas de endereço, chame a operação GetShipmentLabels e passe os seguintes parâmetros:

Nome Descrição Obrigatório
limit O limite do número de registros retornados.

Tipo: int

Não
sortOrder Classifique a lista pela data de criação da etiqueta de remessa em ordem crescente ou decrescente.

Tipo: string

Tipo: enum ( SortOrder )

Não
nextToken Usado para paginação quando há mais pedidos do que o limite de tamanho de resultado especificado. O valor do token é retornado na chamada anterior da API.

Tipo: string

Não
labelCreatedAfter As etiquetas de remessa criadas após esse período serão incluídas no resultado. Esse campo deve estar no formato de data/hora ISO 8601.

Tipo: string (data e hora)

Não
labelCreatedBefore As etiquetas de remessa criadas antes dessa data serão incluídas no resultado. Esse campo deve estar no formato de data/hora ISO 8601.

Tipo: string (data e hora)

Não
buyerReferenceNumber Obtenha etiquetas de remessa passando o ID de referência do comprador.

Tipo: string

Não
vendorShipmentIdentifier Obtenha etiquetas de remessa passando o ID de remessa do fornecedor.

Tipo: string

Não
sellerWarehouseCode Obtenha etiquetas de envio com base no código do depósito do fornecedor. Esse valor deve ser igual ao sellingParty.partyId na remessa.

Tipo: string

Não

Exemplo de solicitação

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

Resposta 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." } ] } ] } }

O que é a API de faturas de fornecedores?

Você pode usar o API de faturas de fornecedores, para trocar documentos relacionados a pagamentos com a Amazon. Com a operação Enviar faturas, você pode enviar faturas de fornecedores para a Amazon para pedidos confirmados e enviados.

As seguintes operações estão incluídas:

OperaçãoMétodo HTTPPathDescrição
submitInvoicesPOST/vendor/payments/v1/invoicesEnvia uma ou mais faturas de fornecedores para a Amazon

📘

Observação

O submitInvoices A operação pode ser usada para enviar notas de crédito na Europa.

Enviar faturas

Você pode usar o submitInvoices operação para solicitar o pagamento da Amazon pelos itens enviados. Você pode usar essa operação para enviar várias faturas em uma única chamada de API.

Os itens devem ser faturados somente após serem confirmados e enviados para a Amazon. Caso contrário, a fatura será rejeitada.

Uma fatura com as informações corretas será processada pela Amazon sem qualquer interação humana, o que significa que o fornecedor recebe o pagamento mais rapidamente.

Faturas com informações incorretas serão rejeitadas no sistema de beneficiários da Amazon, portanto, enviar as informações corretas é importante. Consulte a seção requisitos de negócios para aprender como criar faturas com as informações corretas.

Teste paralelo de envio de faturas

Você precisa concluir testes paralelos com nosso sistema de pagamentos antes de começar a usar o submitInvoices operação para processamento de pagamentos.

Quando você começa a enviar faturas usando a API, a fase de teste paralelo começa. Durante a fase de teste paralela, você envia faturas da Central de Fornecedores e da API para todos os pedidos enviados. Você deve testar paralelamente até que o conteúdo de pelo menos cinco a 10 arquivos de fatura seja validado. Testes paralelos são conduzidos com POs e faturas de produção.

A equipe de contas a pagar da Amazon (AP) entrará em contato com você quando o teste paralelo for concluído ou se houver alguma discrepância de conteúdo em suas faturas.

Quando você recebe um e-mail dizendo que o teste paralelo foi concluído, você não precisa mais enviar faturas do Vender Central; você pode usar a API para enviar faturas.

Verificação de faturas enviadas com sucesso

O API de status da transação mostra o status das validações semânticas das faturas enviadas, mas não o status real do processamento das faturas. Você pode verificar o status real da versão original ou atualizada das faturas via Central de fornecedores > Pagamentos > Faturas. Para obter mais informações sobre como usar o API de status da transação, consulte a documentação do caso de uso comercial do Status da transação. Se a versão original ou atualizada com os valores corretos para a fatura atualizada não estiver presente após 30 minutos, envie um caso de suporte na Central de Fornecedores navegando até Vendor Central > Support > Contact Us > API Integration.

O diagrama a seguir mostra o fluxo de trabalho de integração ao enviar uma fatura para um pedido confirmado e enviado.

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

Requisitos comerciais

  • Para itens cujo preço é determinado por peso, você deve fornecer o totalWeight campo. O totalWeight O campo contém o peso agregado do item que é faturado. Além disso, o netCostUnitOfMeasure O campo deve refletir a unidade de medida dos itens que você precifica por peso. Os valores da unidade de medida incluem POUNDS, OUNCES, GRAMS, e KILOGRAMS.

  • Números da fatura devem ser exclusivos e nunca devem ser reutilizados (mesmo após um ano).

  • Se uma fatura enviada pela API falhar devido a dados incorretos, mas uma fatura da Central de Fornecedores tiver os dados corretos, você deverá atualizar a fatura por meio da API com os dados corretos usando os mesmos Invoice ID.

  • Se uma fatura tiver dados incorretos (Central do Fornecedor e API), a fatura será cancelada e uma nova fatura deverá ser enviada com uma nova Invoice ID.

  • Uma fatura com um total amount = 0 = 0 não deve ser enviada, pois isso faria com que a fatura falhasse.

  • A Amazon exige os detalhes completos do endereço nos segmentos de endereço por motivos de conformidade fiscal. Isso é especialmente importante para bill to party. Para esse segmento, o sistema Amazon Payee exige uma correspondência exata. Para obter a lista de endereços, consulte Endereços do projeto de lei para terceiros da SP-API.

  • Condições de pagamento O envio de uma fatura deve corresponder às condições de pagamento acordadas com o comprador da Amazon.

  • O identificador do produto do item deve corresponder ao identificador do produto do item do pedido que foi enviado ao fornecedor no pedido de compra correspondente.

  • A quantidade total da fatura deve ser igual à soma total dos itens, encargos e subsídios.

  • O total de valor do imposto para cada nível de linha deve ser igual ao total do valor do imposto no nível do cabeçalho.

  • A quantidade total da fatura deve corresponder à soma da quantidade de todos os itens.

  • Cada encargo e subsídio diferente deve ser discriminado no nível do cabeçalho (por exemplo, cobrança de frete, cobrança de pacote, cobrança de pedidos pequenos etc.).

Aviso

Um endereço de remessa deve corresponder ao endereço registrado pela Amazon. Se o endereço não corresponder, a fatura falhará.

Requisitos comerciais específicos do país

Funcionalidade Índia Europa América do Norte
Tipo de fatura Tipo de fatura CreditNote não é suportado. O tipo de fatura deve sempre ser Invoice. Tipos de fatura Invoice e CreditNote são suportados. Os fornecedores precisam enviar o tipo de fatura adequadamente. Tipo de fatura CreditNote não é suportado. O tipo de fatura deve sempre ser Invoice.
Referências de notas de crédito Não usado Os fornecedores devem enviar essas referências no nível do item se o tipo de fatura for CreditNote. Não usado
Data Deve ser now ou antes. Deve ser now ou antes. Deve ser now ou antes.
Número HSN O código do Sistema Harmonizado de Nomenclatura (HSN) é obrigatório para faturas em conformidade com impostos. O tamanho máximo permitido é de oito caracteres. Não usado Não usado
Tipo de imposto no nível da linha e do cabeçalho O seguinte é permitido para o tipo de imposto:
  • SGST & CGST
  • SGST & CGST & CESS
  • UTGST & CGST
  • UTGST & CGST & CESS
  • IGST
  • IGST & CESS

Se nenhuma informação fiscal for fornecida, a fatura será rejeitada.

Tipo de imposto a ser enviado. Não usado
Número de registro fiscal Um ID GST de 15 caracteres deve ser fornecido. Número de IVA Número de IVA
Detalhes fiscais no nível da linha e do cabeçalho Se vários impostos forem aplicáveis a um item, a seção Detalhes fiscais deverá ser enviada várias vezes com o tipo de imposto apropriado para esse item.

O mesmo se aplica ao valor total da fatura.

Se vários impostos forem aplicáveis a um item, a seção Detalhes fiscais deverá ser enviada várias vezes com o tipo de imposto apropriado para esse item.

O mesmo se aplica ao valor total da fatura.

Há também um tipo de imposto adicional chamado DomesticVAT, que pode ser usado para enviar o valor do imposto na moeda local. Para processar o IVA doméstico, você deve usar a mesma alíquota usada no tipo de imposto VAT.

Se vários impostos forem aplicáveis a um item, a seção Detalhes fiscais deverá ser enviada várias vezes com o tipo de imposto apropriado para esse item.

O mesmo se aplica ao valor total da fatura.

Remeter para a parte A parte que fornece mercadorias para a Amazon e que receberá o pagamento. Também chamado de Fornecedor. Detalhes fiscais e de endereço da parte (fornecedor) que receberá o pagamento pelos itens enviados (no caso de uma fatura) ou pelos itens devolvidos (no caso de uma nota de crédito). São obrigatórios. Detalhes fiscais e de endereço da parte (fornecedor) que receberá o pagamento pelos itens enviados. São obrigatórios.
Enviar da parte Detalhes do endereço do remetente, junto com o Código ISO estadual.

A ID do GST deve ser enviada no número de registro fiscal. A informação sobre a origem é obrigatória. Os valores devem corresponder aos valores contidos nos sistemas da Amazon.

Código do fornecedor ou código do depósito e endereço da parte de onde os itens serão enviados. Código do fornecedor ou código do depósito e endereço da parte de onde os itens serão enviados.
Enviar para a parte Detalhes do endereço de envio junto com o Código ISO estadual. A informação sobre o destinatário é obrigatória.

Os valores devem corresponder aos valores contidos nos sistemas da Amazon.

ID da Amazon ou código do depósito e endereço da parte para a qual os itens serão enviados. ID da Amazon ou código do depósito e endereço da parte para a qual os itens serão enviados.
Parte de cobrança A informação sobre para quem o faturamento será emitido é obrigatória. Podem ser os mesmo dados do destinatário. Nesse caso, o fornecedor deve enviar as mesmas informações nos dois campos. Detalhes fiscais e de endereço da parte (Amazon) que será cobrada pelos itens enviados (no caso de uma fatura) ou pelos itens devolvidos (no caso de uma nota de crédito). Para obter uma lista completa de endereços de cobrança da Amazon para as partes e exemplos de códigos JSON, consulte SP-API para endereços de partes de cobrança.

Este campo é obrigatório.

Detalhes fiscais e de endereço da parte (Amazon) que será cobrada pelos itens enviados.

Este campo é obrigatório.

Identificador de produto da Amazon e identificador de produto externo Pelo menos um desses valores é necessário. O identificador deve ser o mesmo que é recebido em ordem. Pelo menos um desses valores é obrigatório. O identificador deve ser o mesmo que o recebido na ordem. Pelo menos um desses valores é obrigatório. O identificador deve ser o mesmo que o recebido na ordem.
Custo líquido Este campo é obrigatório. Este campo é obrigatório. Este campo é obrigatório.
Número da ordem de compra Uma fatura pode conter informações para apenas um pedido. Portanto, o número do pedido deve ser o mesmo para todos os itens de linha em uma fatura.

Obrigatório.

Uma fatura pode conter informações para vários pedidos. O número do pedido deve ser enviado adequadamente para diferentes itens de linha. Este campo é requeridos se o tipo de fatura for Invoice e não é usado quando o tipo de fatura é CreditNote. Uma fatura pode conter informações para vários pedidos. O número da PO deve ser enviado adequadamente para diferentes itens de linha.

Obrigatório.

Detalhes adicionais Não usado Esse campo é usado quando o vendedor precisa enviar detalhes adicionais para fins especiais. Por exemplo, no caso de faturas polonesas de pagamento parcelado, o vendedor deve enviar os detalhes”mechanizm podzielonej płatności“do tipo SUR e languageCodePL“. Não usado
referenceNumber Um número de referência de fatura exclusivo gerado pelo Governo da Índia para cada fatura. Esse campo é obrigatório somente para faturas na Índia. Não usado Não usado

Endereços de partes de cobrança

Ao enviar uma fatura, os detalhes do endereço da fatura devem ser preenchidos e formatados corretamente, ou a chamada da API falhará. Se você não souber o ID fiscal da Amazon para uma fatura até o local, consulte o Central de fornecedores páginas de ajuda.

Para obter uma lista completa de endereços de cobrança e exemplos de códigos JSON da Amazon, consulte Fatura da SP-API para endereços de terceiros. Você também pode encontrar essa lista, incluindo os IDs fiscais da Amazon, no Página de ajuda de recursos EDI na sua conta do Vendor Central.

Nota de crédito

Você pode usar o API de faturas de fornecedores para enviar notas de crédito para a Amazon. Uma nota de crédito lista os produtos, quantidades e preços acordados para produtos ou serviços que você forneceu à Amazon, mas a Amazon devolveu ou não recebeu. Uma nota de crédito pode ser emitida no caso de produtos danificados ou erros no preço, quando franquias ou descontos são previamente acordados entre a Amazon e o fornecedor.

Notas de crédito suportadas pela Amazon

NOTAS DE CRÉDITO DE CONTAS A PAGAR (AP) NOTAS DE CRÉDITO DE CONTAS A RECEBER (AR)
Crédito PPV

Crédito para itens faturados, mas não recebidos, ou crédito para pagamentos duplicados.

Devoluções

Crédito pelos itens devolvidos ao fornecedor devido, por exemplo, a mercadorias danificadas, mercadorias enviadas incorretamente e estoque excessivo.

Crédito PPV

Crédito para itens cobrados a um custo maior/menor.

COOP (por exemplo, proteção de preço, subsídio de danos)

Créditos COOP pagos pelo fornecedor à Amazon para vender o produto ou por um contrato de proteção de preços.


📘

Observação

As notas de crédito não são aceitas em todos os locais.

Classe submitInvoices

Fatura com vários itens sem impostos

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

Fatura com imposto único sobre um item

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

Fatura com vários impostos sobre um item

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

Fatura com nível de cabeçalho e detalhes de subsídio/cobrança em nível de linha com imposto

{ "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 da UE com imposto

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

O que é a API de status da transação do fornecedor?

Você pode usar o API de status de transação do fornecedor para verificar o status da transação de suas transações POST.

As seguintes operações estão incluídas:

.
OperaçãoMétodo HTTPPathDescrição
getTransactionGET/vendor/transactions/v1/transactionStatus/{transactionId}Obtenha o status de uma solicitação pós-transação. Retorna uma ordem de compra (PO) com base no valor purchaseOrderNumber que você especificar. O status das transações pode ser verificado em busca de dados em até quatro meses a partir da data em que a chamada POST original foi feita

Obter status da transação

Os fornecedores podem usar essa API para verificar o status de uma transação POST. Quando uma transação, como uma confirmação de pedido ou confirmação de envio, é publicada na Amazon usando uma API, a resposta inclui um identificador de transação que identifica exclusivamente a transação. A Amazon processará a transação de forma assíncrona e a resposta final estará disponível por meio da operação getTransaction. Consulte os diagramas de fluxo de trabalho de integração correspondentes nas seções individuais da API (por exemplo, pedidos de fornecedores e remessas de fornecedores) para identificar quando chamar essa API para obter o status da transação.

A Amazon oferece o status final processado para transações da API POST, como a confirmação do pedido e da remessa por meio dessa API. É altamente recomendável que os fornecedores verifiquem o status usando essa API para garantir que suas transações tenham sido processadas com sucesso. Se ocorrer um erro, a resposta conterá informações sobre ele. Em seguida, você pode corrigir a transação e reenviá-la.

Status da transaçãoDefinição
ProcessamentoA transação da API foi recebida pela Amazon e está sendo processada. O processamento ainda não foi concluído. Verifique o SLA de cada operação de API para saber o tempo esperado para concluir o processamento.
SucessoEsse status é suportado somente para Enviar confirmações de remessa e Enviar remessa somente na América do Norte e na UE. O sucesso não é suportado pelo submitAcknowledgement e submitInvoices operações.
FalhaA transação da API falhou durante o processamento. Os detalhes do erro serão fornecidos no corpo da resposta do status da transação.

📘

Observação

O status da transação é compatível com as seguintes operações de API:

O status da transação suporta apenas a Processing e Failure valores de status. Se o status da transação for Processing, e não atualizado para Failure após 15 minutos, isso indica que a transação foi processada com sucesso em nossos sistemas.

Geralmente, considera-se que uma transação foi entregue com sucesso do nosso lado quando o status é Processing. Se por algum motivo, Central de fornecedores o status não é atualizado dentro de 30 minutos após o envio da mensagem, abra um caso de suporte usando Central de fornecedores fornecendo o ID da transação retornado na chamada POST. Certifique-se de que os dados enviados estejam no formato correto antes de abrir a caixa.

Você não pode usar essa API para Invoice mensagens, pois elas não são suportadas e o status sempre será Processing. Para qualquer dúvida relacionada a pagamentos, primeiro faça o check-in Central de fornecedorese, em seguida, crie um Contact Us caso em Central de fornecedores e selecione a fila relevante.

Casos de uso do status da transação

A transação está sendo processada

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

A transação foi processada com sucesso

A transação ficou em estado de processamento por 15 minutos após sua publicação.

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

A transação falhou na Amazon

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

Esta página ajudou você?