DBA – Delivery by Amazon – Página inicial

Este artigo interno explica o funcionamento do DBA – Delivery by Amazon no ANYMARKET, incluindo comportamento de anúncio, preço, estoque, tempo de preparo, importação de pedidos, faturamento, emissão de etiqueta, rastreio e importação manual.

No modelo DBA – Delivery by Amazon, o vendedor armazena o produto em seu próprio centro de distribuição, emite a nota fiscal seguindo o fluxo padrão FBM e a Amazon fica responsável pela entrega e pelo frete.

Pré-requisitos

Antes de analisar ou operar o fluxo DBA, valide se:

A transmissão está com a opção FBA – Fulfillment by Amazon desativada;
A integração Amazon está ativa e autorizada no ANYMARKET;
O produto possui estoque disponível no ANYMARKET;
O produto possui preço configurado para envio à Amazon;
O pedido foi disponibilizado pela Amazon via notificação ORDER_STATUS_CHANGE ou, em caso de importação manual, o número do pedido Amazon está disponível;
Para faturamento, o XML da nota fiscal está disponível para envio à Amazon.

Como funciona o DBA

O DBA – Delivery by Amazon não é um anúncio fulfillment. Por isso, a transmissão deve ficar com a opção FBA – Fulfillment by Amazon desativada.

Comportamento esperado nesse modelo:

Selo Prime: não elegível;
Nota Fiscal: emitida pelo vendedor, seguindo o fluxo padrão FBM;
Etiqueta: disponível no ANYMARKET;
Entrega e frete: responsabilidade da Amazon;
Armazenamento: centro de distribuição do vendedor;
Atualização de estoque: realizada pelo ANYMARKET;
Tempo de preparo: permitido para esse tipo de anúncio.

As atualizações de estoque e preço são responsabilidade do ANYMARKET e são realizadas por chamada PATCH no endpoint de Listings API:

https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/items/{sellerID}/{SKU}

Fluxos técnicos do DBA

Anúncio

A transmissão do DBA deve estar com a opção FBA – Fulfillment by Amazon desativada.

Como o anúncio não é fulfillment, o fulfillment_channel_code sempre será:

DEFAULT

O seller é responsável pela gestão do estoque, e o estoque é enviado para a Amazon no campo quantity.

Preço

A atualização de preço será enviada sempre que houver mudança de preço no ANYMARKET.

O envio considera:

Preço De: enviado no campo our_price;
Preço Por: enviado no campo discounted_price.

Estoque e tempo de preparo

Como o DBA não é fulfillment, o ANYMARKET envia a quantidade disponível em estoque para a Amazon.

Esse tipo de anúncio também permite envio do Tempo de Preparo, ou Crossdocking, pelo campo:

lead_time_to_ship_max_days

Exemplo de payload:

