# Conceptos fiscales — CO

> Glosario de términos de facturación electrónica.


## NUC

**Aliases:** `Núcleo Universal de Comprobantes`, `formato NUC`

Archivo XML o JSON que contiene la información necesaria para generar el documento electrónico del país. En Colombia la API lo transforma en un documento UBL 2.1 (Invoice, CreditNote o DebitNote) según el Anexo Técnico DIAN v1.9. En XML se valida contra el esquema XSD del NUC; en JSON no hay validación de esquema previa.

**Aparece en:** `certificacion`, `formato`

---

## DIAN

Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales. Publica el Anexo Técnico de Factura Electrónica de Venta (versión 1.9, Resolución 000165 del 01/NOV/2023) y realiza la validación previa de los documentos electrónicos. En el XML aparece como proveedor de autorización con NIT 800197268.

**Aparece en:** `autoridad`

---

## CUFE

Código Único de Factura Electrónica. Se transporta en cbc:UUID con schemeName CUFE-SHA384 y schemeID = ambiente (1 producción, 2 pruebas). Lo calcula Digifact al certificar (el cliente no lo envía) y se devuelve en el campo authNumber de la respuesta. En notas crédito/débito se informa el CUFE de la factura referenciada (clave UUIDRef).

**Aparece en:** `cude`, `identificador`

---

## CUDE

Código Único de Documento Electrónico. Identifica notas crédito (91) y notas débito (92); se transporta en cbc:UUID con schemeName CUDE-SHA384. Lo calcula Digifact al certificar y se devuelve en authNumber.

**Aparece en:** `cufe`, `nota-credito`, `nota-debito`

---

## NIT

Número de Identificación Tributaria. En la API se envía sin dígito de verificación, sin puntos ni guiones: en el Username del token (CO.<NIT>.<usuario>), en el parámetro TAXID y en Seller.TaxID. El tipo de identificación NIT es el código 31; un adquirente con cualquier otro tipo se emite como consumidor final.

**Aparece en:** `identificacion`

---

## Consumidor final

Para el adquirente consumidor final el Anexo indica: AdditionalAccountID 2, identificación 222222222222 con tipo de documento 13, responsabilidad R-99-PN y tributo ZZ "No aplica". La API aplica ese tratamiento (salvo el número, que se toma de Buyer.TaxID) a todo adquirente cuyo TaxIDType no sea 31 (NIT).

**Aparece en:** `adquirente`

---

## Habilitación (ambiente de pruebas DIAN)

**Aliases:** `ambiente de pruebas`, `ProfileExecutionID 2`

Los documentos enviados al ambiente de pruebas no producen ningún efecto (§13.2). El ambiente se indica con cbc:ProfileExecutionID / cbc:UUID@schemeID = 2 (Header.AdditionalIssueType). Digifact Colombia transmite a la DIAN en habilitación (vpfe-hab.dian.gov.co) y no tiene ambiente de producción.

**Aparece en:** `ambiente`

---

## Resolución y rango de numeración

**Aliases:** `InvoiceControl`, `prefijo`, `consecutivo`

Cada factura declara en sts:InvoiceControl la resolución (InvoiceAuthorization), su vigencia y el rango autorizado (Prefix, From, To). La API toma esos datos de la configuración del emisor en Digifact (no del NUC). El backend rechaza la factura si no hay un rango activo para el NIT y prefijo, si el consecutivo está fuera del rango, si la fecha está fuera de la vigencia o si la resolución no coincide. Las notas crédito y débito no se validan contra el rango.

**Aparece en:** `numeracion`

---

## UBL 2.1

Los documentos se generan en UBL 2.1 con el ProfileID literal por tipo: "DIAN 2.1: Factura Electrónica de Venta", "DIAN 2.1: Nota Crédito de Factura Electrónica de Venta" y "DIAN 2.1: Nota Débito de Factura Electrónica de Venta".

**Aparece en:** `formato`

---

## Firma XAdES-EPES

Digifact firma el documento con XAdES-EPES (rsa-sha256, política de firma DIAN) usando el certificado del emisor, después de calcular el CUFE/CUDE. El XML firmado se devuelve en base64 en responseData1.

**Aparece en:** `firma`

---

## Nota Crédito

**Aliases:** `NC`, `91`

Se emite con Header.DocType NC o 91 en el mismo endpoint de certificación. Debe referenciar la factura afectada (IDFacturaRef, UUIDRef, FechaRef) e informar el concepto de corrección (ResponseCode, Description) en AdditionalDocumentInfo. El backend rechaza notas sobre facturas ya aceptadas, con más de 24 meses o sin saldo suficiente. La anulación de facturas en Colombia se hace con nota crédito.

**Aparece en:** `nota-debito`, `cude`

---

## Nota Débito

**Aliases:** `ND`, `92`

Se emite con Header.DocType ND o 92. Mismos datos de referencia que la nota crédito, más ReferenceID opcional (sección de la factura corregida). En UBL 2.1 la nota débito no lleva type code y sus totales van en cac:RequestedMonetaryTotal.

**Aparece en:** `nota-credito`, `cude`

---

## DocumentGUID

Identificador que Digifact asigna al certificar. Es el valor que espera el parámetro CUFE de GET DOCUMENT. Hoy no se devuelve en la respuesta de certificación.

**Aparece en:** `get-document`

---
