Copyright Teleinte SAS 2021
Para mayor información en operaciones@teleinte.com

Consulta XML por UUID (CUFE,CUDE)

EndPoint


Método: POST

EndPoint:

Nota: La consulta del XML por UUID consume una transacción de la bolsa
Producción
https://servicios.afacturar.com/api/otros/consultar_xml_uuid

Seguridad SSL: Afacturar cuenta en sus endpoint con certificados de seguridad (DigiCert SHA2 Extended Validation Server CA), su aplicación debe ser capaz de negociar y validar dicho certificado.

Parámetros de entrada


HEADERS

Accept: application/json

Authorization: Bearer Token asignado a cada cliente


BODY

documento_obligado: Número de identificación del cliente

data: JSON


Estructura de JSON de entrada


Consultar XML por UUID

uuid Array Requerido

Arreglo de UUID (correspondiente a CUFE o CUDE según el tipo de documento), con mínimo 1 y máximo 10 elementos. Cada UUID debe contener exactamente 96 caracteres hexadecimales: números del 0 al 9 y letras. No se permiten UUID duplicados.

Los UUID enviados para consulta deben corresponder a documentos electrónicos emitidos y validados en el ambiente de producción.

Cada UUID será validado para comprobar que el documento_obligado, asociado al token de autorización, corresponda a la identificación del emisor o del receptor del documento.

Especificación:

generalidades Objeto Requerido

Generalidades

Especificación:

integrador Objeto Requerido

Información de quien solicita la información

Especificación:

nombre Parametrizado Requerido

Código o nombre del medio desde el cual se realiza la integración.

Especificación: S o N
tipo Parametrizado Requerido

Codigo del medio usado para realizar la integración

Especificación:

MOVIL

WEB

DLL

EXCEL

ERP-XXXXXXXXX
usuario Objeto Requerido

Datos del usuario que consulto los documentos

Especificación:

nombres String Requerido

Nombres de la empresa o persona

Especificación: Mínimo 3 caracteres.
identificacion String Requerido

Número completo de la identificación de la empresa o persona.

Especificación: String
correo_electronico String Requerido

Dirección de correo de la empresa o persona

Especificación: Mínimo 3 caracteres.
cargo String No_requerido

Cargo de la persona que consulto el documento

Especificación: Mínimo 3 caracteres.
area String No_requerido

Area de la empresa o persona que consulto el documento

Especificación: Mínimo 3 caracteres.

Estructura json

							{
    "uuid": [
        "",
        ""
    ],
    "generalidades": {
        "integrador": {
            "nombre": "",
            "tipo": ""
        },
        "usuario": {
            "nombres": "",
            "identificacion": "",
            "correo_electronico": "",
            "cargo": "",
            "area": ""
        }
    }
}

Estructura JSON de respuesta


Salida Exitosa


{
	"codigo_error": 0,
	"descripcion_error": "OK",
	"tiempo_ejecucion": 0.7741971015930176,
	"resultado": [
		{
            "cufe": "78df1682acb476c3151a1a682ebe151681811234567823d58f80a7a3efd42ef6417f3a7019c211294b9dc05ddeaa0c1",
            "codigo_error_cufe": 22,
            "descripcion_error_cufe": "El CUFE consultado no pertenece al emisor ni al receptor del documento."
        },
        {
            "cufe": "065933365c78faec1152d9123467899495e91b25ac8959ab08d0ed2e94b4c8d29585a057caee40b98dd9dc9b105e27e",
            "documento_clase": "Factura",
            "documento_tipo": "91",
            "documento_numero": "",
            "documento_fecha": "2026-07-22",
            "documento_moneda": "COP",
            "documento_metodo_pago": "1",
            "documento_fecha_vencimiento": "",
            "documento_valor_total": "410000.00",
            "emisor_tipo_identificacion": "31",
            "emisor_identificacion": "830020470",
            "emisor_nombre": "TELEINTE S A S",
            "emisor_detalles_tributarios": "01",
            "emisor_correo_electronico": "info@teleinte.com",
            "receptor_nombre": "Empresas",
            "receptor_tipo_identificacion": "31",
            "receptor_identificacion": "900900900",
            "receptor_detalles_tributarios": "01",
            "receptor_correo_electronico": "emisor@teleinte.com",
            "url_representacion_xml": "https://afacturar.archivamos.com/3147852/1e552c123456678f8/doc_consultados/2026/07/24/doc_123456789585a057caee40b98dd9dc9b105e27e.xml",
            "codigo_error_cufe": 0,
            "descripcion_error_cufe": "OK"
        }
	]
}
Salida con errores de datos 
{
    "codigo_error": 10,
    "descripcion_error": [
        "The uuid may not have more than 10 items.",
		"The uuid.0 must be 96 characters.",
        "The uuid.1 field has a duplicate value."
    ],
    "tiempo_ejecucion": 0.0042459964752197266,
    "transaccion": "12649419526a63cbef632ec",
    "resultado": []
}

