Voltar para o blog

NF-e e NFC-e

Código 227: divergência de CPF, Id histórico ou consulta por QR Code

Para resolver a 227, identifique mensagem e serviço. No MOC 7, ela compara CPF do emitente e certificado da assinatura. O prefixo NFe no Id é um ramo histórico; consultas públicas têm significado próprio.

Blog ALRA
Capa ilustrada da ALRA: Código 227: divergência de CPF, Id histórico ou consulta por QR Code.

Para resolver a 227, identifique mensagem e serviço. No MOC 7, ela compara CPF do emitente e certificado da assinatura. O prefixo NFe no Id é um ramo histórico; consultas públicas têm significado próprio.

Mensagem da regra F03A: “Rejeição: CPF do Emitente difere do CPF do Certificado Digital”.

Primeiro escolha o diagnóstico correto

Se o retorno menciona CPF do emitente ou autor: confira a identidade no XML e o titular do certificado da assinatura, conforme a operação. A regra F03A do MOC é obrigatória quando se trata de certificado de assinatura com CPF. MOC 7.0, Anexo I, seção 4.1.5.

Se o retorno menciona campo Id ou falta da literal NFe: trate a ocorrência como mensagem histórica ou mapeamento que precisa de confirmação. O MOC 5.0, de março de 2012, contém essa descrição para 227 na tabela de mensagens. Isso documenta a origem do texto, sem provar aplicação na NF-e atual. MOC 5.0, páginas 86 e 88.

Se a tela mostra apenas 227: identifique modelo, serviço, ambiente e versão. No Web Service, obtenha cStat e xMotivo do retorno original; na consulta pública, registre o texto e a URL. Não altere CPF, certificado ou chave de acesso sem identificar a validação.

Ramo atual: CPF diferente do certificado

Na assinatura com e-CPF, o MOC exige que o CPF completo do certificado coincida com o do emitente. Não se compara “raiz do CPF”. MOC, Visão Geral, seção 4.2.4.1.

Para investigar:

  1. Confira a identidade real do emitente e emit/CPF no XML rejeitado.

  2. Identifique o titular e número de série do certificado dentro da assinatura, sem compartilhar chave privada ou senha.

  3. Compare o CPF completo do cadastro, XML e certificado, preservando onze dígitos e zeros iniciais.

  4. Corrija o cadastro verdadeiro ou selecione o certificado permitido. Não substitua o emitente pelo titular de um certificado escolhido por engano; parentesco não satisfaz a F03A.

  5. Gere e assine novamente a mensagem rejeitada pelo emissor. Não edite uma assinatura pronta.

  6. Confirme o retorno definitivo: validação local e desaparecimento da 227 não comprovam autorização.

A Maxiprod diferencia cadastro de CPF incorreto e certificado configurado para outra pessoa. A TotalERP também destaca o cuidado com zeros à esquerda. A comparação relevante neste ramo é de CPF; exemplos envolvendo CNPJ não devem ser transportados para ele.

Situações que mudam a análise

Produtor rural usando software próprio: a NT 2023.002 admite NFC-e por produtor rural pessoa física com inscrição estadual e estabelece assinatura com e-CPF do emitente no fluxo de software próprio. A possibilidade técnica não substitui os requisitos de habilitação e de emissão da UF. NT 2023.002 v1.01, seções 1 e 2.1.

Evento fiscal: confira quem é o autor admitido e qual CPF aparece em infEvento. A NT de Insucesso na Entrega, restrita à NF-e 55, lista 227 com a redação relativa ao CPF do autor. Não altere o emitente da nota original para corrigir a identidade de um evento. NT 2023.005 v1.02, seção 3.6(d), p.9.

Nota Fiscal Fácil: para tpEmis=3, a NT 2021.002 prevê assinatura do XML com certificado da SVRS e registra a exceção na F03A. A orientação genérica de instalar o e-CPF do emitente não deve substituir o procedimento institucional da NFF. NT NFF v1.12, grupo F, página 11.

