Integração Faire Wholesale com Odoo ERP: configuração passo a passo

O comércio eletrónico grossista está a passar por uma transformação fundamental e a Faire está a liderar esse processo. Com mais de 100.000 marcas vendendo para mais de 700.000 varejistas independentes na América do Norte, Europa e Austrália, a Faire se tornou o mercado atacadista digital definitivo. Para as marcas que gerem as suas operações através do Odoo ERP, a questão já não é vender na Faire – é como ligar os dois sistemas sem criar um pesadelo operacional.

Principais conclusões

• A Faire conecta mais de 100.000 marcas com mais de 700.000 varejistas independentes em todo o mundo
• A plataforma processou mais de US$ 1 bilhão em GMV em 2025, crescendo mais de 40% ano a ano
• Os pedidos de atacado B2B são 5 a 10 vezes maiores do que os pedidos DTC, tornando os erros de sincronização muito mais caros
• O conector Faire-Odoo da ECOSIRE lida com importação de pedidos, sincronização de estoque e gerenciamento de varejistas
• Marcas integradas relatam redução de 75% no tempo de processamento de pedidos e quase zero incidentes de vendas excessivas
• As condições de pagamento Net 60 da Faire exigem configuração de contabilidade Odoo específica para rastreamento preciso do fluxo de caixa

---

Compreendendo o modelo de atacado da Faire

Faire opera de forma diferente dos mercados de consumo. Compreender essas diferenças é essencial para construir uma integração eficaz.

Como funciona o Faire para as marcas

As marcas listam seus produtos na Faire com preços de atacado, quantidades mínimas de pedido e configurações de embalagens. Os retalhistas independentes navegam no mercado, fazem encomendas e a Faire trata do processamento de pagamentos com os termos Net 60 – os retalhistas pagam à Faire 60 dias após receberem as mercadorias e a Faire paga às marcas alguns dias após o envio.

Este modelo de pagamento cria um desafio contabilístico único: as marcas enviam mercadorias e recebem o pagamento rapidamente da Faire, mas a Faire assume o risco de crédito do lado do retalhista. Do ponto de vista contábil do Odoo, a Faire é o seu cliente, não os varejistas individuais.

Estatísticas do Faire Marketplace (2025-2026)

Por que a integração é crítica para B2B

As operações de atacado têm características que tornam a gestão manual muito mais propensa a erros do que a venda direta ao consumidor:

• Valores de pedidos maiores: um único pedido Faire com valor médio de US$ 500-800 significa que um erro de estoque ou um pedido perdido custa de 5 a 10 vezes mais do que um erro no mercado de consumo
• Complexidade do pacote de caixas: os produtos são enviados em quantidades de caixas predefinidas (por exemplo, pacotes de 6, 12 ou 24), exigindo rastreamento de estoque tanto em nível de unidade quanto de caixa
• Requisitos mínimos de pedido: As marcas definem mínimos por produto e por pedido, que devem ser validados no nível de integração
• Padrões de novos pedidos: os varejistas fazem novos pedidos regularmente, tornando o atendimento confiável fundamental para o valor do relacionamento de longo prazo
• Inventário multicanal: a maioria das marcas Faire também vende DTC, na Amazon e através de outros canais de atacado — a alocação de inventário em todos os canais deve ser coordenada

---

API Faire e recursos de integração

A Faire fornece uma API REST para integrações de marca, acessada através do Faire Developer Portal. A API permite o gerenciamento programático dos principais fluxos de trabalho que impulsionam as operações de atacado.

Grupos de recursos de API

Pedidos

• Recuperar pedidos novos, pendentes e históricos
• Acesse detalhes do item de linha, incluindo variantes, quantidades e configurações de caixa
• Atualizar status do pedido (aceito, enviado, entregue)
• Lidar com modificações de pedidos e solicitações de cancelamento

Produtos

• Criar e atualizar listas de produtos com preços de atacado
• Gerenciar variantes de produtos (tamanho, cor, estilo)
• Definir quantidades mínimas de pedidos e definições de embalagens de caixas
• Faça upload de imagens e descrições de produtos

Inventário

• Atualizar quantidades de estoque disponíveis por variante
• Definir disponibilidade de pré-encomenda e pedidos pendentes
• Gerenciar estoque em vários armazéns

Envios

• Crie registros de remessa com informações de rastreamento
• Gerar listas de embalagem
• Lidar com remessas parciais para grandes pedidos

Configurações da marca

• Acesse taxas de comissão e estruturas de taxas
• Recuperar dados de pagamento e liquidação
• Gerenciar configurações de taxas de envio

Autenticação

