🧪 Test

https://testnucco.digifact.com/api

🚀 Producción

https://nucco.digifact.com/api
ℹ️

Todas las operaciones requieren un token JWT obtenido en GET TOKEN. El token expira automáticamente — al recibir un error 401, solicitar un nuevo token.


POSTObtención del TOKENGet 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>.

TESThttps://testnucco.digifact.com/api/login/get_token
PRODNo disponible — Digifact Colombia aún no tiene ambiente de producción
NombreReq.Descripción
Content-TypeReqEl body debe enviarse como JSON.
NombreTipoReq.DescripciónEjemplo
UsernamestringReqCO + "." + <NIT> + "." + <usuario>. El prefijo de país debe ser CO.CO.902052428.testuser
PasswordstringReqContraseña de las credenciales de pruebas.
NombreTipoDescripción
TokenstringJWT generado. Vigencia de 30 días.
expira_enstringFecha y hora de expiración del token.
otorgado_astringUsername 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.

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>"
}'
json
{
  "Token": "eyJhbGciOiJIUzI1NiIs…",
  "expira_en": "11/06/2026 14:29:37",
  "otorgado_a": "CO.902052428.testuser"
}
POSTCertificación NUC XMLCertificar XML

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.

TESThttps://testnucco.digifact.com/api/transform/nuc
PRODNo disponible — Digifact Colombia aún no tiene ambiente de producción
NombreReq.Descripción
AuthorizationReqToken vigente obtenido en Obtención del TOKEN, SIN el prefijo "Bearer".
Content-TypeReqapplication/xml
NombreReq.DescripciónEjemplo
TAXIDReqNIT 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
NombreReq.Descripción
BODY (raw)ReqXML con el contenido del NUC (elemento raíz <Root>). Ver Formato del NUC.
NombreTipoDescripción
codenumberCó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.
messagestringNombre del resultado cuando hay error (ej. XML_INVALID, DOCUMENT_ALREADY_EXISTS). Vacío si fue exitoso.
descriptionstringDescripción del resultado cuando hay error. Vacío si fue exitoso.
responseData1stringXML UBL 2.1 FIRMADO (XAdES-EPES) codificado en base64, con el CUFE/CUDE ya calculado.
responseData2stringVacío: este endpoint no solicita la representación HTML.
responseData3stringVacío: este endpoint no solicita la representación PDF. Para obtener HTML/PDF usar GET DOCUMENT.
responseData4stringVacío.
authNumberstringCUFE (factura) o CUDE (nota crédito/débito) del documento, algoritmo SHA-384 (96 caracteres hexadecimales).
urlstringVacío.
infoDetailsarrayArreglo de eventos {evento, dCodRes, dMsgRes}. En Colombia llega vacío.
suggestedFileName / suggestedFileName2stringVacíos.
batchstringPrefijo de numeración del documento (sts:Prefix).
serialstringConsecutivo del documento (dígitos finales de cbc:ID).
issuedTimeStampstringCopia de Header.IssuedDateTime enviado en el NUC.
taxID / namestringCopia de Seller.TaxID y Seller.Name del NUC.
branchCode / branchNamestringCopia de Seller.BranchInfo.Code y Seller.BranchInfo.Name del NUC.
receiverTaxID / receiverNamestringCopia de Buyer.TaxID y Buyer.Name del NUC.
discounts / taxesstringVacíos.
subTotalstringCopia de Totals.TotalItems del NUC.
totalAmountstringCopia de Totals.GrandTotal.InvoiceTotal del NUC.
enrolledTimeStampstringFecha y hora de certificación devuelta por el backend (formato ISO 8601).
backprocessorstringServidor que procesó la certificación.
additionalInfoobjectNormalmente 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.

curl -X POST "https://testnucco.digifact.com/api/transform/nuc?TAXID=902052428" \
  -H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  -H "Content-Type: application/json"
json
// 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."
  }
}
POSTCertificación NUC JSONCertificar JSON

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

