Conector Odoo Etsy: Integração de comércio artesanal

O Etsy hospeda mais de 9 milhões de vendedores ativos e atende a um nicho que nenhum outro mercado replica: produtos feitos à mão, vintage e artesanais. Para os vendedores Etsy que cresceram além do rastreamento básico de planilhas, o Odoo 19 Enterprise fornece os recursos de gerenciamento de estoque, contabilidade financeira e planejamento de produção que um negócio artesanal em expansão precisa.

O ECOSIRE Odoo Etsy Connector conecta sua loja Etsy com Odoo, sincronizando listagens, pedidos, estoque e dados de clientes. Este guia cobre a integração completa desde a configuração de credenciais da API Etsy até o gerenciamento de ordens de produção e relatórios de vendedores Etsy.

Principais conclusões

• O conector usa Etsy API v3 com autenticação OAuth 2.0
• Listagens sincronizadas em ambas as direções: crie no Odoo, publique no Etsy
• A importação do pedido inclui detalhes do comprador, notas de personalização do item e bandeiras de embrulho para presente
• O estoque é enviado para o Etsy dentro de 5 minutos após as alterações de estoque no Odoo
• A integração da ordem de produção (MRP) rastreia produtos artesanais feitos sob encomenda
• As taxas Etsy e taxas de processamento de pagamentos são reconciliadas automaticamente com as faturas Odoo
• Várias lojas suportadas: gerencie várias lojas Etsy a partir de uma instância Odoo
• A renovação da listagem do Etsy (renovação automática de 20 centavos por listagem) é rastreada nos custos do Odoo

---

Por que os vendedores Etsy precisam de integração Odoo

O gerente de loja integrado do Etsy lida com o rastreamento básico de pedidos, mas não tem a profundidade que as empresas artesanais em crescimento precisam:

Para vendedores que geram mais de US$ 10 mil de receita mensal ou gerenciam mais de 50 SKUs ativos em produtos artesanais e materiais, o Odoo oferece recursos operacionais que se adaptam ao negócio.

---

Configuração da API Etsy

Etapa 1: Crie uma conta de desenvolvedor Etsy

1. Vá para developers.etsy.com e faça login com sua conta de vendedor Etsy
2. Clique em Criar aplicativo em Meus aplicativos
3. Dê um nome ao seu aplicativo (por exemplo, "Integração Odoo") e descreva sua finalidade
4. Aceite os Termos de Serviço da API Etsy
5. A Etsy analisará sua inscrição (normalmente de 1 a 3 dias úteis)

Etapa 2: Configurar escopos OAuth

Seu aplicativo precisa dos seguintes escopos do OAuth 2.0:

listings_r      — Read active listings
listings_w      — Create/edit listings
listings_d      — Delete listings
transactions_r  — Read orders and transactions
transactions_w  — Update order status
shops_r         — Read shop data
billing_r       — Read payment and billing data

Etapa 3: gerar credenciais de API

Após aprovação:

• Chave API (Keystring): o identificador do seu aplicativo
• Segredo compartilhado: usado para fluxo OAuth PKCE
• URI de redirecionamento: https://your-odoo.com/etsy/oauth/callback

Etapa 4: Concluir autorização OAuth

Na configuração do conector no Odoo:

1. Clique em Conectar loja Etsy
2. Autorize o conector no pop-up Etsy OAuth
3. O conector recebe e armazena seu token de acesso e token de atualização

Os tokens OAuth da Etsy não expiram com um limite de tempo fixo (ao contrário dos tokens de atualização de 18 meses da Amazon). Eles permanecem válidos até que você os revogue.

---

Instalação e configuração do conector

Instale no mercado ECOSIRE:

Disponível em Produtos ECOSIRE. Após a compra:

1. Carregue e instale o módulo Etsy Connector por meio de aplicativos
2. Navegue até Inventário → Etsy ou Vendas → Lojas Etsy

Configuração da loja:

Mapeamento de seções da loja Etsy:

O Etsy organiza as listagens em seções de lojas (equivalentes a categorias). Mapeie seções do Etsy para categorias de produtos Odoo:

---

Gerenciamento de listagem

Criando listagens Etsy de produtos Odoo:

1. Abra um formulário de produto → guia Etsy → Criar listagem
2. Configure campos específicos da listagem:

• Título: máximo de 140 caracteres, rico em palavras-chave para Etsy SEO
• Descrição: descrição completa com materiais, dimensões, instruções de cuidados
• Tags: até 13 tags, essenciais para o algoritmo de pesquisa Etsy
• Categoria: navegue na árvore de taxonomia do Etsy
• Quem fez isso: eu, um membro da minha loja, outra pessoa
• Quando fabricado: Feito sob encomenda, 2020–2025, 2010–2019, etc.
• Tipo: Item Físico, Download Digital
• Preço: preço de listagem (pode ser diferente do preço de tabela do Odoo)
• Quantidade: estoque disponível para listar
• Materiais: até 13 tags de material
• Fotos: até 10 fotos (a primeira imagem se torna a imagem principal do anúncio)

3. Clique em Publicar no Etsy

Listagens de variações (variantes de produtos):

Etsy oferece suporte a "variações" - Odoo mapeia-as para atributos do produto:

Exemplo: um anel vendido em ouro/prata com tamanhos 5 a 10 cria uma única listagem no Etsy com 12 combinações de variações, cada uma com seu próprio preço e controle de estoque.

Listagens de pedidos personalizados e personalizados:

Etsy é famosa por itens personalizados. Configure a personalização no conector:

• Ative Personalização obrigatória/opcional na listagem
• O comprador insere o texto de personalização (nome, data, monograma) na finalização da compra
• Este texto aparece no campo de notas do cliente do pedido de venda Odoo
• A equipe de produção vê a customização na hora de confeccionar o item

---

Sincronização de pedidos

Detalhes de importação do pedido:

Os pedidos do Etsy incluem campos essenciais para vendedores artesanais:

Roteamento de pedidos para produção sob encomenda:

Os vendedores da Etsy costumam fazer itens após receber um pedido (MTO). Configure o conector:

1. Nas configurações do produto → aba Vendas → Sob Demanda: "Feito sob Encomenda"
2. Quando um pedido do Etsy é importado, o Odoo cria:

• Pedido de venda (confirmado)
• Ordem de fabricação (rascunho) vinculada à venda
• A ordem de fabricação mostra os materiais necessários e o tempo de mão de obra

3. A equipe de produção trabalha através da ordem de fabricação
4. Quando o MO é concluído, as mercadorias chegam em estoque → a entrega é confirmada
5. Detalhes da remessa enviados de volta para a Etsy

Tratamento de pedidos personalizados:

Para comissões personalizadas (não listadas no Etsy):

1. Aceite o pedido personalizado no Etsy
2. No Odoo, crie manualmente um pedido de venda de "Produto Personalizado" com preço acordado
3. Link para a conversa do Etsy nas notas do pedido
4. Marque como enviado no Etsy manualmente ou por meio da ferramenta de pedido personalizado do conector

---

Sincronização de inventário

Para produtos físicos:

A sincronização de inventário é executada a cada 5 minutos por padrão. Quando o estoque Odoo muda:

1. Quantidade disponível recalculada (disponível menos reservada)
2. Quantidade enviada para Etsy por meio da API Listing Inventory
3. Se a quantidade chegar a 0: listagem definida como esgotada (mantém listagem ativa)
4. Quando reabastecido: listagem reativada automaticamente

Para produtos sob encomenda:

Os produtos MTO não rastreiam o estoque físico no sentido tradicional. Configure a quantidade listada no Etsy como um indicador de capacidade de produção:

• Defina uma "quantidade disponível" fixa (por exemplo, 5) representando a capacidade atual do pedido
• Ajuste manualmente conforme sua fila de produção é preenchida

Para downloads digitais:

Os produtos digitais têm estoque infinito. O conector define a quantidade Etsy como 999 e nunca sincroniza alterações de inventário. A entrega de arquivos digitais é feita pelo sistema de download digital nativo da Etsy – o conector não afeta a entrega de arquivos.

---

Reconciliação Financeira

O processamento de pagamentos e a estrutura de taxas do Etsy exigem uma configuração contábil cuidadosa.

Estrutura de taxas do Etsy Payments (para referência):

• Taxa de listagem: US$ 0,20 por listagem (cobrada quando listada e a cada 4 meses na renovação automática)
• Taxa de transação: 6,5% do preço do item + frete
• Taxa de processamento de pagamento: 3% + US$ 0,25 por transação (EUA)
• Taxa de anúncios externos: 12-15% quando o Etsy anuncia seu item (se inscrito)

Configurando reconciliação de taxas no Odoo:

1. Crie um diário Etsy Payments dedicado (tipo de banco)
2. Crie contas:

• Etsy Listing Fees (despesa)
• Etsy Transaction Fees (despesa)
• Etsy Payment Processing Fees (despesa)
• Etsy Payments Receivable (ativo circulante)