Codigo de respuesta


Codigo Descripción
5 El token no esta asociado al documento del obligado XXXXXXX, o no se encuentra en servicios
6 El servicio de la DIAN no se encuentra activo
10 Errores de parametros de entrada
11 / 14 El cliente con NIT: XXXXX no tiene suscripción activa, o no tiene bolsa de tx disponible
20 Error en el consumo del API de la DIAN
21 Error en la consulta del UUID
23 El obligado no es el tenedor legitimo del UUID o el UUID no es del ambiente de producción
24 XML no encontrado
⚠
Importante: La consulta será rechazada cuando el UUID no corresponda al ambiente de producción o cuando la identificación del obligado no coincida con la identificación del emisor ni del receptor del documento.

Ejemplos


Ejemplo 1.

{
    "uuid": [
		"78df1682acb476c31a1a682ebe1516818df97d01ca723d58f80a7a3efd42ef6417f3a7019c211294b9dc05ddeaa0c1"
    ],
    "generalidades": {
        "integrador": {
            "nombre": "WEB",
            "tipo": "PRUEBA"
        },
        "usuario": {
            "nombres": "Usuario Uno",
            "identificacion": "900900900",
            "correo_electronico": "info@teleinte.com",
            "cargo": "",
            "area": ""
        }
    }
}

Ejemplo 2.

{
    "uuid": [
		"78df1682acb476c31a1a682ebe1516818df12346578956d58f80a7a3efd42ef6417f3a7019c2111294b9dc05ddeaa0c1",
		"78df1682acb476c31a1a682ebe1516818df12346578956d58f80147852369ef6417f3a7019c2111294b9dc05ddeaa0c1"
    ],
    "generalidades": {
        "integrador": {
            "nombre": "WEB",
            "tipo": "PRUEBA"
        },
        "usuario": {
            "nombres": "Usuario Uno",
            "identificacion": "900900900",
            "correo_electronico": "info@teleinte.com",
            "cargo": "",
            "area": ""
        }
    }
}

Consumo del API


CURL

								curl --location 'https://servicios.afacturar.com/api/otros/consultar_xml_uuid' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer token obligado' \
--form 'documento_obligado="830020470"' \
--form 'data="{
    \"uuid\": [
		\"78df1682acb476c31a1a682ebe1516818df97d01ca723d1234567890d42ef6417f3a7019c211294b9dc05ddeaa0c1\",        \"065933365c7812345678900ae5d99495e91b25ac8959ab08d0ed2e94b4c8d29585a057caee40b98dd9dc9b105e27e\",
		\"78df1682acb476c3151a1a682ebe1516818df971234567890a7a3efd42ef16417f3a7019c211294b9dc05ddeaa0c1\"
    ],
    \"generalidades\": {
        \"integrador\": {
            \"nombre\": \"WEB\",
            \"tipo\": \"PRUEBA\"
        },
        \"usuario\": {
            \"nombres\": \"Usuario Uno\",
            \"identificacion\": \"123456789\",
            \"correo_electronico\": \"info@teleinte.com\",
            \"cargo\": \"\",
            \"area\": \"\"
        }
    }
}"'

C#

								var options = new RestClientOptions("https://servicios.afacturar.com")
{
  MaxTimeout = -1,
};
var client = new RestClient(options);
var request = new RestRequest("/api/otros/consultar_xml_uuid", Method.Post);
request.AddHeader("Accept", "application/json");
request.AddHeader("Authorization", "Bearer token obligado");
request.AlwaysMultipartFormData = true;
request.AddParameter("documento_obligado", "830020470");
request.AddParameter("data", "{
    \"uuid\": [
		\"78df1682acb476c31a1a682ebe1516818df97d01ca723d1234567890d42ef6417f3a7019c211294b9dc05ddeaa0c1\",        \"065933365c7812345678900ae5d99495e91b25ac8959ab08d0ed2e94b4c8d29585a057caee40b98dd9dc9b105e27e\",
		\"78df1682acb476c3151a1a682ebe1516818df971234567890a7a3efd42ef16417f3a7019c211294b9dc05ddeaa0c1\"
    ],
    \"generalidades\": {
        \"integrador\": {
            \"nombre\": \"WEB\",
            \"tipo\": \"PRUEBA\"
        },
        \"usuario\": {
            \"nombres\": \"Usuario Uno\",
            \"identificacion\": \"123456789\",
            \"correo_electronico\": \"info@teleinte.com\",
            \"cargo\": \"\",
            \"area\": \"\"
        }
    }
}");
RestResponse response = await client.ExecuteAsync(request);
Console.WriteLine(response.Content);

Historico de cambios


Versión Cambios Fecha de liberación
1 Generación del API para consultar los XML de los UUID 24 de Julio de 2026