TESThttps://testnucco.digifact.com/api/transform/nuc_json
PRODNo disponible — Digifact Colombia aún no tiene ambiente de producción
NombreReq.Descripción
AuthorizationReqToken vigente obtenido en Obtención del TOKEN, SIN el prefijo "Bearer".
Content-TypeReqapplication/json
NombreReq.DescripciónEjemplo
TAXIDReqNIT 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
NombreReq.Descripción
BODY (raw)ReqJSON con el contenido del NUC. Ver Formato del NUC.
NombreTipoDescripción
codenumberCó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.
messagestringNombre del resultado cuando hay error (ej. XML_INVALID, DOCUMENT_ALREADY_EXISTS). Vacío si fue exitoso.
descriptionstringDescripción del resultado cuando hay error. Vacío si fue exitoso.
responseData1stringXML UBL 2.1 FIRMADO (XAdES-EPES) codificado en base64, con el CUFE/CUDE ya calculado.
responseData2stringVacío: este endpoint no solicita la representación HTML.
responseData3stringVacío: este endpoint no solicita la representación PDF. Para obtener HTML/PDF usar GET DOCUMENT.
responseData4stringVacío.
authNumberstringCUFE (factura) o CUDE (nota crédito/débito) del documento, algoritmo SHA-384 (96 caracteres hexadecimales).
urlstringVacío.
infoDetailsarrayArreglo de eventos {evento, dCodRes, dMsgRes}. En Colombia llega vacío.
suggestedFileName / suggestedFileName2stringVacíos.
batchstringPrefijo de numeración del documento (sts:Prefix).
serialstringConsecutivo del documento (dígitos finales de cbc:ID).
issuedTimeStampstringCopia de Header.IssuedDateTime enviado en el NUC.
taxID / namestringCopia de Seller.TaxID y Seller.Name del NUC.
branchCode / branchNamestringCopia de Seller.BranchInfo.Code y Seller.BranchInfo.Name del NUC.
receiverTaxID / receiverNamestringCopia de Buyer.TaxID y Buyer.Name del NUC.
discounts / taxesstringVacíos.
subTotalstringCopia de Totals.TotalItems del NUC.
totalAmountstringCopia de Totals.GrandTotal.InvoiceTotal del NUC.
enrolledTimeStampstringFecha y hora de certificación devuelta por el backend (formato ISO 8601).
backprocessorstringServidor que procesó la certificación.
additionalInfoobjectNormalmente 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.

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"
      }
    ]
  }
}'
json
// 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
}
GETGET DOCUMENTObtener documento

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

TESThttps://testnucco.digifact.com/api/GetDocument
PRODNo disponible — Digifact Colombia aún no tiene ambiente de producción
NombreReq.Descripción
AuthorizationReqToken vigente, SIN el prefijo "Bearer".
NombreReq.DescripciónEjemplo
TAXIDReqNIT del emisor (sin dígito de verificación). Debe coincidir con el NIT del token. Alias heredado aceptado: RUC.902052428
USERNAMEReqNombre de usuario.testuser
AUTHNUMBERReqCUFE (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
FORMATReqFormatos a devolver: XML, HTML y/o PDF, separados por pipe (|).XML|HTML|PDF
NombreTipoDescripción
REQUEST_DATAarrayUna posición con { "Respuesta", "Codigo", "Procesador", "Mensaje", "Descripcion", "Fecha" }. Si no se encontró el documento: Mensaje = "Error" y Descripcion con el motivo.
RESPONSEarrayUna 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[].EstadoDIANstringACEPTADO | RECHAZADO | PENDIENTE.
RESPONSE[].CodigoDIANstringStatusCode de la DIAN: 00 aceptado, 99 rechazado; vacío si está pendiente.
RESPONSE[].DescripcionDIANstringStatusDescription de la DIAN.
RESPONSE[].MensajeDIANstringStatusMessage de la DIAN (p.ej. "La Factura electrónica SETP… ha sido autorizada").
RESPONSE[].ReglasDIANarrayReglas 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.

curl -X GET "https://testnucco.digifact.com/api/GetDocument?TAXID=902052428&USERNAME=testuser&AUTHNUMBER=ddae210a0ba8c9074e3aeb09e229f44c96f3003621a0f66a3a9d3e6b5f012f932520f64a845dc5049dd80758158c96eb&FORMAT=XML%7CHTML%7CPDF" \
  -H "Authorization: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
json
// 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."
        }
      ]
    }
  ]
}
GETEstado del APIEstado

Devuelve la versión del API NUC que está corriendo. No requiere token.

TESThttps://testnucco.digifact.com/api/
PRODNo disponible — Digifact Colombia aún no tiene ambiente de producción
NombreTipoDescripción
Messagestring"Api NUC <versión> is running!"
Authorstring"Digifact Servicios S.A."
curl -X GET "https://testnucco.digifact.com/api/"
json
{ "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.

Email

[email protected]

Subject recomendado: [NIT] Tipo_REST · [NIT] Tipo_GENERAL