Amazon
A integração com o Amazon conecta a sua conta ao idworks e sincroniza os fluxos correspondentes ao canal — credenciais, regras de sincronização de produtos, importação de pedidos, conciliação financeira e demais ações específicas dele. A configuração reúne 50 parâmetros distribuídos em 6 grupo(s).
Antes de configurar, ative a integração em Configurações → Integrações (aba Integrações Disponíveis), preencha o nome interno e (quando o tipo exigir) passe pelo fluxo de autenticação. A partir daí, os parâmetros abaixo ficam disponíveis em Configurar parâmetros.
Categoria no catálogo do idworks: Marketplace.
Índice
Conceito
Cadastro e autenticação
Parâmetros por grupo
- Credenciais de Acesso
- Integração de Vendas
- Integração de Produtos
- Conciliação
- Importação de Anúncios
- Logística (WMS) -> Picking
Sincronização de pedidos
Comissão e taxas do pedido
Erros mais comuns
- Mensagem "Access to requested resource is denied"
- "Categoria não tem tipo de produto da Amazon"
- "Verificar Atributo Regulamentações de produtos perigosos"
Referência rápida
O que é a integração Amazon?
É a conexão entre o canal Amazon e o idworks. Ela controla como dados fluem entre os dois sistemas — depende do tipo da integração (a categoria neste caso é Marketplace), mas em geral cobre uma combinação de credenciais, regras de sincronização, gatilhos automáticos e parâmetros de conciliação.
📍 Onde: menu lateral → Configurações → Integrações → aba Integrações Disponíveis → Amazon.
Como ativar a integração?
- Acesse Configurações → Integrações.
- Na aba Integrações Disponíveis, busque por Amazon e clique no botão +.
- Preencha:
- Conta (apenas multi-conta) — empresa dona da integração.
- Nome da Integração — texto livre. Útil para distinguir várias instâncias do mesmo tipo.
- Clique em Salvar.
A integração aparece imediatamente em Minhas Integrações. Dependendo do tipo, o status inicial é Ativo (quando só requer credencial fixa) ou Não Autenticado (quando depende de autenticação externa).
Pré-requisito: privilégio Criar parametrizações empresa.
Como autenticar e validar as credenciais?
Preencha o grupo Credenciais de Acesso (ver tabela abaixo). Quando a integração pede uma autorização externa (o canal abre a tela de login dele para você liberar o acesso), clique em Autenticar Integração na linha da integração (ícone de cadeado) — uma nova aba abre o login do canal e, ao confirmar, a conexão fica liberada. Para integrações com credencial fixa (usuário/senha/chave), basta preencher os campos e salvar.
Depois de salvar, use a ação Verificar credenciais (quando disponível) para confirmar que o canal responde. O status na listagem reflete o resultado: Ativo = OK, Erro = credencial inválida ou revogada, Não Autenticado = falta concluir o fluxo de autorização.
Pré-requisito: privilégio Editar parametrizações empresa.
Credenciais de Acesso
2 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Seller ID | Cópia | (sem descrição cadastrada) |
| Validar credenciais | Botão | Clique para validar as credenciais informadas |
Integração de Vendas
14 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Empresa Faturadora | Lista | Empresa responsável pelo faturamento dos pedidos, caso seja diferente da principal. |
| Excluir valor frete na NF para PF | Sim/Não | Ative se quiser excluir o valor do frete na Nota Fiscal quando a venda por para pessoa física (PF) |
| Importar pedidos | Sim/Não | Ative se quiser que a idworks integre os pedidos feitos no canal de vendas. |
| Incluir pedidos fulfillment | Sim/Não | Ative se quiser que a idworks integre pedidos fulfillment do canal de vendas |
| Incluir pedidos normais | Sim/Não | Ative se quiser que a idworks integre os pedidos normais na integração com o canal de vendas. |
| Incluir pedidos OnSite | Sim/Não | Ative se quiser que a idworks integre os pedidos feitos no OnSite |
| Fechar pedido automaticamente | Sim/Não | Quando marcado, o idworks fecha o pedido integrado do canal de vendas através do hub. Se desmarcado, o pedido quando integrado permanece com o status de aberto para atualização manual. |
| Cancelar pedido automaticamente | Sim/Não | Ative se quiser cancelar pedido automaticamente caso ele seja cancelado no canal de vendas |
| Incluir pedidos transferencia fulfillment | Sim/Não | Ative se quiser que a idworks integre pedidos de transferencia para o fulfillment. Se não estiver ativo, a nota fiscal será importada, mas sem movimentação de saldo de estoque |
| Emails para enviar Nfe fulfillment | Texto | Adicionar lista de email separado por vírgula para enviar nota fiscal emitida pelo FULL |
| Não importar NF de retorno simbólico fulfillment | Sim/Não | Ative para não importar as notas fiscais de retorno simbólico emitidas pelo canal na modalidade full. Esta funcionalidade só tem validade se a opção de "incluir pedidos fulfillment" estiver ativa |
| Margem mínima desejável | % | Percentual mínimo de margem de contribuição para os pedidos desta integração. Quando a margem do pedido fica abaixo do valor configurado, o pedido é enviado para aprovação de margem em vez de seguir o fluxo automático. |
| Checar taxa/imposto efetivo do pedido | Sim/Não | Ao ativar, o sistema valida a margem de contribuição no fechamento do pedido. Exige que a Margem mínima desejável (ou a taxa efetiva) esteja preenchida. |
| Consultar etiqueta automaticamente | Sim/Não | Ao ativar, a etiqueta é consultada e baixada automaticamente no canal de vendas assim que a nota fiscal do pedido é emitida. |
Integração de Produtos
12 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Estoque de segurança | Inteiro | Se a quantidade de um produto estiver abaixo do valor escolhido, seu anúncio será pausado para evitar que sejam feitas vendas sem estoque. O valor de estoque mínimo é aplicado a todos os produtos. |
| Atualizar saldo estoque | Sim/Não | Ative se quiser que a idworks atualize o saldo de estoque na integração. |
| Valor de ajuste no preço | Decimal | Valor em R$ fixo a ser somado ao preço por (base) para compor o preço de venda |
| Valor de ajuste no preço frete grátis | Decimal | Valor em R$ fixo a ser somado ao preço de venda já ajustado, se houver frete grátis e se o preço com o ajuste normal atingir a regra de frete grátis |
| Percentual de ajuste no preço | % | Valor percentual a ser somado ao preço por (base) para compor o preço de venda |
| Percentual de ajuste no preço frete grátis | % | Valor percentual sobre o preço por (base) a ser somado ao preço de venda já ajustado, se houver frete grátis e se o preço com o ajuste normal atingir a regra de frete grátis |
| Arredondamento dos centavos do preço | Decimal | Valor em centavos para arredondar o preço de venda. Preencha entre 0,01 e 0,99. |
| Atualizar preço | Sim/Não | Ative se quiser enviar a atualização de preço na integração |
| Utilizar título como nome SKU | Sim/Não | Utilizar o campo título como nome do SKU ao enviar para o canal |
| Atualizar Imagem | Sim/Não | Ative se quiser enviar a atualização de imagem na integração |
| Armazéns para somar quantidade | Lista múltipla | Selecionar os armazéns que deve somar a quantidade para enviar aos canais de venda. Caso não seja preenchido, será enviado a quantidade do armazém que esta no de/para |
| Percentual disponibilidade de estoque | % | Valor base para utilizar do estoque em percentual. Ex. se tiver 100 unidades disponíveis e o percentual for 80% será enviado 80 para o canal |
Conciliação
11 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Ativar conciliação | Sim/Não | Ativar a conciliação para importar as transações |
| Plano de contas taxa | Lista | Plano de contas para lançamento da taxa marketplace |
| Tipo documento taxa | Lista | Tipo documento para lançamento da taxa marketplace |
| Centro de custo taxa | Lista | Centro de custo para lançamento da taxa marketplace |
| Conta bancária para realizar conciliação | Lista | Conta bancária para realizar conciliação. Deve ser uma conta própria para a integração |
| Plano de contas antecipação | Lista | Plano de contas para lançamento de antecipação marketplace |
| Diferença dias data venda para conciliação automática | Inteiro | Quantidade de dias a mais e a menos permitido na conciliação automática |
| Diferença valor para conciliação automática | Decimal | Diferença de valor a maior e a menor permitido na conciliação automática |
| Plano de contas comissão frete | Lista | Plano de contas para lançamento de comissão de frete |
| Plano de contas cupom | Lista | Plano de contas para lançamento de comissão de cupom |
| Atualizar comissão marketplace ao realizar conciliação | Sim/Não | Ao ativar, as taxas de marketplace são atualizadas no pedido conforme a conciliação é feita. Como a comissão pode subir ou cair, isso afeta os relatórios de resultado e a aba de resultado do pedido. |
Os cadastros de plano de contas, tipo de documento, centro de custo e conta bancária precisam existir antes — ver Financeiro → Plano de Contas, Financeiro → Tipo Documento, Financeiro → Centro de Custo e Financeiro → Contas Bancárias.
As outras taxas apuradas na conciliação (tributos e demais cobranças que não são comissão, comissão de frete, cupom ou antecipação) entram somadas ao lançamento de Plano de contas taxa — nesta integração não existe um plano de contas separado só para elas.
Importação de Anúncios
10 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Incluir Preços na ficha do Anúncio | Sim/Não | Traz o preço do anúncio publicado para dentro da ficha do anúncio no sistema. Caso não habilite, será utilizado preço definido pela política comercial do cadastro do produto no momento da sincronização do anúncio. |
| Incluir URL do Video no Cadastro do Produto | Sim/Não | Traz a URL do vídeo do anúncio publicado para dentro da ficha de cadastro do produto, somente nos casos em que for possível realizar o vínculo (match) entre o anúncio, suas variações e os produtos/SKUs cadastrados no sistema. |
| Incluir Título na ficha do Anúncio | Sim/Não | Traz o título do anúncio publicado para dentro da ficha do anúncio no sistema. Caso não habilite, será utilizado o campo Nome do cadastro do produto no momento da sincronização do anúncio. |
| Incluir Descrição na Ficha do Anúncio. | Sim/Não | Traz o descrição do anúncio publicado para dentro da ficha do anúncio no sistema. Caso não habilite, será utilizado o campo Descrição do cadastro do produto no momento da sincronização do anúncio. |
| **Importar somente anúncios inexistente dentro da ** | Sim/Não | Só importa anúncios que ainda não estão cadastrados no sistema. |
| Incluir Imagem dentro do Produto | Sim/Não | Traz as imagens do anúncio publicado para dentro do cadastro do produto no sistema. Caso a opção de trazer imagens para dentro do anúncio esteja habilitada, esta funcionalidade será desconsiderada. |
| Incluir Imagem dentro do Anúncio | Sim/Não | Traz as imagens do anúncio publicado para dentro da ficha do anúncio no sistema. Caso não habilite, serão utilizadas as imagens vinculadas ao cadastro do produto no momento da sincronização do anúncio e das imagens. |
| Não Realizar o vínculo do Anúncio ao Produto/SKU | Sim/Não | Ignora o vínculo automático do anúncio com o produto/SKU, permitindo que o vínculo seja realizado posteriormente. |
| Criar Produto/SKU, com base no Anúncio Importado. | Sim/Não | Cria o Produto/SKU com base no anúncio importado... |
| Criar Produto ou SKU Único (Todos Anúncios terá um produto único associado) | Sim/Não | Diferente da opção Criar Produto/SKU com base no Anúncio Importado, esta configuração faz com que o sistema crie um produto único para cada anúncio importado. Nesse caso, o código será utilizado como código do produto, enquanto o código da variação será utilizado para o cadastro do SKU correspondente. O sistema criará os cadastros sempre como Tipo Produto e Tipo SKU. Caso algum dos anúncios importados represente um Kit, será necessário editar manualmente o item após a importação, alterando seu tipo para Kit e definindo sua composição corretamente. |
Logística (WMS) -> Picking
1 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Emitir NF após iniciar picking | Sim/Não | Emitir NF de forma automática ao iniciar o picking |
Por que um pedido virou "Extraviado" sozinho?
O idworks acompanha automaticamente o andamento da entrega dos pedidos da Amazon e atualiza o status do pedido conforme o que o canal informa. Quando a Amazon reporta que a remessa foi avariada (status "DAMAGED"), o idworks marca o pedido como "Extraviado" — o mesmo status usado quando um pedido sofre sinistro/extravio completo da transportadora. Não é preciso fazer nada na tela: a mudança acontece na próxima sincronização de status.
A consulta olha primeiro o status da remessa (pacote) do pedido e, quando a Amazon ainda não gerou a remessa, usa o status geral de atendimento do pedido. Enquanto o canal não devolver nenhum dos dois, o pedido fica sem atualização — ele volta a ser consultado na rodada seguinte, sem precisar de ação sua.
Nessa mesma sincronização automática, o idworks também trata os outros desfechos informados pela Amazon:
- Entregue — quando a Amazon confirma a entrega, o pedido passa para "Entregue com sucesso" (registrando a data mais próxima que o canal informa).
- Cancelado — quando a Amazon cancela o pedido, o idworks o cancela também, desde que o parâmetro Cancelar pedido automaticamente (grupo Integração de Vendas) esteja ativo. Se estiver desativado, o cancelamento não é replicado e o pedido segue para tratamento manual.
O status "Extraviado" aparece destacado em vermelho na listagem de pedidos e indica perda total da mercadoria no transporte. A partir daí, conduza o pedido pelo seu fluxo interno de sinistro (abertura de ocorrência com a transportadora/Amazon, reenvio ou reembolso ao cliente), conforme a política da sua loja.
Por que a comissão da Amazon ainda não apareceu no pedido?
A comissão que a Amazon cobrou de um pedido vem das transações financeiras já liberadas pela Amazon para aquele pedido — ou seja, do valor realizado no extrato do vendedor, e não de uma estimativa calculada no momento da venda.
Isso muda o momento em que o número aparece: a Amazon só libera a transação financeira da venda depois de fechar o ciclo do pedido (normalmente alguns dias após o envio). Enquanto isso não acontece, o idworks não grava nada — o pedido segue com o valor que já tinha, ou em branco. Não é erro: é a Amazon ainda não ter liberado o repasse daquela venda.
| Transação da Amazon | O que vira no pedido |
|---|---|
| Venda liberada | As tarifas cobradas pela Amazon naquela venda entram como comissão do marketplace. |
| Postagem contratada pela Amazon (etiqueta de envio comprada através da Amazon) | A tarifa de postagem cobrada de você entra como comissão de frete. |
| Venda estornada (devolução/reembolso) | É ignorada — o estorno não sobrescreve a comissão da venda original. |
Quando esses valores são atualizados
- Automaticamente, para pedidos importados nos últimos 15 dias que ainda estão sem comissão e não foram cancelados.
- Sob demanda, pela ação Recalcular Comissão Marketplace na tela de pedidos (selecione o pedido e confirme).
- Pela conciliação, quando Atualizar comissão marketplace ao realizar conciliação (grupo Conciliação) está ligado.
Pedidos antigos podem ter sido gravados com a estimativa de comissão usada anteriormente. Se você precisa do valor realizado neles, use Recalcular Comissão Marketplace: se a Amazon já liberou a transação, o valor estimado é substituído pelo realizado. Como a comissão pode subir ou descer, isso muda o resultado do pedido nos relatórios.
Mensagem "Access to requested resource is denied"
Mensagem "Access to requested resource is denied" (frequentemente repetida várias vezes em sequência, em estoque, preço e importação de pedidos). A SP-API da Amazon (a API oficial dos vendedores) negou o acesso do idworks à conta. Não é problema de pedido específico — é a credencial/autorização da loja inteira que está bloqueada.
As três causas mais comuns:
- Autorização revogada na Seller Central — quem operou na Amazon entrou em Configurações → Permissões de usuário → Gerenciar seus aplicativos e removeu o idworks. Toda chamada começa a falhar imediatamente.
- Loja em estado restrito — Amazon suspendeu temporariamente o acesso à API por suspeita de uso indevido, atraso no Health Check do vendedor, ou pendência de revisão (KYC, comprovação de origem).
- Conta de desenvolvedor expirada — a Amazon obriga revalidação anual do app idworks. Quando a validação não é concluída no prazo, a conta perde acesso a todos os vendedores.
Como resolver:
- Em Configurações → Integrações → Minhas Integrações → Amazon, confira o status da integração. Se aparecer Não Autenticado ou Erro, refaça a autorização.
- Clique no ícone de cadeado (Autenticar Integração) na linha — abre a tela da Amazon para você autorizar o idworks de novo, com o usuário dono da loja (não funciona com login de operador).
- Conclua o fluxo até voltar ao idworks. O status deve virar Ativo em alguns minutos.
- Aguarde alguns minutos e tente uma sincronização. Se o erro continuar, é provável que a loja esteja com restrição na própria Amazon — entre na Seller Central → Performance da conta e confira se há aviso de saúde da conta, Account Health ou Compliance.
- Em caso de restrição da Amazon, resolva pelo painel deles primeiro (atende avisos, sobe documentos pedidos). Só depois a API volta a aceitar chamadas.
Se a mensagem aparece só em uma operação (ex.: importar pedidos funciona mas atualizar estoque não), o vendedor pode ter dado permissões parciais ao app. Refaça a autorização e marque todos os escopos solicitados (estoque, pedidos, anúncios, relatórios).
"Categoria não tem tipo de produto da Amazon"
Mensagem "categoria não tem tipo de produto da Amazon. Entrar em contato com suporte". O idworks precisa publicar o anúncio em uma categoria Amazon, e cada categoria local (do seu cadastro de produtos) precisa estar mapeada para um Product Type da Amazon. Quando o produto que você está tentando publicar tem categoria sem mapeamento, o anúncio nem é enviado — o idworks bloqueia antes.
A Amazon Brasil tem centenas de Product Types (LUGGAGE, SHIRT, ELECTRIC_KETTLE, etc.), cada um com seu conjunto próprio de atributos obrigatórios. O mapeamento entre categoria local e Product Type da Amazon é feito uma vez pelo time de suporte, com base no catálogo da loja, e fica salvo.
Como resolver:
- Anote qual produto/SKU disparou o erro e qual a categoria dele em Produtos → Listar Produtos → editar produto → campo Categoria.
- Abra chamado no suporte do idworks informando: (a) nome do produto, (b) categoria atual, (c) Product Type da Amazon que deveria ser usado (consulte a categoria correspondente no painel da Amazon, em Adicionar um produto → o sistema sugere o Product Type por nome/descrição).
- O suporte adiciona o mapeamento e o anúncio passa a sincronizar.
- Para evitar o erro em produtos futuros, padronize as categorias do seu catálogo antes de criar muitos SKUs novos — quanto mais categorias diferentes, mais mapeamentos precisam ser feitos.
Se você já tem o Product Type que deveria ser usado, inclua no chamado — agiliza o atendimento. O Product Type aparece na URL da página de cadastro do produto na Amazon (ex.:
productType=SHIRT).
"Verificar Atributo Regulamentações de produtos perigosos"
Mensagem "Verificar Atributo Regulamentações de produtos perigosos, -> 'Regulamentações de produtos perigosos' é obrigatório, mas não foi inserido". A categoria do anúncio na Amazon exige a declaração obrigatória de "Regulamentações de produtos perigosos" (substâncias perigosas, bateria de lítio, líquidos inflamáveis, aerossóis) — toda categoria que toca em transporte aéreo precisa dessa declaração, mesmo quando o produto não é perigoso. O valor padrão é geralmente "Não aplicável", mas o campo precisa estar preenchido.
Como resolver:
- Em Produtos → Listar Produtos → editar o produto → aba Atributos (ou Especificações, dependendo da versão da tela).
- Localize o atributo Regulamentações de produtos perigosos (ou em inglês "Hazmat / Dangerous Goods Regulations") e preencha o valor adequado:
- Não aplicável (Not Applicable) — para produtos comuns sem nenhuma classificação de perigo.
- O código específico da regulamentação (UN, classe de risco, embalagem) — para produtos realmente classificados (cosméticos com aerossol, baterias, líquidos).
- Em caso de dúvida sobre qual valor usar, consulte o fabricante ou o painel da Amazon → ajuda de Hazmat.
- Salve e sincronize o anúncio de novo.
A Amazon expandiu a obrigatoriedade desse atributo em várias categorias ao longo do tempo. Anúncios antigos que funcionavam podem começar a recusar atualização quando a Amazon adiciona o campo na categoria — nesse caso, basta preencher o valor uma vez e a publicação volta.
Privilégios da tela
Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.
| Privilégio | Libera |
|---|---|
| Visualizar integrações | Acesso à tela de Integrações e a esta página de configuração. |
| Criar parametrizações empresa | Ativar a integração (botão + no catálogo). |
| Editar parametrizações empresa | Configurar parâmetros, editar nome e status, autenticar e validar credenciais. |
| Deletar parametrizações empresa | Excluir a integração. |