Faire usa OAuth 2.0 com tokens ao portador. O acesso à API requer aprovação através do programa de desenvolvimento da Faire e as credenciais são emitidas por conta de marca. Os limites de taxas são generosos para operações de atacado – normalmente 100 solicitações por minuto – refletindo o menor volume de transações, mas a maior complexidade de dados dos pedidos B2B.

---

Arquitetura de integração: Faire to Odoo

Projeto de fluxo de dados

A integração ideal do Faire-Odoo segue um modelo hub-and-spoke onde o Odoo serve como sistema mestre para produtos e estoque, enquanto o Faire é tratado como um canal de vendas:

Odoo (Master)
  ├── Products → Faire (listing sync)
  ├── Inventory → Faire (stock updates)
  ├── Faire → Orders (order import)
  ├── Faire → Shipments (tracking push)
  └── Faire → Accounting (settlement reconciliation)

Componente 1: Sincronização do catálogo de produtos

Os produtos fluem de Odoo para Faire. A sincronização deve lidar com:

• Preços de atacado: Mapeamento de listas de preços Odoo para a estrutura de preços da Faire (preço de atacado, MSRP, quantidade mínima de pedido)
• Pacotes de caixas: tradução da unidade de medida e configurações de embalagem do Odoo para o formato de pacote de caixas da Faire
• Variantes: sincronização de variantes de produtos com mapeamentos de atributos corretos
• Imagens: enviar imagens de produtos do Odoo ou URLs externos para o sistema de mídia da Faire
• Categorias: Mapeamento de categorias de produtos Odoo para a taxonomia da Faire

Componente 2: Importação de pedido

Os pedidos Faire são importados para o Odoo como pedidos de venda com configurações B2B específicas:

• Registro do cliente: a Faire atua como cliente de cobrança; a loja de varejo é registrada como o contato de envio
• Lista de preços: preços de atacado aplicados automaticamente com base no canal Faire
• Condições de pagamento: configuradas para refletir o prazo de liquidação da Faire (não Net 60, uma vez que as marcas recebem o pagamento em alguns dias)
• Armazém: atribuído com base no destino de envio e disponibilidade de estoque
• Gestão fiscal: a Faire coleta e envia impostos sobre vendas na maioria dos estados dos EUA; a integração deve levar em conta isso na geração da fatura

Componente 3: Gerenciamento de estoque

A sincronização de estoque tem efeito bidirecional, mas fluxo unidirecional - Odoo envia as quantidades disponíveis para Faire. A complexidade reside no cálculo da quantidade disponível específica da Faire:

Faire Available = Total On Hand
  - Reserved (other channels)
  - Safety Buffer
  - Minimum Display Quantity

Para marcas que vendem na Faire, Amazon, Shopify e outros canais, a alocação inteligente de inventário evita que qualquer canal consuma todo o estoque disponível. Leia mais sobre estratégias de sincronização de inventário multicanal.

Componente 4: Remessa e Rastreamento

Quando a equipe do armazém processa um pedido Faire no Odoo e cria uma entrega com informações de rastreamento, a integração envia os detalhes da remessa de volta para a Faire. Isso aciona o pagamento da Faire à marca e notifica o varejista.

Remessas parciais são comuns no atacado – um varejista pode encomendar 10 caixas, mas apenas 8 estão disponíveis imediatamente. A integração deve lidar com remessas divididas normalmente, criando registros de entrega parciais em ambos os sistemas.

Componente 5: Reconciliação Financeira

Os relatórios de liquidação da Faire detalham pagamentos menos comissões, subsídios de envio e quaisquer ajustes. A integração deve:

• Combine pagamentos Faire com faturas Odoo
• Criar lançamentos diários para comissões Faire (normalmente 15-25%)
• Lidar com as deduções das contribuições de envio da Faire
• Reconciliar créditos promocionais e ajustes
• Sinalizar discrepâncias acima dos limites configuráveis

---

Guia de configuração passo a passo

Etapa 1: Pré-requisitos

Antes de iniciar a integração:

1. Conta de marca Faire: conta de vendedor ativa com acesso API aprovado
2. Instância Odoo: Versão 17, 18 ou 19 (Community ou Enterprise)
3. Dados do produto: produtos no Odoo com preços de atacado, SKUs e imagens
4. Configuração do armazém: pelo menos um armazém configurado para atendimento no atacado
5. Configuração de contabilidade: Plano de contas com comissões Faire e contas de despesas de taxas

Etapa 2: Instale o Módulo Conector

O conector ECOSIRE Faire-Odoo é instalado como qualquer módulo Odoo:

