Módulos ECOSIRE Odoo: Guia completo do conector do Marketplace 2026

Gerenciar o comércio eletrônico multicanal sem automação é uma batalha perdida. O vendedor médio que gerencia mais de 3 mercados gasta 23 horas por semana na entrada manual de dados, de acordo com o Relatório de mercado de 2025 da ChannelAdvisor. São 23 horas copiando pedidos, atualizando estoque e reconciliando preços que poderiam ser eliminados com a integração adequada do ERP.

Os módulos conectores de mercado Odoo da ECOSIRE automatizam todo o fluxo de trabalho multicanal – desde a listagem de produtos até o atendimento de pedidos, desde a sincronização de estoque até atualizações de preços. Este guia cobre cada módulo que oferecemos, seus recursos, requisitos de instalação e como eles funcionam juntos para criar um back-end de comércio eletrônico unificado.

Principais conclusões

• ECOSIRE oferece 36 módulos Odoo abrangendo conectores de mercado, módulos utilitários e automação comercial - cada um disponível para compra única com licenciamento perpétuo.
• Os conectores do Marketplace são sincronizados bidirecionalmente — produtos, pedidos, estoque e preços fluem entre o Odoo e o Marketplace em tempo real ou em intervalos programados.
• Todos os módulos suportam Odoo 17, 18 e 19 — com otimizações específicas de versão e compatibilidade garantida entre as edições Community e Enterprise.
• O preço único de US$ 49 a US$ 499 inclui a licença do módulo, suporte de instalação e 90 dias de atualizações para correção de bugs — sem taxas recorrentes de SaaS.
• O cliente de licença ECOSIRE (ecosire_license_client) é instalado automaticamente como uma dependência e lida com verificação de licença, ativação e verificações de atualização.

Visão geral do módulo

O portfólio de módulos da ECOSIRE cobre os mercados globais mais populares, cada um construído para lidar com os requisitos específicos e peculiaridades da API dessa plataforma:

Módulos de conector do Marketplace

Módulos Utilitários e de Negócios

Como funcionam os conectores

Os conectores de mercado ECOSIRE integram-se ao Odoo por meio da instalação de módulos padrão. Cada conector se comunica com a API oficial do mercado usando OAuth2 ou autenticação de chave de API. Dados de produtos, pedidos, níveis de estoque e atualizações de remessa são sincronizados bidirecionalmente em programações configuráveis. Os conectores criam pedidos de venda Odoo a partir de pedidos de mercado, atualizam as quantidades de estoque quando o estoque muda e enviam números de rastreamento de volta ao mercado quando as remessas são criadas no Odoo.

Arquitetura

┌─────────────────┐     ┌──────────────────────────┐     ┌──────────────────┐
│   Marketplace    │     │        Odoo Server        │     │   ECOSIRE        │
│   (Amazon, eBay, │◄───►│  ┌────────────────────┐  │     │   License Server  │
│    Shopify...)   │     │  │ ECOSIRE Connector  │  │────►│   (Verification)  │
│                  │     │  │                    │  │     │                  │
│  • Products      │     │  │ • API Client       │  │     └──────────────────┘
│  • Orders        │     │  │ • Data Mapper      │  │
│  • Inventory     │     │  │ • Sync Scheduler   │  │
│  • Shipping      │     │  │ • Error Handler    │  │
│  • Returns       │     │  │ • Queue Manager    │  │
└─────────────────┘     │  └────────────────────┘  │
                        │                          │
                        │  ┌────────────────────┐  │
                        │  │   Odoo Core         │  │
                        │  │                    │  │
                        │  │ • Products          │  │
                        │  │ • Sale Orders       │  │
                        │  │ • Inventory         │  │
                        │  │ • Accounting        │  │
                        │  │ • Contacts          │  │
                        │  └────────────────────┘  │
                        └──────────────────────────┘

Exemplo de fluxo de sincronização: importação de pedido

