Central de Ajuda - Integração de Listagem Amazon

Última atualização: 09/09/2026

Esta página reúne toda a documentação de listagem de produtos na Amazon pela plataforma GoDeep. Aqui você encontra como configurar a integração, publicar produtos, corrigir erros e usar os recursos avançados de catálogo.

A integração usa a Amazon Selling Partner API (SP-API), pela Listings Items API v2021-08-01, para gerenciar todo o ciclo de vida dos produtos no marketplace.

Onde encontrar cada funcionalidade

Funcionalidade	Seção
Criação de ofertas	3. Como criar uma oferta
Atualização de preço e estoque	6. Como atualizar o preço e 7. Como atualizar o estoque
Restrições de listagem	8. Como identificar produtos com restrição
Criação de produtos novos	4. Como criar um produto novo
Listagem de produtos com variação	5. Como listar produtos com variação
Consulta de erros síncronos e assíncronos	9. Como consultar os erros de listagem
List Now (ofertas ainda não publicadas)	10. Como publicar ofertas pendentes (List Now)
Listagem em massa	11. Como listar produtos em massa
Integração reversa	12. Como importar ofertas já existentes na Amazon
Remoção de fundo de imagens	15. Como remover o fundo das imagens
Mapeamento de categoria	13. Como funciona o mapeamento de categoria
Edição de atributos de produtos já listados	14. Como editar atributos de produtos já listados

Índice

Antes de começar: configure a integração

Como funciona o fluxo de listagem

Como criar uma oferta

Como criar um produto novo no catálogo da Amazon

Como listar produtos com variação

Como atualizar o preço

Como atualizar o estoque

Como identificar produtos com restrição de venda

Como consultar os erros de listagem

10.

Como publicar ofertas pendentes (List Now)

11.

Como listar produtos em massa

12.

Como importar ofertas já existentes na Amazon (integração reversa)

13.

Como funciona o mapeamento de categoria

14.

Como editar atributos de produtos já listados

15.

Como remover o fundo das imagens

16.

Como enviar imagens do produto

17.

Marketplaces suportados

18.

Glossário

19.

Histórico de alterações

1. Antes de começar: configure a integração

Antes de publicar qualquer produto, a integração precisa estar configurada. Sem essas definições, os envios são recusados pela Amazon.

1.1. Acesse as configurações do marketplace

Etapa 1. No menu lateral do Admin, acesse Configurações > Gerais.

Etapa 2. No lado esquerdo, localize o grupo Marketplace Amazon Hub.

Grupo Marketplace Amazon Hub nas configurações

Etapa 3. Preencha as configurações de produto conforme a tabela abaixo.

Tela de configurações de produto do marketplace

1.2. O que cada configuração faz

Configuração	Para que serve
Código de integração	Define qual campo do seu cadastro será usado como SKU na Amazon. Opções: ISBN, ISBN13, COD_BARRAS, COD_PRODUTO ou EAN
Composição do nome	Define como o título do produto será montado. Aceita os marcadores {NOME}, {CODIGO_PRODUTO}, {ISBN}, {EAN}, {MARCA}, {MODELO} e {VARIACAO}
Reserva de estoque	Quantidade subtraída do estoque disponível no momento do envio, para evitar venda sem lastro
Tabela de frete (Shipping Template)	Nome do Merchant Shipping Group configurado na Amazon
Código BISAC padrão	Código BISAC usado quando o produto não tem código próprio
Descrição BISAC padrão	Descrição BISAC usada quando o produto não tem descrição própria

Atenção: a Tabela de Frete é obrigatória para o envio de ofertas. O nome precisa ser idêntico ao do template de envio cadastrado no Seller Central da Amazon. Qualquer diferença de escrita faz a oferta ser recusada.

1.3. Defina quais produtos serão enviados (Seletor de Mix)

Etapa 1. Acesse a configuração do marketplace Amazon Hub.

Etapa 2. Selecione ou crie um Seletor de Mix com os produtos que devem ir para a Amazon.

Etapa 3. Confirme. Só entram na integração os produtos que estão no Seletor de Mix e estão ativos na plataforma.

2. Como funciona o fluxo de listagem

Todo produto passa por 8 etapas, executadas automaticamente por rotinas programadas (crons). Você não precisa disparar nada manualmente: basta configurar a integração e manter os dados dos produtos corretos.

Diagrama do fluxo de listagem em 8 etapas

Ordem	Etapa	O que acontece
1ª	Verificação de catálogo	Verifica se o produto já existe no catálogo do vendedor na Amazon
2ª	Matching	Busca o produto no catálogo da Amazon por ISBN ou EAN para encontrar o ASIN correspondente
3ª	Verificação de restrições	Verifica se o vendedor tem permissão para vender aquele produto
4ª	Listing ou oferta	Cria um produto novo ou envia a oferta em um ASIN já existente
5ª	Imagens	Envia as imagens do produto
6ª	Preço	Envia o preço de venda e as promoções
7ª	Estoque	Envia a quantidade disponível
8ª	Feeds	Monitora o processamento e o retorno dos envios

