FBA OnSite (Brasil) - Seller Flex (México) – Página inicial

Este artigo interno explica o funcionamento do FBA OnSite no Brasil e do Seller Flex no México no ANYMARKET, incluindo comportamento de anúncio, preço, estoque, importação de pedidos, faturamento, etiqueta, rastreio e diagnóstico de pedidos não importados.

Para a Amazon, o FBA OnSite e o Seller Flex funcionam como modalidades fulfillment. Mesmo quando a mercadoria está fisicamente no estoque do vendedor, a operação é tratada como fulfillment pela Amazon, e o anúncio deve estar configurado como FBA – Fulfillment by Amazon.

Neste artigo:

Pré-requisitos
Como funciona o FBA OnSite e Seller Flex
Fluxos técnicos do FBA OnSite e Seller Flex
Boas práticas
Dúvidas comuns

Pré-requisitos

Antes de analisar ou operar o fluxo de FBA OnSite ou Seller Flex, valide se:

O anúncio está configurado como FBA – Fulfillment by Amazon;
A integração Amazon está ativa e autorizada no ANYMARKET;
Há acesso ao LOGSTASH para consultar notificações recebidas via SQS;
Há acesso ao banco da Amazon para validar a tabela fbaos_notification, quando necessário;
Para pedidos do Brasil, o XML da nota fiscal está disponível para envio à Amazon;
Para pedidos do México, considere que a nota fiscal não é exigida nesse fluxo.

Como funciona o FBA OnSite e Seller Flex

O programa FBA OnSite, no Brasil, e Seller Flex, no México, é elegível ao selo Prime e possui operação logística feita pela Amazon, mas com armazenamento no centro de distribuição do vendedor.

Comportamento esperado nesse modelo:

Selo Prime: elegível;
Disponibilidade: Brasil e México;
Nota Fiscal: no Brasil, é emitida pelo vendedor e enviada ao ANYMARKET, que repassa à Amazon. No México, não é necessária;
Etiqueta: disponibilizada no OnSite Tools;
Entrega e frete: realizados pela Amazon;
Armazenamento: centro de distribuição do vendedor;
Atualização de estoque: manual, via OnSite Tools.

Mesmo com a mercadoria no estoque do vendedor, o anúncio é tratado pela Amazon como fulfillment. Por isso, o fulfillment_channel_code será sempre AMAZON_NA, e o ANYMARKET não fará atualização de estoque nesse fluxo.

Fluxos técnicos do FBA OnSite e Seller Flex

Anúncio

Para esse programa, o anúncio deve estar configurado como FBA – Fulfillment by Amazon.

Apenas a atualização de preço fica sob responsabilidade do ANYMARKET, sendo realizada por chamada PATCH no endpoint de Listings API:

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

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

Para a Amazon, o FBA OnSite funciona como fulfillment, porém a mercadoria está no estoque do vendedor.

Nesse programa, a gestão do estoque deve ser feita manualmente pelo vendedor por meio do OnSite Tools da Amazon.

Artigo de apoio da Amazon:

Programa FBA OnSite da Amazon

O fulfillment_channel_code sempre será:

AMAZON_NA

Como esse é um anúncio fulfillment, o ANYMARKET não realiza atualização de estoque.

Esse tipo de anúncio também não permite envio de Tempo de Preparo, ou Crossdocking.

Exemplo de payload:

{
  "productType": "PRODUCT",
  "patches": [
    {
      "op": "replace",
      "path": "/attributes/fulfillment_availability",
      "value": [
        {
          "fulfillment_channel_code": "AMAZON_NA",
          "marketplace_id": "A2Q3Y263D00KWC"
        }
      ]
    },
    {
      "op": "replace",
      "path": "/attributes/purchasable_offer",
      "value": [
        {
          "marketplace_id": "A2Q3Y263D00KWC",
          "currency": "BRL",
          "our_price": [
            {
              "schedule": [
                {
                  "value_with_tax": 242.03
                }
              ]
            }
          ],
          "discounted_price": [
            {
              "schedule": [
                {
                  "value_with_tax": 222.99,
                  "start_at": "2025-07-25T15:25:35.568Z",
                  "end_at": "2030-07-25T15:25:35.568Z"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Importação de pedidos

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

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

FBA_OUTBOUND_SHIPMENT_STATUS

Essa notificação é recebida via SQS. Quando chega com status CREATED, o ANYMARKET cria o pedido.

Exemplo de log no LOGSTASH:

{
  "NotificationVersion": "1.0",
  "NotificationType": "FBA_OUTBOUND_SHIPMENT_STATUS",
  "PayloadVersion": "1.0",
  "EventTime": "2025-07-25T13:17:20.347Z",
  "Payload": {
    "FBAOutboundShipmentStatusNotification": {
      "SellerId": "A328H4KMUWIGAB",
      "AmazonOrderId": "702-2598057-0227444",
      "AmazonShipmentId": "Bxyz5nwNt",
      "ShipmentStatus": "Created"
    }
  },
  "NotificationMetadata": {
    "ApplicationId": "amzn1.sellerapps.app.7a0912d8-474f-480e-8ee4-52d4271a5f3f",
    "SubscriptionId": "7dbc5ba2-a808-468f-9693-17bf51d3dc29",
    "PublishTime": "2025-07-25T13:17:20.417Z",
    "NotificationId": "8187e186-2230-4f80-951a-69276a31c104"
  }
}

Para criar o pedido, o ANYMARKET realiza uma chamada GET para o endpoint:

https://sellingpartnerapi-na.amazon.com/fba/outbound/brazil/v0/shipments/{AmazonShipmentId}

Essa chamada retorna as informações necessárias para criação do pedido.

Faturamento

Para pedidos FBA OnSite do Brasil, 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/fba/outbound/brazil/v0/shipments/{AmazonShipmentId}/invoice

Para pedidos Seller Flex do México, a nota fiscal não é exigida.

Emissão de etiqueta

Em pedidos FBA OnSite, a responsabilidade do envio é da Amazon. Após o envio da nota fiscal, o vendedor precisa emitir a etiqueta manualmente pela ferramenta OnSite Tools da Amazon.

Para esse programa, não existe serviço que possibilite a emissão de etiqueta no ANYMARKET.

Artigo de apoio da Amazon:

Programa FBA OnSite da Amazon

Informações de rastreio

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

Acompanhamento de rastreio

Após o envio da nota fiscal para a Amazon, o status final na Amazon será Faturado.

Não existe um serviço que permita marcar o pedido como ENVIADO ou 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 FBA OnSite e Seller Flex não permitem importação manual pela tela de Pedidos.

Para análise, é necessário verificar se o ANYMARKET recebeu a notificação:

FBA_OUTBOUND_SHIPMENT_STATUS

Pedido não importado: o que verificar?

Quando um pedido FBA OnSite ou Seller Flex não for importado, valide os seguintes pontos:

Verifique no LOGSTASH se existe o log:

Importando Notificação FBAOS do SQS de corpo

Valide se a notificação foi persistida na tabela fbaos_notification no banco de dados da Amazon;
Confira o valor do campo process_status.

Interpretação do process_status:

PENDING: a notificação ainda não foi processada. Deve ser processada nos próximos minutos;
MONITORING: foi gerado monitoramento para o seller;
MONITORING_WITHOUT_RETRY: houve erro de negócio, como SKU inexistente ou falta de estoque. Nesse caso, não foi gerado monitoramento com retentativa.

Boas práticas

Confirme se o anúncio está configurado como FBA – Fulfillment by Amazon.
Considere que o estoque deve ser gerenciado manualmente pelo vendedor via OnSite Tools.
Valide que o fulfillment_channel_code está como AMAZON_NA.
Não envie tempo de preparo ou crossdocking em anúncios FBA OnSite ou Seller Flex.
Para pedidos do Brasil, valide se o XML da nota foi enviado à Amazon em Base64.
Para pedidos do México, considere que a nota fiscal não é exigida.
Não espere emissão de etiqueta pelo ANYMARKET nesse fluxo; a etiqueta deve ser emitida no OnSite Tools.
Em caso de pedido não importado, valide a notificação FBA_OUTBOUND_SHIPMENT_STATUS no LOGSTASH e na tabela fbaos_notification.

Dúvidas comuns

O que é FBA OnSite?
É o modelo fulfillment da Amazon no Brasil em que a mercadoria fica no estoque do vendedor, mas a entrega e o frete são realizados pela Amazon.

O que é Seller Flex?
É o modelo equivalente no México, também tratado como fulfillment pela Amazon.

O FBA OnSite e Seller Flex são elegíveis ao selo Prime?
Sim, conforme elegibilidade definida pela Amazon.

Em quais países esse fluxo está disponível?
Brasil e México.

Quem emite a nota fiscal?
No Brasil, a nota fiscal é emitida pelo vendedor e enviada ao ANYMARKET, que repassa à Amazon. No México, a nota fiscal não é exigida nesse fluxo.

Quem emite a etiqueta?
A etiqueta é disponibilizada pela Amazon no OnSite Tools. O ANYMARKET não emite etiqueta para esse programa.

Quem faz a entrega?
A entrega e o frete são responsabilidade da Amazon.

Onde a mercadoria fica armazenada?
No centro de distribuição do vendedor.

Como o estoque é atualizado?
A atualização de estoque é manual e deve ser feita pelo vendedor no OnSite Tools.

O ANYMARKET atualiza estoque nesse fluxo?
Não. Mesmo com a mercadoria no estoque do vendedor, o anúncio é fulfillment para a Amazon, e o ANYMARKET não realiza atualização de estoque.

Qual fulfillment_channel_code é usado?
O fulfillment_channel_code sempre será AMAZON_NA.

O ANYMARKET envia tempo de preparo?
Não. Esse tipo de anúncio não permite envio de tempo de preparo ou crossdocking.

Quando o pedido é importado?
O pedido é importado quando está com status PAGO e o ANYMARKET recebe a notificação FBA_OUTBOUND_SHIPMENT_STATUS com status CREATED.

Qual endpoint é usado para criar o pedido?
O ANYMARKET consulta https://sellingpartnerapi-na.amazon.com/fba/outbound/brazil/v0/shipments/{AmazonShipmentId} para obter os dados necessários.

Como o XML da nota é enviado para a Amazon no Brasil?
O XML é enviado em formato Base64 pelo endpoint /fba/outbound/brazil/v0/shipments/{AmazonShipmentId}/invoice.

Há emissão de etiqueta no ANYMARKET?
Não. A etiqueta deve ser emitida manualmente no OnSite Tools.

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

O pedido pode ser atualizado para Enviado ou Entregue na Amazon?
Não por esse fluxo. Após o envio da nota fiscal, o status final na Amazon será Faturado. Atualizações enviadas pelo vendedor ao ANYMARKET ficam apenas no ANYMARKET.

É possível importar manualmente o pedido pela tela de Pedidos?
Não. É necessário verificar se a notificação FBA_OUTBOUND_SHIPMENT_STATUS foi recebida.

O que verificar quando o pedido não foi importado?
Verifique no LOGSTASH o log Importando Notificação FBAOS do SQS de corpo, valide a tabela fbaos_notification e confira o campo process_status.

O que significa process_status PENDING?
Significa que a notificação ainda não foi processada e deve ser processada nos próximos minutos.

O que significa process_status MONITORING?
Significa que foi gerado monitoramento para o seller.

O que significa process_status MONITORING_WITHOUT_RETRY?
Significa que houve erro de negócio, como SKU inexistente ou falta de estoque. Nesse caso, não foi gerado monitoramento com retentativa.

Relativo a