Integração de marketplaces com ERP: como funciona, quais APIs usar e quanto custa

A dor real: o que acontece sem esse recurso

Imagine uma loja que vende cosmeticos no TikTok Shop, na Shopee e no Magalu. Sem integracao, o processo diario e um pesadelo: a vendedora precisa abrir o painel de cada marketplace, copiar os dados do pedido (nome do cliente, endereco, itens, valor) e digitar manualmente no ERP. Isso consome de 2 a 4 horas por dia, e cada erro de digitacao — um CEP trocado, um SKU errado — gera retrabalho e insatisfacao do cliente.

O estoque e outro ponto critico. Se um item e vendido na Shopee, a vendedora precisa lembrar de atualizar manualmente a quantidade no TikTok Shop e no Magalu. Se ela esquece, vende algo que nao tem, atrasa a entrega e toma multa. A emissao de nota fiscal tambem e feita uma a uma, manualmente, o que atrasa o faturamento e pode gerar problemas fiscais.

O que muda na pratica

Com a integracao, o fluxo se inverte: o pedido que chega no marketplace e automaticamente enviado para o ERP via webhook. O sistema cria o pedido, separa os itens, emite a nota fiscal e atualiza o estoque em todos os canais simultaneamente. A vendedora so precisa conferir e despachar.

As principais funcionalidades resolvidas sao: sincronizacao bidirecional de estoque (venda em um canal reduz o estoque nos outros), importacao automatica de pedidos com todos os dados fiscais, e emissao de NF-e integrada ao fluxo de faturamento. O tempo gasto com operacao cai de horas para minutos.

Comparacao pratica: sem sistema vs. com sistema

Passo a passo: como implementar

1. Mapeamento de requisitos: Liste os marketplaces que voce usa, o ERP atual e os campos que precisam ser sincronizados (SKU, preco, estoque, dados fiscais).
2. Analise das APIs: Cada marketplace tem documentacao publica. TikTok Shop usa API GraphQL, Shopee tem API REST com OAuth 2.0, Magalu oferece endpoints SOAP e REST. Verifique a qualidade da documentacao e se ha sandbox para testes.
3. Desenvolvimento do middleware: Crie um servico que conecta as APIs. Use Node.js ou Python para consumir os webhooks, tratar os dados e enviar para o ERP. Ferramentas como Supabase podem ser usadas para armazenar logs e controlar filas de processamento.
4. Mapeamento de dados: Cada marketplace chama os campos de forma diferente. Por exemplo, "variation" no Shopee pode ser "sku_id" no Magalu. Crie um dicionario de mapeamento que traduza os dados para o modelo do ERP.
5. Testes e validacao: Simule pedidos reais em ambiente sandbox. Verifique se o estoque atualiza corretamente, se a NF-e e emitida sem erros e se o webhook esta funcionando apos autenticacao OAuth.
6. Implantacao e monitoramento: Coloque em producao, monitore logs de erro e configure alertas para falhas de conexao. Faca ajustes finos no mapeamento conforme necessario.

Pros e contras

• Vantagens: reducao de erros operacionais, economia de tempo (horas para minutos), estoque sempre atualizado em todos os canais, emissao fiscal automatizada, escalabilidade para novos marketplaces.

• Pontos de atencao: custo inicial de desenvolvimento (R$ 8k a R$ 15k para 3 marketplaces), dependencia da documentacao da API (algumas sao mal documentadas), necessidade de manutencao quando as APIs mudam, e complexidade tecnica para mapear estruturas de dados diferentes.

Investimento e retorno esperado

O custo de integracao com um marketplace varia de R$ 3 mil a R$ 6 mil. Para tres marketplaces (TikTok Shop, Shopee e Magalu), o investimento fica entre R$ 8 mil e R$ 15 mil, dependendo da complexidade das APIs e da necessidade de customizacao. O prazo de desenvolvimento e de 3 a 8 semanas.

O retorno sobre o investimento e rapido. Uma loja que fatura R$ 50 mil por mes e gasta 3 horas por dia em operacao manual esta perdendo cerca de R$ 3 mil por mes em produtividade. Com a integracao, esse custo desaparece. Em 4 a 6 meses, o sistema se paga, e a partir dai e lucro operacional puro.

Perguntas frequentes

Como resolvi isso na pratica

Atendi uma cliente que vendia artesanato em tres marketplaces: TikTok Shop, Shopee e Magalu. Ela passava cerca de 4 horas por dia copiando pedidos manualmente para o ERP dela, que era um sistema legado sem API. O estoque estava sempre desatualizado, e ela ja tinha tomado duas multas por vender produtos sem estoque. O faturamento mensal era de R$ 30 mil, mas o custo operacional estava comendo a margem.

Desenvolvi um middleware em Node.js que rodava em um servidor na nuvem (usando Supabase para armazenar logs e controlar as filas de processamento). O primeiro desafio foi conectar o ERP legado: como ele nao tinha API, criei um script que gerava um arquivo CSV padrao e o enviava por FTP para o sistema. Para os marketplaces, usei as APIs oficiais: TikTok Shop com GraphQL, Shopee com REST e Magalu com SOAP. O maior problema foi no TikTok Shop: a documentacao nao explicava claramente como tratar o refresh token, e o webhook parava de funcionar a cada 24 horas. Depois de alguns dias de tentativa e erro, descobri que era necessario renovar o token antes do vencimento e reconfigurar o webhook manualmente na plataforma.

Outro desafio foi o mapeamento de dados. No Magalu, o campo "codigo do produto" era chamado de "sku_externo", enquanto no Shopee era "item_sku". Criei uma tabela de mapeamento no Supabase com regras de negocio: por exemplo, se o produto tinha variacao de cor, o sistema concatenava o SKU base com o codigo da cor. Para garantir seguranca, implementei RLS (Row Level Security) no banco para que cada loja so visse seus proprios dados, mesmo que o middleware fosse compartilhado.

O resultado foi transformador. A cliente reduziu o tempo de operacao de 4 horas para 20 minutos por dia. O estoque passou a ser atualizado em tempo real, e as multas pararam. Em tres meses, o faturamento subiu para R$ 45 mil porque ela conseguiu dedicar mais tempo a criar novos produtos e a divulgar nos marketplaces. O sistema se pagou em cinco meses, e hoje ela planeja integrar mais dois canais de venda.