1. Acionadores do agendador — A cada 15 minutos (configurável), o conector verifica novos pedidos do marketplace
2. Chamada de API — O conector busca pedidos novos/atualizados da API do marketplace
3. Mapeamento de dados — Os dados do pedido do Marketplace são mapeados para os campos do pedido de venda Odoo (cliente → res.partner, itens → sale.order.line, frete → delivery.carrier)
4. Desduplicação — O conector verifica os pedidos existentes por ID de pedido do mercado para evitar duplicatas
5. Criação de pedido — O pedido de venda Odoo é criado com todos os itens de linha, detalhes de envio e informações do cliente
6. Confirmação automática — Se configurado, o pedido é confirmado automaticamente e uma ordem de entrega é gerada
7. Atualização de estoque — Os níveis de estoque são reduzidos e sincronizados com todos os mercados conectados

Exemplo de fluxo de sincronização: atualização de inventário

1. Alteração de estoque detectada — Alterações quantitativas de estoque Odoo (venda, compra, ajuste, fabricação)
2. Cálculo de buffer — São aplicados estoque de segurança e regras de buffer específicas do canal
3. Fila de prioridade — As alterações são enfileiradas com prioridade (estoque baixo = alta prioridade)
4. API push — A quantidade disponível é enviada para cada mercado conectado
5. Confirmação — O Marketplace reconhece a atualização; falhas são repetidas

Guia de instalação

Pré-requisitos

• Odoo 17, 18 ou 19 (Comunidade ou Empresa) -Python 3.10+
• Conexão ativa com a Internet (para chamadas de API do marketplace)
• Conta de vendedor do Marketplace com acesso à API ativado

Instalação passo a passo

# 1. Download the module from your ECOSIRE portal
# https://ecosire.com/portal/downloads

# 2. Extract to your Odoo addons directory
unzip ecosire_amazon_connector-18.0.1.0.0.zip -d /opt/odoo/custom_addons/

# 3. Update the addons path in odoo.conf
# addons_path = /opt/odoo/addons,/opt/odoo/enterprise,/opt/odoo/custom_addons

# 4. Restart Odoo and update the module list
# Settings → Apps → Update App List

# 5. Search for "ECOSIRE" and install
# The ecosire_license_client dependency installs automatically

Ativação de licença

# During first use, you'll be prompted to enter your license key
# Format: AMZN-XXXX-XXXX-XXXX-XXXX (prefix varies by module)

# License verification happens via ECOSIRE's API:
# POST https://api.ecosire.com/api/licenses/validate
# POST https://api.ecosire.com/api/licenses/activate

Após a ativação, o módulo está totalmente funcional. As verificações de licença acontecem periodicamente em segundo plano e nunca bloqueiam as operações normais.

Aprofundamento do recurso: Amazon Connector

O conector Amazon é nosso módulo mais abrangente, suportando todos os 16 mercados da Amazon a partir de uma única instância do Odoo.

Operações Suportadas

Configuração de vários mercados

# Amazon Connector supports all marketplaces:
# North America: US (ATVPDKIKX0DER), CA (A2EUQ1WTGCTBG2), MX (A1AM78C64UM0Y8)
# Europe: UK (A1F83G8C2ARO7P), DE (A1PA6795UKMFR9), FR (A13V1IB3VIYZZH),
#         IT (APJ6JRA9NG5V4), ES (A1RKKUPIHCS9HS)
# Asia-Pacific: AU (A39IBJ37TRP1C6), JP (A1VC38T7YXB528), IN (A21TJRUUN4KGV)
# Each marketplace is configured independently with its own credentials,
# but products and orders flow into a single Odoo instance with
# marketplace-specific pricelists and warehouses.

Integração FBA

O conector lida com o fluxo de trabalho FBA (Fulfillment by Amazon):

• Crie planos de remessa de entrada no Odoo
• Rastrear o status da remessa de entrada
• Importar níveis de estoque FBA
• Encaminhe pedidos FBA para atendimento da Amazon (não é necessária entrega Odoo)
• Reconciliar taxas FBA na contabilidade Odoo

Aprofundamento do recurso: Conector eBay

