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.

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).

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.

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-debitocude

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-creditocude

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