# Lançar a compra no Paraguai: pelo CDC, pelo QR do KuDE, pelo XML ou manual

> Como lançar a compra no Paraguai no Mheads ERP pelo CDC, pelo QR do KuDE, pelo XML ou à mão, com timbrado, IVA, cuotas e nota de crédito.

Fonte: https://mheads.com.br/pt-py/ajuda/compra-paraguai-por-cdc-ou-xml · Atualizado em 2026-11-15 · Equipe Mheads

No Paraguai, o Mheads ERP lança a factura de compra do fornecedor de quatro jeitos. São eles: pelo **CDC** (Código de Control, 44 dígitos), lendo o **QR do KuDE**, pelo **XML** da factura ou à mão, para a factura de papel. Pelo CDC ou pelo QR, o sistema consulta a factura na SET e cria a compra com os itens, o IVA e as cuotas. Tudo começa em **Estoque › Compras**.

## Que forma de lançamento eu uso?

| Forma | Quando usar | O que traz |
|---|---|---|
| CDC ou QR do KuDE | Factura eletrônica do fornecedor | Fornecedor, itens, IVA, cuotas e a situação na SET |
| XML | Você tem o arquivo XML da factura eletrônica | Fornecedor, itens, IVA e cuotas, sem a situação na SET |
| Manual | Factura de papel (pré-impressa) | Só o cabeçalho; os itens entram depois |

O lançamento pelo CDC exige o certificado digital paraguaio da empresa configurado.

## Lançar pelo CDC ou pelo QR do KuDE

1. Abra **Estoque › Compras** e crie uma compra nova. Abre o **Lançamento de Compra**.
2. Em **Forma de Lançamento**, escolha o CDC.
3. Em **CDC da factura (44 dígitos)**, digite o CDC ou leia o QR do KuDE com um leitor 2D.
4. Clique em **Confirmar**. Abre a segunda tela do lançamento, na empresa em que você está.
5. Escolha o **Tipo Registro** e o **Armazenamento** e clique em **Lançar compra**.

O Mheads ERP consulta a factura na SET e cria a compra na hora. Se o CDC não tiver 44 dígitos, aparece "Informe o CDC da factura com 44 dígitos."

## O que a factura traz para a compra

- **Fornecedor:** pelo RUC do emissor. Se não existir no [cadastro de pessoas](https://mheads.com.br/pt-py/ajuda/cadastro-de-pessoas), o Mheads ERP cadastra.
- **Itens:** código do fornecedor, descrição, GTIN (código de barras), unidade, quantidade, preço e desconto. O produto é relacionado pelo código do fornecedor ou pelo GTIN.
- **IVA do item:** o que o fornecedor declarou na factura. Não muda na edição.
- **Cuotas:** uma por cuota da factura. A crédito por prazo, uma só, na emissão mais o prazo. À vista, uma só, no dia do lançamento.
- **Timbrado:** o da factura, para o livro de compras.

Se a factura estiver em [outra moeda](https://mheads.com.br/pt-py/ajuda/moeda-padrao-e-fuso-da-empresa), ela entra convertida pelo câmbio da própria factura.

> **Nota:** Se o Mheads ERP não conseguir ler o prazo da factura, a cuota fica no dia do lançamento e a tela avisa. Acerte o vencimento à mão nas parcelas.

## Por que a factura não é lançada?

O Mheads ERP recusa a factura nestes casos:

- o CDC já foi lançado em outra compra;
- a SET não achou a factura ou não permitiu a consulta;
- o documento não é uma factura eletrônica (nem uma nota de crédito de devolução, veja abaixo);
- a factura está **cancelada** na SET;
- a factura foi emitida para outro RUC, não o da empresa escolhida;
- a moeda da factura não está cadastrada, ou falta o câmbio;
- a factura traz câmbio por item, que ainda não é aceito.

## Lançar pelo XML

Em **Forma de Lançamento**, escolha **XML** e selecione o arquivo XML da factura. O resto segue como no CDC.

> **Atenção:** O XML não traz os eventos da factura. Por isso o lançamento pelo XML não percebe uma factura cancelada. Quando puder, prefira o CDC.

## Lançar uma factura de papel (manual)

1. Em **Forma de Lançamento**, escolha **Manual**.
2. Escolha o **Fornecedor** e a **Data Emissão**.
3. Em **Documento**, digite o número no formato 001-001-0000123: estabelecimento, ponto de expedição e número.
4. Digite o **Timbrado** da factura, com 8 dígitos.
5. Escolha a **Empresa** e o **Armazenamento**, clique em **Confirmar** e inclua os itens.

O número só com dígitos (por exemplo, 811) é recusado: use as três partes. O timbrado vai para o livro de compras da RG 90; veja [os livros da RG 90](https://mheads.com.br/pt-py/ajuda/livros-rg-90-e-arquivo-zip).

## Concluir a compra

Cada item precisa de um **grupo de IVA** para a compra concluir. Na conclusão, o produto recebe o grupo do item. Veja [os grupos de IVA](https://mheads.com.br/pt-py/ajuda/grupos-de-iva-10-5-isento). O andamento da compra e o OK de cada item estão em [lançar compra no Mheads ERP](https://mheads.com.br/pt-py/ajuda/lancar-compra-ciclo-e-ok-do-item).

Em guaranis, o preço unitário guarda até 7 casas e o total da linha fica inteiro, igual ao da factura. Na conclusão, o sistema aceita até 50 guaranis de diferença entre o calculado e o total da factura, por causa do arredondamento.

## A nota de crédito do fornecedor (devolução)

No Paraguai a devolução ao fornecedor é documentada pela **nota de crédito** que ele emite. Lance-a pelo CDC ou pelo XML, como uma compra:

- só entra a nota de crédito de **devolução** (motivos 1 e 2);
- o Mheads ERP a liga à compra concluída da factura que ela corrige, do mesmo fornecedor e da mesma empresa;
- a lista mostra o selo **Nota de crédito – devolução**.

Na conclusão, a mercadoria sai do estoque e nasce um **vale-crédito** a favor da sua empresa, para usar no pagamento ao fornecedor. A nota de crédito não gera conta a pagar.

## Perguntas frequentes

### Posso lançar a compra lendo o QR do KuDE?

Sim. Com um leitor 2D, leia o QR do KuDE no campo do CDC. O Mheads ERP tira o CDC do link do QR, consulta a factura na SET e cria a compra com os itens.

### Qual a diferença entre lançar pelo CDC e pelo XML?

Pelo CDC, o Mheads ERP consulta a SET e percebe se a factura foi cancelada. O XML não traz os eventos da factura, por isso a importação pelo XML não percebe o cancelamento.

### Como lanço uma factura de papel?

Use a forma Manual. Informe o fornecedor, a data de emissão, o número no formato 001-001-0000123 e o timbrado de 8 dígitos. O timbrado vai para o livro de compras da RG 90.

### Por que a compra não conclui?

Cada item precisa de um grupo de IVA e de um produto do cadastro. Confira os itens sem grupo ou sem produto relacionado e conclua de novo.

### Como registro a devolução ao fornecedor?

A devolução é feita pela nota de crédito que o fornecedor emite. Lance-a pelo CDC ou pelo XML, como uma compra. O Mheads ERP a liga à compra original e gera um vale-crédito a favor da sua empresa.

## Fontes

- [Consulta de documentos eletrônicos e-Kuatia (DNIT)](https://ekuatia.set.gov.py/consultas/)
- [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ó.