Onde acompanhar: menu lateral > Marketplaces > Marketplace Amazon Hub > Produtos.

Menu Marketplaces, Marketplace Amazon Hub, Produtos

Listagem de produtos do Hub com os status

3. Como criar uma oferta

Criar uma oferta é vincular a sua venda a um produto que já existe no catálogo da Amazon. Você não cadastra título, descrição ou atributos: esses dados pertencem ao anúncio existente. Você informa apenas as condições da sua venda.

3.1. Passo a passo

Etapa 1. Confirme que o produto está ativo e dentro do Seletor de Mix (veja a seção 1.3).

Etapa 2. Confirme que o produto tem ISBN-13 ou EAN preenchido. É por esse código que a Amazon localiza o anúncio.

Etapa 3. Aguarde a rotina automática. O sistema busca o produto no catálogo da Amazon (matching) e, ao encontrar o ASIN correspondente, vincula o produto e envia a oferta.

Etapa 4. Acompanhe o resultado em Marketplaces > Marketplace Amazon Hub > Produtos, na coluna Envio do produto.

Etapa 5. Quando o status ficar Integrado, a oferta foi aceita. O sistema segue automaticamente para o envio de imagem, preço e estoque.

3.2. Dados enviados na oferta

Dado	Descrição
ASIN	Código do produto na Amazon, obtido pelo matching
Condição	Novo, Usado - Como Novo, Usado - Muito Bom, Usado - Bom ou Usado - Aceitável
Tabela de frete	Merchant Shipping Group configurado
Imagem principal	URL da imagem principal do produto
Marketplace	Marketplace de destino do envio

3.3. Como o produto é localizado no catálogo

Verificação de catálogo (1ª etapa). O sistema consulta a Amazon pelo SKU do produto. Se ele já existe no seu catálogo, o fluxo pula direto para a atualização de preço e estoque.

Matching (2ª etapa). Se não existe no seu catálogo, o sistema busca no catálogo geral da Amazon pelo ISBN-13, EAN ou GTIN:

se encontrar um ASIN correspondente, o produto é vinculado e a oferta é criada

se não encontrar, o produto segue para criação de produto novo

3.4. Conversão automática de produto novo para oferta

Às vezes um produto entra na fila para ser criado do zero, mas o sistema identifica depois que ele já existe no catálogo. Quando isso acontece:

o sistema detecta que o produto já tem um ASIN na Amazon

converte o envio de "produto novo" para "oferta"

envia apenas a oferta, evitando duplicar o catálogo

O processo é automático e não exige nenhuma ação sua.

4. Como criar um produto novo no catálogo da Amazon

Quando nenhum ASIN corresponde ao ISBN-13 ou EAN do produto, o sistema entende que ele ainda não existe na Amazon e cria o anúncio do zero, enviando todos os dados.

4.1. Antes de enviar: confira os pré-requisitos

Produtos que não atendem a todos os itens abaixo são barrados na validação prévia e não chegam a ser enviados.

ISBN-13 ou EAN válido

Título com no mínimo 1 e no máximo 200 caracteres

Descrição preenchida

Altura, largura e comprimento preenchidos

Peso preenchido

Editora ou fabricante preenchido

Tabela de frete (Merchant Shipping Group) configurada

Produto ativo e dentro do Seletor de Mix

4.2. Passo a passo

Etapa 1. Preencha o cadastro do produto conforme a lista de pré-requisitos acima.

Etapa 2. Preencha as dimensões e o peso.

Etapa 3. Aguarde a rotina automática. Antes de criar o produto, o sistema faz uma validação prévia com a Amazon (modo VALIDATION_PREVIEW da Listings Items API), que aponta erros nos dados antes do envio real.

Resultado da validação	O que acontece
VALID ou ACCEPTED	Dados válidos, o produto segue para criação
INVALID	Dados inválidos, o produto não é enviado e a mensagem de erro fica salva no produto

Etapa 4. Se a validação passar, o produto é enviado à Amazon.

Etapa 5. Acompanhe o retorno na listagem de produtos do Hub.

Status retornado	O que significa	O que fazer
ACCEPTED	Produto aceito, será criado no catálogo	Aguardar até 15 minutos pela publicação
DISCOVERABLE	Produto visível no catálogo, mas ainda sem oferta ativa	Nada. O sistema agenda o envio de preço e estoque
BUYABLE	Produto disponível para compra	Nada, publicação concluída
INVALID	Rejeitado pela Amazon	Verificar a mensagem de erro e corrigir os dados

