Pular para o conteúdo principal

FBA – Fulfillment by Amazon (Classic)

Arthur Pereira
Atualizado

Este artigo interno explica o funcionamento do FBA – Fulfillment by Amazon Classic no ANYMARKET, incluindo comportamento de anúncio, preço, estoque, importação de pedidos, faturamento, notas fiscais, etiquetas e rastreio.

O FBA Classic é o fulfillment tradicional da Amazon. Nesse modelo, a mercadoria fica armazenada no centro de distribuição da Amazon, e a própria Amazon é responsável pelo faturamento, emissão da etiqueta, entrega, frete e gestão do estoque.

 

Neste artigo:

 

Pré-requisitos

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

  • O anúncio está configurado como FBA – Fulfillment by Amazon;
  • O produto está armazenado no centro de distribuição da Amazon;
  • A integração Amazon está ativa e autorizada no ANYMARKET;
  • Há acesso ao OUTPUT e ao LOGSTASH para consulta de reports, notificações e chamadas da Amazon;
  • O pedido foi disponibilizado no report GET_AMAZON_FULFILLED_SHIPMENTS_DATA_GENERAL, quando a análise for sobre importação de pedidos.

Como funciona o FBA Classic

No FBA Classic, a Amazon centraliza a operação logística e fiscal do pedido. Por isso, o comportamento esperado é:

  • Selo Prime: elegível;
  • Disponibilidade: todos os países, conforme disponibilidade da Amazon;
  • Nota Fiscal: emitida pela Amazon e disponibilizada no ANYMARKET;
  • Etiqueta: gerada pela Amazon;
  • Entrega e frete: responsabilidade da Amazon;
  • Armazenamento: centro de distribuição da Amazon;
  • Atualização de estoque: controlada pela Amazon.

Como o estoque fica sob gestão da Amazon, o ANYMARKET não realiza atualização de estoque para esse tipo de anúncio. A responsabilidade do ANYMARKET fica concentrada principalmente na atualização de preço e na importação das informações disponibilizadas pela Amazon.

Fluxos técnicos do FBA Classic

Anúncio

O programa FBA – Fulfillment by Amazon, também chamado de FBA Classic, exige que o produto esteja configurado com a opção FBA – Fulfillment by Amazon.

Essa configuração indica que o produto está no estoque da Amazon. Nesse cenário, a gestão de estoque é feita totalmente pela 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 Classic é o fulfillment tradicional. Como o produto está no estoque da Amazon, a gestão de estoque é feita totalmente pela Amazon.

O fulfillment_channel_code sempre será:

AMAZON_NA

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

Esse tipo de anúncio também não permite o 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 FBA Classic só será apresentado no report e importado para o ANYMARKET quando estiver com status ENVIADO.

Por recomendação da Amazon, a importação se inicia após a execução da rotina:

FbaClassicSellerSpecificTask

Essa rotina é executada a cada 6 horas:

  • 00h;
  • 06h;
  • 12h;
  • 18h.

A rotina faz uma chamada POST para gerar o report:

https://sellingpartnerapi-na.amazon.com/reports/2021-06-30/reports

O report gerado é:

GET_AMAZON_FULFILLED_SHIPMENTS_DATA_GENERAL

Esse report busca todos os pedidos das últimas 48 horas ou desde a última execução concluída com sucesso.

Exemplo de log no OUTPUT:

{
  "reportType": "GET_AMAZON_FULFILLED_SHIPMENTS_DATA_GENERAL",
  "dataStartTime": "2025-07-23T12:00:53-03:00",
  "dataEndTime": "2025-07-25T12:00:53-03:00",
  "marketplaceIds": [
    "A2Q3Y263D00KWC"
  ]
}

Depois, a Amazon envia a notificação REPORT_PROCESSING_FINISHED para informar que o report foi finalizado.

Exemplo de log no LOGSTASH:

{
  "notificationVersion": "2020-09-04",
  "notificationType": "REPORT_PROCESSING_FINISHED",
  "payloadVersion": "1.0",
  "eventTime": "2025-07-25T09:01:15.965Z",
  "payload": {
    "reportProcessingFinishedNotification": {
      "sellerId": "A3KW89NPNRUEIV",
      "accountId": "amzn1.merchant.o.A3KW89NPNRUEIV",
      "reportId": "55663020294",
      "reportType": "GET_AMAZON_FULFILLED_SHIPMENTS_DATA_GENERAL",
      "processingStatus": "DONE",
      "reportDocumentId": "amzn1.spdoc.1.4.na.bece7d4d-d63e-485c-a4f4-407a181b3cb7.T3SSH8QVP6B0OQ.2511"
    }
  }
}

Após o report ser finalizado, o ANYMARKET faz uma chamada GET para buscar o documento do report:

https://sellingpartnerapi-na.amazon.com/reports/2021-06-30/documents/{reportDocumentId}

