⚙️ Configuração de Importação
⚙️

Configuração de Importação

v1.0.0 review Spec

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.

Dica: A configuração de importação é parte integrante das Regras NF-e, permitindo mapear CFOPs de saída para CFOPs de entrada e auditar esse relacionamento.

Arquitetura resumida

FLUXO DE TRANSFORMAÇÃO XML

  1. O Esteira Contador recebe o XML original do fornecedor/cliente.
  2. As Regras Fiscais são aplicadas para filtrar e direcionar produtos aos CFOPs corretos conforme a função de cada item na empresa.
  3. O XML é transformado em um XML filtrado e padronizado, mantendo apenas os itens e CFOPs válidos para a operação.
  4. 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

  1. Na aba Fiscal → Cadastros → Regras NF-e.
  2. Após abrir o formulário de uma regra, os campos estarão lá em baixo.
  3. 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.
Gerado por agente · Fonte: @HEAD