Leilão e Suporte a Preço Fixo

# The eBay connector handles both listing formats:
# - Auction: Starting price, duration, reserve price, Buy It Now
# - Fixed Price: Standard listing, multi-quantity, Good 'Til Cancelled
# - Promoted Listings: Automatic ad rate management
#
# Listing templates can be created in Odoo with:
# - HTML description templates (with eBay-compliant CSS)
# - Item specifics mapping from Odoo product attributes
# - Shipping profiles and return policies
# - Category-specific required fields

Fluxo de trabalho de devoluções

O conector eBay automatiza o processo de devolução:

1. Solicitação de devolução importada para Odoo
2. Aprovação automática com base nas regras configuradas (motivo da devolução, prazo, valor)
3. Gere uma etiqueta de remessa de devolução (se paga pelo vendedor)
4. Rastreie a remessa de devolução
5. Processar reembolso na contabilidade Odoo no recebimento do item
6. Atualize o caso do eBay automaticamente

Aprofundamento do recurso: Conector Shopify

Recursos de sincronização de produtos

Recursos do Shopify Plus

Para lojistas do Shopify Plus, o conector inclui:

• Gerenciamento de várias lojas — Gerencie várias lojas Shopify a partir de um Odoo
• Integração do Shopify Flow — Acione fluxos de trabalho do Shopify a partir de eventos Odoo
• Suporte a scripts — Scripts de desconto sincronizados com promoções Odoo
• Canal B2B — Preços de atacado das listas de preços Odoo

Estratégia Multicanal

O verdadeiro poder dos módulos ECOSIRE surge quando você conecta vários mercados simultaneamente. Aqui está uma configuração recomendada para uma empresa de comércio eletrônico de médio porte:

Configuração recomendada

Estratégia de alocação de estoque

# Example: 1000 units available, selling on 4 channels
#
# Channel          Buffer   Allocated   Listed
# ──────────────   ──────   ─────────   ──────
# Amazon (60%)     50       600         550
# Shopify (25%)    20       250         230
# eBay (10%)       10       100         90
# Walmart (5%)     5        50          45
# ──────────────   ──────   ─────────   ──────
# Total            85       1000        915
#
# The Multi-Channel Inventory Sync module manages these allocations
# automatically based on your configured percentages and buffer rules.
# When stock drops below buffer thresholds, listings are automatically
# deactivated to prevent overselling.

Preços e licenciamento

Todos os módulos ECOSIRE utilizam um modelo de compra única com licenciamento perpétuo:

Como funciona o licenciamento

Cada licença de módulo inclui:

• Chave de licença no formato PREFIX-XXXX-XXXX-XXXX-XXXX
• Ativação em uma instância de produção + instâncias de teste/desenvolvimento ilimitadas
• Verificação automática através do módulo ecosire_license_client (leve, sem bloqueio)
• Período de carência offline — os módulos continuam funcionando se o servidor de licença estiver temporariamente inacessível

Opções de compra

• Módulos individuais — Compre apenas o que você precisa no catálogo de produtos ECOSIRE
• Descontos em pacotes — 20% de desconto na compra de mais de 3 módulos, 30% de desconto para mais de 5 módulos
• Pacote empresarial — Todos os conectores + todos os utilitários com 40% de desconto

Suporte e Documentação

Cada módulo ECOSIRE inclui:

• Guia de instalação com instruções passo a passo
• Referência de configuração para todas as configurações e opções
• Documentação de mapeamento de API mostrando quais campos são sincronizados e onde
• Guia de solução de problemas para problemas comuns
• Tutoriais em vídeo para configuração e operações diárias

Para questões além da documentação:

• Suporte por e-mail: [email protected] (resposta de 24 a 48 horas)
• Suporte prioritário: Disponível com contratos de suporte (SLA de resposta em 4 horas)
• Desenvolvimento personalizado: Precisa de recursos que não estão no módulo padrão? Entre em contato conosco

Perguntas frequentes

Os módulos ECOSIRE funcionam com o Odoo Community Edition?

