Pular para o conteúdo principal

FBA OnSite – SmartConnect

Arthur Pereira
Atualizado

Este artigo interno explica o funcionamento do FBA OnSite – SmartConnect no ANYMARKET, incluindo comportamento de anúncio, preço, estoque por centro de distribuição, importação de pedidos, faturamento, IMEI, dimensões do pacote, emissão de etiqueta, rastreio e diagnóstico de pedidos não importados.

O FBA OnSite SmartConnect é um conjunto de APIs que permite ao vendedor operar o FBA OnSite sem necessidade de usar o OnSite Tools para gestão de estoque e pedidos. Com o SmartConnect, a integração passa a utilizar as APIs ExternalFulfillment da Amazon para controlar estoque, importar pedidos, enviar faturamento, emitir etiqueta e acompanhar rastreio diretamente pelo ANYMARKET.

 

Neste artigo:

 

Pré-requisitos

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

  • A integração Amazon Global API está ativa e autorizada no ANYMARKET;
  • A opção FBA OnSite SmartConnect está ativa na aba Configurações de Frete da integração Amazon;
  • O anúncio está configurado como FBA – Fulfillment by Amazon;
  • O anúncio está marcado como Multi CD Marketplace;
  • O Local de Estoque do ANYMARKET está vinculado ao Centro de Distribuição da Amazon;
  • O ID do Centro de Distribuição da Amazon, como WBR4, foi informado no vínculo do Local de Estoque;
  • Há acesso ao LOGSTASH para consultar notificações recebidas via SQS;
  • Há acesso ao banco da Amazon para validar as tabelas AMAZON_ORDER_NOTIFICATION e AMAZON_ORDER, quando necessário.

Como funciona o FBA OnSite SmartConnect

O FBA OnSite SmartConnect está disponível inicialmente para o Brasil e, posteriormente, será liberado para o Seller Flex do México.

Comportamento esperado nesse modelo:

  • Selo Prime: elegível;
  • Disponibilidade: Brasil, equivalente ao Seller Flex no México;
  • Nota Fiscal: emitida pelo vendedor e enviada ao ANYMARKET, que repassa à Amazon;
  • Etiqueta: disponibilizada no ANYMARKET;
  • Entrega e frete: responsabilidade da Amazon;
  • Armazenamento: centro de distribuição do vendedor;
  • Atualização de estoque: automatizada via ANYMARKET, com controle por centro de distribuição.

As principais vantagens do FBA OnSite SmartConnect são:

  • Gestão de estoque integrada;
  • Gestão de estoque por Local de Estoque com a funcionalidade Multi CD Marketplace;
  • Gestão de pedidos integrada;
  • Importação de pedidos;
  • Envio das informações de faturamento;
  • Preenchimento de IMEI para venda de itens regulados pela Anatel;
  • Emissão de etiqueta;
  • Acompanhamento do rastreio.

Documentação de apoio da Amazon:

ExternalFulfillment

Fluxos técnicos do FBA OnSite SmartConnect

Anúncio

O programa FBA OnSite SmartConnect funciona para a Amazon simbolicamente como fulfillment. A mercadoria fica alocada no estoque do vendedor, mas o vendedor precisa informar a quantidade disponível para cada centro de distribuição cadastrado na Amazon.

Por isso, o anúncio precisa estar com as opções abaixo ativas:

  • FBA – Fulfillment by Amazon;
  • Multi CD Marketplace.

Com essas opções ativas, o ANYMARKET fará a atualização de estoque conforme as regras descritas no tópico de estoque.

Preço

A atualização de preço funciona da mesma forma que no FBA OnSite tradicional.

A atualização é realizada pelo endpoint:

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

O envio ocorre sempre que houver mudança de preço no ANYMARKET, considerando:

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

Estoque

A principal diferença entre o FBA OnSite e o FBA OnSite SmartConnect é que, no SmartConnect, a gestão de estoque é integrada.