{
  "productType": "PRODUCT",
  "patches": [
    {
      "op": "replace",
      "path": "/attributes/fulfillment_availability",
      "value": [
        {
          "fulfillment_channel_code": "DEFAULT",
          "quantity": 3,
          "marketplace_id": "A2Q3Y263D00KWC"
        }
      ]
    },
    {
      "op": "replace",
      "path": "/attributes/purchasable_offer",
      "value": [
        {
          "marketplace_id": "A2Q3Y263D00KWC",
          "currency": "BRL",
          "our_price": [
            {
              "schedule": [
                {
                  "value_with_tax": 315.67
                }
              ]
            }
          ],
          "discounted_price": [
            {
              "schedule": [
                {
                  "value_with_tax": 315.67,
                  "start_at": "2025-07-25T15:09:45.362Z",
                  "end_at": "2025-07-25T15:14:45.362Z"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Importação de pedidos

O pedido DBA só será importado para o ANYMARKET quando estiver com status PAGO.

A importação se inicia após o recebimento da notificação:

ORDER_STATUS_CHANGE

Essa notificação é recebida via SQS.

Durante o fluxo, o ANYMARKET avalia o status do pedido:

Quando o status recebido é PENDING, o ANYMARKET cria uma reserva;
Quando uma nova notificação chega com status UNSHIPPED, o pedido é criado no ANYMARKET.

Exemplo de log no LOGSTASH:

{
  "NotificationVersion": "1.0",
  "NotificationType": "ORDER_STATUS_CHANGE",
  "PayloadVersion": "1.0",
  "EventTime": "2025-07-25T01:26:26.898Z",
  "Payload": {
    "OrderStatusChangeNotification": {
      "SellerId": "AS3RQ8A7NMK0D",
      "MarketplaceId": "A2Q3Y263D00KWC",
      "AmazonOrderId": "702-5945623-1656234",
      "PurchaseDate": null,
      "OrderStatus": "UpComing",
      "DestinationPostalCode": "85601560",
      "SupplySourceId": null,
      "OrderItemId": "134769465920441",
      "SellerSKU": "139158",
      "Quantity": 1,
      "FulfillmentChannel": "MFN"
    }
  },
  "NotificationMetadata": {
    "ApplicationId": "amzn1.sellerapps.app.7a0912d8-474f-480e-8ee4-52d4271a5f3f",
    "SubscriptionId": "0cc10b5e-4a44-439f-a6e5-fd52d82578f2",
    "PublishTime": "2025-07-25T01:26:27.742Z",
    "NotificationId": "55161f47-6202-418e-aff2-5b87273d00eb"
  }
}

Para criar o pedido, o ANYMARKET realiza chamadas para obter as informações do pedido, dos itens e do comprador:

GET /orders/v0/orders;
GET /orders/v0/orders/{orderId}/orderItems;
GET /orders/v0/orders/{orderId}/address.

Faturamento

Para pedidos DBA – Delivery by Amazon, a Amazon exige o envio do XML da nota fiscal.

O envio é feito em formato Base64 por meio de uma chamada POST para:

https://sellingpartnerapi-na.amazon.com/delivery/2022-07-01/invoice?orderId={orderId}

Emissão de etiqueta

Em pedidos DBA, a responsabilidade pela entrega é da Amazon. Após o envio da nota fiscal, o vendedor precisa solicitar a etiqueta.

A etiqueta pode ser solicitada pelas seguintes opções:

API /v2/printtag/{type};
Menu Tarefas em Lote, pela emissão de etiqueta;
Individualmente, na tela de Pedidos.

Ao solicitar a etiqueta, o ANYMARKET realiza a chamada:

POST https://sellingpartnerapi-na.amazon.com/easyShip/2022-03-23/packages/bulk

Essa chamada realiza o agendamento da coleta e retorna a etiqueta no formato solicitado pelo vendedor, podendo ser:

PDF;
ZPL.

Após a emissão da etiqueta, a Data limite de envio passa a ficar disponível no pedido.

Informações de rastreio

A Amazon é responsável pela entrega do pedido DBA e não disponibiliza os dados de rastreio do pedido para o ANYMARKET.

Acompanhamento de rastreio

Após a emissão da etiqueta na Amazon, o status final na Amazon será ENVIADO.

Não existe um serviço que permita marcar o pedido como ENTREGUE na Amazon por meio desse fluxo.

Caso o vendedor deseje, pode enviar status para o ANYMARKET. Nesse cenário, o pedido será atualizado apenas no ANYMARKET.

Importante: essa atualização não será enviada para a Amazon.

Existe uma atividade mapeada para mapear o substatus de entrega e melhorar a visão do rastreio desse tipo de pedido:

Product Backlog Item 958847: [AMAZON] [DBA] Atualizar status de pedido conforme disponibilizado pelo Marketplace no campo "EasyShipShipmentStatuses"

Importação manual de pedidos

Pedidos DBA permitem importação manual pela tela de Pedidos.

Para isso, basta informar o número do pedido na Amazon.

Boas práticas

Confirme se a transmissão está com FBA – Fulfillment by Amazon desativado.
Valide que o fulfillment_channel_code está como DEFAULT.
Confira se o estoque está sendo enviado no campo quantity.
Utilize o campo lead_time_to_ship_max_days quando houver tempo de preparo configurado.
Valide no LOGSTASH se a notificação ORDER_STATUS_CHANGE foi recebida.
Considere que pedidos em PENDING geram reserva, e pedidos em UNSHIPPED são criados no ANYMARKET.
Após o faturamento, valide se o XML foi enviado para a Amazon em Base64.
Solicite a etiqueta após o envio da nota fiscal.
Não espere dados de rastreio da Amazon nesse fluxo, pois eles não são disponibilizados para o ANYMARKET.
Use a importação manual apenas informando o número do pedido Amazon na tela de Pedidos.

Dúvidas comuns

O que é DBA – Delivery by Amazon?
É o modelo em que o vendedor armazena o produto e emite a nota fiscal, enquanto a Amazon realiza a entrega e o frete.

O DBA é elegível ao selo Prime?
Não. O DBA não é elegível ao selo Prime.

Quem emite a nota fiscal no DBA?
A nota fiscal é emitida pelo vendedor, seguindo o fluxo padrão FBM.

A etiqueta fica disponível no ANYMARKET?
Sim. A etiqueta pode ser solicitada pelo ANYMARKET após o envio da nota fiscal.

Quem faz a entrega e o frete?
A Amazon é responsável pela entrega e pelo frete.

Onde o produto fica armazenado?
No centro de distribuição do vendedor.

Quem atualiza o estoque?
O ANYMARKET envia as atualizações de estoque para a Amazon, com base no estoque gerenciado pelo seller.

A transmissão deve estar como FBA?
Não. Para DBA, a opção FBA – Fulfillment by Amazon deve ficar desativada.

Qual fulfillment_channel_code é usado no DBA?
O fulfillment_channel_code sempre será DEFAULT.

O DBA permite tempo de preparo?
Sim. O tempo de preparo, ou crossdocking, pode ser enviado no campo lead_time_to_ship_max_days.

Quando o pedido DBA é importado?
O pedido é importado quando está com status PAGO e, após a notificação ORDER_STATUS_CHANGE, evolui para o fluxo de criação no ANYMARKET.

O que acontece quando o pedido está PENDING?
O ANYMARKET cria uma reserva até receber uma nova notificação com status UNSHIPPED.

Quando o pedido é criado no ANYMARKET?
Quando o ANYMARKET recebe uma nova notificação com status UNSHIPPED.

Quais chamadas são feitas para criar o pedido?
São realizadas chamadas para /orders/v0/orders, /orders/v0/orders/{orderId}/orderItems e /orders/v0/orders/{orderId}/address.

Como o XML da nota é enviado para a Amazon?
O XML é enviado em Base64 pelo endpoint /delivery/2022-07-01/invoice?orderId={orderId}.

Como emitir etiqueta DBA?
A etiqueta pode ser emitida pela API /v2/printtag/{type}, por Tarefas em Lote ou individualmente na tela de Pedidos.

Qual chamada é feita para emitir etiqueta?
O ANYMARKET chama POST /easyShip/2022-03-23/packages/bulk.

Quais formatos de etiqueta são suportados?
A etiqueta pode retornar em PDF ou ZPL, conforme formato solicitado pelo vendedor.

A Amazon disponibiliza rastreio para o ANYMARKET?
Não. A Amazon é responsável pela entrega, mas não disponibiliza os dados de rastreio do pedido.

O pedido pode ser atualizado como Entregue na Amazon?
Não por esse fluxo. Após a emissão da etiqueta, o status final na Amazon será ENVIADO. Atualizações enviadas ao ANYMARKET ficam apenas no ANYMARKET.

É possível importar pedido DBA manualmente?
Sim. Basta informar o número do pedido Amazon na tela de Pedidos.

Relativo a