Sim, todos os módulos conectores do mercado ECOSIRE são compatíveis com as edições Odoo Community e Enterprise. Os módulos são construídos usando API Odoo padrão e padrões ORM. Alguns recursos avançados, como suporte multiempresa e entradas contábeis automatizadas, funcionam melhor com o Enterprise, mas a funcionalidade principal (sincronização de produtos, importação de pedidos, gerenciamento de estoque) funciona de forma idêntica em ambas as edições.

Quantos mercados posso conectar simultaneamente?

Não há limite técnico para o número de mercados que você pode conectar. Cada módulo conector opera de forma independente e o módulo Multi-Channel Inventory Sync coordena os níveis de estoque em todos os canais conectados. As empresas geralmente executam de 5 a 8 conectores de mercado simultaneamente. Para obter o desempenho ideal com mais de 10 canais, recomendamos dedicar recursos do servidor ao agendador de sincronização e usar o processamento baseado em fila.

O que acontece se o servidor de licença estiver inacessível?

Os módulos ECOSIRE incluem um período de carência off-line. A verificação de licença acontece periodicamente em segundo plano — se o servidor de licença estiver temporariamente inacessível devido a problemas de rede, seus módulos continuarão funcionando normalmente. O cliente de licença armazena em cache a última verificação bem-sucedida e bloqueia a funcionalidade somente após um longo período de verificações com falha, garantindo tempo de inatividade zero para suas operações comerciais.

Posso personalizar o mapeamento de campo entre o Odoo e o marketplace?

Sim. Cada conector inclui um sistema de mapeamento de campo configurável no painel de configurações do Odoo. Você pode mapear qualquer campo de produto Odoo para qualquer atributo do mercado, criar regras de transformação para valores que diferem entre sistemas e definir valores padrão para campos obrigatórios do mercado que não existem no Odoo. Para mapeamentos complexos que exigem lógica customizada, a ECOSIRE oferece serviços de customização.

Como os conectores lidam com os limites de taxa da API do mercado?

Cada conector é construído com limitação de taxa específica do mercado integrada. Por exemplo, o conector Amazon respeita a aceleração SP-API com espera automática, e o conector Shopify permanece dentro do limite de 2 chamadas por segundo para planos padrão. As operações são enfileiradas e processadas dentro dos limites de taxa, com prioridade para operações urgentes, como importações de pedidos e atualizações de estoque.

Preciso de conhecimentos técnicos para instalar e configurar os módulos?

Conhecimento básico de administração do Odoo é suficiente para instalação e configuração inicial. Os módulos incluem um assistente de configuração que orienta você na autenticação do marketplace, mapeamento de warehouse e configuração de agendamento de sincronização. No entanto, para configurações complexas de vários armazéns ou regras de negócios personalizadas, recomendamos usar o serviço de suporte à instalação do ECOSIRE, que é incluído gratuitamente em cada compra de módulo.

Comece

Pronto para automatizar seu e-commerce multicanal? Aqui estão suas próximas etapas:

1. Navegue em nossos módulos em ecosire.com/products
2. Verifique a compatibilidade com sua versão Odoo e contas do Marketplace
3. Compre e baixe — acesso instantâneo ao seu portal ECOSIRE
4. Instalar e ativar — nossa equipe ajuda na configuração sem nenhum custo extra
5. Configure e entre em operação — normalmente de 1 a 2 horas para configuração básica

Para empresas que precisam de configurações personalizadas, configurações multiempresas ou requisitos de mercado especializados, a equipe de implementação da ECOSIRE fornece serviços de implantação ponta a ponta.

Recursos relacionados:

• Tutorial da API REST do Odoo — Compreendendo a camada API do Odoo
• Melhor ERP para comércio eletrônico 2026 — Por que Odoo é excelente para comércio eletrônico
• Guia de depuração de Webhook — Solução de problemas de webhooks do marketplace

Precisa de um conector para um mercado que não listamos? Entre em contato com nossa equipe de desenvolvimento — criamos integrações de mercado personalizadas para qualquer plataforma com API.