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
01800123451001001000000122026042710000000006Cada 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 | 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.
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.
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ónicaRepresentació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 0006Có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
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.cdcreferencia 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 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.
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.
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.
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.