3. Importe extratos de pagamento do Etsy:

• Navegue até Etsy → Pagamentos → Extrato Mensal → Baixar CSV
• Importe para a ferramenta de reconciliação do conector
• O conector cria lançamentos contábeis manuais para cada tipo de transação

Processo de reconciliação de final de mês:

1. Baixe o CSV de pagamento mensal do Etsy
2. Importação via conector: Etsy → Reconciliação → Declaração de importação
3. Revise as entradas de correspondência automática
4. Combine manualmente quaisquer transações não reconhecidas
5. Confirme a reconciliação → lançamentos contábeis manuais publicados no Odoo
6. Reconcilie a conta bancária do Etsy Payments com o saldo do Odoo

---

Etsy SEO e acompanhamento de desempenho

Listando sincronização de desempenho:

O conector importa estatísticas da loja Etsy para Odoo:

• Visualizações por listagem por dia
• Contagem de favoritos
• Taxa de conversão (visualizações em vendas)
• Receita por listagem

Esses dados aparecem no painel de análise do Etsy no Odoo, permitindo que você identifique listagens de melhor desempenho e de baixo desempenho sem mudar para a interface de estatísticas do Etsy.

Acompanhamento de tags e palavras-chave:

Acompanhe quais termos de pesquisa direcionam o tráfego do Etsy obtendo estatísticas da API Shop Stats do Etsy. Use esses dados para:

• Identifique tags de alta conversão para adicionar a listagens semelhantes
• Encontre listagens com muitas visualizações, mas baixa conversão (preços ou problemas com fotos)
• Identifique tendências sazonais em sua categoria de produto

---

Perguntas frequentes

O conector pode lidar com o Etsy's Pattern (site personalizado), além do mercado Etsy?

Não. O conector integra-se especificamente ao mercado Etsy. Etsy Pattern (seu construtor de sites hospedados) compartilha o mesmo inventário, mas usa checkout e processamento de pagamento separados. Os pedidos de padrões precisariam ser gerenciados separadamente. Para uma integração completa do site, recomenda-se o módulo de site do Odoo ou uma integração do Shopify.

Como o conector lida com a reserva do Etsy para transações (retenções de pagamento do Etsy)?

A Etsy às vezes coloca uma reserva nos pagamentos de novos vendedores para gerenciamento de risco. O conector rastreia o status do pagamento de cada pedido. Os valores reservados aparecem no saldo do Etsy Payments, mas não estão disponíveis para saque. O conector marca essas faturas como "pagamento pendente" até que a reserva seja liberada e, em seguida, atualiza para "paga" quando os fundos são liberados para seu banco.

Posso gerenciar várias lojas Etsy (por exemplo, uma de joias e outra de decoração) a partir de uma instância do Odoo?

Sim. Crie configurações de loja Etsy separadas com credenciais OAuth independentes para cada loja. Cada loja tem suas próprias configurações de importação de pedidos, alocação de estoque e reconciliação de pagamentos. Os produtos podem ser listados em várias lojas com substituições de preços específicas da loja.

O conector suporta a funcionalidade de atacado/B2B do Etsy?

Etsy não possui um programa nativo de atacado/B2B. Se você usar o Etsy para consultas de atacado, mas lidar com a transação real off-line, o conector lidará com isso da mesma forma que qualquer pedido personalizado – você criaria o pedido de venda Odoo manualmente com o preço acordado e o cumpriria por meio de seu processo padrão.

Como o conector lida com vendas internacionais do Etsy e requisitos de IVA/GST?

A Etsy recolhe e envia IVA/GST em nome de vendedores para compradores na UE, Reino Unido, Austrália e outras jurisdições onde a Etsy atua como facilitadora de mercado. O conector importa esses pedidos com imposto de US$ 0 (já que o Etsy os cobrou). Para mercados onde você é responsável pela cobrança de impostos, configure posições fiscais apropriadas no Odoo com base no país do comprador.

---

Próximas etapas

O ECOSIRE Etsy Connector transforma o Etsy de um mercado independente em um canal de vendas totalmente integrado dentro do Odoo 19 Enterprise. Para empresas artesanais que vão além da gestão básica da loja, esta integração proporciona a espinha dorsal operacional para o crescimento sustentável.

Obtenha o conector ECOSIRE Etsy para Odoo 19 →

O conector inclui documentação de configuração, ferramentas de importação para dados históricos de pedidos e suporte de implementação para integrar sua loja Etsy ao Odoo de forma rápida e correta.