Exportar el reporte de documentos consultados
El método ExportReport permite consultar y exportar el detalle de los documentos electrónicos consultados ante la DIAN, aplicando filtros por sistema integrado, rango de fechas, emisor, código de respuesta de la DIAN y tipo de documento.
POST https://micro.conexusit.com/corp/demo/api/Service.svc/ExportReport
Endpoint
| Dato | Valor |
|---|---|
| Método HTTP | POST |
| Operación | ExportReport |
Parámetros de entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
GuidSistemaIntegrado | string | Sí | GUID del sistema integrado que realiza la consulta. |
FechaInicial | string | Sí | Fecha inicial del rango de búsqueda, en formato yyyy-MM-dd. |
FechaFinal | string | Sí | Fecha final del rango de búsqueda, en formato yyyy-MM-dd. Internamente se ajusta para abarcar todo el día (hasta las 23:59:59.999). |
GuidIssuer | string | No | GUID del emisor. Si no se envía, o se envía null o vacío, la búsqueda no se filtra por emisor. |
DianResponseCode | string | No | Código de respuesta de la DIAN por el cual filtrar, por ejemplo "100", "400" o "401". Si es null, no se filtra. |
DocumentTypeCode | string | No | Tipo de documento por el cual filtrar, por ejemplo "FAC", "NCR" o "NDB". Ver Tipos de transacción. Si es null, no se filtra. |
Ejemplo de solicitud
{
"GuidSistemaIntegrado": "3408859dc7cc426991edcb70220bbfb6",
"GuidIssuer": "e144e070dffb4b90a0f93bb192b0ea30",
"FechaInicial": "2026-09-14",
"FechaFinal": "2026-09-14",
"DianResponseCode": null,
"DocumentTypeCode": null
}
Estructura de la respuesta
Ejemplo de respuesta exitosa (200 OK)
{
"ExportReportResult": {
"TotalDocuments": 1,
"DocumentsRetrievals": [
{
"Id": 43,
"NitIssuer": "900123456",
"BusinesNameIssuer": "Empresa de ejemplo S.A.S.",
"Cufe": "<CUFE o CUDE del documento>",
"DocumentType": "FAC",
"Source": "DIAN",
"DianResponseCode": "100",
"MessageResponseDian": "Accion completada OK",
"QueriedAt": "2026-09-14T06:31:36.380522Z",
"CreatedOn": "2026-09-14T06:31:36.4796Z"
}
]
}
}
Campos de la respuesta
| Campo | Tipo | Descripción |
|---|---|---|
TotalDocuments | int | Cantidad total de documentos encontrados según los filtros aplicados. |
DocumentsRetrievals | array | Listado de documentos encontrados. |
DocumentsRetrievals[].Id | long | Identificador interno del registro. |
DocumentsRetrievals[].NitIssuer | string | NIT del emisor relacionado con el CUFE. |
DocumentsRetrievals[].BusinesNameIssuer | string | Razón social del emisor relacionado con el CUFE. |
DocumentsRetrievals[].Cufe | string | CUFE o CUDE del documento electrónico. |
DocumentsRetrievals[].DocumentType | string | Código del tipo de documento (FAC, NCR, NDB, etc.). |
DocumentsRetrievals[].Source | string | Origen del documento, por ejemplo DIAN. |
DocumentsRetrievals[].DianResponseCode | string | Código de respuesta devuelto por la DIAN. |
DocumentsRetrievals[].MessageResponseDian | string | Mensaje descriptivo de la respuesta de la DIAN. |
DocumentsRetrievals[].QueriedAt | datetime | Fecha y hora en que se consultó el documento ante la DIAN. |
DocumentsRetrievals[].CreatedOn | datetime | Fecha y hora de creación del registro. |
Respuestas de error
| Código HTTP | Causa | Ejemplo de respuesta |
|---|---|---|
400 Bad Request | FechaInicial o FechaFinal no tienen un formato de fecha válido, o no se envía GuidSistemaIntegrado. | {"ExportReportResult": "La FechaFinal no tiene un formato válido."} |
401 Unauthorized | GuidSistemaIntegrado no coincide con ningún sistema integrado registrado en la plataforma. | {"ExportReportResult": {"Error": "Sistema integrado '<guid>' no encontrado."}} |
Consideraciones importantes
GuidSistemaIntegrado,FechaInicialyFechaFinalson obligatorios.- Los filtros opcionales que se envían en
nullo vacíos no restringen la búsqueda. - El reporte incluye todas las consultas registradas, también las que no generaron consumo (código DIAN diferente de
100); filtra porDianResponseCodepara obtener solo las exitosas.