Etapa 6. Assim que o produto é aceito, o sistema agenda automaticamente o envio de preço e estoque para ativar a sua oferta.

4.3. Dados enviados na criação

Atributo	Descrição
item_name	Título do produto, conforme a composição configurada
product_description	Descrição completa
author	Nome do autor principal
manufacturer	Editora ou fabricante
externally_assigned_product_identifier	ISBN-13 do produto
binding	Tipo de encadernação (capa dura, brochura e outros)
language	Idioma da publicação
pages	Número de páginas
publication_date	Data de publicação ou edição
item_dimensions	Altura, largura e comprimento, em centímetros
item_package_weight	Peso do pacote, em gramas
list_price	Preço de capa ou MSRP
country_of_origin	País de fabricação ou edição
subject	Descrição BISAC
subject_code	Código BISAC
batteries_required	Indica se o item exige pilhas ou baterias. Em livros, sempre false
supplier_declared_dg_hz_regulation	Declaração de regulamentação de materiais perigosos

Tipo de produto: a integração usa o product type ABIS_BOOK, com requirements igual a LISTING_PRODUCT_ONLY. O schema de atributos é buscado automaticamente na Amazon pela Product Type Definitions API antes de cada envio, o que garante que os dados sigam sempre a versão mais recente exigida pelo marketplace.

5. Como listar produtos com variação

Na plataforma GoDeep, cada variação de um produto (capa dura e brochura, edição normal e pocket) é um produto independente, com cadastro e código próprios.

5.1. Como as variações são tratadas

cada variação é um produto separado na plataforma

cada variação tem o seu próprio ISBN-13 ou EAN

cada variação passa pelo fluxo completo de 8 etapas individualmente

cada variação pode ter um ASIN diferente, já que cada edição tem o seu

preço e estoque são independentes por variação

5.2. Passo a passo

Etapa 1. Cadastre cada variação como um produto, com o seu ISBN-13 ou EAN próprio.

Etapa 2. Preencha o campo Variação de cada produto (por exemplo: "Edição Pocket").

Etapa 3. Em Configurações > Gerais > Marketplace Amazon Hub, inclua o marcador {VARIACAO} na Composição do nome, para que a variação apareça no título enviado.

Exemplo: com a composição {NOME} - {VARIACAO}, o título enviado fica "O Pequeno Príncipe - Edição Pocket".

Etapa 4. Inclua todas as variações no Seletor de Mix e aguarde a rotina. Cada uma será listada individualmente.

5.3. Exemplo prático

Produto	Variação	SKU	ISBN-13	ASIN	Preço
O Pequeno Príncipe	Brochura	SKU-001	978-85-XXX-0001	B08XXX001	R$ 29,90
O Pequeno Príncipe	Capa Dura	SKU-002	978-85-XXX-0002	B08XXX002	R$ 49,90
O Pequeno Príncipe	Pocket	SKU-003	978-85-XXX-0003	B08XXX003	R$ 19,90

Observação: na Amazon, variações de um mesmo produto podem aparecer agrupadas quando compartilham o mesmo parent ASIN no catálogo. Esse agrupamento é feito pelo próprio catálogo da Amazon. A integração gerencia cada variação como um produto ou oferta individual.

6. Como atualizar o preço

Os preços são sincronizados automaticamente entre a plataforma e a Amazon. Você altera o preço no Admin e a próxima rotina envia a mudança.

6.1. Passo a passo

Etapa 1. No Admin, abra o cadastro do produto e altere o preço por (preço de venda).

Etapa 2. Se quiser exibir preço riscado, preencha também o preço de (preço de comparação).

Etapa 3. Para promoções, informe a data de início e a data de fim.

Etapa 4. Salve. Na próxima execução da rotina, o preço é enviado à Amazon.

Etapa 5. Acompanhe o resultado na coluna Preço da listagem de produtos do Hub.

6.2. Como o preço é enviado

o preço por é enviado como preço do produto na Amazon

o preço de é enviado como preço riscado (strike-through)

promoções com data de início e fim são suportadas

para marketplaces internacionais, a conversão de moeda é automática

Marketplace	Moeda	Conversão
Brasil (BR)	BRL, Real	Sem conversão
Estados Unidos (US)	USD, Dólar	BRL para USD, automática
Canadá (CA)	CAD, Dólar canadense	BRL para CAD, automática
México (MX)	MXN, Peso mexicano	BRL para MXN, automática

7. Como atualizar o estoque

O estoque também é sincronizado automaticamente.

7.1. Passo a passo

Etapa 1. Altere a quantidade em estoque no cadastro do produto.

Etapa 2. Se você usa reserva de estoque, confira o valor configurado em Configurações > Gerais > Marketplace Amazon Hub. Essa quantidade é subtraída antes do envio.

Etapa 3. Salve. A próxima rotina envia a atualização à Amazon.

