Odoo Amazon Connector: configuração e venda multicanal

A Amazon é responsável por quase 40% da receita do comércio eletrônico nos EUA, tornando-se um canal obrigatório para vendedores de produtos. Gerenciar pedidos, estoque e atendimento da Amazon separadamente de seu ERP principal cria silos de dados, dores de cabeça de reconciliação e erros de atendimento que custam dinheiro real.

O ECOSIRE Odoo Amazon Connector conecta o Odoo 19 Enterprise e o Amazon Seller Central, sincronizando produtos, pedidos, níveis de estoque e status de atendimento em ambas as direções. Este guia cobre o processo completo de configuração, configuração de mapeamento de dados, opções de frequência de sincronização, tratamento de erros e práticas recomendadas operacionais para executar vendas da Amazon por meio do Odoo.

Principais conclusões

• O conector suporta todos os mercados da Amazon (EUA, Reino Unido, UE, Japão, Emirados Árabes Unidos, etc.)
• A sincronização de pedidos é executada a cada 15 minutos por padrão; configurável até 5 minutos
• Os níveis de estoque são enviados para a Amazon automaticamente a cada movimentação de estoque
• Os pedidos FBA e FBM (atendidos pelo comerciante) são tratados em fluxos de trabalho separados
• O mapeamento de produtos usa ASIN, SKU e EAN/UPC como chaves correspondentes
• As sincronizações com falha são registradas com detalhes do erro e podem ser repetidas individualmente
• As regras de preços podem substituir os preços da Amazon com base nas listas de preços do Odoo
• O conector usa Amazon SP-API (Selling Partner API), substituindo o obsoleto MWS

---

Pré-requisitos e configuração da Amazon SP-API

O conector usa a API Selling Partner da Amazon (SP-API). Antes de instalar o conector, você precisa de credenciais SP-API da Amazon.

Etapa 1: registre-se como desenvolvedor no Amazon Seller Central

1. Faça login na Central do Vendedor → Aplicativos e Serviços → Desenvolver Aplicativos
2. Clique em "Adicionar novo cliente de aplicativo" e conclua o registro do desenvolvedor
3. A Amazon analisará sua inscrição (1 a 3 dias úteis para aprovação)

Etapa 2: Crie um aplicativo SP-API

Depois de aprovado:

1. Vá para Aplicativos e Serviços → Desenvolver Aplicativos → Seus Aplicativos
2. Clique em "Adicionar novo cliente de aplicativo"
3. Selecione IAM ARN (crie primeiro um usuário AWS IAM) ou use OAuth
4. Defina o URI de redirecionamento para sua instância Odoo: https://your-odoo.com/amazon/oauth/callback
5. Selecione os escopos de API necessários:

• API de pedidos
• API de relatórios
• API de listagens
• API de itens de catálogo
• API de inventário FBA
• API de feeds

Etapa 3: autorize sua conta de vendedor

Após a criação do aplicativo, autorize-o em cada mercado:

1. Copie as credenciais LWA (Login With Amazon) do seu aplicativo
2. Acesse o URL de autorização do conector
3. Conclua o fluxo OAuth para cada conta do Amazon Marketplace

Credenciais necessárias no Odoo:

• ID do cliente LWA
• Segredo do cliente LWA
• Token de atualização (gerado durante o fluxo OAuth)
• Região AWS (com base no mercado)

---

Instalando e configurando o conector

Instale o módulo ECOSIRE Amazon Connector:

O conector está disponível no mercado ECOSIRE. Após a compra:

1. Baixe o arquivo zip do módulo da sua conta ECOSIRE
2. Faça upload para o seu servidor Odoo: cp amazon_connector.zip /opt/odoo/addons/
3. Extraia e instale: navegue até Aplicativos → Atualizar lista de aplicativos → pesquise "Amazon Connector" → Instalar

Configuração inicial:

Navegue até Inventário → Configuração → Amazon Marketplaces (ou Vendas → Amazon → Configuração dependendo do layout do Odoo).

Clique em Criar para adicionar uma nova conexão ao Marketplace:

Teste a conexão:

Após salvar, clique em Testar conexão. Um teste bem-sucedido retorna seu nome de comerciante e confirma o acesso à API. Se falhar, verifique:

• As credenciais LWA estão corretas
• O token de atualização não expirou
• A região da AWS corresponde ao seu mercado
• O aplicativo SP-API está no estado "Publicado" (não "Rascunho")

---

Mapeamento de produtos e sincronização de catálogo

O conector mapeia produtos Odoo para Amazon ASINs usando três métodos:

Método 1: correspondência de SKU (recomendado)

Se suas referências internas de produto (códigos SKU) corresponderem ao SKU do vendedor que você usa na Amazon, ative a Correspondência automática de SKU nas configurações do mercado. O conector vinculará automaticamente os produtos Odoo às suas listagens na Amazon.

Método 2: correspondência EAN/UPC