No FBA OnSite tradicional, a atualização de estoque é feita manualmente pelo vendedor no OnSite Tools. Já no SmartConnect, o seller envia o estoque atual de cada SKU em cada Local de Estoque pelo ANYMARKET, utilizando a funcionalidade Multi CD Marketplace.

Ativar o FBA OnSite SmartConnect

Para iniciar a ativação do SmartConnect, o vendedor deve acessar a configuração da integração Amazon Global API, ir até a aba Configurações de Frete e ativar a opção:

FBA OnSite SmartConnect

A partir dessa ativação, o ANYMARKET passa a gerir o estoque dos anúncios marcados como Multi CD Marketplace e também a gerir os pedidos desse fluxo.

Vincular Local de Estoque do ANYMARKET ao Centro de Distribuição da Amazon

Para realizar o vínculo, o Centro de Distribuição precisa estar cadastrado na Amazon.

A Amazon informará um identificador de 4 caracteres, por exemplo:

WBR4

No ANYMARKET, acesse a tela de Local de Estoque, selecione o Local de Estoque desejado, acesse a aba Vínculos, selecione o marketplace Amazon Global API e informe o ID do Centro de Distribuição fornecido pela Amazon.

Converter o anúncio para FBA e Multi CD Marketplace

Na edição da transmissão, o anúncio deve ser convertido para:

  • FBA – Fulfillment by Amazon;
  • Multi CD Marketplace.

Como os anúncios FBA OnSite SmartConnect são considerados fulfillment, todos devem estar obrigatoriamente com a opção FBA – Fulfillment by Amazon ativa na transmissão.

Após ativar o anúncio como FBA, a opção Multi CD Marketplace também deve ser obrigatoriamente ativada. Essa opção define que o ANYMARKET fará a gestão de estoque do anúncio. Sem ela, o anúncio não receberá atualizações de estoque.

Regra de envio de estoque por Local de Estoque

A gestão de estoque do SmartConnect utiliza a funcionalidade Multi CD Marketplace. Dessa forma, o ANYMARKET envia para a Amazon a quantidade atual de estoque do SKU para cada Local de Estoque vinculado a um Centro de Distribuição da Amazon.

Caso o Local de Estoque não esteja vinculado a um Centro de Distribuição da Amazon, o estoque desse local não será atualizado na Amazon.

Exemplo:

  • SKU ABC123 possui 10 unidades no Local de Estoque São Paulo;
  • SKU ABC123 possui 20 unidades no Local de Estoque Espírito Santo;
  • SKU ABC123 possui 30 unidades no Local de Estoque Minas Gerais;
  • Apenas São Paulo e Minas Gerais estão vinculados aos CDs da Amazon.

Nesse caso, o ANYMARKET enviará atualização de estoque apenas para São Paulo e Minas Gerais. As 20 unidades do Espírito Santo não serão enviadas para a Amazon.

Endpoint de atualização de estoque SmartConnect

Diferente dos fluxos FBA e DBA, em que o ANYMARKET atualiza estoque pelo endpoint de Listings API, os anúncios SmartConnect utilizam o conjunto de APIs ExternalFulfillment.

A atualização de estoque é enviada para atualizar o estoque do SKU nos Locais de Estoque vinculados e que possuem o SKU.

Exemplo de chamada:

curl --location 'https://sellingpartnerapi-na.amazon.com/externalFulfillment/inventory/2024-09-11/inventories' \
--header 'Accept: application/json' \
--header 'x-amz-access-token: {access_token}' \
--header 'Content-Type: application/json' \
--data '{
  "requests": [
    {
      "method": "POST",
      "uri": "/inventory/update?locationId=WBR4&skuId=B07WHZSKH1FBM",
      "body": {
        "quantity": 8,
        "clientSequenceNumber": 1717495650084
      }
    },
    {
      "method": "POST",
      "uri": "/inventory/update?locationId=WBR5&skuId=B07WHZSKH1FBM",
      "body": {
        "quantity": 10,
        "clientSequenceNumber": 1717495650084
      }
    }
  ]
}'