Etapa 4. Acompanhe o resultado na coluna Estoque da listagem de produtos do Hub.

7.2. Regras de estoque

quando o estoque chega a zero, o produto é pausado automaticamente na Amazon

se houver reserva de estoque configurada, ela é subtraída antes do envio

periodicamente o sistema compara o estoque enviado com o estoque atual da plataforma. Se encontrar divergência, envia uma atualização corretiva automática (conciliação de estoque)

8. Como identificar produtos com restrição de venda

A Amazon limita quem pode vender determinados produtos, por categoria ou por marca (brand gating). Antes de enviar, o sistema verifica se você tem permissão para vender aquele item.

8.1. Como a verificação funciona

Na 3ª etapa do fluxo, o sistema consulta as restrições de venda para o ASIN no marketplace escolhido:

se houver restrição, o produto é marcado como Restrito e não é enviado

se não houver, o produto segue para a criação do produto ou da oferta

8.2. Passo a passo para consultar

Etapa 1. No menu lateral, acesse Marketplaces > Marketplace Amazon Hub > Produtos.

Etapa 2. Use o filtro de status e selecione Restrito.

Etapa 3. A listagem exibe os produtos restritos com a mensagem de restrição retornada pela Amazon.

Listagem de produtos com restrição de venda

Etapa 4. Para liberar o produto, solicite aprovação diretamente no Seller Central da Amazon.

Etapa 5. Depois da aprovação, não é preciso fazer nada no Admin: o sistema reavalia o produto automaticamente na próxima rotina e segue com o envio.

9. Como consultar os erros de listagem

A Amazon devolve erros de duas formas: síncronos, na hora da chamada, e assíncronos, depois do processamento em lote. Os dois tipos são consultados em telas diferentes.

Diagrama comparando erros síncronos e assíncronos

9.1. Erros síncronos

Ocorrem na criação de produto, no envio de oferta e na atualização de preço individual. A resposta da API traz:

o campo status: ACCEPTED, VALID, BUYABLE, DISCOVERABLE ou INVALID

uma lista de issues com os problemas encontrados

cada issue traz código, mensagem e severidade (ERROR, WARNING ou INFO)

Quando o status é INVALID, o produto é marcado com erro e a mensagem aparece na listagem.

Como consultar:

Etapa 1. Acesse Marketplaces > Marketplace Amazon Hub > Produtos.

Etapa 2. Localize o produto com status de erro.

Etapa 3. Abra o detalhe do produto ou consulte a coluna Mensagem para ver o retorno da Amazon.

Erros síncronos mais comuns:**

Código	Mensagem	O que fazer
90117	Imagem não atende aos requisitos mínimos	Enviar imagem com pelo menos 1000px no lado maior
8572	Preço ausente ou inválido	Verificar a configuração de preço do produto
8541	SKU não existe no catálogo	Verificar se o produto foi criado corretamente
99010	Atributo obrigatório ausente	Preencher o campo indicado na mensagem

9.2. Erros assíncronos

Ocorrem no processamento em lote, quando preço e estoque são atualizados em massa por feeds.

Como funciona:

o feed é enviado e recebe um feedId

o sistema monitora o status periodicamente: IN_QUEUE, IN_PROGRESS e depois DONE, CANCELLED ou FATAL

quando chega em DONE, o documento de resultado é baixado

cada item pode ter severidade ERROR (falha total) ou WARNING (aceito com ressalvas)

os erros são vinculados ao produto específico pelo messageId

Status do feed	O que significa
IN_QUEUE	Aguardando processamento
IN_PROGRESS	Em processamento
DONE	Processamento concluído
CANCELLED	Cancelado pela Amazon
FATAL	Erro crítico no processamento

Como consultar:

Etapa 1. No menu lateral, acesse Marketplaces > Marketplace Amazon Hub > Feeds.

Etapa 2.** A listagem mostra todos os feeds enviados, com data, tipo e status.

Listagem de feeds com os status de processamento

Etapa 3.** Localize um feed com status Processado com erros e clique no ícone de detalhes.

Etapa 4. O sistema exibe os erros retornados pela Amazon para cada produto do lote.

Detalhe do feed com os erros por produto

Status dos feeds no painel:**

Status	O que significa
Pendente	Feed gerado, aguardando envio
Enviado	Enviado à Amazon, aguardando processamento
Em processamento	A Amazon está processando
Processado	Processado com sucesso
Processado com erros	Processado, mas alguns itens falharam
Cancelado	Feed cancelado

9.3. Reenvio automático

Envios que falham são reenviados automaticamente pelo sistema. O número de tentativas é limitado, para evitar repetição de erros permanentes. Erros que persistem exigem correção do cadastro.

9.4. Como reenviar um produto manualmente

Etapa 1. Corrija o dado que gerou o erro no cadastro do produto.