O conector consulta a API de catálogo da Amazon para encontrar listagens que correspondam ao código de barras do seu produto (EAN13 ou UPC). Isso funciona para produtos de marca listados no catálogo da Amazon.

Método 3: mapeamento ASIN manual

Para produtos ou pacotes personalizados:

1. Vá para o formulário do produto → guia Amazon
2. Insira o ASIN de cada mercado
3. Mapeie variantes para seus ASINs específicos

Importando o catálogo da Amazon:

Em vez de mapear um por um, importe seu catálogo da Amazon:

1. Vá para Amazon → Catálogo → Importar listagens
2. Selecione o mercado
3. O conector baixa todas as suas listagens ativas e cria/atualiza produtos Odoo
4. Revise os produtos importados para obter precisão no mapeamento de campo

Configuração de mapeamento de campo de produto:

---

Sincronização de pedidos

Os pedidos fluem da Amazon para o Odoo automaticamente. Compreender o ciclo de vida do pedido evita confusões e erros de atendimento.

Fluxo de trabalho de sincronização de pedidos:

Amazon Order Created (status: Pending)
        ↓ [15-minute sync interval]
Odoo receives order → creates sale.order in DRAFT
        ↓
Amazon confirms payment (status: Unshipped)
        ↓ [next sync]
Odoo sale.order auto-confirmed → delivery order created
        ↓
Warehouse picks, packs, ships
        ↓
Odoo records shipment → sends tracking to Amazon via API
        ↓
Amazon status: Shipped → Customer receives
        ↓
Amazon releases payment to seller
        ↓
Odoo invoice created and posted (auto or manual)

Configurações de sincronização de pedidos:

Tratamento de pedidos cancelados:

Quando a Amazon cancela um pedido (cancelamento do cliente ou falha no pagamento):

1. O conector detecta o cancelamento na próxima sincronização
2. Se o pedido de entrega não for validado: é automaticamente cancelado
3. Se a entrega já foi validada: o conector cria um RMA de devolução
4. A fatura é cancelada ou estornada com nota de crédito

---

Sincronização de inventário

A precisão do inventário em tempo real evita vendas excessivas, o que leva a penalidades na conta do vendedor da Amazon.

Envio de inventário para a Amazon:

Cada vez que ocorre uma movimentação de estoque Odoo (entrega, recebimento, devolução, ajuste), o conector envia a quantidade atualizada para a API Amazon Inventory:

• Produtos FBM: quantidade disponível do Odoo menos buffer de estoque de segurança
• Produtos FBA: a Amazon gerencia o inventário FBA; Odoo recebe níveis FBA por meio da API Amazon Inventory

Configuração do estoque de segurança:

Available for Amazon = On-Hand Quantity - Safety Stock Buffer - Reserved Quantity

Configure o estoque de segurança por produto ou globalmente:

• Navegue até o produto → guia Amazon → Estoque de segurança: 5
• Ou globalmente em configurações de mercado → Estoque de segurança padrão: 2

Frequência de sincronização de inventário:

Ao contrário da sincronização de pedidos (orientada por eventos + programada), a sincronização de inventário é baseada em lote:

• Padrão: a cada 30 minutos
• Após qualquer movimentação de estoque: dentro de 5 minutos (estilo webhook)
• Antes dos períodos de pico: execute a sincronização manual

Inventário de vários armazéns:

Se estiver atendendo em vários armazéns:

1. Crie configurações separadas do Amazon Marketplace para cada armazém
2. O conector agrega inventário em todos os armazéns vinculados
3. Ou: use o recurso de estoque em vários locais da Amazon com alocação de quantidades específicas do armazém

---

Integração FBA (preenchida pela Amazon)

Os pedidos da FBA são atendidos pelo armazém da Amazon, mas Odoo ainda precisa saber sobre eles para a reconciliação financeira.

Fluxo de trabalho de pedidos FBA no Odoo:

1. A Amazon recebe e atende o pedido (Odoo não tem função de atendimento)
2. O conector cria um pedido de venda no Odoo marcado como "FBA"
3. O pedido de entrega é validado automaticamente (sem coleta física no Odoo)
4. Uma localização virtual “Amazon FBA” foi diminuída
5. A fatura é criada e lançada
6. A remessa da Amazon é reconciliada com a fatura

Gerenciamento de estoque FBA:

Envie inventário para Amazon FBA por meio do Odoo:

1. Crie uma remessa FBA no Odoo (ou no Seller Central e vincule-a)
2. O conector cria uma transferência de estoque do seu armazém para o local "Amazon FBA"
3. Valide a transferência quando as mercadorias forem enviadas para a Amazon
4. As quantidades FBA são rastreadas no Odoo para fins de relatório

Conciliação de taxas FBA:

A Amazon deduz taxas (cumprimento, armazenamento, referência) antes de efetuar o pagamento. Configure o conector para:

• Importar relatórios de liquidação da Amazon
• Criar automaticamente lançamentos contábeis manuais para taxas FBA
• Reconciliar o valor líquido de liquidação com faturas pendentes