Importação de pedidos

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

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

EXTERNAL_FULFILLMENT_SHIPMENT_STATUS_CHANGE

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

Exemplo de log no LOGSTASH:

{
  "notificationVersion": "1.0",
  "notificationType": "EXTERNAL_FULFILLMENT_SHIPMENT_STATUS_CHANGE",
  "payloadVersion": "1.0",
  "eventTime": "2025-06-12T19:23:05.935Z",
  "payload": {
    "externalFulfillmentShipmentNotification": {
      "merchantId": "A7740OOPA79C8",
      "locationId": "ad609a17-dd9a-46ad-809c-628c582c6671",
      "shipmentId": "BB5wt5sb3",
      "channelName": "FBA",
      "shipmentStatus": "ACCEPTED",
      "earliestPackDateTime": "2025-06-12T19:16:03Z"
    }
  },
  "notificationMetadata": {
    "applicationId": "amzn1.sp.solution.db012d82-3fd4-4615-9a08-56d0e85d8575",
    "subscriptionId": "5b071a2b-5493-4019-8deb-dd9ec0eef1c4",
    "publishTime": "2025-06-12T19:23:06.489Z",
    "notificationId": "b3ba0be2-81fe-43dc-bd1e-1e9003137a2c"
  }
}

Para criar o pedido, são realizadas duas chamadas:

1. Consulta no fluxo ExternalFulfillment

GET https://sellingpartnerapi-na.amazon.com/externalFulfillment/2024-09-11/shipments/{AmazonShipmentId}

Essa chamada retorna dados do pacote, como:

  • Dimensões;
  • Local de Estoque;
  • Itens;
  • Quantidades;
  • Valores;
  • Status;
  • Obrigatoriedade de IMEI;
  • Etiqueta HAZMAT;
  • Outras informações operacionais.

2. Consulta no fluxo FBA OnSite

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

Essa chamada retorna informações do comprador, necessárias para a criação e o faturamento do pedido.

Ao importar o pedido, o ANYMARKET recebe o atributo LocationID, contendo o ID do Centro de Distribuição na Amazon.

Com base nessa informação, o ANYMARKET identifica de qual Local de Estoque do ANYMARKET a venda deverá decrementar o estoque, utilizando o vínculo realizado.

Importante: caso o LocationId da venda não esteja vinculado a um Local de Estoque do ANYMARKET, a venda não será importada.

Faturamento

Para pedidos FBA OnSite SmartConnect 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 FBA OnSite SmartConnect do México, a nota fiscal não é exigida.

Obrigatoriedade de IMEI

O fluxo de FBA OnSite SmartConnect exige que seja enviado o IMEI para produtos que possuem regulamentação da Anatel.

Ao fazer a chamada:

GET https://sellingpartnerapi-na.amazon.com/externalFulfillment/2024-09-11/shipments/{AmazonShipmentId}

O ANYMARKET verifica, em cada item, se o campo abaixo está como REQUIRED:

serialNumberRequirement

Quando o campo estiver como REQUIRED, o seller precisará informar o IMEI para o produto.

Nesse caso, o ANYMARKET disponibilizará no pedido a informação de que existe item com exigência de IMEI. O seller poderá preencher essa informação pela opção Enviar IMEI, disponível na tela da venda enquanto o pedido estiver nos status:

  • PAGO;
  • FATURADO.

Também será identificado no metadata do pedido, pela V2, que o pedido exige IMEI.

Importante: neste primeiro momento, não será possível preencher o IMEI via API.

Pedidos que não possuem item com obrigatoriedade de IMEI ficam isentos dessa necessidade.

Dimensões do pacote

Parte do processo de organização do envio dos pedidos FBA OnSite SmartConnect consiste em enviar a dimensão do pacote que será enviado.