Etapa 2. Na listagem de produtos do Hub, localize o produto.

Etapa 3. Use a opção de reenviar / reintegrar nas ações do produto.

Etapa 4.** O produto volta para a fila e passa por todas as etapas novamente.

10. Como publicar ofertas pendentes (List Now)

List Now é a identificação de produtos que já estão no catálogo da Amazon vinculados a você, mas ainda não têm oferta ativa. Eles aparecem no catálogo, porém não podem ser comprados.

10.1. Como reconhecer o status

Status na Amazon	O que significa	Pode ser comprado?
BUYABLE	Oferta ativa, produto disponível	Sim
DISCOVERABLE	No catálogo, visível, mas sem oferta ativa	Não
VALID	Produto válido, processamento em andamento	Ainda não
ACCEPTED	Aceito, aguardando publicação	Ainda não
INVALID	Dados inválidos	Não

Produtos em DISCOVERABLE são exatamente os casos de List Now.

10.2. Passo a passo

Etapa 1. No menu lateral, acesse Marketplaces > Marketplace Amazon Hub > Produtos.

Etapa 2. Consulte a coluna Status Marketplace, que mostra o status atual do produto na Amazon.

Coluna Status Marketplace com produtos DISCOVERABLE

Etapa 3.** Filtre por DISCOVERABLE para identificar rapidamente as ofertas pendentes.

Etapa 4. Não é preciso fazer nada: ao detectar um produto DISCOVERABLE, o sistema agenda automaticamente o envio de preço e estoque para ativar a oferta.

Etapa 5. Depois do envio bem-sucedido, o status muda para BUYABLE e o produto passa a ser vendável.

10.3. O produto continua DISCOVERABLE. E agora?

Se o status não mudar depois do envio, verifique:

se o preço foi aceito sem erros

se o estoque está maior que zero

se não há issues pendentes no produto (veja a seção 9)

se a Tabela de Frete está configurada corretamente (veja a seção 1.2)

11. Como listar produtos em massa

A listagem em massa não exige envio produto a produto. Você define o conjunto de produtos e o sistema processa todos em lote, por meio de feeds enviados à Amazon.

11.1. Passo a passo

Etapa 1. Prepare os cadastros dos produtos que serão listados, seguindo os pré-requisitos da seção 4.1.

Etapa 2. Acesse Configurações > Gerais > Marketplace Amazon Hub e abra o Seletor de Mix.

Etapa 3. Inclua no seletor todos os produtos que devem ser enviados. É esse conjunto que define o lote de listagem.

Etapa 4. Salve. A rotina automática processa todos os produtos do seletor, agrupando as operações em feeds.

Etapa 5. Acompanhe o processamento do lote em Marketplaces > Marketplace Amazon Hub > Feeds.

Etapa 6. Quando o feed retornar Processado ou Processado com erros, abra o detalhe para ver o resultado item a item.

11.2. Vínculo em massa de SKUs

Se você já vende na Amazon e precisa vincular vários produtos de uma vez, use a importação de de/para por CSV, descrita na seção 12.4.

12. Como importar ofertas já existentes na Amazon (integração reversa)

Se você já tem ofertas ativas no Seller Central que não foram criadas pela integração, é possível importá-las e vinculá-las aos produtos da plataforma. A partir daí, a integração passa a gerenciar preço, estoque e dados desses produtos.

12.1. Como a importação funciona

O sistema baixa automaticamente o relatório GET_MERCHANT_LISTINGS_ALL_DATA da SP-API, que traz todas as suas ofertas ativas:

solicita a geração do relatório à Amazon

aguarda o processamento

baixa o arquivo quando fica pronto

processa os dados e tenta identificar cada produto na plataforma

12.2. Vínculo automático por SKU

Quando o SKU da Amazon é idêntico ao código do produto na plataforma, o vínculo é feito sozinho:

o sistema compara o seller-sku do relatório com o código do produto no Hub

havendo correspondência exata, o vínculo é criado

o ASIN é gravado como código externo do produto

12.3. Produtos órfãos: o que são e como resolver

Produtos que existem na Amazon mas não têm correspondência na plataforma são classificados como órfãos. Eles ficam disponíveis em uma tela dedicada, com SKU, ASIN, nome, status, estoque e preço.

Etapa 1. No menu lateral, acesse Marketplaces > Amazon Hub > Produtos Órfãos.

Etapa 2. Use os filtros para localizar o produto. É possível buscar por SKU, ASIN ou nome, e filtrar por status ativo ou inativo.

Etapa 3. Escolha a ação desejada:

Ação	Ícone	O que faz
Vincular	🔍	Busca um produto da plataforma para vincular ao órfão
Remover	♻️	Remove o produto do marketplace Amazon
Zerar estoque	⏸️	Zera o estoque na Amazon, pausando a venda