1. Carregue o módulo ZIP ou instale do Odoo Apps
2. Navegue até Configurações > Integração Faire
3. Conclua o fluxo OAuth 2.0 para autorizar sua conta da marca Faire
4. Configure parâmetros básicos de sincronização

Etapa 3: configurar o mapeamento do produto

1. Mapeamento de categorias: Combine categorias de produtos Odoo com a árvore de categorias da Faire
2. Atribuição de lista de preços: selecione ou crie uma lista de preços de atacado para o canal Faire
3. Configuração da embalagem de caixas: Defina as quantidades de embalagens de caixas por produto (a Faire requer informações sobre a embalagem de caixas)
4. Mapeamento de variantes: verifique o mapa de atributos de variantes (tamanho, cor) corretamente
5. Seleção de imagens: Escolha quais imagens de produtos Odoo sincronizar com Faire

Etapa 4: Configurar o processamento de pedidos

1. Canal de vendas: Crie uma equipe ou canal de vendas "Faire" no Odoo
2. Registro do cliente: Configure a "Faire Inc." como um cliente com condições de pagamento adequadas
3. Contatos de envio: configure como os endereços de entrega do varejista são armazenados
4. Atribuição de armazém: Definir armazém padrão para pedidos Faire
5. Configuração fiscal: Configure o tratamento isento de impostos para encomendas Faire (a Faire remete impostos)

Etapa 5: Configurar regras de inventário

1. Frequência de sincronização: Defina o intervalo de envio do inventário (recomendado: a cada 30 minutos para atacado)
2. Buffer de segurança: Configure a porcentagem de estoque de segurança global ou por produto
3. Alocação de canal: Se usar multicanal, defina a parcela máxima de inventário da Faire
4. Tratamento de pedidos em espera: configure se deseja permitir pedidos em espera ou ocultar itens fora de estoque

Etapa 6: testar e validar

1. Sincronize de 3 a 5 produtos de teste com a Faire e verifique a precisão da listagem
2. Faça um pedido de teste através da Faire e confirme a criação do pedido de venda Odoo
3. Processe o pedido de teste por meio de coleta e envio
4. Verifique se as informações de rastreamento aparecem no Faire
5. Revise o tratamento do relatório de liquidação para a transação de teste

---

Desafios e soluções específicos para atacado

Desafio 1: Acompanhamento de estoque de pacotes de caixas

Faire opera em pacotes de caixas (por exemplo, "caixa de 12 unidades"), mas Odoo normalmente rastreia unidades individuais. A integração deve converter entre o inventário Odoo em nível de unidade e a disponibilidade Faire em nível de caso.

Solução: o conector usa o sistema de unidade de medida do Odoo para lidar com conversões automaticamente. Configure cada produto com sua quantidade de embalagens e a integração calcula as caixas disponíveis a partir do estoque unitário.

Desafio 2: Estrutura de Comissão da Faire

A Faire cobra das marcas uma comissão de 15-25%, dependendo se o varejista foi adquirido através da Faire (taxa mais alta) ou se um cliente existente foi trazido para a plataforma (taxa mais baixa). As taxas de comissão também podem variar de acordo com a categoria de produto.

Solução: O módulo de importação de liquidação analisa detalhes de comissão por linha de pedido e cria entradas de despesas precisas. Com o tempo, o sistema cria um relatório de margem que mostra a verdadeira rentabilidade por produto após taxas Faire.

Desafio 3: Padrões sazonais de atacado

A compra no atacado é altamente sazonal. Os varejistas fazem grandes pedidos meses antes das temporadas de varejo (por exemplo, pedidos de feriados feitos entre julho e agosto). Esses picos sazonais exigem diferentes fluxos de trabalho de alocação de estoque e atendimento.

Solução: Configure regras sazonais no mecanismo de alocação de inventário. Durante as janelas de compra da pré-temporada, aumente a alocação de estoque da Faire e permita a aceitação de pedidos em espera. O conector oferece suporte a alterações de regras agendadas com base em intervalos de datas.

Desafio 4: Novo varejista vs gerenciamento de novos pedidos

Os primeiros pedidos de varejistas na Faire têm perfis de risco e necessidades operacionais diferentes dos novos pedidos de contas estabelecidas. Os novos pedidos devem fluir mais rapidamente e com menos revisões.

Solução: O conector marca os pedidos como "novo varejista" ou "repedido" com base nos dados da Faire, permitindo que o Odoo os encaminhe por meio de diferentes fluxos de trabalho de aprovação.

Desafio 5: Integração Faire Direct

A Faire oferece o "Faire Direct" — um programa onde as marcas enviam seus clientes de varejo existentes para fazer pedidos através da Faire com taxas de comissão reduzidas. O gerenciamento de pedidos diretos e de mercado requer rastreamento de comissões diferente.