A Amazon disponibiliza, nas informações do pedido, uma dimensão recomendada. O ANYMARKET utiliza essa informação no momento da criação do pacote.

Caso o vendedor deseje modificar a dimensão do pacote, poderá alterar essa informação pela opção Editar Dimensões, disponível na tela de venda enquanto o pedido estiver com status PAGO.

Emissão de etiqueta

A Amazon disponibiliza as etiquetas do FBA OnSite SmartConnect por API. O ANYMARKET consome a etiqueta conforme solicitação do seller pela tela ou pela API.

A escolha do formato da etiqueta é feita na criação do centro de distribuição pela Amazon. Por isso, não será possível escolher o formato da etiqueta pela tela ou pela API do ANYMARKET.

Caso o seller esteja recebendo um formato diferente do desejado, deverá acionar a Amazon para solicitar a alteração.

A emissão da etiqueta ficará disponível no ANYMARKET enquanto o pedido estiver com status FATURADO.

Acompanhamento de rastreio

Após a solicitação da etiqueta, as informações de janela de coleta serão disponibilizadas no ANYMARKET.

Também será enviada a atualização de SHIPPED para a Amazon.

Após essa atualização, o ANYMARKET aguardará a notificação:

EXTERNAL_FULFILLMENT_SHIPMENT_STATUS_CHANGE

Com essa notificação, o pedido será atualizado no ANYMARKET conforme o status equivalente:

  • SHIPPED: ENVIADO;
  • DELIVERED: CONCLUÍDO;
  • CANCELLED: CANCELADO.

Importação manual de pedidos

Pedidos FBA OnSite SmartConnect não permitem importação manual pela tela de Pedidos.

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

EXTERNAL_FULFILLMENT_SHIPMENT_STATUS_CHANGE

Pedido não importado: o que verificar?

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

  1. Verifique no LOGSTASH se existe o log:
Importando Notificação FBAOS do SQS de corpo
  1. Confirme se o log contém a notificação EXTERNAL_FULFILLMENT_SHIPMENT_STATUS_CHANGE;
  2. Verifique se o LocationId disponível no endpoint abaixo está vinculado a um Local de Estoque do ANYMARKET:
GET /externalFulfillment/2024-09-11/shipments/{AmazonShipmentId}
  1. Valide se a notificação foi persistida na tabela AMAZON_ORDER_NOTIFICATION, no banco de dados da Amazon;
  2. Se a notificação existir e estiver com process_status = PENDING, ela ainda não foi processada e deve ser processada nos próximos minutos;
  3. Após o processamento, valide se foi gerado um registro na tabela AMAZON_ORDER;
  4. Se o registro estiver com process_status = ERROR, verifique se foi gerado monitoramento para o seller.

Boas práticas

  • Ative a opção FBA OnSite SmartConnect na aba Configurações de Frete da integração Amazon Global API.
  • Garanta que o anúncio esteja configurado como FBA – Fulfillment by Amazon.
  • Ative obrigatoriamente a opção Multi CD Marketplace na transmissão.
  • Vincule todos os Locais de Estoque do ANYMARKET aos respectivos Centros de Distribuição da Amazon.
  • Considere que estoque de local não vinculado não será enviado para a Amazon.
  • Valide o LocationId antes de investigar falha de importação de pedido.
  • Para pedidos com IMEI obrigatório, oriente o seller a preencher a informação pela opção Enviar IMEI.
  • Oriente o seller a revisar dimensões pela opção Editar Dimensões, quando necessário.
  • Considere que o formato da etiqueta é definido na criação do centro de distribuição pela Amazon.
  • Use o LOGSTASH e as tabelas AMAZON_ORDER_NOTIFICATION e AMAZON_ORDER para análise de pedidos não importados.

Dúvidas comuns

O que é FBA OnSite SmartConnect?
É um conjunto de APIs que permite operar o FBA OnSite sem usar o OnSite Tools para gestão de estoque e pedidos, centralizando o fluxo no ANYMARKET.