Etapa 4. Para vincular, clique no ícone 🔍. A tela mostra os dados do produto órfão (SKU Amazon, ASIN e nome).

Etapa 5. No campo de busca, localize o produto da plataforma. A busca aceita código do produto, nome ou ISBN-13. Só aparecem produtos que ainda não estão vinculados a outro marketplace.

Etapa 6. Confirme. O ASIN é vinculado ao produto da plataforma.

12.4. Vínculo em massa por CSV (de/para de SKUs)

Quando o SKU da Amazon é diferente do código usado na plataforma, faça o mapeamento em lote.

Etapa 1. Na tela de produtos órfãos, clique em Importar de/para SKUs (CSV).

Etapa 2. Baixe o arquivo Órfãos atuais, que exporta todos os órfãos com as colunas SKU Amazon;SKU Local;ASIN;Nome, já com a coluna SKU Local em branco para você preencher.

Etapa 3. Preencha a coluna SKU Local com o código correspondente de cada produto na plataforma.

Etapa 4. Faça o upload do arquivo preenchido.

Etapa 5. O sistema processa linha a linha e exibe o resultado de cada par, com sucesso ou erro.

Formatos aceitos: o arquivo pode usar ponto e vírgula (;), vírgula (,) ou tabulação como separador. As colunas são identificadas automaticamente pelo cabeçalho.

12.5. Criação automática de produto por pedido

Quando chega um pedido da Amazon com um SKU que não existe na plataforma, o sistema pode criar automaticamente um produto provisório. O comportamento é controlado pelo parâmetro inserir_pedidos_sem_produtos.

13. Como funciona o mapeamento de categoria

Na Amazon, a categoria de um produto é determinada por dois elementos: o Product Type, que define quais atributos são obrigatórios, e a classificação por assunto, que posiciona o produto na navegação da loja.

13.1. Product Type

A integração usa o product type ABIS_BOOK, específico para livros e publicações. Antes de cada envio, o sistema busca o schema de atributos desse tipo diretamente na Amazon, pela Product Type Definitions API. Isso garante que a lista de atributos obrigatórios esteja sempre atualizada, mesmo quando a Amazon muda as regras.

Você não precisa escolher o Product Type manualmente.

13.2. Classificação por assunto (BISAC)

O posicionamento do produto nas categorias da loja é feito pelo código BISAC, padrão internacional de classificação temática da indústria editorial. Ele é enviado nos atributos subject_code (código) e subject (descrição).

Etapa 1. Preencha o código e a descrição BISAC no cadastro do produto.

Etapa 2. Para os produtos que não têm BISAC próprio, configure um valor padrão em Configurações > Gerais > Marketplace Amazon Hub, nos campos Código BISAC padrão e Descrição BISAC padrão.

Etapa 3. Salve. A partir daí, todo produto sem BISAC próprio é enviado com o código padrão configurado.

13.3. Boas práticas de classificação

use o BISAC mais específico possível. Códigos genéricos posicionam o livro em categorias amplas e de menor conversão

revise o BISAC padrão periodicamente: ele deve refletir o assunto predominante do seu catálogo

quando o produto é criado por matching em um ASIN existente, a categoria é a do anúncio já publicado, e não a do seu cadastro

14. Como editar atributos de produtos já listados

Depois de publicado, é possível editar atributos do produto, como descrição, peso, dimensões e outros dados de catálogo. As alterações passam pela aprovação da Amazon.

14.1. Atributos com tela própria

Alguns atributos não são editados na tela genérica porque têm fluxo dedicado:

Atributo	Onde editar
Título (item_name)	Tela de Qualidade de Catálogo, ícone ⭐ na lista de produtos
Bullet points	Tela de Qualidade de Catálogo, ícone ⭐
Imagens	Tela de Qualidade de Catálogo e rotina automática de imagens
Preço e estoque	Rotinas automáticas (seções 6 e 7)
Canal de fulfillment (FBA ou MFN)	Tela Converter Oferta, ícone 🚚 na lista de produtos
Condição (condition_type)	Definido na criação da oferta
Tabela de frete (merchant_shipping_group)	Definido na criação da oferta

14.2. Passo a passo da edição genérica

Etapa 1. Acesse Marketplaces > Marketplace Amazon Hub > Produtos e localize o produto.

Etapa 2. Clique no ícone ✏️ (lápis verde) na linha do produto.

Etapa 3. A tela é dividida em duas áreas:

Atributos do produto: os que já estão preenchidos na listagem, prontos para edição

Atributos disponíveis para adicionar: seção recolhível com os atributos do schema que ainda não foram preenchidos

Etapa 4. Se a lista for longa, use o campo de busca para localizar o atributo por nome ou chave.

Etapa 5. Edite os campos desejados.