---

Gerenciamento de preços

Reprecificação automatizada:

O conector oferece suporte a atualizações automatizadas de preços para a Amazon com base nas regras da lista de preços do Odoo:

Amazon Price = Odoo List Price × Marketplace Multiplier + Fixed Offset

Configuração:

• Navegue até configurações do mercado → Preços
• Definir Fonte de preço: Lista de preços, Custo + Margem ou Fixo
• Definir Multiplicador (por exemplo, 1,0 para o mesmo preço, 1,15 para margem de lucro de 15%)
• Habilitar Preços de sincronização automática: os preços são enviados para a Amazon quando alterados no Odoo

Manuseio de moeda:

Para mercados que não sejam USD (EUR, GBP, JPY), o conector:

1. Lê os preços da lista de preços específica do mercado, se configurada
2. Ou converte de sua moeda base usando taxas de câmbio diárias do Odoo

---

Tratamento e monitoramento de erros

Registro de erros de sincronização:

Navegue até Amazon → Sync Logs para ver todas as operações de sincronização:

• Verde: sincronização bem-sucedida
• Amarelo: sincronização parcial (alguns registros falharam)
• Vermelho: falha completa na sincronização

Cada entrada de erro mostra:

• Carimbo de data e hora e tipo de sincronização (pedidos, estoque, listagens)
• Código de erro da Amazon API
• ID do registro afetado
• Mensagem de erro
• Botão Tentar novamente

Erros e soluções comuns:

Alertas automatizados:

Configure alertas por e-mail para falhas de sincronização:

• Navegue até configurações do mercado → Notificações
• Adicione endereços de e-mail para notificar sobre erros de sincronização
• Definir limite de alerta: notificar após 3 falhas consecutivas

---

Perguntas frequentes

O conector oferece suporte ao Amazon FBA Multi-Channel Fulfillment (MCF)?

Sim. O MCF permite que você use o estoque FBA da Amazon para atender pedidos de outros canais de vendas (seu site, outros mercados). O conector pode criar solicitações de atendimento MCF quando um pedido de venda de um canal não Amazon é recebido, desde que o produto esteja em estoque no FBA. Os pedidos MCF são rastreados no Odoo com movimentos de localização FBA.

Como o conector lida com as complexas regras fiscais da Amazon (IVA OSS, Marketplace Facilitator)?

Para mercados onde a Amazon coleta e remete impostos (regras do Facilitador de Mercado, aplicáveis ​​na maioria dos estados dos EUA e da UE para vendedores fora da UE), o conector cria pedidos com imposto de US$ 0, à medida que a Amazon lida com a obrigação fiscal. Para situações não Facilitadoras, o conector aplica posições fiscais configuradas no Odoo com base no endereço de entrega do comprador.

Posso gerenciar várias contas da Amazon (contas de vendedores diferentes) a partir de uma instância do Odoo?

Sim. Crie diversas configurações de marketplace, cada uma com suas próprias credenciais SP-API. Você pode ter configurações separadas para diferentes contas de vendedor, diferentes mercados na mesma conta ou diferentes empresas em uma configuração Odoo multiempresa. Pedidos, estoque e preços são gerenciados de acordo com a configuração do mercado.

O que acontece se a Amazon alterar um pedido depois de ele ter sido importado para o Odoo?

O conector verifica modificações de pedido em cada ciclo de sincronização. Se a Amazon atualizar um pedido (por exemplo, alteração de quantidade antes do envio, correção de endereço), o conector atualizará o pedido de venda Odoo correspondente, caso ainda não tenha sido confirmado. Modificações em pedidos confirmados criam um alerta de sistema para revisão manual.

O conector lida com conteúdo Amazon A+ ou conteúdo de marca aprimorado?

O gerenciamento de conteúdo A+ é o conteúdo de marketing gerenciado exclusivamente pelo Seller Central. O conector se concentra em dados operacionais: pedidos, estoque, preços e atendimento. O conteúdo do produto (descrições, imagens) pode ser enviado para listagens básicas da Amazon, mas não para modelos de conteúdo A+.

---

Próximas etapas

Vender na Amazon por meio do Odoo é significativamente mais eficiente do que gerenciar dois sistemas separadamente — mas o conector deve ser configurado corretamente desde o início. Mapeamentos de produtos mal configurados, configurações incorretas de sincronização de estoque ou configurações fiscais incorretas criam problemas que aumentam com o tempo.

O módulo Amazon Connector da ECOSIRE foi desenvolvido especificamente para o Odoo 19 Enterprise, e nossa equipe fornece assistência de configuração, treinamento e suporte contínuo para vendedores de mercado que gerenciam a Amazon por meio do Odoo.

Obtenha o conector ECOSIRE Amazon para Odoo 19 →

A compra inclui licença de módulo, documentação e 30 dias de suporte de implementação para que sua integração Amazon-Odoo funcione corretamente desde o primeiro dia.