Quais APIs são utilizadas no SmartConnect?
São utilizadas as APIs ExternalFulfillment da Amazon.

O SmartConnect está disponível para quais países?
Inicialmente para o Brasil. Posteriormente, será liberado para o Seller Flex do México.

O FBA OnSite SmartConnect é elegível ao selo Prime?
Sim, conforme elegibilidade definida pela Amazon.

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

Quem emite a etiqueta?
A etiqueta é disponibilizada por API e pode ser consumida pelo ANYMARKET conforme solicitação pela tela ou API.

Quem faz a entrega e o frete?
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?
O estoque é atualizado automaticamente pelo ANYMARKET, por Local de Estoque, usando a funcionalidade Multi CD Marketplace e as APIs ExternalFulfillment.

Quais opções o anúncio precisa ter?
O anúncio precisa estar como FBA – Fulfillment by Amazon e Multi CD Marketplace.

O que acontece se o anúncio não estiver como Multi CD Marketplace?
O anúncio não receberá atualizações de estoque pelo fluxo SmartConnect.

O que acontece se o Local de Estoque não estiver vinculado ao Centro de Distribuição da Amazon?
O estoque desse local não será enviado para a Amazon. Além disso, se o LocationId da venda não estiver vinculado a um Local de Estoque do ANYMARKET, a venda não será importada.

Qual endpoint atualiza estoque no SmartConnect?
O endpoint /externalFulfillment/inventory/2024-09-11/inventories.

Quando o pedido é importado?
Quando o pedido está com status PAGO e o ANYMARKET recebe a notificação EXTERNAL_FULFILLMENT_SHIPMENT_STATUS_CHANGE com status ACCEPTED.

Quais chamadas são feitas para criar o pedido?
São feitas chamadas para /externalFulfillment/2024-09-11/shipments/{AmazonShipmentId} e /fba/outbound/brazil/v0/shipments/{AmazonShipmentId}.

Como o XML da nota é enviado?
Para pedidos do Brasil, o XML é enviado em Base64 pelo endpoint /fba/outbound/brazil/v0/shipments/{AmazonShipmentId}/invoice.

Quando o IMEI é obrigatório?
Quando o campo serialNumberRequirement retornado pela Amazon estiver como REQUIRED.

Como o seller informa o IMEI?
Pela opção Enviar IMEI na tela da venda, enquanto o pedido estiver nos status PAGO ou FATURADO.

É possível enviar IMEI via API?
Neste primeiro momento, não.

Como são definidas as dimensões do pacote?
A Amazon envia uma dimensão recomendada, que será usada pelo ANYMARKET. O seller pode alterar pela opção Editar Dimensões enquanto o pedido estiver como PAGO.

É possível escolher o formato da etiqueta no ANYMARKET?
Não. O formato é definido na criação do centro de distribuição pela Amazon. Caso o formato esteja incorreto, o seller deve acionar a Amazon.

Quando a etiqueta fica disponível?
Enquanto o pedido estiver com status FATURADO.

Como funciona o rastreio?
Após solicitar a etiqueta, o ANYMARKET disponibiliza a janela de coleta, envia a atualização SHIPPED para a Amazon e aguarda novas notificações para atualizar o pedido como ENVIADO, CONCLUÍDO ou CANCELADO.

É possível importar manualmente pedido SmartConnect?
Não. É necessário verificar se a notificação EXTERNAL_FULFILLMENT_SHIPMENT_STATUS_CHANGE foi recebida.

O que verificar quando o pedido não foi importado?
Verifique o LOGSTASH, a notificação EXTERNAL_FULFILLMENT_SHIPMENT_STATUS_CHANGE, o vínculo do LocationId, a tabela AMAZON_ORDER_NOTIFICATION e o registro na tabela AMAZON_ORDER.

Relativo a

Artigos relacionados

Comentários

0 comentário

Por favor, entre para comentar.

Powered by Zendesk