Etapa 6. Clique em Enviar alterações para a Amazon. O sistema envia via patchListingsItem da Listings Items API.

Etapa 7. A Amazon retorna o resultado: aceito, rejeitado ou aceito com observações.

Atenção: alterações aprovadas entram em vigor em até 24 horas. Nem toda edição é aceita. A aprovação depende de fatores como a sua autorização para editar aquele ASIN e a validade do conteúdo enviado. Produtos vinculados por matching pertencem ao detentor do ASIN, o que limita o que você pode alterar.

14.3. Atributos editáveis nessa tela

A tela permite editar qualquer atributo marcado como editável no schema da Amazon para aquele Product Type. Exemplos:

descrição do produto (product_description)

peso (item_weight)

dimensões (item_length, item_width, item_height)

marca (brand)

fabricante (manufacturer)

número de páginas (pages)

autor (author)

qualquer outro atributo retornado pelo schema do Product Type

15. Como remover o fundo das imagens

A Amazon exige fundo branco puro na imagem principal. A plataforma tem uma ferramenta própria para trocar o fundo da imagem por branco (#FFFFFF), sem precisar de editor externo.

15.1. Passo a passo

Etapa 1. Na lista de produtos do Hub, clique no ícone ⭐ para abrir a tela de Qualidade de Catálogo.

Etapa 2. Na seção Imagens, clique em Remover fundo na imagem desejada.

Etapa 3. A ferramenta abre exibindo a imagem original.

Etapa 4. Ajuste a tolerância de detecção no controle deslizante, entre 5% e 80%:

5% a 15%: mais conservador, remove apenas cores muito próximas ao fundo

30% a 80%: mais agressivo, pode acabar removendo partes do produto

Etapa 5. Clique em Processar remoção de fundo.

Etapa 6. Compare o resultado com a imagem original, exibidos lado a lado.

Etapa 7. Escolha o que fazer:

Confirmar e salvar: substitui a imagem original e marca o produto para reenvio automático à Amazon

Reprocessar: ajusta a tolerância e processa de novo

Cancelar: descarta o resultado e mantém a imagem original

Etapa 8. Depois de confirmar, a nova imagem é enviada à Amazon na próxima execução da rotina de imagens.

15.2. Como a detecção funciona

A ferramenta usa um algoritmo de preenchimento a partir dos 4 cantos da imagem:

identifica a cor predominante nos cantos, entendida como cor de fundo

preenche de branco todas as áreas conectadas aos cantos com cor parecida, dentro da tolerância definida

preserva o produto no centro da imagem

Limitação: a ferramenta funciona melhor em imagens com fundo uniforme, de uma cor só ou já próxima do branco. Em imagens com cenário ou gradiente, o resultado pode não ficar bom. Nesses casos, use um editor de imagem externo.

15.3. Requisitos da Amazon para imagens

fundo branco puro na imagem principal

o produto deve ocupar pelo menos 85% da imagem

as imagens devem ser fotografias, não ilustrações

resolução mínima: 1000px no lado mais longo e 500px no mais curto

resolução máxima: 10.000px no lado mais longo

formatos aceitos: JPEG (preferencial), TIFF, GIF e PNG

sem logotipos, marcas d'água ou texto sobreposto

16. Como enviar imagens do produto

Depois de criado o produto ou a oferta, as imagens são enviadas automaticamente.

Como funciona:

as imagens vêm da biblioteca de mídias do produto na plataforma

são enviadas a imagem principal e as imagens adicionais

quando configurado, o sistema redimensiona as imagens automaticamente para atender ao mínimo exigido pela Amazon

o resultado do envio aparece na coluna Imagem da listagem de produtos do Hub

Se a imagem for recusada, o motivo aparece na mensagem do produto. O erro mais comum é resolução abaixo do mínimo (código 90117). Veja os requisitos completos na seção 15.3.

17. Marketplaces suportados

Marketplace	Domínio	Idioma	Moeda
Brasil	amazon.com.br	pt_BR	BRL
Estados Unidos	amazon.com	en_US	USD
Canadá	amazon.ca	en_CA	CAD
México	amazon.com.mx	es_MX	MXN

Cada marketplace tem configuração e rotinas próprias. Os produtos são enviados separadamente para cada um, com o idioma e a moeda correspondentes.

18. Glossário

Termo	Significado	O que é
ASIN	Amazon Standard Identification Number	Código de 10 caracteres que a Amazon dá a cada produto do catálogo. Exemplo: B08N5WRWNW
SKU	Stock Keeping Unit	Código interno que o vendedor usa para identificar um produto. Definido por você e único na sua conta
EAN	European Article Number	Código de barras numérico de 13 dígitos, usado internacionalmente para identificar produtos
ISBN	International Standard Book Number	Código internacional que identifica livros e publicações
ISBN-13	-	Versão de 13 dígitos do ISBN, padrão em vigor desde 2007
GTIN	Global Trade Item Number	Número global de identificação de produto. Engloba EAN, UPC e ISBN-13
BISAC	Book Industry Standards and Communications	Sistema de códigos de classificação por assunto usado pela indústria editorial
NCM	Nomenclatura Comum do Mercosul	Código de 8 dígitos usado para classificação fiscal de mercadorias
SP-API	Selling Partner API	API da Amazon que permite acessar os serviços do Seller Central de forma programática
Listing	-	Publicação de um produto no catálogo da Amazon, com todos os dados: título, descrição, imagens e atributos
Oferta	-	Vínculo do vendedor a um produto que já existe no catálogo (ASIN), informando preço, estoque e condição
Feed	-	Arquivo de dados enviado à Amazon para processar operações em lote
Matching	-	Processo de buscar no catálogo da Amazon se já existe produto correspondente ao EAN ou ISBN informado
Seller Central	-	Painel da Amazon onde os vendedores gerenciam produtos, pedidos e configurações
Merchant Shipping Group	-	Template de frete criado no Seller Central que define as regras de envio
Product Type	-	Classificação da Amazon que define quais atributos são obrigatórios e opcionais para cada tipo de produto
ABIS_BOOK	-	Product Type específico da Amazon para livros e publicações
Brand Gating	-	Restrição da Amazon que limita quais vendedores podem listar produtos de determinadas marcas
MSRP	Manufacturer's Suggested Retail Price	Preço sugerido pelo fabricante. Em livros, corresponde ao preço de capa
Produto órfão	-	Produto que existe na sua conta da Amazon mas não tem correspondência na plataforma GoDeep

19. Histórico de alterações

Data	Alteração
09/09/2026	Publicação inicial. Cobre listagem níveis 1, 2 e 3: criação de ofertas, criação de produtos novos, variações, preço, estoque, restrições, erros síncronos e assíncronos, List Now, listagem em massa, integração reversa, mapeamento de categoria, edição de atributos e remoção de fundo de imagens

GoDeep E-commerce Platform - Integração Amazon SP-API - Listing níveis 1, 2 e 3

Help Page Amazon

Central de Ajuda - Integração de Listagem Amazon#

Onde encontrar cada funcionalidade#

Índice#

1. Antes de começar: configure a integração#

1.1. Acesse as configurações do marketplace#

1.2. O que cada configuração faz#

1.3. Defina quais produtos serão enviados (Seletor de Mix)#

2. Como funciona o fluxo de listagem#

3. Como criar uma oferta#

3.1. Passo a passo#

3.2. Dados enviados na oferta#

3.3. Como o produto é localizado no catálogo#

3.4. Conversão automática de produto novo para oferta#

4. Como criar um produto novo no catálogo da Amazon#

4.1. Antes de enviar: confira os pré-requisitos#

4.2. Passo a passo#

4.3. Dados enviados na criação#

5. Como listar produtos com variação#

5.1. Como as variações são tratadas#

5.2. Passo a passo#

5.3. Exemplo prático#

6. Como atualizar o preço#

6.1. Passo a passo#

6.2. Como o preço é enviado#

7. Como atualizar o estoque#

7.1. Passo a passo#

7.2. Regras de estoque#

8. Como identificar produtos com restrição de venda#

8.1. Como a verificação funciona#

8.2. Passo a passo para consultar#

9. Como consultar os erros de listagem#

9.1. Erros síncronos#

9.2. Erros assíncronos#

9.3. Reenvio automático#

9.4. Como reenviar um produto manualmente#

10. Como publicar ofertas pendentes (List Now)#

10.1. Como reconhecer o status#

10.2. Passo a passo#

10.3. O produto continua DISCOVERABLE. E agora?#

11. Como listar produtos em massa#

11.1. Passo a passo#

11.2. Vínculo em massa de SKUs#

12. Como importar ofertas já existentes na Amazon (integração reversa)#

12.1. Como a importação funciona#

12.2. Vínculo automático por SKU#

12.3. Produtos órfãos: o que são e como resolver#

12.4. Vínculo em massa por CSV (de/para de SKUs)#

12.5. Criação automática de produto por pedido#

13. Como funciona o mapeamento de categoria#

13.1. Product Type#

13.2. Classificação por assunto (BISAC)#

13.3. Boas práticas de classificação#

14. Como editar atributos de produtos já listados#

14.1. Atributos com tela própria#

14.2. Passo a passo da edição genérica#

14.3. Atributos editáveis nessa tela#

15. Como remover o fundo das imagens#

15.1. Passo a passo#

15.2. Como a detecção funciona#

15.3. Requisitos da Amazon para imagens#

16. Como enviar imagens do produto#

17. Marketplaces suportados#

18. Glossário#

19. Histórico de alterações#