# 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.

Fonte: https://mheads.com.br/pt-py/ajuda/2501-hash-do-qr-csc-sifen · Atualizado em 2026-11-15 · Equipe Mheads

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.

> **Nota:** O CSC do Paraguai é parecido com o CSC da NFC-e no Brasil, mas é outro código, entregue pela DNIT. O do Brasil não serve.

## 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:

| Parte | Formato | Campo no Mheads ERP |
|---|---|---|
| ID do CSC | 4 dígitos, por exemplo `0001` | **CSC ID** |
| Código do CSC | O texto que a DNIT entregou | **CSC** |

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**.

> **Atenção:** O CSC de produção e o de teste são diferentes. CSC de teste em produção, ou o contrário, também dá 2501.

## 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](https://mheads.com.br/pt-py/ajuda/prazo-de-transmissao-sifen).

Se depois da alteração o 2501 continuar, [fale com o suporte da Mheads](https://mheads.com.br/pt-py/ajuda/abrir-chamado-com-a-mheads) com o número da factura. O CSC é um dos três requisitos para emitir, junto com o [timbrado](https://mheads.com.br/pt-py/ajuda/timbrado-validade-e-vigencia) e o certificado. Veja [o que configurar antes de emitir](https://mheads.com.br/pt-py/ajuda/factura-eletronica-paraguai-sifen).

## 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

- [Manual Técnico del SIFEN, versión 150 (validación J002a, código 2501)](https://www.dnit.gov.py/documents/20123/420592/Manual+T%C3%A9cnico+Versi%C3%B3n+150.pdf)
- [Marangatu, sistema de gestión tributaria de la DNIT](https://marangatu.set.gov.py/eset/)

---

O Mheads ERP é o sistema de gestão da Mheads para a operação do varejo, com uma ou várias lojas: venda com PDV que funciona sem internet, estoque e compras, fiscal, financeiro e relacionamento com o cliente numa base só.
