CFOP identifica a natureza da operação fiscal de entrada ou saída.

CFOP na escrita fiscal: o que é e como classificar

Quem desenvolve ou opera módulo fiscal no Brasil esbarra cedo no CFOP — Código Fiscal de Operações e Prestações. Como arquiteto de ERP e integrações na TEK Softwares, já vi nota rejeitada por CFOP incoerente com UF, natureza da operação ou CST; já vi estoque divergir porque dev trocou dígito na pressa. CFOP não é detalhe contábil opcional: é classificação que governa ICMS, PIS/COFINS, escrituração SPED e cruzamento Sefaz. Este artigo explica o básico que todo dev fiscal precisa internalizar.

O que é CFOP

CFOP identifica natureza da circulação de mercadoria ou prestação de serviço vinculada a operação de NF-e/NFC-e/CT-e. Entrada ou saída, dentro ou fora do estado, do exterior — combinação errada gera autuação ou rejeição 302/500-series conforme layout. Software deve validar combinação CFOP + CST + NCM + UF antes de transmitir.

Estrutura dos grupos

Tradicionalmente dividimos:

  • 1.xxx — Entrada de mercadoria/aquisição de serviço dentro do estado.
  • 2.xxx — Entrada de fora do estado.
  • 3.xxx — Entrada do exterior.
  • 5.xxx — Saída dentro do estado.
  • 6.xxx — Saída fora do estado.
  • 7.xxx — Saída para o exterior.
  • 4.xxx / 8.xxx — Grupos especiais (subcontratação, industrialização, etc. — consulte tabela vigente).

Primeiro dígito indica direção e abrangência geográfica macro. Subcódigos refinam operação (venda, devolução, bonificação, remessa para demonstração). Devolução tem CFOP específico espelhando operação original — regra frequentemente automatizada em ERP maduro.

CFOP na implementação software

Nunca hardcode lista completa em código sem versionamento. Tabela CFOP muda; carregue de base versionada com vigência (dt_inicio, dt_fim). UI filtra CFOP permitido conforme:

  1. Tipo movimento (entrada/saída).
  2. UF emitente vs destinatário.
  3. Regime tributário e segmento (indústria, varejo, serviço).
  4. Finalidade NF-e (normal, complementar, devolução).
// Pseudocódigo validação
function cfopPermitido(cfop, operacao, ufOrig, ufDest) {
  return repo.buscarVigente(cfop, operacao, ufOrig, ufDest) != null;
}

Integração com estoque e contabilidade

CFOP errado movimenta estoque na direção oposta ou conta contábil default incorreta. Eventos pós-autorização Sefaz devem ser idempotentes — reprocessamento Pentaho ou fila não pode duplicar movimento. Leitura complementar: arquitetura ERP e integrações.

Devolução e bonificação

Devolução de venda usa CFOP de entrada espelhando saída original (ex.: saída 5.102 → devolução entrada 1.202). Bonificação, brinde, remessa para conserto — cada um CFOP distinto; confundir gera ICMS indevido. Product owner fiscal valida matriz antes do sprint.

Referência oficial

Consulte tabela atualizada no portal Sefaz do seu estado ou convênio nacional. Link histórico útil (verifique vigência): lista CFOP Sefaz PE. Automatize download anual se possível; alerte quando vigência expira.

Testes automatizados fiscais

Suite de casos: venda interna, interestadual contribuinte, consumidor final, devolução parcial, exportação indireta. Asserta CFOP calculado vs esperado. Homologação Sefaz ambiente nacional antes de produção — nunca só mock XML.

Erros comuns de desenvolvedor

  • Reutilizar CFOP de venda em transferência entre filiais.
  • Ignorar UF destinatário isento vs contribuinte.
  • Não versionar tabela após atualização CONFAZ.
  • Log XML sem mascarar CPF — privacidade LGPD.

CFOP e SPED

Escrituração SPED Fiscal cruza CFOP declarado vs NF-e chave. Divergência gera multa. ERP deve gerar SPED from same source of truth que NF-e — não planilha paralela.

Operações interestaduais DIFAL

CFOP 6.xxx disparou regras partilha ICMS; sistema deve calcular partilha conforme convênio vigente, não só trocar primeiro dígito. Teste caso SP→RJ contribuinte vs consumidor final.

CFOP serviço versus mercadoria

Confundir prestação serviço com venda mercadoria gera ISS onde deveria ICMS. Natureza operação NF-e campo obrigatório coerente com CFOP.

Matriz exemplo documentada

Tabela interna: operacao_id, cfop_saida_intra, cfop_saida_inter, cfop_devolucao_entrada, vigencia. Product owner fiscal assina PDF versionado anual.

CFOP complementar e ajuste

Nota complementar ICMS CFOP específico — não reutilize venda normal. Ajuste escrituração SPED referencia documento original. Software amarra chave NF-e referenciada validação schema.

Importação exportação

CFOP 3.xxx entrada exterior 7.xxx saída — alíquota câmbio DUIMP novas regras 2026 consulte contador antes automatizar. Flag importação temporária suspensão tributos.

UI assistida contador

Tooltip CFOP descrição completa tabela CONFAZ. Busca fuzzy código descrição. Histórico CFOP usado empresa filtro inteligente reduz erro operador.

Workflow aprovação CFOP excepcional

Operação rara CFOP 5922 supervisor fiscal aprova ticket workflow antes XML gerado. Audit log user id timestamp cfop anterior cfop novo motivo texto. Compliance interno auditoria SOX-like PME exportadora.

Treinamento operador emissor nota

UI fiscal tooltip CFOP exemplo operacao real screenshot. Quiz interno mensal cinco perguntas CFOP devolucao bonificacao transferencia filial. Erro humano reduz mesmo software validando — educacao complementa codigo.

Integração contábil automática

Lançamento contábil dispara após autorização NF-e evento fila: débito crédito conta configurada matriz CFOP plano contas versão ano fiscal. Contador valida matriz uma vez software aplica milhares notas consistente. Divergência SPED detectada reconciliação job Pentaho noturno diff ERP contabilidade terceiro.

Atualize tabela CFOP anualmente no primeiro sprint janeiro — débito técnico fiscal explode silenciosamente se operador confia lista desatualizada. Automatize alerta vigência expirando trinta dias antes via job scheduler email fiscal TI.

Prática adicional TEK Softwares: revise este tópico com stakeholder operacional antes de fechar sprint — alinhamento negócio evita retrabalho custoso em produção fiscal e integrações críticas ERP que atendem milhares documentos eletrônicos mensais sem downtime planejado inadequado.

Documente lições aprendidas DECISIONS.md link artigos relacionados blog tiagoek manutenção longo prazo conteúdo AdSense qualidade leitor desenvolvedor arquiteto tom primeira pessoa experiência vinte anos mercado brasileiro software sob medida impressão 3D marca TEK unificada confiança cliente indicacao orgânica composição juros reputação técnica honestidade entrega previsível pipeline verde segurança prepared statement parametros pentaho cfop correto.

Conclusão

CFOP é alfabeto da escrita fiscal brasileira. Classifique certo na origem, valide no software, documente matriz operação→CFOP e teste cenários reais. Desenvolvedor que domina CFOP conversa de igual para igual com contador e evita deploys de sexta que param emissão segunda de manhã. Para fluxo de dados entre módulos fiscais e financeiros, combine com integração robusta — Pentaho ou APIs internas bem contratadas.

WhatsApp