Conceptos fiscales 📖
Glosario de términos del régimen de facturación electrónica de Colombia. Cada concepto está referenciado desde la documentación del NUC y de la API.
NUC
Aliases: Núcleo Universal de Comprobantes · formato NUCArchivo 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.
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.
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).
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.
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.
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).
Habilitación (ambiente de pruebas DIAN)
Aliases: ambiente de pruebas · ProfileExecutionID 2Los 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.
Resolución y rango de numeración
Aliases: InvoiceControl · prefijo · consecutivoCada 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.
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".
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.
Nota Crédito
Aliases: NC · 91Se 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.
Nota Débito
Aliases: ND · 92Se 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.
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.