CDC (Código de Control)

Qué es el CDC, cómo se estructura y por qué es el identificador más importante de tus documentos electrónicos.

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

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)

El CDC se arma concatenando 11 campos en este orden:

Pos.	Largo	Campo	Descripción
1–2	2	Tipo de documento (`iTiDE`)	`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	Auto-incremental por establecimiento+punto
25	1	Tipo de contribuyente (`iTipCont`)	`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, `2` = contingencia
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.

El campo iTipCont (posición 25, tipo de contribuyente del emisor) 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.

Ejemplo desglosado

Tomando el CDC 01800123451001001000000122026042710000000006:

01 80012345 1 001 001 0000001 2 20260427 1 000000000 6
│  │        │ │   │   │       │ │        │ │         │
│  │        │ │   │   │       │ │        │ │         └─ DV módulo 11 del CDC
│  │        │ │   │   │       │ │        │ └─ Código de seguridad (9 dígitos)
│  │        │ │   │   │       │ │        └─ Tipo emisión: 1 = normal
│  │        │ │   │   │       │ └─ Fecha 2026-04-27
│  │        │ │   │   │       └─ Tipo contribuyente: 2 = persona jurídica
│  │        │ │   │   └─ Documento N° 0000001
│  │        │ │   └─ Punto expedición 001
│  │        │ └─ Establecimiento 001
│  │        └─ DV del RUC emisor (1)
│  └─ RUC del emisor (sin DV) — 80012345
└─ Tipo: 01 = Factura Electrónica

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

Sifende genera el CDC al recibir el request de emisión, en este orden:

Determina el iTiDE según el tipoDocumento enviado.

Recupera RUC y DV del emisor desde la configuración del contribuyente.

Asigna el siguiente número disponible del timbrado para el establecimiento+punto solicitados.

Determina el iTipCont según el tipo de contribuyente del emisor (persona física o jurídica).

Genera un código de seguridad aleatorio de 9 dígitos.

Calcula el dígito verificador con módulo 11 sobre los 43 dígitos previos.

Concatena todo y lo asigna al documento como id y atributo de la firma XML.

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.
Consulta pública en e-kuatia: cualquier persona con el CDC puede verificar el documento en https://ekuatia.set.gov.py/consultas/.

Guardá el CDC en tu base de datos 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.

Inmutabilidad

Una vez generado, el CDC no se puede modificar. Si SIFEN rechaza el documento y querés re-emitirlo:

Si los cambios no tocan ninguno de los 11 campos del CDC (RUC, número, fecha, etc.), SIFEN permite reutilizar el mismo CDC.
Si los cambios afectan algún campo del CDC (por ejemplo, cambia el número o la fecha), tenés que emitir un documento nuevo con CDC nuevo.

En la práctica, Sifende siempre genera un CDC nuevo ante un POST nuevo. Los reintentos manuales del mismo payload terminan creando documentos diferentes con CDC diferentes.

Próximos pasos

Convenciones — CDC: el formato exacto en la API.
Timbrado y Numeración: qué partes del CDC dependen del timbrado.
Documentos Asociados: cómo referenciar un CDC en NCE/NDE.

CDC (Código de Control)

On this page