Solução: O conector identifica pedidos Faire Direct por meio de metadados de API e aplica a taxa de comissão apropriada nas entradas contábeis do Odoo.

---

Operações manuais vs conector ECOSIRE

---

Otimizando sua operação de feira por meio do Odoo

Relatórios e análises

Com dados integrados no Odoo, as marcas podem construir análises de atacado poderosas:

• Desempenho do varejista: acompanhe as taxas de novos pedidos, os valores médios dos pedidos e o crescimento por varejista
• Desempenho do produto: Identifique os principais vendedores, os que avançam lentamente e os líderes de margem na Faire
• Comparação de canais: compare a lucratividade da Faire com outros canais de atacado e DTC
• Planejamento sazonal: use dados históricos de pedidos para prever a demanda sazonal e planejar o estoque
• Análise de comissão: acompanhe as taxas de comissão efetivas ao longo do tempo e por categoria de produto

Automação de fluxo de trabalho

Aproveite o mecanismo de automação do Odoo para agilizar as operações Faire:

• Confirmação automática de pedidos abaixo de um limite de valor configurável
• Gerar listas de seleção classificadas por prioridade de envio
• Enviar notificações de envio para contatos do varejista por e-mail
• Crie propostas de novo pedido quando produtos de venda rápida ficarem abaixo do estoque de segurança
• Sinalize pedidos de alto valor para revisão manual antes do processamento

Para marcas que gerem vários canais grossistas juntamente com a Faire, o nosso guia sobre gestão de vários mercados abrange a estratégia unificada de canais B2B/B2C.

---

Primeiros passos com ECOSIRE

ECOSIRE fornece módulos de conector Odoo pré-construídos para Faire e dezenas de outros mercados. Para marcas que exigem fluxos de trabalho de atacado personalizados, os serviços de integração Odoo da ECOSIRE incluem:

• Workshop de descoberta para mapear seus processos de atacado
• Design de fluxo de trabalho personalizado para requisitos específicos da Faire
• Pacote de casos e configuração de preços
• Treinamento de pessoal para equipes de almoxarifado e contabilidade
• Suporte contínuo à medida que a plataforma da Faire evolui

---

Perguntas frequentes

Posso gerenciar listagens de produtos Faire inteiramente no Odoo?

Sim. Títulos de produtos, descrições, imagens, preços, variantes e configurações de pacotes de caixas podem ser gerenciados no Odoo e enviados para o Faire. As alterações são sincronizadas automaticamente com base no intervalo configurado ou você pode acionar sincronizações manuais para atualizações urgentes.

O que acontece quando um retalhista cancela ou modifica uma encomenda Faire?

O conector monitoriza as alterações do estado da encomenda na Faire. Os cancelamentos antes do envio cancelam automaticamente o pedido de venda Odoo correspondente e liberam o estoque reservado. Para modificações, o conector atualiza o pedido Odoo adequadamente e envia uma notificação ao armazém se a separação já tiver sido iniciada.

Como as comissões Faire são tratadas na contabilidade Odoo?

Cada pagamento Faire gera um lançamento contábil manual que divide o valor bruto do pedido em receita (seu pagamento líquido) e despesas de comissão Faire. O conector utiliza os dados do relatório de liquidação da Faire para valores exatos de comissões por pedido, mapeando as comissões para uma conta de despesas configurável no seu plano de contas.

Quais versões do Odoo são suportadas?

O conector ECOSIRE Faire suporta Odoo 17, 18 e 19 nas edições Community e Enterprise. Cada versão recebe testes e atualizações dedicados à medida que a API da Faire evolui.

---

Conclusão

A Faire estabeleceu-se como o mercado grossista que as marcas independentes não se podem dar ao luxo de ignorar. Com mais de 700.000 varejistas adquirindo produtos ativamente, a plataforma oferece acesso incomparável ao canal de varejo independente. Mas as operações grossistas são inerentemente mais complexas do que as vendas ao consumidor – encomendas maiores, logística de embalagens, estruturas de comissões e padrões de compra sazonais exigem uma disciplina operacional rigorosa.

A integração do Faire com o Odoo transforma o atacado de um processo de alto contato e sujeito a erros em uma operação simplificada que se adapta à sua marca. As marcas que crescem mais rapidamente na Faire são aquelas que tratam o mercado como um canal de vendas integrado no seu ERP, e não como um negócio separado que requer os seus próprios fluxos de trabalho manuais.

Comece por avaliar o seu volume atual de encomendas Faire e os custos de processamento e, em seguida, explore os módulos conectores da ECOSIRE para encontrar o nível de automação certo para a sua operação grossista.