API Reference — Colombia 🇨🇴
API REST para certificar, anular y consultar documentos electrónicos ante la Dirección de Impuestos y Aduanas Nacionales (DIAN).
🧪 Test
https://testnucco.digifact.com/api🚀 Producción
https://nucco.digifact.com/apiTodas las operaciones requieren un token JWT obtenido en GET TOKEN. El token expira automáticamente — al recibir un error 401, solicitar un nuevo token.
El primer paso es la obtención del TOKEN, que se utilizará como forma de autenticación para las demás peticiones. En el Body se envían, en formato JSON, los atributos Username y Password de las credenciales. Username es la concatenación separada por punto (.): CO + "." + <NIT del emisor sin dígito de verificación> + "." + <Nombre de usuario>.
https://testnucco.digifact.com/api/login/get_tokenNo disponible — Digifact Colombia aún no tiene ambiente de producciónHeaders
| Nombre | Req. | Descripción |
|---|---|---|
| Content-Type | Req | El body debe enviarse como JSON. |
Body
| Nombre | Tipo | Req. | Descripción | Ejemplo |
|---|---|---|---|---|
| Username | string | Req | CO + "." + <NIT> + "." + <usuario>. El prefijo de país debe ser CO. | CO.902052428.testuser |
| Password | string | Req | Contraseña de las credenciales de pruebas. |
Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| Token | string | JWT generado. Vigencia de 30 días. |
| expira_en | string | Fecha y hora de expiración del token. |
| otorgado_a | string | Username al que se otorgó el token. |
El token debe enviarse en el header Authorization de las demás peticiones, SIN el prefijo "Bearer".
El token vence a los 30 días; vencido, la API responde 401 Unauthorized y hay que generar uno nuevo.
Errores: HTTP 401 {"response": "Credenciales con formato incorrecto (Country.TaxID.Username)"} si el Username no tiene tres partes; HTTP 401 {"response": "Credenciales incorrectas"} si la validación falla (incluye un prefijo de país distinto de CO); HTTP 400 sin cuerpo si falta Username o Password.
Ejemplo de Request
curl -X POST "https://testnucco.digifact.com/api/login/get_token" \
-H "Content-Type: application/json" \
-d '{
"Username": "CO.902052428.testuser",
"Password": "<password de las credenciales>"
}'Ejemplo de Response
{
"Token": "eyJhbGciOiJIUzI1NiIs…",
"expira_en": "11/06/2026 14:29:37",
"otorgado_a": "CO.902052428.testuser"
}Transforma un NUC en formato XML en el documento electrónico UBL 2.1 de la DIAN (Factura de Venta, Nota Crédito o Nota Débito según Header/DocType) y lo certifica: calcula el CUFE/CUDE, lo firma con XAdES-EPES y lo almacena; luego se transmite a la DIAN (habilitación) de forma asíncrona. Antes de transformarlo, el NUC se valida contra el esquema XSD del NUC.
https://testnucco.digifact.com/api/transform/nucNo disponible — Digifact Colombia aún no tiene ambiente de producciónHeaders
| Nombre | Req. | Descripción |
|---|---|---|
| Authorization | Req | Token vigente obtenido en Obtención del TOKEN, SIN el prefijo "Bearer". |
| Content-Type | Req | application/xml |
Query Params
| Nombre | Req. | Descripción | Ejemplo |
|---|---|---|---|
| TAXID | Req | NIT del emisor sin dígito de verificación, sin puntos ni guiones. Debe ser el mismo NIT del token (Username CO.<NIT>.<usuario>) y el mismo Seller.TaxID del NUC. | 902052428 |
Body
| Nombre | Req. | Descripción |
|---|---|---|
| BODY (raw) | Req | XML con el contenido del NUC (elemento raíz <Root>). Ver Formato del NUC. |
Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| code | number | Código de resultado del backend de certificación. 1 = documento certificado (firmado y almacenado). 3010 = falló una validación (ver message/description). 3052 = documento duplicado. 3000 = error no controlado. -1 = sin respuesta del backend. |
| message | string | Nombre del resultado cuando hay error (ej. XML_INVALID, DOCUMENT_ALREADY_EXISTS). Vacío si fue exitoso. |
| description | string | Descripción del resultado cuando hay error. Vacío si fue exitoso. |
| responseData1 | string | XML UBL 2.1 FIRMADO (XAdES-EPES) codificado en base64, con el CUFE/CUDE ya calculado. |
| responseData2 | string | Vacío: este endpoint no solicita la representación HTML. |
| responseData3 | string | Vacío: este endpoint no solicita la representación PDF. Para obtener HTML/PDF usar GET DOCUMENT. |
| responseData4 | string | Vacío. |
| authNumber | string | CUFE (factura) o CUDE (nota crédito/débito) del documento, algoritmo SHA-384 (96 caracteres hexadecimales). |
| url | string | Vacío. |
| infoDetails | array | Arreglo de eventos {evento, dCodRes, dMsgRes}. En Colombia llega vacío. |
| suggestedFileName / suggestedFileName2 | string | Vacíos. |
| batch | string | Prefijo de numeración del documento (sts:Prefix). |
| serial | string | Consecutivo del documento (dígitos finales de cbc:ID). |
| issuedTimeStamp | string | Copia de Header.IssuedDateTime enviado en el NUC. |
| taxID / name | string | Copia de Seller.TaxID y Seller.Name del NUC. |
| branchCode / branchName | string | Copia de Seller.BranchInfo.Code y Seller.BranchInfo.Name del NUC. |
| receiverTaxID / receiverName | string | Copia de Buyer.TaxID y Buyer.Name del NUC. |
| discounts / taxes | string | Vacíos. |
| subTotal | string | Copia de Totals.TotalItems del NUC. |
| totalAmount | string | Copia de Totals.GrandTotal.InvoiceTotal del NUC. |
| enrolledTimeStamp | string | Fecha y hora de certificación devuelta por el backend (formato ISO 8601). |
| backprocessor | string | Servidor que procesó la certificación. |
| additionalInfo | object | Normalmente null. Si el backend devuelve una sugerencia (Hint) llega como { "hint": "..." }. |
Ejemplo de URL: https://testnucco.digifact.com/api/transform/nuc?TAXID=902052428
Validación previa: antes de firmar, el documento se valida contra el esquema UBL 2.1 y contra las reglas de validación de la DIAN (Anexo Técnico v1.9). Si alguna falla, la API responde code 3010 y cada regla incumplida llega en infoDetails como { "evento": "SCHEMATRON_DIAN" | "XSD_UBL21", "dCodRes": "<regla DIAN, p.ej. FAM19>", "dMsgRes": "<motivo>" }. El documento no se registra, así que puede reenviarse corregido con el mismo número.
El XML se valida contra el esquema XSD del NUC: elementos que el esquema marca obligatorios (por ejemplo AdditionalIssueDocInfo, TaxIDAdditionalInfo, AdditionalBranchInfo, Buyer/AdditionlInfo, Payments, AdditionalDocumentInfo) deben venir aunque el documento DIAN no los use. Un error de esquema responde HTTP 400 con el mensaje de validación. El XML distingue mayúsculas y minúsculas.
Ambiente de PRUEBAS únicamente: los documentos se transmiten a la DIAN en habilitación (sin efectos legales). Digifact Colombia no tiene ambiente de producción.
code = 1 significa que el documento pasó las validaciones de Digifact, fue firmado y almacenado; la transmisión a la DIAN ocurre después, de forma asíncrona. Para conocer el veredicto de la DIAN (ACEPTADO / RECHAZADO con sus reglas) consultar GET DOCUMENT con el authNumber, aprox. 1 minuto después.
Ante un error de negocio la API responde HTTP 200 con code distinto de 1 (ej. 3010 XML_INVALID). Solo se informa el primer error encontrado. Los errores del armado del documento (DocType, TaxIDType o tributo no soportado, emisor no configurado, nota sin factura referenciada) responden HTTP 400 con el motivo en texto plano.
La fecha de emisión (Header.IssuedDateTime) debe ser la fecha de hoy en hora de Colombia y no más de 1 hora en el futuro. Enviarla SIN desfase horario (ej. 2026-09-04T10:00:00).
Header.Reference.Code (número del documento) no puede repetirse: un número ya certificado para el mismo NIT y prefijo responde 3052 DOCUMENT_ALREADY_EXISTS, incluso si la DIAN luego rechazó ese documento. En facturas, el prefijo y el consecutivo deben estar dentro del rango de numeración autorizado al emisor.
El emisor (NIT) debe estar dado de alta por Digifact con su resolución y rango de numeración DIAN; si no lo está la API responde HTTP 400 "El facturador NIT=<nit> no esta configurado en DIAN:FACTURADORES".
El ambiente de pruebas se apaga de lunes a viernes de 20:00 a 06:00 (hora de Colombia) y los fines de semana.
El tipo de documento (factura, nota crédito o nota débito) se toma de Header.DocType; el mismo endpoint certifica los tres.
La API NO valida en el momento la aritmética de los totales: un documento con Totals descuadrados se certifica igual (code 1) y el rechazo, si ocurre, llega después desde la DIAN de forma asíncrona. Verificar los totales antes de enviar.
Ejemplo de Request
curl -X POST "https://testnucco.digifact.com/api/transform/nuc?TAXID=902052428" \
-H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
-H "Content-Type: application/json"Ejemplo de Response
// Exitosa (code 1)
{
"code": 1,
"message": "",
"description": "",
"responseData1": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0i…",
"responseData2": "",
"responseData3": "",
"responseData4": "",
"authNumber": "ddae210a0ba8c9074e3aeb09e229f44c96f3003621a0f66a3a9d3e6b5f012f932520f64a845dc5049dd80758158c96eb",
"url": "",
"infoDetails": [],
"suggestedFileName": "",
"suggestedFileName2": "",
"batch": "SETP",
"serial": "993383374",
"issuedTimeStamp": "2026-10-07T09:29:34",
"taxID": "902052428",
"name": "DIGIFACT COLOMBIA SAS",
"branchCode": "1",
"branchName": "",
"receiverTaxID": "222222222222",
"receiverName": "CLIENTE PRUEBA",
"discounts": "",
"taxes": "",
"subTotal": "100000.00",
"totalAmount": "119000.00",
"enrolledTimeStamp": "2026-10-07T14:29:49.4440336+00:00",
"backprocessor": "ip-10-30-10-58",
"additionalInfo": null
}
// Error 3010 XML_INVALID (aquí: número SETP999999999 fuera del rango autorizado; el mensaje siempre dice "esquema")
{
"code": 3010,
"message": "XML_INVALID",
"description": "Falló la validación de XML contra su esquema.",
"responseData1": "",
"responseData2": "",
"responseData3": "",
"responseData4": "",
"authNumber": "",
"url": "",
"infoDetails": [],
"suggestedFileName": "",
"suggestedFileName2": "",
"batch": "",
"serial": "",
"issuedTimeStamp": "2026-10-07T09:30:07",
"taxID": "902052428",
"name": "DIGIFACT COLOMBIA SAS",
"branchCode": "1",
"branchName": "",
"receiverTaxID": "222222222222",
"receiverName": "CLIENTE PRUEBA",
"discounts": "",
"taxes": "",
"subTotal": "100000.00",
"totalAmount": "119000.00",
"enrolledTimeStamp": "2026-10-07T14:30:21.4740140+00:00",
"backprocessor": "ip-10-30-10-58",
"additionalInfo": {
"hint": "Favor de validar su XML contra los esquemas que ostenta."
}
}
// Error 3052 DOCUMENT_ALREADY_EXISTS (número ya usado)
{
"code": 3052,
"message": "DOCUMENT_ALREADY_EXISTS",
"description": "El documento identificado con país de emisor, su NIT, serie y folio ya existe en la base de datos.",
"responseData1": "",
"responseData2": "",
"responseData3": "",
"responseData4": "",
"authNumber": "",
"url": "",
"infoDetails": [],
"suggestedFileName": "",
"suggestedFileName2": "",
"batch": "",
"serial": "",
"issuedTimeStamp": "2026-10-07T09:29:34",
"taxID": "902052428",
"name": "DIGIFACT COLOMBIA SAS",
"branchCode": "1",
"branchName": "",
"receiverTaxID": "222222222222",
"receiverName": "CLIENTE PRUEBA",
"discounts": "",
"taxes": "",
"subTotal": "100000.00",
"totalAmount": "119000.00",
"enrolledTimeStamp": "2026-10-07T14:30:22.4015972+00:00",
"backprocessor": "ip-10-30-10-58",
"additionalInfo": {
"hint": "No se admiten duplicados."
}
}
// Error 3010 por validación previa (regla DIAN FAM19: municipio inexistente en CityCode)
{
"code": 3010,
"message": "XML_INVALID",
"description": "Falló la validación de XML contra su esquema.",
"responseData1": "",
"responseData2": "",
"responseData3": "",
"responseData4": "",
"authNumber": "",
"url": "",
"infoDetails": [
{
"evento": "SCHEMATRON_DIAN",
"dCodRes": "FAM19",
"dMsgRes": "Municipio informado '99999' no se encuentra en el catalogo de Municipios"
}
],
"suggestedFileName": "",
"suggestedFileName2": "",
"batch": "",
"serial": "",
"issuedTimeStamp": "2026-10-09T01:30:49",
"taxID": "902052428",
"name": "DIGIFACT COLOMBIA SAS",
"branchCode": "1",
"branchName": "",
"receiverTaxID": "222222222222",
"receiverName": "CLIENTE PRUEBA",
"discounts": "",
"taxes": "",
"subTotal": "100000.00",
"totalAmount": "119000.00",
"enrolledTimeStamp": "2026-10-09T06:30:35.9298027+00:00",
"backprocessor": "ip-10-30-11-42",
"additionalInfo": {
"hint": "Favor de validar su XML contra los esquemas que ostenta."
}
}Transforma un NUC en formato JSON en el documento electrónico UBL 2.1 de la DIAN (Factura de Venta, Nota Crédito o Nota Débito según Header.DocType) y lo certifica: calcula el CUFE/CUDE, lo firma con XAdES-EPES y lo almacena; luego se transmite a la DIAN (habilitación) de forma asíncrona. El funcionamiento va de la mano con el Anexo Técnico de Factura Electrónica de Venta v1.9 de la DIAN (Resolución 000165 de 2023).
https://testnucco.digifact.com/api/transform/nuc_jsonNo disponible — Digifact Colombia aún no tiene ambiente de producciónHeaders
| Nombre | Req. | Descripción |
|---|---|---|
| Authorization | Req | Token vigente obtenido en Obtención del TOKEN, SIN el prefijo "Bearer". |
| Content-Type | Req | application/json |
Query Params
| Nombre | Req. | Descripción | Ejemplo |
|---|---|---|---|
| TAXID | Req | NIT del emisor sin dígito de verificación, sin puntos ni guiones. Debe ser el mismo NIT del token (Username CO.<NIT>.<usuario>) y el mismo Seller.TaxID del NUC. | 902052428 |
Body
| Nombre | Req. | Descripción |
|---|---|---|
| BODY (raw) | Req | JSON con el contenido del NUC. Ver Formato del NUC. |
Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| code | number | Código de resultado del backend de certificación. 1 = documento certificado (firmado y almacenado). 3010 = falló una validación (ver message/description). 3052 = documento duplicado. 3000 = error no controlado. -1 = sin respuesta del backend. |
| message | string | Nombre del resultado cuando hay error (ej. XML_INVALID, DOCUMENT_ALREADY_EXISTS). Vacío si fue exitoso. |
| description | string | Descripción del resultado cuando hay error. Vacío si fue exitoso. |
| responseData1 | string | XML UBL 2.1 FIRMADO (XAdES-EPES) codificado en base64, con el CUFE/CUDE ya calculado. |
| responseData2 | string | Vacío: este endpoint no solicita la representación HTML. |
| responseData3 | string | Vacío: este endpoint no solicita la representación PDF. Para obtener HTML/PDF usar GET DOCUMENT. |
| responseData4 | string | Vacío. |
| authNumber | string | CUFE (factura) o CUDE (nota crédito/débito) del documento, algoritmo SHA-384 (96 caracteres hexadecimales). |
| url | string | Vacío. |
| infoDetails | array | Arreglo de eventos {evento, dCodRes, dMsgRes}. En Colombia llega vacío. |
| suggestedFileName / suggestedFileName2 | string | Vacíos. |
| batch | string | Prefijo de numeración del documento (sts:Prefix). |
| serial | string | Consecutivo del documento (dígitos finales de cbc:ID). |
| issuedTimeStamp | string | Copia de Header.IssuedDateTime enviado en el NUC. |
| taxID / name | string | Copia de Seller.TaxID y Seller.Name del NUC. |
| branchCode / branchName | string | Copia de Seller.BranchInfo.Code y Seller.BranchInfo.Name del NUC. |
| receiverTaxID / receiverName | string | Copia de Buyer.TaxID y Buyer.Name del NUC. |
| discounts / taxes | string | Vacíos. |
| subTotal | string | Copia de Totals.TotalItems del NUC. |
| totalAmount | string | Copia de Totals.GrandTotal.InvoiceTotal del NUC. |
| enrolledTimeStamp | string | Fecha y hora de certificación devuelta por el backend (formato ISO 8601). |
| backprocessor | string | Servidor que procesó la certificación. |
| additionalInfo | object | Normalmente null. Si el backend devuelve una sugerencia (Hint) llega como { "hint": "..." }. |
Ejemplo de URL: https://testnucco.digifact.com/api/transform/nuc_json?TAXID=902052428
Validación previa: antes de firmar, el documento se valida contra el esquema UBL 2.1 y contra las reglas de validación de la DIAN (Anexo Técnico v1.9). Si alguna falla, la API responde code 3010 y cada regla incumplida llega en infoDetails como { "evento": "SCHEMATRON_DIAN" | "XSD_UBL21", "dCodRes": "<regla DIAN, p.ej. FAM19>", "dMsgRes": "<motivo>" }. El documento no se registra, así que puede reenviarse corregido con el mismo número.
El body JSON NO se valida contra el esquema del NUC antes de transformarse: un campo mal nombrado se ignora en silencio (los nombres de propiedad no distinguen mayúsculas). Usar exactamente los nombres del Formato del NUC, incluidos los históricos AdditionlInfo y AditionalData.
Ambiente de PRUEBAS únicamente: los documentos se transmiten a la DIAN en habilitación (sin efectos legales). Digifact Colombia no tiene ambiente de producción.
code = 1 significa que el documento pasó las validaciones de Digifact, fue firmado y almacenado; la transmisión a la DIAN ocurre después, de forma asíncrona. Para conocer el veredicto de la DIAN (ACEPTADO / RECHAZADO con sus reglas) consultar GET DOCUMENT con el authNumber, aprox. 1 minuto después.
Ante un error de negocio la API responde HTTP 200 con code distinto de 1 (ej. 3010 XML_INVALID). Solo se informa el primer error encontrado. Los errores del armado del documento (DocType, TaxIDType o tributo no soportado, emisor no configurado, nota sin factura referenciada) responden HTTP 400 con el motivo en texto plano.
La fecha de emisión (Header.IssuedDateTime) debe ser la fecha de hoy en hora de Colombia y no más de 1 hora en el futuro. Enviarla SIN desfase horario (ej. 2026-09-04T10:00:00).
Header.Reference.Code (número del documento) no puede repetirse: un número ya certificado para el mismo NIT y prefijo responde 3052 DOCUMENT_ALREADY_EXISTS, incluso si la DIAN luego rechazó ese documento. En facturas, el prefijo y el consecutivo deben estar dentro del rango de numeración autorizado al emisor.
El emisor (NIT) debe estar dado de alta por Digifact con su resolución y rango de numeración DIAN; si no lo está la API responde HTTP 400 "El facturador NIT=<nit> no esta configurado en DIAN:FACTURADORES".
El ambiente de pruebas se apaga de lunes a viernes de 20:00 a 06:00 (hora de Colombia) y los fines de semana.
El tipo de documento (factura, nota crédito o nota débito) se toma de Header.DocType; el mismo endpoint certifica los tres.
La API NO valida en el momento la aritmética de los totales: un documento con Totals descuadrados se certifica igual (code 1) y el rechazo, si ocurre, llega después desde la DIAN de forma asíncrona. Verificar los totales antes de enviar.
Ejemplo de Request
curl -X POST "https://testnucco.digifact.com/api/transform/nuc_json?TAXID=902052428" \
-H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
-H "Content-Type: application/json" \
-d '{
"Version": "1.0",
"CountryCode": "CO",
"Header": {
"DocType": "FE",
"IssuedDateTime": "2026-09-04T10:00:00",
"AdditionalIssueType": "2",
"Currency": "COP",
"Reference": {
"Code": "SETP990000001",
"Date": "2026-09-04T10:00:00"
},
"AdditionalIssueDocInfo": [
{
"Name": "ref",
"Value": "SETP990000001"
}
]
},
"Seller": {
"TaxID": "902052428",
"TaxIDType": "NIT",
"TaxIDAdditionalInfo": [
{
"Name": "check",
"Value": "3"
}
],
"Name": "DIGIFACT COLOMBIA SAS",
"BranchInfo": {
"Code": "1",
"AddressInfo": {
"Address": "CRA 1 # 1-1",
"City": "BOGOTA D.C.",
"District": "Bogota",
"State": "Bogota",
"Country": "CO"
},
"AdditionalBranchInfo": [
{
"Name": "dept",
"Value": "11"
}
]
}
},
"Buyer": {
"TaxID": "222222222222",
"TaxIDType": "CC",
"TaxIDAdditionalInfo": [
{
"Name": "type",
"Value": "natural"
}
],
"Name": "CLIENTE PRUEBA",
"Contact": {
"EmailList": {
"Email": [
"[email protected]"
]
}
},
"AdditionlInfo": [
{
"Name": "email",
"Value": "[email protected]"
}
]
},
"Items": [
{
"Number": "1",
"Codes": [
{
"Name": "EAN13",
"Data": "999",
"Value": "TEST-001"
}
],
"Description": "Servicio de prueba certificacion interna",
"Qty": "1.00",
"UnitOfMeasure": "94",
"Price": "100000.00",
"Taxes": {
"Tax": [
{
"Code": "01",
"Description": "IVA",
"TaxableAmount": "100000.00",
"Rate": "19.00",
"Amount": "19000.00"
}
]
},
"Totals": {
"TotalBTaxes": "100000.00",
"TotalWTaxes": "119000.00",
"TotalItem": "119000.00"
}
}
],
"Totals": {
"QtyItems": 1,
"TotalItems": "100000.00",
"TotalTaxableAmount": "100000.00",
"TotalTaxes": {
"TotalTax": [
{
"Code": "01",
"Description": "IVA",
"TaxableAmount": "100000.00",
"Rate": "19.00",
"Amount": "19000.00"
}
]
},
"GrandTotal": {
"TotalBTaxes": "100000.00",
"TotalWTaxes": "119000.00",
"InvoiceTotal": "119000.00"
}
},
"Payments": [
{
"Type": "Contado",
"Code": "10",
"Amount": "119000.00"
}
],
"AdditionalDocumentInfo": {
"AdditionalInfo": [
{
"Description": "Ejemplo de prueba"
}
]
}
}'Ejemplo de Response
// Exitosa (code 1)
{
"code": 1,
"message": "",
"description": "",
"responseData1": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0i…",
"responseData2": "",
"responseData3": "",
"responseData4": "",
"authNumber": "32b484af914ce1270dbd45a398364514c12740f0edb8bcab2e9efc94afd74d6ab642b6f35c7efeb4ce3c264a5a9250c4",
"url": "",
"infoDetails": [],
"suggestedFileName": "",
"suggestedFileName2": "",
"batch": "SETP",
"serial": "993383406",
"issuedTimeStamp": "2026-10-07T09:29:49",
"taxID": "902052428",
"name": "DIGIFACT COLOMBIA SAS",
"branchCode": "1",
"branchName": "",
"receiverTaxID": "222222222222",
"receiverName": "CLIENTE PRUEBA",
"discounts": "",
"taxes": "",
"subTotal": "100000.00",
"totalAmount": "119000.00",
"enrolledTimeStamp": "2026-10-07T14:30:06.0061142+00:00",
"backprocessor": "ip-10-30-10-58",
"additionalInfo": null
}Operación de tipo GET que permite obtener un documento certificado en formato XML firmado, HTML y/o PDF (codificados en base64) y su estado ante la DIAN (aceptado, rechazado o pendiente, con las reglas informadas).
https://testnucco.digifact.com/api/GetDocumentNo disponible — Digifact Colombia aún no tiene ambiente de producciónHeaders
| Nombre | Req. | Descripción |
|---|---|---|
| Authorization | Req | Token vigente, SIN el prefijo "Bearer". |
Query Params
| Nombre | Req. | Descripción | Ejemplo |
|---|---|---|---|
| TAXID | Req | NIT del emisor (sin dígito de verificación). Debe coincidir con el NIT del token. Alias heredado aceptado: RUC. | 902052428 |
| USERNAME | Req | Nombre de usuario. | testuser |
| AUTHNUMBER | Req | CUFE (factura) o CUDE (nota crédito/débito) del documento: el campo authNumber que devuelve la certificación. También acepta el DocumentGUID. Alias heredado aceptado: CUFE. Solo devuelve documentos del NIT del token; un CUFE de otro emisor responde "no encontrado". | ddae210a0ba8c9074e3aeb09e229f44c96f3003621a0f66a3a9d3e6b5f012f932520f64a845dc5049dd80758158c96eb |
| FORMAT | Req | Formatos a devolver: XML, HTML y/o PDF, separados por pipe (|). | XML|HTML|PDF |
Respuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| REQUEST_DATA | array | Una posición con { "Respuesta", "Codigo", "Procesador", "Mensaje", "Descripcion", "Fecha" }. Si no se encontró el documento: Mensaje = "Error" y Descripcion con el motivo. |
| RESPONSE | array | Una posición con { "ResponseData1", "ResponseData2", "ResponseData3" } (XML firmado, HTML y PDF en base64; vacío el formato no solicitado) y el estado ante la DIAN: EstadoDIAN, CodigoDIAN, DescripcionDIAN, MensajeDIAN, ReglasDIAN. Si hubo error es un arreglo vacío. |
| RESPONSE[].EstadoDIAN | string | ACEPTADO | RECHAZADO | PENDIENTE. |
| RESPONSE[].CodigoDIAN | string | StatusCode de la DIAN: 00 aceptado, 99 rechazado; vacío si está pendiente. |
| RESPONSE[].DescripcionDIAN | string | StatusDescription de la DIAN. |
| RESPONSE[].MensajeDIAN | string | StatusMessage de la DIAN (p.ej. "La Factura electrónica SETP… ha sido autorizada"). |
| RESPONSE[].ReglasDIAN | array | Reglas informadas por la DIAN: [{ "Regla": "FAJ28", "Tipo": "Rechazo" | "Notificación", "Mensaje": "..." }]. Las de Tipo Rechazo son las que impiden la validación; las Notificaciones no bloquean. |
Ejemplo de URL: https://testnucco.digifact.com/api/GetDocument?TAXID=902052428&USERNAME=testuser&AUTHNUMBER=<authNumber de la certificación>&FORMAT=XML|PDF
El veredicto de la DIAN es asíncrono (llega aprox. 1 minuto después de certificar): si se consulta antes, EstadoDIAN = PENDIENTE. ACEPTADO = la DIAN lo validó (código 00); RECHAZADO = la DIAN lo rechazó (código 99) y ReglasDIAN dice por qué. Un documento RECHAZADO no aparece en la consulta pública de la DIAN por CUFE.
El HTML y el PDF se generan al momento de la consulta; si su generación falla llegan vacíos sin error. La representación gráfica de notas crédito/débito aún no muestra correctamente sus líneas.
Si falta alguno de los parámetros la API responde HTTP 400 "Faltan parametros requeridos en la URL (TAXID, USERNAME, AUTHNUMBER, FORMAT)"; con un token inválido o de otro NIT, 401.
Ejemplo de Request
curl -X GET "https://testnucco.digifact.com/api/GetDocument?TAXID=902052428&USERNAME=testuser&AUTHNUMBER=ddae210a0ba8c9074e3aeb09e229f44c96f3003621a0f66a3a9d3e6b5f012f932520f64a845dc5049dd80758158c96eb&FORMAT=XML%7CHTML%7CPDF" \
-H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."Ejemplo de Response
// Documento RECHAZADO por la DIAN (falta CityCode en la dirección del emisor)
{
"REQUEST_DATA": [
{
"Respuesta": 1,
"Codigo": "1",
"Procesador": "ip-10-30-10-xx",
"Mensaje": "",
"Descripcion": "",
"Fecha": "2026-10-09T06:26:14-05:00"
}
],
"RESPONSE": [
{
"ResponseData1": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0i…",
"ResponseData2": "",
"ResponseData3": "",
"EstadoDIAN": "RECHAZADO",
"CodigoDIAN": "99",
"DescripcionDIAN": "Validación contiene errores en campos mandatorios.",
"MensajeDIAN": "Documento con errores en campos mandatorios.",
"ReglasDIAN": [
{
"Regla": "FAJ29",
"Tipo": "Rechazo",
"Mensaje": "Este código no corresponde a un valor válido de la lista"
},
{
"Regla": "FAJ09",
"Tipo": "Rechazo",
"Mensaje": "Este código no corresponde a un valor válido de la lista"
},
{
"Regla": "FAJ28",
"Tipo": "Rechazo",
"Mensaje": "No fue informado el conjunto formado por los elementos : ID, CityName, CountrySubentity, CountrySubentityCode, PostalZone, AddressLine, Line, Country, IdentificationCode"
},
{
"Regla": "FAJ12",
"Tipo": "Rechazo",
"Mensaje": "Este código no corresponde a un valor válido de la lista"
},
{
"Regla": "FAJ32",
"Tipo": "Rechazo",
"Mensaje": "Este código no corresponde a un valor válido de la lista"
},
{
"Regla": "FAJ08",
"Tipo": "Rechazo",
"Mensaje": "No fue informado el conjunto formado por los elementos : ID, CityName, CountrySubentity, CountrySubentityCode, PostalZone , AddressLine, Line, Country, IdentificationCode"
},
{
"Regla": "FAJ43b",
"Tipo": "Notificación",
"Mensaje": "Nombre informado No corresponde al registrado en el RUT con respecto al Nit suminstrado."
}
]
}
]
}Devuelve la versión del API NUC que está corriendo. No requiere token.
https://testnucco.digifact.com/api/No disponible — Digifact Colombia aún no tiene ambiente de producciónRespuesta
| Nombre | Tipo | Descripción |
|---|---|---|
| Message | string | "Api NUC <versión> is running!" |
| Author | string | "Digifact Servicios S.A." |
Ejemplo de Request
curl -X GET "https://testnucco.digifact.com/api/"Ejemplo de Response
{ "Message": "Api NUC V2.2.8 Core is running!", "Author": "Digifact Servicios S.A." }Soporte Técnico
Disponible en horario hábil para dudas durante implementación, pruebas y producción.
Subject recomendado: [NIT] Tipo_REST · [NIT] Tipo_GENERAL