Essa chamada retorna a URL com o arquivo CSV contendo os pedidos FBA. A consulta do arquivo CSV também é logada no OUTPUT e pode ser encontrada pesquisando pela URL.

Exemplo de retorno:

{
  "reportDocumentId": "amzn1.spdoc.1.4.na.bece7d4d-d63e-485c-a4f4-407a181b3cb7.T3SSH8QVP6B0OQ.2511",
  "url": "https://tortuga-prod-na.s3-external-1.amazonaws.com/..."
}

Identificação de pedidos FBA no CSV

Para identificar quais pedidos são FBA Classic dentro do arquivo CSV, o ANYMARKET considera os pedidos cujo fulfillment-center-id contém uma das seguintes referências:

  • GRU;
  • XCV;
  • POA;
  • CNF;
  • REC;
  • GIG.

Os demais pedidos não são considerados FBA Classic nesse fluxo. Eles podem ser FBA OnSite, mas não serão tratados como FBA Classic.

As informações necessárias para importação do pedido são extraídas do arquivo CSV.

Os pedidos serão criados no ANYMARKET já com status ENVIADO.

Faturamento

No FBA Classic, a mercadoria está no centro de distribuição da Amazon. Por isso, a Amazon é responsável por realizar o faturamento do pedido.

Após o faturamento, a Amazon disponibiliza as notas fiscais.

Para consumir essas notas fiscais, o ANYMARKET executa a rotina:

GetFbaInvoicesExportScheduler#getFbaInvoicesDaily

Essa rotina é executada todos os dias às 03h da manhã, buscando todas as notas fiscais das últimas 48 horas.

A chamada realizada é:

GET https://sellingpartnerapi-na.amazon.com/tax/invoices/2024-06-19/exports

Exemplo de request e response:

{
  "dateEnd": "2025-07-25T06:00:16Z",
  "dateStart": "2025-07-23T06:00:03Z",
  "fileFormat": "XML",
  "marketplaceId": "A2Q3Y263D00KWC",
  "statuses": [
    "AUTHORIZED",
    "CANCELED"
  ]
}

Response:
{
  "exportId": "ff079b98-44e8-4d04-91ba-c765496f10fd"
}

Consulta e download das notas fiscais

A cada 30 minutos, o ANYMARKET executa uma rotina para verificar se a solicitação das notas está pronta na Amazon e baixar os arquivos:

GetFbaInvoicesExportScheduler#getFbaInvoiceExports

Exemplo de consulta:

https://sellingpartnerapi-na.amazon.com/tax/invoices/2024-06-19/exports?marketplaceId=A2Q3Y263D00KWC&dateStart=2025-07-24T06%3A30%3A00.269Z&nextToken=6a1f3380-cb3b-4bb2-9a0a-f6edefac3949&pageSize=100&status=DONE

Exemplo de retorno:

{
  "exports": [
    {
      "generateExportFinishedAt": "2025-07-25T06:03:35Z",
      "invoicesDocumentIds": [
        "6c0176b5-2d04-400e-b5a1-9924d46666cb"
      ],
      "generateExportStartedAt": "2025-07-25T06:00:16Z",
      "exportId": "ff079b98-44e8-4d04-91ba-c765496f10fd",
      "status": "DONE"
    }
  ]
}

Quando a Amazon retorna que o exportId está com status DONE, o ANYMARKET consulta o arquivo com as notas fiscais utilizando o invoicesDocumentId:

https://sellingpartnerapi-na.amazon.com/tax/invoices/2024-06-19/documents/{invoicesDocumentId}

Essa chamada retorna a URL com o arquivo das notas fiscais. O arquivo é salvo no S3.

Exemplo simplificado de retorno:

{
  "invoicesDocument": {
    "invoicesDocumentUrl": "https://prod-us-east-1-cdo-gisv3-invoicing-central-action-data.s3.amazonaws.com/...",
    "invoicesDocumentId": "6c0176b5-2d04-400e-b5a1-9924d46666cb"
  }
}

Rotinas de retentativa de notas fiscais

Além das rotinas principais, existem rotinas para retentativas:

  • GetFbaInvoicesExportScheduler#retryGetInvoiceExportsWithError: retenta solicitações de notas que apresentaram erro;
  • GetFbaInvoicesExportScheduler#getFbaInvoiceExportsWithError: retenta o download de notas que apresentaram erro.

Por isso, pode acontecer de a rotina retornar notas fiscais que ainda não possuem pedido no ANYMARKET. Nesse caso, não será possível relacionar a nota a um pedido naquele momento.

Na próxima execução da rotina, o pedido será importado e a nota será vinculada.

Tipos de notas fiscais da Amazon

A Amazon disponibiliza diversos tipos de notas fiscais. O ANYMARKET padroniza esses tipos no retorno da API.

Para esclarecer esse processo, consulte a tabela abaixo:

Para obter as notas fiscais, o vendedor precisa desenvolver o fluxo de consumo de notas fiscais do ANYMARKET pelo endpoint:

/fulfillment/{marketplace}/documents

