Erro 2501 do SIFEN: o hash do QR code é inválido (CSC)

O que significa o erro 2501 do SIFEN, o hash do QR code inválido, e como corrigir o CSC e o CSC ID no Mheads ERP para emitir a factura.

Atualizado em 4 min de leitura

O erro 2501 do SIFEN significa que o hash do QR code da factura não bate com o que o SIFEN calcula com o CSC (código de segurança do contribuinte) registrado para o seu RUC. Quase sempre, o CSC ou o CSC ID cadastrados no Mheads ERP não são os da sua empresa ou não são os do ambiente em uso. Corrija os dois em Configurações › Parâmetros › Fiscal e envie a factura de novo.

A mensagem do SIFEN

No Manual Técnico, a validação J002a tem o código 2501 e a mensagem, em espanhol: "El hash del código QR incluido el de la cadena de caracteres es inválido". A observação explica que o hash do QR não corresponde ao cálculo feito com a cadeia informada e o CSC existente na base de dados do SIFEN.

No Mheads ERP a recusa aparece ao enviar, precedida de "SIFEN:", e fica em Opções › Resultado do Processamento.

O que é o CSC?

O CSC é um código secreto que a DNIT entrega a cada contribuinte. Ele tem duas partes:

ParteFormatoCampo no Mheads ERP
ID do CSC4 dígitos, por exemplo 0001CSC ID
Código do CSCO texto que a DNIT entregouCSC

O Mheads ERP usa o CSC para gerar o QR code de cada factura. Sem o CSC certo, o XML sai íntegro, mas o SIFEN recusa.

Como corrigir o 2501 no Mheads ERP

  1. Obtenha o CSC de produção no Marangatu, em Facturación y Timbrado, opção de solicitação e obtenção do CSC.
  2. Abra Configurações › Parâmetros › Fiscal no Mheads ERP.
  3. Digite o CSC ID com os 4 dígitos, como a DNIT entregou.
  4. Digite o CSC exatamente igual, sem espaços a mais.
  5. Salve. A alteração vale para todas as empresas do mesmo RUC.
  6. Volte à factura, clique em Salvar e confirme em Concluir, para gerar e assinar de novo o XML com o QR certo.
  7. Envie em Opções › Enviar à SIFEN/DNIT.

As causas mais comuns

  • CSC de outro contribuinte ou de outro ambiente. Em produção, o CSC é único para o seu RUC. Em teste, a DNIT usa CSC de teste, diferentes dos de produção.
  • CSC ID com formato errado. O ID vai com 4 dígitos. Se não for um número de até 4 dígitos, o serviço fiscal nem envia e responde PY-0306: "O id do CSC não é um número de até 4 dígitos.".
  • Par misturado. O ID de um CSC com o código de outro. Use sempre o par que a DNIT entregou junto.
  • CSC em uso em outro sistema. Se a sua empresa também emite pelo faturador gratuito da DNIT, confira no Marangatu qual ID de CSC corresponde a cada um.

Depois de corrigir

O CSC não faz parte do CDC (o código de controle de 44 dígitos). Por isso a correção do CSC muda só o QR: a factura recusada por 2501 continua com o mesmo número. Se o Mheads ERP não deixar concluir a factura de novo, fale com o suporte.

Lembre do prazo: passadas 120 horas da emissão, a transmissão é extemporânea. Veja os prazos de transmissão.

Se depois da alteração o 2501 continuar, fale com o suporte da Mheads com o número da factura. O CSC é um dos três requisitos para emitir, junto com o timbrado e o certificado. Veja o que configurar antes de emitir.

Perguntas frequentes

O que significa o erro 2501 do SIFEN?

O hash do QR code da factura não bate com o cálculo que o SIFEN faz com o CSC registrado para o seu RUC. Na prática, o CSC cadastrado no sistema não é o certo para o contribuinte ou para o ambiente.

Onde obtenho o CSC de produção?

No Marangatu, em Facturación y Timbrado, na opção de solicitação e obtenção do CSC. São dois dados, o ID de 4 dígitos e o código.

Onde cadastro o CSC no Mheads ERP?

Em Configurações › Parâmetros › Fiscal, nos campos CSC e CSC ID. A alteração vale para todas as empresas do mesmo RUC.

Reenviar a factura resolve o 2501?

Não. Com o mesmo CSC, o SIFEN recusa de novo. Corrija o CSC e o CSC ID e, depois, envie a factura outra vez.

Fontes

Este artigo foi útil?

Artigos relacionados

Não encontrou o que procurava?

Busque outro assunto na central de ajuda.

Buscar

Usa o Mheads ERP? O suporte atende de segunda a sexta, das 8h às 18h, pelos canais do contato do site.

Este artigo em Markdown (para assistentes de IA)