Configuração de Importação
Owner: Time Fiscal · Atualizado: 13/11/2025
Objetivo
Documentar o processo de configuração de importação que padroniza a transformação de XMLs entre o Esteira Contador e outros ERPs (como Domínio).
Explicar como as regras fiscais do Esteira Contador filtram e direcionam produtos para CFOPs corretos, criando uma relação fiel entre itens e suas funções na empresa.
Garantir que CFOPs de saída sempre resultem no mesmo CFOP de entrada, mantendo consistência fiscal entre sistemas.
Mostrar onde cada configuração acontece na interface e como validar o mapeamento antes de aplicar em produção.
Onde acessar na aplicação
ACESSO
Menu: Fiscal → Cadastros → Regras NF-e.
Contexto: Esse relacionamento de CFOP saída → entrada configuramos junto com a Regra NF-e, sendo o campo CFOP e CST Entrada referente a como o lançamento de entrada deve ser, para tal regra.
Localização: Após abrir o formulário de uma regra, os campos estarão lá em baixo.
Arquitetura resumida
FLUXO DE TRANSFORMAÇÃO XML
- O Esteira Contador recebe o XML original do fornecedor/cliente.
- As Regras Fiscais são aplicadas para filtrar e direcionar produtos aos CFOPs corretos conforme a função de cada item na empresa.
- O XML é transformado em um XML filtrado e padronizado, mantendo apenas os itens e CFOPs válidos para a operação.
- O XML transformado é exportado para o ERP destino (ex: Domínio) com a estrutura padronizada.
FRONTEND
O processo de inserir essa informação no cadastro da Regra NF-e, permite mapear CFOPs de saída (Esteira Contador) para CFOPs de entrada (ERP destino), e, auditar isso.
BACKEND
- Serviço de transformação XML aplica as regras fiscais cadastradas antes de gerar o XML de exportação.
- Validação de integridade: garante que todos os itens do XML original tenham correspondência nas regras.
- Mapeamento CFOP: mantém tabela de relacionamento entre CFOPs de saída e entrada.
- Versionamento: histórico de alterações preservado para auditoria e rollback quando necessário.
- Integração com APIs dos ERPs destino para validação prévia dos CFOPs de entrada.
GOVERNANÇA E SEGURANÇA
- Configurações podem ser herdadas do escritório para filiais, mas cada empresa pode ter regras específicas.
- Logs registram todas as transformações aplicadas, incluindo XML original e XML transformado.
- Validação de permissões: apenas usuários com perfil fiscal podem criar ou alterar configurações ativas.
Campos & validações
Use a tabela abaixo como checklist ao configurar a importação. Sempre valide se os CFOPs existem em ambos os sistemas antes de salvar.
| Grupo | Campo | Obrigatório | Orientação |
|---|---|---|---|
| Mapeamento CFOP Gerado | CFOP de saída (Esteira Contador) | SIM | CFOP que será gerado no Esteira Contador após aplicação das regras fiscais. Este é o CFOP que identifica a função do item na empresa. |
| Mapeamento CFOP Entrada | CFOP de entrada (ERP Destino) | SIM | CFOP que deve ser importado no ERP destino. Este valor garante que CFOP X1 de saída sempre resulte no mesmo CFOP X1 de entrada. |
| Mapeamento CST Gerado | CST Gerado (Esteira Contador) | SIM | CST que será gerado no Esteira Contador após aplicação das regras fiscais. Este é o CST que identifica a função do item na empresa. |
| Mapeamento CST Entrada | CST Entrada (ERP Destino) | SIM | CST que deve ser importado no ERP destino. Este valor garante que CST X1 de saída sempre resulte no mesmo CST X1 de entrada. |
Fluxo operacional
COMO FUNCIONA A TRANSFORMAÇÃO
O Esteira Contador recebe XMLs originais (de fornecedores ou clientes) e, mediante as Regras Fiscais, transforma esses XMLs em XMLs filtrados e direcionados. Cada item do XML é analisado e direcionado para o CFOP correto conforme sua função na empresa. Isso cria uma relação fiel: tal item, que tem tal função, sempre será gerado no CFOP X.
Com essa padronização, a Configuração de Importação garante que quando esse CFOP X for exportado para outro ERP (como Domínio), ele sempre resulte no mesmo CFOP X de entrada, mantendo a consistência fiscal entre sistemas.
ANTES DE CONFIGURAR
- Valide se as Regras de Entradas estão cadastradas e ativas para os CFOPs que você pretende mapear.
- Confirme que os CFOPs de entrada existem no ERP destino e estão habilitados para importação.
- Combine com o time fiscal quais CFOPs precisam de mapeamento e se há alguma exceção ou caso especial.
- Teste a transformação XML em ambiente de homologação antes de criar a configuração definitiva.
CADASTRAR UMA NOVA CONFIGURAÇÃO
- Na aba Fiscal → Cadastros → Regras NF-e.
- Após abrir o formulário de uma regra, os campos estarão lá em baixo.
- No mapeamento CFOP, informe o CFOP e CST Gerados, bem como o CFOP e CST de entrada correspondente (para o ERP destino).
Conciliação automática/manual
A conciliação da configuração de importação acontece em duas etapas: validação do mapeamento e verificação da transformação XML.
VERIFICAÇÃO DA TRANSFORMAÇÃO XML
- Após uma exportação, compare o XML original com o XML gerado.
- Confirme que todos os itens que possuem regra fiscal foram direcionados para os CFOPs corretos.
- Valide que itens sem regra foram filtrados (se essa opção estiver ativa).
- No ERP destino, verifique se os CFOPs de entrada correspondem exatamente aos mapeados na configuração.
- Em caso de divergência, revise as Regras de Entradas e a Configuração de Importação para identificar a causa.
MONITORAMENTO CONTÍNUO
- Configure alertas para quando uma transformação falhar ou gerar XMLs com CFOPs não mapeados.
- Revise semanalmente os logs de exportação para identificar padrões ou inconsistências.
- Mantenha um registro das configurações ativas por ERP para facilitar auditorias.
Cuidados & boas práticas
- Padronização é fundamental: Mantenha uma relação clara e documentada entre CFOPs de saída e entrada. Evite criar múltiplas configurações para o mesmo CFOP, a menos que haja necessidade real de diferenciação por segmento ou regime.
- Validação de CFOPs: Antes de criar uma configuração, confirme que os CFOPs de entrada existem e estão habilitados no ERP destino. Use a função de validação automática quando disponível.
- Coordenação com Regras de Entradas: Mantenha alinhamento entre as Regras de Entradas e as Configurações de Importação. Se uma regra fiscal mudar, verifique se as configurações de importação ainda estão corretas.
- Comunicação com times: Informe o time fiscal e o time de integração sempre que criar ou alterar configurações críticas. Mantenha um canal de comunicação para casos de dúvida ou divergências.
- Teste antes de aplicar: Sempre teste a transformação XML em ambiente de homologação antes de aplicar em produção.
- Documentação: Mantenha documentado quais CFOPs estão mapeados e para quais ERPs, facilitando manutenções futuras.
Referências
- Guia de Regras de Entradas – Documentação sobre como cadastrar regras fiscais que direcionam produtos para CFOPs corretos.
- Documentação do Domínio – Guia de importação de XMLs no ERP Domínio (quando disponível).
- Política interna de padronização fiscal entre ERPs
- Checklist de validação de mapeamento CFOP
Histórico
- 2025-11-13: Blueprint inicial para Configuração de Importação, documentando o fluxo de transformação XML e mapeamento CFOP entre Esteira Contador e outros ERPs.