Saltar al contenido principal

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​

DatoValor
Método HTTPPOST
OperaciónExportReport

Parámetros de entrada​

ParámetroTipoObligatorioDescripción
GuidSistemaIntegradostringSíGUID del sistema integrado que realiza la consulta.
FechaInicialstringSíFecha inicial del rango de búsqueda, en formato yyyy-MM-dd.
FechaFinalstringSí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).
GuidIssuerstringNoGUID del emisor. Si no se envía, o se envía null o vacío, la búsqueda no se filtra por emisor.
DianResponseCodestringNoCódigo de respuesta de la DIAN por el cual filtrar, por ejemplo "100", "400" o "401". Si es null, no se filtra.
DocumentTypeCodestringNoTipo 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​

CampoTipoDescripción
TotalDocumentsintCantidad total de documentos encontrados según los filtros aplicados.
DocumentsRetrievalsarrayListado de documentos encontrados.
DocumentsRetrievals[].IdlongIdentificador interno del registro.
DocumentsRetrievals[].NitIssuerstringNIT del emisor relacionado con el CUFE.
DocumentsRetrievals[].BusinesNameIssuerstringRazón social del emisor relacionado con el CUFE.
DocumentsRetrievals[].CufestringCUFE o CUDE del documento electrónico.
DocumentsRetrievals[].DocumentTypestringCódigo del tipo de documento (FAC, NCR, NDB, etc.).
DocumentsRetrievals[].SourcestringOrigen del documento, por ejemplo DIAN.
DocumentsRetrievals[].DianResponseCodestringCódigo de respuesta devuelto por la DIAN.
DocumentsRetrievals[].MessageResponseDianstringMensaje descriptivo de la respuesta de la DIAN.
DocumentsRetrievals[].QueriedAtdatetimeFecha y hora en que se consultó el documento ante la DIAN.
DocumentsRetrievals[].CreatedOndatetimeFecha y hora de creación del registro.

Respuestas de error​

Código HTTPCausaEjemplo de respuesta
400 Bad RequestFechaInicial 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 UnauthorizedGuidSistemaIntegrado no coincide con ningún sistema integrado registrado en la plataforma.{"ExportReportResult": {"Error": "Sistema integrado '<guid>' no encontrado."}}

Consideraciones importantes​

  • GuidSistemaIntegrado, FechaInicial y FechaFinal son obligatorios.
  • Los filtros opcionales que se envían en null o 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 por DianResponseCode para obtener solo las exitosas.