PAA: existem assinatura avançada específica e assinatura qualificada do provedor. A exceção da F03 para CNPJ não dispensa genericamente a F03A. O provedor precisa identificar a etapa rejeitada. A NT 2026.001 v1.02b abrange NF-e 55/SVRS; produção prevista em 05/10/2026 não comprova habilitação individual. NT PAA v1.02b, seções 1.1 e 8.2.

Ramo histórico: campo Id sem o prefixo NFe

O Id de infNFe é “NFe + chave de acesso”: 3 caracteres + 44 posições = 47. Na assinatura, Reference URI acrescenta # antes desse Id; # não integra a chave. A representação é simbólica e não deve ser transmitida.

Se uma ocorrência confirmada mencionar a falta desse prefixo, a equipe técnica deve conferir a geração de infNFe/Id, a versão do schema e a referência da assinatura ao elemento correto. Corrige-se o gerador e assina-se novamente a mensagem rejeitada; não se acrescenta texto à chave de acesso armazenada nem se modifica um documento já autorizado.

O MOC 7 usa 227 na F03A e 502 na A03-10, para divergência na composição do Id. O MOC 5 também lista 546 para falta da literal NFe. Essas tabelas não estabelecem a data exata de transição nem comprovam uso atual do rótulo antigo. A Omie mantém esse rótulo em sua ajuda; sua existência explica resultados de busca conflitantes, sem substituir o retorno original e a documentação do autorizador.

CT-e, MDF-e e outras famílias fiscais exigem suas próprias especificações, mesmo quando o código é 227.

Ramo da consulta pública por QR Code

Na NF-e 55 com DANFE Simplificado Tipo 2, a tabela de consulta pública descreve 227 como DigestValue do QR inconsistente com a NF-e. Isso não é a F03A. NT 2026.003 v1.00, seções 4.3 e 5.3.

Compare QR decodificado, XML original, versão e ambiente com o integrador. Há uma diferença documental: os parâmetros da versão 3 não incluem DigestValue avulso. Não invente esse parâmetro, altere CPF ou modifique XML autorizado; confirme o leiaute aplicado pela UF e corrija o gerador do QR quando a causa estiver demonstrada. A produção prevista em 03/08/2026 não certifica disponibilidade estadual.

Código 227 na consulta pública da NFC-e modelo 65

O Manual DANFE NFC-e v6.0 também registra 227 para divergência entre o DigestValue do QR e o da NFC-e. É Código da consulta por chave ou QR, sem definição de cStat de autorização nessa tabela. Na versão 2 offline, confira o DigestValue da assinatura do XML e sua conversão hexadecimal no sexto parâmetro, conforme o manual. Uma impressão ligada a outro XML pode produzir a divergência. Manual v6.0, pp.22–24 e 38–39.

Na versão 2 online também não há DigestValue avulso. Na versão 3, o QR online contém chave, versão e ambiente; o offline possui assinatura própria. Se o aviso contrariar esse leiaute, encaminhe QR, XML original e contexto ao integrador. Não acrescente o parâmetro legado nem troque CPF ou certificado por esse aviso. NT 2025.001 v1.03, pp.5 e 14

Como confirmar e quando pedir suporte

Confirme que o CPF da identidade exigida coincide com o do certificado correto no ramo de assinatura. No ramo de estrutura, confira Id e referência conforme o schema. Leia o retorno definitivo e preserve o protocolo de autorização ou registro do evento.

Se houve tentativa anterior sem resposta, consulte sua situação antes de retransmitir. Se código e mensagem apontarem para ramos diferentes, pare as alterações e encaminhe ao suporte retorno original, serviço, versão e contexto. Não use mudança de CPF, de série ou de regime de emissão como tentativa de contorno.

Revisão documental: 09/10/2026. Autorização/eventos conforme modelo; Id histórico; consultas QR da NFC-e 65 e da NF-e 55 Tipo 2 separadas, sem promessa de implantação estadual.

Pronto para dar o próximo passo?

Pronto para organizar sua empresa e ganhar mais tempo?

Teste grátis por 15 dias e descubra como a Alra pode transformar a gestão do seu negócio.