# CDC (Código de Control) (/docs/conceptos/cdc)



Para verificar tu factura, buscá el CDC en el PDF o en la factura impresa e ingresalo en la [consulta de la DNIT](https://ekuatia.set.gov.py/consultas/). También podés escanear el QR de la factura.

El **CDC** (Código de Control) es el identificador único de un documento electrónico ante SIFEN. Tiene 44 caracteres numéricos y lleva toda la información esencial del documento codificada en su estructura. Es el dato más importante a guardar después de emitir.

## Qué es el CDC [#qué-es-el-cdc]

```
01800123451001001000000122026042710000000006
```

Cada documento electrónico tiene un único CDC, irrepetible. Lo genera Sifende al emitir y SIFEN lo valida. Es el código que aparece en el QR del KuDE y permite consultar el documento en e-kuatia.

## Estructura del CDC (44 dígitos) [#estructura-del-cdc-44-dígitos]

El CDC se construye concatenando 11 campos en este orden, según las secciones 10.1 y 10.2 del [Manual Técnico V150](https://www.dnit.gov.py/web/e-kuatia/documentacion-tecnica):

| Pos.  | Largo | Campo                      | Descripción                                                             |
| ----- | ----- | -------------------------- | ----------------------------------------------------------------------- |
| 1–2   | 2     | Tipo de documento          | `01` = FE, `04` = AFE, `05` = NCE, `06` = NDE, `07` = NRE               |
| 3–10  | 8     | RUC del emisor             | Sin DV, padded con ceros a izquierda — ej. `80012345`                   |
| 11    | 1     | DV del emisor              | Dígito verificador del RUC del emisor                                   |
| 12–14 | 3     | Establecimiento            | Número de sucursal (`001`–`999`)                                        |
| 15–17 | 3     | Punto de expedición        | Caja/terminal dentro del establecimiento                                |
| 18–24 | 7     | Número del documento       | Secuencial por ambiente, tipo de documento, establecimiento y punto     |
| 25    | 1     | Tipo de contribuyente      | `1` = persona física, `2` = persona jurídica                            |
| 26–33 | 8     | Fecha de emisión           | `AAAAMMDD` — ej. `20260427`                                             |
| 34    | 1     | Tipo de emisión            | `1` = normal. El `2` (contingencia) todavía no está habilitado en SIFEN |
| 35–43 | 9     | Código de seguridad        | Aleatorio, 9 dígitos, generado por Sifende                              |
| 44    | 1     | Dígito verificador del CDC | Calculado con módulo 11 sobre los 43 dígitos previos                    |

Total: 2 + 8 + 1 + 3 + 3 + 7 + 1 + 8 + 1 + 9 + 1 = 44 caracteres.

<Callout type="warn">
  El tipo de contribuyente del emisor (posición 25) es parte del CDC y no hay que confundirlo con `numeroTimbrado`, que no aparece en el CDC. El timbrado se referencia indirectamente a través de la combinación `establecimiento + puntoExpedicion + numeroDocumento`.
</Callout>

## Ejemplo desglosado [#ejemplo-desglosado]

Tomando el CDC `01800123451001001000000122026042710000000006`:

<DesgloseCodigo
  segmentos="[
{ valor: '01', nombre: 'Tipo de documento', detalle: 'Factura Electrónica' },
{ valor: '80012345', nombre: 'RUC del emisor', detalle: 'sin DV' },
{ valor: '1', nombre: 'DV del RUC emisor' },
{ valor: '001', nombre: 'Establecimiento' },
{ valor: '001', nombre: 'Punto de expedición' },
{ valor: '0000001', nombre: 'Número del documento' },
{ valor: '2', nombre: 'Tipo de contribuyente', detalle: 'persona jurídica' },
{ valor: '20260427', nombre: 'Fecha de emisión', detalle: '2026-04-27' },
{ valor: '1', nombre: 'Tipo de emisión', detalle: 'normal' },
{ valor: '000000000', nombre: 'Código de seguridad', detalle: '9 dígitos' },
{ valor: '6', nombre: 'DV del CDC', detalle: 'módulo 11' },
]"
/>

## Representación visual en el KuDE [#representación-visual-en-el-kude]

En la representación gráfica del documento, el CDC se muestra en grupos de 4 dígitos para que sea más fácil de leer:

```
0180 0123 4510 0100 1000 0001 2202 6042 7100 0000 0006
```

## Cómo se genera [#cómo-se-genera]

Sifende genera el CDC con los datos del emisor, del documento y su numeración. Lo recibís en la respuesta de emisión; no tenés que calcularlo ni enviarlo.

## Cómo usar el CDC [#cómo-usar-el-cdc]

El CDC es la clave primaria de tu documento ante SIFEN. Lo necesitás para:

* Consultar estado: `GET /api/v1/documento-electronico/status/:cdc`
* Descargar el KuDE: `GET /api/v1/documento-electronico/:cdc/kude`
* Cancelar el documento: `POST /api/v1/documento-electronico/:cdc/cancelar`
* Asociarlo en una NCE/NDE: el campo `documentoAsociado.cdc` referencia la FE original.

<Callout type="warn">
  Guardá el CDC en tu sistema apenas Sifende lo retorne. Es el único dato que te permite operar sobre el documento después. Sin CDC no podés consultar, cancelar ni descargar el KuDE.
</Callout>

## CDC e idempotencia [#cdc-e-idempotencia]

El CDC identifica al documento electrónico; no identifica la intención de emitirlo. La `Idempotency-Key` existe antes que el documento y es distinta del `id`, `deId`, CDC o ID de evento que la API devuelve después. Para recuperar una emisión, aplicá [Idempotencia y Reintentos Seguros](/docs/guias/idempotencia).

## Inmutabilidad [#inmutabilidad]

Una vez generado, el CDC no se puede modificar. Si corregís y volvés a emitir un documento rechazado, Sifende asigna siempre un número nuevo y un CDC nuevo. El número rechazado queda libre y se puede [inutilizar](/docs/guias/inutilizar-numeracion).

## Próximos pasos [#próximos-pasos]

* [Convenciones — CDC](/docs/referencia/convenciones): el formato exacto en la API.
* [Timbrado y Numeración](/docs/conceptos/timbrado-numeracion): qué partes del CDC dependen del timbrado.
* [Documentos Asociados](/docs/referencia/modelos/documento-asociado): cómo referenciar un CDC en NCE/NDE.
