Conector Odoo eBay: listagem, pedidos e sincronização de estoque

O eBay continua sendo um dos maiores mercados do mundo, com 132 milhões de compradores ativos em todo o mundo. Para vendedores que usam eBay e Odoo 19 Enterprise, gerenciar dois sistemas separados para pedidos, estoque e dados de clientes é ineficiente e sujeito a erros. O ECOSIRE Odoo eBay Connector sincroniza sua loja eBay com o Odoo, automatizando todo o fluxo de trabalho de vendas, desde a criação da listagem até o atendimento do pedido e contabilidade pós-venda.

Este guia cobre tudo, desde a configuração de credenciais da API do eBay até o gerenciamento de listagens, automação de pedidos, sincronização de estoque, tratamento de devoluções e monitoramento de desempenho do vendedor.

Principais conclusões

• O Connector usa APIs REST do eBay e OAuth 2.0 para autenticação
• Suporta eBay Motors, eBay Business & Industrial e categorias de consumo
• Listagens de preço fixo e leilão são suportadas (importação de pedidos apenas para leilões)
• A sincronização de estoque atualiza as quantidades do eBay dentro de 10 minutos após alterações de estoque do Odoo
• A configuração de falta de estoque (OOS) do eBay é gerenciada automaticamente quando a quantidade chega a 0
• A importação do pedido inclui detalhes do comprador, requisitos de envio e valores de checkout do eBay
• Casos de devolução e garantia de devolução de dinheiro do eBay são sincronizados com o fluxo de trabalho Odoo RMA
• Suporte para várias lojas: gerencie várias contas de vendedores do eBay a partir de uma instância do Odoo

---

Configuração e autorização da API do eBay

O conector usa o conjunto de API REST do eBay, substituindo a API de negociação mais antiga para a maioria das operações.

Etapa 1: Crie uma conta de desenvolvedor no eBay

1. Registre-se em developer.ebay.com
2. Crie um novo aplicativo em Minha conta → Conjuntos de chaves de aplicativo
3. Anote seu ID do aplicativo (ID do cliente), ID do desenvolvedor e ID do certificado (segredo do cliente)
4. Gere um RuName (nome de URL de redirecionamento do eBay) para fluxo OAuth

Etapa 2: Configurar escopos OAuth

Seu aplicativo precisa dos seguintes escopos OAuth:

https://api.ebay.com/oauth/api_scope
https://api.ebay.com/oauth/api_scope/sell.inventory
https://api.ebay.com/oauth/api_scope/sell.inventory.readonly
https://api.ebay.com/oauth/api_scope/sell.fulfillment
https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly
https://api.ebay.com/oauth/api_scope/sell.account
https://api.ebay.com/oauth/api_scope/sell.account.readonly
https://api.ebay.com/oauth/api_scope/commerce.identity.readonly

Etapa 3: gerar tokens de usuário

Os tokens de usuário do OAuth 2.0 (não os tokens de aplicativo) são necessários para operações do vendedor:

1. Na configuração do conector, clique em Autorizar com eBay
2. Conclua o fluxo de consentimento do eBay OAuth
3. O conector armazena o token de acesso e o token de atualização automaticamente
4. Os tokens expiram após 18 meses; o conector é atualizado automaticamente usando o token de atualização

Sandbox x Produção

Sempre teste primeiro com o ambiente sandbox do eBay:

• API de sandbox: api.sandbox.ebay.com
• As credenciais do sandbox são diferentes das credenciais de produção
• Crie contas de vendedor e comprador sandbox em developer.ebay.com/sandbox

---

Instalação e configuração do conector

Instale no mercado ECOSIRE:

1. Adquira o módulo eBay Connector em Produtos ECOSIRE
2. Instale via Aplicativos → Atualizar lista de aplicativos → pesquise "eBay Connector" → Instalar
3. Navegue até Inventário → Configuração → Lojas eBay ou Vendas → eBay

Configuração da loja:

Políticas de Cumprimento:

Antes de listar, configure as políticas de atendimento do eBay no Seller Hub:

• Política de envio: transportadoras, prazo estimado de entrega, tempo de manuseio
• Política de devolução: devoluções em 30 dias, taxa de reabastecimento
• Política de pagamento: pagamentos gerenciados pelo eBay exigidos desde 2021

O conector faz referência a eles por ID de política. Vincule-os nas configurações da loja.

---

Gerenciamento de listagem

O conector suporta a criação e o gerenciamento de listagens de preços fixos diretamente dos registros de produtos Odoo.

Criando uma listagem a partir de um produto Odoo:

1. Abra o formulário do produto → guia eBay
2. Clique em Lista no eBay
3. Configure os campos de listagem:

• Título: até 80 caracteres, preenchido automaticamente a partir do nome do produto
• Categoria: selecione a categoria do eBay (pesquise por palavra-chave ou ID)
• Condição: Novo, Usado, Para Peças/Não Funcionando, etc.
• Preço: usa a lista de preços do produto ou substitui o preço
• Quantidade: estoque disponível ou quantidade personalizada
• Duração: GTC (Good 'Til Cancelled) recomendado para preço fixo
• Especificações do item: atributos obrigatórios do eBay para a categoria

4. Clique em Publicar no eBay

Modelos de listagem:

Para vendedores com muitos produtos na mesma categoria, crie modelos de listagem:

• Navegue até eBay → Modelos → Criar modelo
• Configurar campos compartilhados: categoria, frete, política de devolução, especificações do item
• Aplique modelos a vários produtos simultaneamente

Listagem em massa:

Para catálogos com mais de 100 produtos:

1. Exporte a lista de produtos para CSV com os campos obrigatórios do eBay
2. Use a importação em massa no eBay → Listagem em massa → Carregar CSV
3. Revise e publique em lote

Sincronização de listagem:

Alterações feitas na sincronização do Odoo com o eBay:

• Mudanças de preço → Preço do eBay atualizado em 15 minutos
• Alterações na descrição do produto → Listagem do eBay atualizada na próxima sincronização
• Alterações nas imagens → Imagens do eBay atualizadas (requer nova listagem para algumas alterações)

Especificações do item da categoria eBay:

O eBay exige atributos específicos da categoria (por exemplo, marca, tamanho, cor para roupas). O conector mapeia atributos de produtos Odoo para itens específicos do eBay:

---

Sincronização de pedidos

Processo de importação de pedidos:

Os pedidos fluem do eBay para o Odoo automaticamente:

1. O comprador faz o pedido no eBay e conclui a compra
2. O eBay cria um pedido com status "Aguardando envio"
3. O conector pesquisa a API de pedidos do eBay a cada 15 minutos (configurável)
4. Odoo cria um pedido de venda com detalhes do comprador do eBay
5. O pedido de entrega é criado automaticamente
6. Armazém atende o pedido e valida a entrega
7. O conector envia o número de rastreamento de volta ao eBay
8. O eBay marca o pedido como “Enviado”

Mapeamento de dados do pedido:

Enviando informações de rastreamento:

Ao validar uma entrega no Odoo e inserir um número de rastreamento:

1. O conector detecta o número de rastreamento na seleção de estoque
2. Ele chama a API de atendimento de pedidos do eBay para adicionar rastreamento
3. O comprador recebe uma notificação do eBay com detalhes de rastreamento
4. O eBay atualiza o status do pedido para “Enviado”

Operadoras suportadas para atualizações automáticas de rastreamento: USPS, UPS, FedEx, DHL, Royal Mail, Deutsche Post e mais de 100 outras por meio da lista de códigos de operadoras do eBay.

---

Sincronização de inventário

O inventário preciso evita métricas de "defeitos" do eBay em situações de falta de estoque.

Mecanismo de sincronização de inventário:

O conector usa a API de inventário do eBay com a seguinte lógica:

eBay Quantity = Odoo On-Hand - Safety Stock Buffer - Odoo Reserved Quantity

Quando o inventário é sincronizado:

• Após cada pedido de entrega confirmado (imediato)
• Após cada recebimento validado (imediato)
• Sincronização completa programada a cada 30 minutos
• Sincronização manual disponível a qualquer momento

Manuseio fora de estoque:

Configure o que acontece quando a quantidade chega a 0:

• Opção A: modo OOS (Recomendação Odoo): mantenha a listagem ativa com quantidade 0 usando a opção Esgotado do eBay - a listagem mantém seu histórico e avaliações
• Opção B: Fim da listagem: remova a listagem do eBay quando o estoque chegar a 0 e reliste quando reabastecido
• Opção C: Definir mínimo: defina uma quantidade mínima (por exemplo, 1) e vá para 0 no Odoo somente quando o mínimo OOS for acionado

Encerrar e recadastrar frequentemente prejudica o posicionamento de pesquisa no eBay. O modo OOS é recomendado.

Inventário em vários locais:

Se estiver atendendo em vários armazéns:

• Defina um armazém principal para o eBay nas configurações da loja
• Ou agregue estoque em vários armazéns
• Configurar por produto se alguns SKUs forem enviados de locais específicos

---

Tratamento de devoluções e reembolsos

A garantia de devolução do dinheiro do eBay significa que os vendedores devem aceitar devoluções. O conector lida com o fluxo de trabalho de devolução no Odoo.

Fluxo de trabalho de sincronização de retorno:

1. O comprador abre uma solicitação de devolução no eBay
2. O Connector importa o caso de devolução para Odoo como uma RMA (Autorização de Devolução de Mercadoria)
3. A equipe de operações analisa o motivo da devolução no Odoo
4. Se aceito: gere uma etiqueta de envio de devolução (se fornecer etiquetas pré-pagas)
5. O comprador envia o item de volta
6. Receba mercadorias devolvidas no Odoo → valide o recebimento
7. Processar reembolso: crie uma nota de crédito no Odoo → conector aciona reembolso do eBay

Status de casos de retorno rastreados:

---

Monitoramento de desempenho do vendedor no eBay

O eBay avalia os vendedores com base em métricas que impactam diretamente a visibilidade da listagem. Monitore-os no Odoo:

Principais métricas do vendedor do eBay:

Painel de desempenho no Odoo:

Navegue até eBay → Desempenho para ver:

• Pedidos por status nos últimos 30 dias
• Remessas atrasadas (pedidos enviados após o tempo de processamento)
• Taxa de retorno por categoria
• Resumo de defeitos com IDs de pedidos
• Nível de vendedor projetado para próxima avaliação

---

Preços e promoções

Regras de precificação automatizadas:

Configure preços dinâmicos do eBay com base nos dados de custo do Odoo:

eBay Price = Product Cost × (1 + Target Margin %) + eBay Fee Buffer

Exemplo: se o custo for $ 10, a margem alvo é de 40% e as taxas do eBay são normalmente de 12,5%:

eBay Price = $10 × 1.40 / (1 - 0.125) = $16.00

Promoções com desconto:

O conector oferece suporte à integração do eBay Promotions Manager:

• Criar vendas no Odoo → o conector cria promoções correspondentes no eBay
• Vendas relâmpago, descontos em pedidos e promoções de remessa
• Promoções programadas: datas de início e término configuradas no Odoo

---

Perguntas frequentes

O conector suporta listagens de leilões do eBay?

O conector importa pedidos de listagens de leilão da mesma forma que listagens de preço fixo. No entanto, a criação e o gerenciamento de listagens de leilões (definição de preço inicial, preço de reserva, duração) por meio do conector são limitados – os leilões são melhor gerenciados diretamente no eBay Seller Hub. O principal recurso de gerenciamento de listagem do conector é para listagens de Preço Fixo/GTC.

Como o conector lida com os pagamentos gerenciados do eBay (processamento de pagamentos do eBay)?

Desde 2021, o eBay processa todos os pagamentos por meio de pagamentos gerenciados pelo eBay. O conector importa os totais dos pedidos, incluindo o preço de finalização da compra do eBay (preço do item + frete). O eBay remete os rendimentos líquidos (após taxas) para sua conta bancária. O conector suporta a importação de relatórios de pagamentos do eBay para reconciliação, criando automaticamente lançamentos contábeis manuais que contabilizam as taxas do eBay deduzidas dos pagamentos.

Posso sincronizar produtos do Odoo com várias lojas do eBay (contas de vendedores diferentes)?

Sim. Crie várias configurações de loja do eBay, cada uma com suas próprias credenciais OAuth. Os produtos podem ser listados em várias lojas simultaneamente com substituições de preços específicas da loja. O estoque é rastreado globalmente no Odoo e alocado nas listagens de cada loja com base em regras configuradas.

O que acontece com meu histórico de listagem do eBay (avaliações, contagem de vendas) quando atualizo uma listagem?

As atualizações padrão da listagem (preço, quantidade, descrição, imagens) preservam o histórico da listagem e a contagem de vendas. Ações que zeram o histórico: encerrar e relançar, alterar a categoria do eBay para algumas categorias. O conector usa o endpoint de "oferta de atualização" da API de inventário do eBay para alterações de rotina, o que preserva o histórico.

Como o conector atende aos requisitos alfandegários e de vendas internacionais do eBay?

Para vendas internacionais por meio do eBay International Shipping ou GSP (Global Shipping Program), o conector marca o pedido de venda com o país do comprador. Você configura posições fiscais e tratamento fiscal apropriados no Odoo para vendas internacionais. Os pedidos GSP são enviados para o centro de atendimento doméstico do eBay; a documentação alfandegária é tratada pelo programa GSP do eBay, não pelas suas operações.

---

Próximas etapas

O gerenciamento das operações do eBay por meio do Odoo elimina a entrada manual de dados, evita erros de estoque e oferece uma única fonte de verdade para todos os canais de vendas. O ECOSIRE eBay Connector foi desenvolvido para Odoo 19 Enterprise e inclui suporte completo para as APIs REST mais recentes do eBay.

Obtenha o conector ECOSIRE eBay para Odoo 19 →

Cada compra inclui a licença do módulo, documentação de configuração e acesso à nossa equipe de suporte de implementação para que sua sincronização eBay-Odoo funcione perfeitamente desde o primeiro dia.