Integração de sistemas ERP com e-commerce, marketplaces e fiscal
Integração de sistemas ERP é fazer o ERP trocar dados automaticamente com a loja virtual, os marketplaces, o financeiro, o CRM e o emissor fiscal, sem digitação dupla. Atendemos empresas que vendem em vários canais ou usam vários sistemas e precisam de pedidos, estoque, preços e notas fiscais sincronizados e rastreáveis.
Sintomas comuns
Pedidos da loja virtual e dos marketplaces são digitados de novo no ERP, e um erro de digitação vira nota fiscal errada.
O estoque não bate entre os canais, e a empresa vende o que já não tem ou deixa de vender o que tem.
A integração atual falha em silêncio: ninguém é avisado quando um pedido não sincroniza, e o problema aparece na reclamação do cliente.
O ERP ou o emissor ainda não está pronto para os campos de IBS e CBS na NF-e, e ninguém sabe dizer o que falta ajustar.
O que entregamos
A documentação e as credenciais ficam em nome da sua empresa.
- Mapa das integrações: sistemas, dados trocados, direção, frequência e dono de cada cadastro.
- Integrações por API, webhooks ou filas, com nova tentativa automática e fila de erros para reprocessar.
- Sincronização de cadastros (produtos, clientes, preços e estoque) com regra clara de qual sistema manda em cada campo.
- Painel de monitoramento com o que sincronizou, o que falhou e por quê, e alerta por e-mail ou WhatsApp.
- Ajuste técnico de XML, cadastros e integrações para a NF-e com IBS e CBS, conforme a classificação definida pela sua contabilidade.
- Documentação de cada integração e runbook de reprocessamento.
Como desenhamos uma integração que não falha em silêncio
Uma integração confiável tem três partes: uma fonte de verdade definida para cada dado, um mecanismo de entrega com nova tentativa e uma fila de erros visível. Sem isso, a integração funciona no teste e falha na primeira instabilidade de API, sem ninguém perceber.
Na prática:
- Fonte de verdade por campo. O ERP manda no preço e no estoque; a loja manda no pedido; o CRM manda no contato. Cada regra fica escrita no mapa de integrações.
- Webhooks quando disponíveis, consulta periódica quando não. Eventos chegam por webhook e entram numa fila; sistemas sem webhook são consultados em intervalo definido no escopo.
- Idempotência. Cada pedido e cada nota têm um identificador único, para que uma nova tentativa não duplique o lançamento.
- Nova tentativa e fila de erros. Falha temporária é repetida automaticamente; falha de dado vai para uma fila com o motivo, até alguém corrigir e reprocessar.
- Limites de API respeitados. Marketplaces e ERPs limitam requisições por minuto. A integração controla o ritmo em vez de ser bloqueada.
Integrações mais comuns
| Integração | Dados trocados |
|---|---|
| ERP ↔ loja virtual | Produtos, preços, estoque, pedidos, status de entrega, nota fiscal |
| ERP ↔ marketplaces | Anúncios vinculados a produtos, estoque por canal, pedidos, etiquetas, nota fiscal |
| ERP ↔ financeiro e bancos | Boletos, Pix, conciliação de recebimentos, contas a pagar |
| ERP ↔ CRM | Clientes, oportunidades, pedidos fechados, histórico de compras |
| ERP ↔ gateway de pagamento | Status de pagamento, estornos, taxas por transação |
| ERP ↔ emissor fiscal | Envio de dados para NF-e e NFC-e, retorno de XML, DANFE e protocolo |
Quando o ERP é de mercado, usamos a API oficial dele. Quando é sistema próprio sem API, construímos uma camada de API ou um middleware que lê e grava com segurança, sem alterar o banco por fora das regras do sistema.
Adequação da NF-e ao IBS e à CBS
A Nota Técnica 2025.002-RTC acrescentou à NF-e e à NFC-e o grupo de IBS e CBS em cada item, com CST, cClassTrib, base de cálculo, alíquotas e valores separados de IBS estadual, IBS municipal e CBS, além de totais novos, notas de crédito e de débito e devoluções referenciadas por item. O leiaute mudou em várias versões desde 2025, e cada versão exige ajuste nos sistemas que montam ou leem o XML.
O que verificamos e ajustamos:
- Cadastro. CST e cClassTrib no cadastro de produtos ou na regra fiscal, conforme a classificação da contabilidade.
- Montagem do XML. Grupos de IBS e CBS por item, totais da nota e validação contra o schema da versão vigente antes do envio.
- Devoluções e ajustes. Referência ao documento de origem por item e fluxos de nota de crédito e de débito.
- Integrações que leem XML. Lojas, hubs de marketplace, importadores de nota de compra e rotinas de conciliação que validam schema de forma estrita.
- CNPJ alfanumérico. Bancos de dados e validações que ainda tratam o CNPJ como número.
O cronograma da Sefaz mudou várias vezes. Antes de cada ajuste, conferimos a versão da nota técnica publicada no Portal Nacional da NF-e e testamos no ambiente de homologação. Não fazemos consultoria tributária: a decisão sobre como cada operação é tributada fica com a contabilidade, e nós garantimos que o sistema emita exatamente o que ela definiu.
O que não fazemos
- Classificação tributária das operações (CST e cClassTrib). Essa decisão é da contabilidade da empresa; nós implementamos o que ela definir.
- Implantação ou parametrização completa de ERP de mercado. Integramos o ERP que a empresa já usa.
- Integração que depende de acesso não autorizado, raspagem de tela ou quebra de termos de uso de uma plataforma.
- Gestão comercial dos marketplaces, como anúncios, preços e atendimento ao comprador.
Por que esses limites
Não definimos a classificação tributária porque essa responsabilidade é da contabilidade, que responde por ela. Não implantamos ERP de mercado do zero porque o fornecedor do ERP faz isso melhor; nossa parte é fazê-lo conversar com o resto. E não fazemos integração por raspagem de tela ou acesso não autorizado, porque ela quebra sem aviso e expõe a empresa a bloqueio na plataforma.
Como funciona
As etapas do serviço e o prazo típico de cada uma.
Diagnóstico das integrações
Levantamos os sistemas, as APIs disponíveis, os volumes e onde os dados divergem hoje. Definimos qual sistema é a fonte de verdade de cada cadastro.
prazo1 a 2 semanasProposta com critério de aceite
Escopo por integração, tempo máximo de sincronização esperado, tratamento de erros, custos de terceiros (conectores, emissor, servidor) separados do nosso honorário.
prazoaté 5 dias úteisExecução e homologação
Desenvolvemos em ambiente de teste, validamos com pedidos e notas de homologação e só então ligamos em produção, com monitoramento ativo.
prazo3 a 10 semanas, conforme o número de sistemasSustentação
Acompanhamos falhas, reprocessamos o que ficou na fila e ajustamos a integração quando um fornecedor muda a API ou a Sefaz publica nova versão de nota técnica.
prazomensal
Tecnologias
- APIs REST
- Webhooks
- Filas de mensagens
- n8n
- PostgreSQL
- Redis
- XML da NF-e
- NT 2025.002-RTC
- Docker
- Linux
- OAuth 2.0
Ferramentas do nosso trabalho, não parcerias comerciais.
Investimento
a partir de R$ 5.000 por projeto
Sustentação a partir de R$ 400/mês.
Valores de referência. Cada atendimento é dimensionado após levantamento do ambiente e do escopo; o valor final consta na proposta.
Perguntas frequentes
Quanto custa integrar ERP com e-commerce?
Projetos de integração têm referência a partir de R$ 5.000, e a sustentação mensal, a partir de R$ 400. O valor depende de quantos sistemas entram, das APIs disponíveis, do volume de pedidos e das regras de estoque e preço. Conectores pagos e emissor fiscal são custos de terceiros, cobrados à parte.
É melhor usar um conector pronto ou uma integração sob medida?
Use conector pronto quando ele cobre os seus canais e as suas regras sem adaptação. Faça sob medida quando há regra própria de estoque, preço ou fiscal, vários canais com lógicas diferentes ou necessidade de rastrear cada falha. Muitas vezes a solução é mista: conector para o padrão e integração sob medida para a exceção.
O que preciso ajustar na NF-e para o IBS e a CBS?
Tecnicamente, o XML da nota ganha o grupo de IBS e CBS por item, com CST, cClassTrib, base, alíquotas e valores, além de totais novos e novas regras de devolução. O cadastro precisa ter os códigos, e as integrações que leem ou montam XML precisam aceitar o leiaute vigente da NT 2025.002-RTC. A classificação de cada operação é definida pela contabilidade.
Vocês integram com qualquer ERP?
Com qualquer ERP que ofereça API, webhook, banco de dados acessível ou exportação estruturada de arquivos. Antes da proposta, verificamos a documentação da API e os limites de uso. Se o ERP não oferece nenhum desses caminhos, dizemos isso no diagnóstico.
Como sei se uma integração falhou?
O painel de monitoramento mostra cada sincronização com status e motivo do erro, e um alerta avisa a equipe responsável. Itens com falha ficam numa fila e podem ser reprocessados depois da correção, sem redigitar pedido nem nota.
Próximo passo
Liste os sistemas que precisam conversar e onde os dados divergem hoje. O próximo passo é um diagnóstico das integrações ou uma proposta.
Prefere escrever? Use o formulário de contato.
Respondemos em até 1 dia útil, de segunda a sexta, das 9h às 17h.