Para mais detalhes, consulte:

Como obter as notas fiscais do FBA Classic da Amazon

Emissão de etiqueta

Como, no pedido FBA Classic, a Amazon está em posse da mercadoria, ela é responsável por emitir a etiqueta.

A etiqueta não é disponibilizada para o ANYMARKET.

Informações de rastreio

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

Acompanhamento de rastreio

Como a Amazon é responsável pela logística desse pedido, o status final do pedido no ANYMARKET será ENVIADO.

Não existe um serviço que permita ao ANYMARKET consultar ou marcar automaticamente o pedido como ENTREGUE nesse fluxo.

Caso o vendedor deseje, ele pode enviar atualizações de status para o ANYMARKET. Nesse caso, o pedido será atualizado apenas no ANYMARKET.

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

Importação manual de pedidos

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

Quando houver necessidade de análise, verifique se o pedido foi disponibilizado na última consulta do report:

GET_AMAZON_FULFILLED_SHIPMENTS_DATA_GENERAL

Boas práticas

  • Confirme se o anúncio está configurado como FBA – Fulfillment by Amazon.
  • Considere que a Amazon controla o estoque e o ANYMARKET não envia atualização de estoque nesse fluxo.
  • Valide que o fulfillment_channel_code está como AMAZON_NA.
  • Não envie tempo de preparo ou crossdocking em anúncios FBA Classic.
  • Pesquise o report GET_AMAZON_FULFILLED_SHIPMENTS_DATA_GENERAL para validar importação de pedidos.
  • Considere que pedidos FBA Classic são criados no ANYMARKET já como ENVIADO.
  • Ao analisar notas fiscais sem pedido vinculado, aguarde a próxima execução da rotina para validar se o vínculo será criado.
  • Use o endpoint /fulfillment/{marketplace}/documents para consumo de notas fiscais pelo fluxo externo.
  • Não espere etiqueta ou rastreio no ANYMARKET, pois essas informações não são disponibilizadas pela Amazon nesse fluxo.

Dúvidas comuns

O que é FBA Classic?
É o fulfillment tradicional da Amazon, em que a mercadoria fica armazenada no centro de distribuição da Amazon, e a Amazon é responsável por estoque, faturamento, etiqueta, entrega e frete.

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

Quem controla o estoque no FBA Classic?
A Amazon. O ANYMARKET não envia atualização de estoque para anúncios FBA Classic.

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

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

O que o ANYMARKET atualiza no anúncio FBA Classic?
O ANYMARKET atualiza o preço, enviando our_price e, quando aplicável, discounted_price.

Quando o pedido FBA Classic é importado?
O pedido só é apresentado no report e importado para o ANYMARKET quando estiver com status ENVIADO.

Qual rotina gera o report de pedidos FBA Classic?
A rotina FbaClassicSellerSpecificTask, executada a cada 6 horas.

Qual report é utilizado para importar pedidos FBA Classic?
O report GET_AMAZON_FULFILLED_SHIPMENTS_DATA_GENERAL.

Como identifico pedidos FBA Classic no CSV?
Pelo campo fulfillment-center-id, considerando referências como GRU, XCV, POA, CNF, REC e GIG.

Com qual status o pedido é criado no ANYMARKET?
O pedido FBA Classic é criado no ANYMARKET com status ENVIADO.

Quem emite a nota fiscal?
A Amazon emite a nota fiscal e a disponibiliza para consumo pelo ANYMARKET.

Qual rotina busca as notas fiscais?
A rotina GetFbaInvoicesExportScheduler#getFbaInvoicesDaily, executada diariamente às 03h.

Como o vendedor obtém as notas fiscais?
O vendedor precisa consumir as notas pelo endpoint /fulfillment/{marketplace}/documents.

A etiqueta fica disponível no ANYMARKET?
Não. A etiqueta é emitida pela Amazon e não é disponibilizada para o ANYMARKET.

O rastreio fica disponível no ANYMARKET?
Não. A Amazon não disponibiliza os dados de rastreio desse pedido para o ANYMARKET.

O pedido será atualizado para Entregue automaticamente?
Não. Como não existe serviço de consulta de entrega para esse fluxo, o status final no ANYMARKET será ENVIADO.

Posso atualizar o status manualmente no ANYMARKET?
Sim. O vendedor pode enviar status para o ANYMARKET, mas essa atualização ficará apenas no ANYMARKET e não será enviada para a Amazon.

É possível importar manualmente pedido FBA Classic pela tela de Pedidos?
Não. Para análise, verifique se o pedido foi disponibilizado no último report GET_AMAZON_FULFILLED_SHIPMENTS_DATA_GENERAL.

 

Em caso de dúvidas sobre o fluxo interno de FBA Classic no ANYMARKET, consulte os logs no OUTPUT e LOGSTASH ou acione o time responsável pela integração Amazon.

Relativo a

Artigos relacionados

Comentários

0 comentário

Por favor, entre para comentar.

Powered by Zendesk