# RUC: o dígito verificador, como é gravado e a consulta à SET

> Como se calcula o dígito verificador do RUC do Paraguai, como o Mheads ERP grava e mostra o RUC e o que a consulta à SET devolve, com os estados do RUC.

Fonte: https://mheads.com.br/pt-py/ajuda/ruc-digito-verificador-e-consulta · Atualizado em 2026-11-15 · Equipe Mheads

O **RUC** (Registro Único del Contribuyente) tem uma base de números e um **dígito verificador** no fim, depois do hífen: em 80012345-0, o dígito verificador é o 0. Esse dígito é calculado pelo **módulo 11** e serve para pegar um RUC digitado errado. No Mheads ERP você digita o RUC completo, com o dígito, e a tela confere a conta antes de salvar.

## Como se calcula o dígito verificador do RUC?

A conta usa o módulo 11, com pesos da direita para a esquerda:

1. Pegue a base do RUC, sem o dígito verificador.
2. Multiplique cada dígito por um peso: o último por 2, o anterior por 3, e assim até 11.
3. Some os resultados.
4. Divida a soma por 11 e veja o resto.
5. Se o resto for 0 ou 1, o dígito verificador é **0**. Se não, é **11 menos o resto**.

Exemplo com a base 80012345:

| Dígito | 8 | 0 | 0 | 1 | 2 | 3 | 4 | 5 |
|---|---|---|---|---|---|---|---|---|
| Peso | 9 | 8 | 7 | 6 | 5 | 4 | 3 | 2 |
| Produto | 72 | 0 | 0 | 6 | 10 | 12 | 12 | 10 |

A soma é 122. O resto de 122 por 11 é 1, então o dígito verificador é 0. O RUC completo fica **80012345-0**.

## Como o Mheads ERP grava o RUC

- Você pode digitar o RUC com ou sem hífen.
- O Mheads ERP grava o RUC com o dígito **junto e sem hífen** (800123450) e o mostra com o hífen (80012345-0).
- A tela confere o dígito verificador. Se bate, mostra **✓ RUC 80012345-0**. Se não bate, trata o que você digitou como a base, calcula o dígito e avisa: **Será gravado como … (dígito calculado)**.
- O RUC que começa com **80** é de pessoa jurídica. A tela sugere jurídica quando o RUC começa assim.

> **Importante:** Digite o RUC com o dígito verificador e leia o aviso abaixo do campo. Se você digitar só a base e o último número dela coincidir por acaso com o dígito do resto, a tela aceita o número como completo. Quem confirma o RUC é a consulta à SET.

## CPF, CNPJ ou documento estrangeiro não é RUC

Um cliente com documento do Brasil ou de outro país não tem RUC. Para esse documento a tela não oferece Contribuyente, e o sistema recusa salvar um cadastro novo assim: "CPF, CNPJ ou documento estrangeiro não é RUC: cadastre como No contribuyente, com o tipo de documento". Cadastre a pessoa como **No contribuyente** (não contribuinte) e escolha o tipo de documento, por exemplo cédula estrangeira.

O contribuinte precisa do RUC preenchido. E a natureza (contribuinte ou não) precisa estar marcada: é ela que decide quais campos o documento fiscal exige.

## Consultar o RUC na SET

No [cadastro da pessoa](https://mheads.com.br/pt-py/ajuda/cadastro-de-pessoas), a consulta do documento busca o RUC na SET. Na tela há o aviso de que é uma consulta paga. Ela exige o [certificado digital paraguaio](https://mheads.com.br/pt-py/ajuda/certificado-digital-paraguai) da empresa.

A SET devolve cinco dados:

- o **RUC**;
- a **razão social**;
- o **estado** e a descrição dele;
- se é **faturador eletrônico**.

A consulta não traz endereço, telefone nem atividade. Preencha esses dados à mão.

### Os estados do RUC

| Código | Estado |
|---|---|
| ACT | Ativo |
| SUS | Suspensão temporária |
| SAD | Suspensão administrativa |
| BLQ | Bloqueado |
| CAN | Cancelado |
| CDE | Cancelado de ofício |

Só o estado **Ativo** opera normalmente. O dado de faturador eletrônico é só informativo: há RUC que a SET informa como não faturador e que emite factura eletrônica. O Mheads ERP não bloqueia nada por esse dado.

### Quando a consulta não acha o RUC

- **"Consulta de documento: RUC não existe"**: confira os números e o dígito verificador.
- **"Consulta de documento: Sem permissão para consultar este RUC"**: a SET não permitiu a consulta desse RUC.

## Perguntas frequentes

### Qual é a conta do dígito verificador do RUC?

Pelo módulo 11. Cada dígito da base é multiplicado por um peso, de 2 em diante, da direita para a esquerda. Soma-se tudo e divide-se por 11. Se o resto for 0 ou 1, o dígito é 0. Se não, é 11 menos o resto.

### Digito o RUC com ou sem o hífen?

Como preferir, mas com o dígito verificador. O Mheads ERP grava o RUC com o dígito junto, sem hífen, e o mostra com o hífen. Se o último número não bater com o dígito, a tela trata o que você digitou como a base, calcula o dígito e avisa como vai gravar.

### CNPJ ou CPF do Brasil serve como RUC?

Não. CPF, CNPJ ou documento estrangeiro não é RUC. Cadastre a pessoa como não contribuinte (No contribuyente), com o tipo de documento, por exemplo cédula estrangeira.

### Que dados a consulta do RUC traz?

Cinco dados da SET - o RUC, a razão social, o estado, a descrição do estado e se é faturador eletrônico. A consulta não traz endereço nem telefone; esses dados são preenchidos à mão.

### O que preciso para consultar um RUC no Mheads ERP?

O certificado digital paraguaio da empresa configurado. Sem ele, o sistema avisa que a consulta de RUC exige o certificado paraguaio.

## Fontes

- [Manual Técnico do SIFEN, versão 150 (DNIT)](https://www.dnit.gov.py/documents/20123/420592/Manual+T%C3%A9cnico+Versi%C3%B3n+150.pdf)

---

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