hashCSRT: geração SHA-1/Base64 e diagnóstico da rejeição 978

hashCSRT é o resultado em Base64 do hash SHA-1 calculado a partir do CSRT concatenado com a chave de acesso da NF-e/NFC-e. O CSRT é um segredo do responsável técnico e do Fisco; ele não deve aparecer no XML. A tag transporta o resultado derivado, junto do identificador idCSRT.

Caminho desta página: /nfeProc/NFe/infNFe/infRespTec/hashCSRT. O prefixo nfeProc identifica a nota processada; a informação estudada pertence ao conteúdo da NF-e, dentro de NFe/infNFe.

Entradas e sequência de geração

A NT 2018.005 v1.52 descreve: concatenar CSRT com a chave de acesso, nessa ordem; calcular SHA-1; converter o resultado para Base64; informar idCSRT correspondente e hashCSRT. Não há separador entre as duas entradas na concatenação documentada.

SHA-1 produz 20 bytes. Sua representação hexadecimal tem 40 caracteres; codificar esses 40 caracteres como se fossem os 20 bytes produz outro resultado. Para a forma canônica documentada, o Base64 dos 20 bytes tem 28 caracteres. A redação explicativa da NT menciona bytes hexadecimais; o XSD é inequívoco ao exigir comprimento binário 20, por isso a implementação deve trabalhar com o resultado binário do hash. NT, p. 8–10 e XSD.

Amostra de codificação sem segredo fiscal

Apenas para mostrar o tamanho binário, os 20 bytes didáticos todos iguais a zero têm esta representação:

<hashCSRT xmlns="http://www.portalfiscal.inf.br/nfe">AAAAAAAAAAAAAAAAAAAAAAAAAAA=</hashCSRT>

Não é um hashCSRT operacional, não corresponde a uma nota ou segredo de cliente e não deve ser usado para emissão. O fragmento é parcial, sem XML completo. Ele demonstra a forma Base64 aceita para 20 bytes, não comprova cálculo, credenciamento ou autoria.

No documento real, idCSRT e hashCSRT formam a sequência opcional de segurança: quando a sequência existe, ambos são obrigatórios. idCSRT identifica o segredo usado; não é o próprio segredo e não é concatenado no lugar dele.

Onde a NT v1.52 exige e valida o par

A NT 2018.005 v1.52 apresenta, para ZD07-10 na NF-e modelo 55 do Paraná: 19/01/2026 em homologação e 23/02/2026 em produção. Há uma comunicação estadual posterior: o Boletim 005/2026, publicado em 03/03/2026, informa a obrigatoriedade do CSRT na NF-e em produção a partir de 01/04/2026. A página estadual de CSRT ainda reproduz a previsão de 23/02/2026; para a exigência em produção, é necessário considerar a comunicação posterior, sem confundir os dois registros.

As verificações de credenciais informadas possuem outro histórico: 7ZD08-10, 7ZD08-20 e 7ZD09-10 registram PR/modelo 55, homologação desde 16/09/2024 e produção desde 01/10/2024. Exigir presença e validar conteúdo quando informado não são a mesma etapa. Modelo 65 permanece assinalado como implementação futura nas linhas da NT; há exceções para NFF (tpEmis=3) e SVC (tpEmis=7 ou 8). Essas condições não devem ser generalizadas para todas as UFs.

NT 2018.005 v1.52, p. 4 e 23–25 e Boletim estadual 005/2026.

Como investigar 978 sem expor o CSRT

Confirme UF, ambiente, emitente e CNPJ do responsável, depois verifique se o identificador corresponde ao CSRT vigente configurado. Compare a chave final da nota com a usada no cálculo; alterações de componentes da chave exigem novo resultado correspondente antes da assinatura.

Revise ordem da concatenação, caracteres adicionais, codificação de entrada e conversão dos 20 bytes para Base64. Teste localmente sem imprimir o segredo ou registrar a concatenação em logs. Se houver 976 ou 977, investigue cadastro ou revogação do identificador em vez de recalcular indefinidamente o mesmo hash. Corrija a causa comprovada, preservando histórico e credenciais de cada ambiente.

Fontes oficiais

• Leiaute NF-e/NFC-e — PL_010f_v1.04: TInfRespTec/hashCSRT l7412–7423; xs:base64Binary comprimento binário de 20 bytes
• NT 2018.005 — responsável técnico — 1.52, julho/2025: Cronograma, p. 4; CSRT e geração, p. 8–10; regras ZD07-10 e 7ZD02/08/09, p. 23–25.
• MOC 7.0 — Anexo I — 7.00, novembro/2020: Grupo ZD, p. 65; regras de responsável técnico, p. 128.
• Receita Estadual do Paraná — Boletim 005/2026 — publicado em 03/03/2026: Parágrafo de abertura: exigência CSRT na NF-e em produção a partir de 01/04/2026; posterior à previsão da NT v1.52.
• Paraná — página CSRT — captura de 14/10/2026: Abertura ainda reproduz 19/01/2026 em teste e 23/02/2026 em produção; divergência com boletim posterior preservada nas evidências.