Consultar los eventos de un documento emitido

El método ExtraerEventosEmision permite extraer los eventos registrados en la DIAN (validación, acuse, recibo del bien o servicio, aceptación expresa o tácita, o rechazo) sobre una factura electrónica emitida, que hayan sido sincronizados previamente.

POST https://micro.conexusit.com/corp/demo/api/Service.svc/ExtraerEventosEmision

Endpoint

Dato	Valor
Método HTTP	POST
Operación	ExtraerEventosEmision

Requisito previo

Los eventos del documento deben haberse sincronizado antes con SincronizarEventosEmision.

Parámetros de entrada

La solicitud se envía dentro de un objeto solicitud.

Parámetro	Tipo	Obligatorio	Descripción
guidEmpresa	string	Sí	GUID de la empresa emisora registrada en Colfact.
periodo	string	Sí	Periodo de la fecha de emisión del documento, en formato yyyyMM (por ejemplo, 202503).
codigoTransaccion	string	Sí	CUFE del documento registrado en la DIAN.
codigoEvento	string	No	Código del evento que se desea buscar: 02 (validación DIAN), 030 (acuse de recibo), 032 (recibo del bien o servicio), 033 (aceptación expresa), 031 (rechazo) o 034 (aceptación tácita). Si se envía vacío, se devuelven todos los eventos.
esRecepcion	boolean	No	Indica si el documento es recibido. Para documentos emitidos se envía false.

Ejemplo de solicitud

{
  "solicitud": {
    "guidEmpresa": "<GUID de la empresa emisora>",
    "periodo": "202503",
    "codigoTransaccion": "2a378536a1c8988289fc4794c79baf8f26e2033423106de0be9e7d713bd25152",
    "codigoEvento": "",
    "esRecepcion": false
  }
}

Estructura de la respuesta

Ejemplo de respuesta

{
  "ExtraerEventosEmisionResult": {
    "Estado": "OK",
    "DetalleEstado": "<mensaje del resultado>",
    "guidEmpresa": "<GUID de la empresa emisora>",
    "periodo": "202503",
    "codigoTransaccion": "<CUFE del documento>",
    "eventos": [
      {
        "idTransaccion": 123456,
        "idSegmento": 202503,
        "tipoTransaccion": "E_FAC",
        "numeroTransaccion": "<número del evento>",
        "fechaEmision": "2025-03-10T09:15:00",
        "codigoTransaccion": "<CUDE del evento>",
        "estado": "EXITO",
        "descripcionEstado": "<descripción del resultado>",
        "codigoEvento": "030",
        "descripcionEvento": "Acuse de recibo de la factura",
        "tipoRechazo": null,
        "nombreRechazo": null,
        "fechaHoraIngreso": "2025-03-10T09:16:00",
        "fechaHoraEnvioAutoridad": "2025-03-10T09:16:05",
        "fechaHoraUltProceso": "2025-03-10T09:16:10",
        "XML": "<XML del evento>"
      }
    ]
  }
}

Campos de la respuesta

Campo	Tipo	Descripción
Estado	string	Resultado de la operación: OK o ERROR.
DetalleEstado	string	Mensaje explicativo del resultado.
guidEmpresa	string	GUID de la empresa emisora.
periodo	string	Periodo consultado, en formato yyyyMM.
codigoTransaccion	string	CUFE del documento.
eventos	array	Eventos sincronizados del documento (ver tabla siguiente).

Estructura de cada evento

Campo	Tipo	Descripción
idTransaccion	int	Identificador interno del documento en la plataforma.
idSegmento	int	Periodo del evento, en formato yyyyMM.
tipoTransaccion	string	Tipo de transacción. Para eventos de documentos emitidos es E_FAC.
numeroTransaccion	string	Número del documento del evento.
fechaEmision	datetime	Fecha y hora de emisión del evento.
codigoTransaccion	string	Código de la transacción registrada en el sistema.
estado	string	Estado del procesamiento: RECIB, EXITO o ERROR.
descripcionEstado	string	Descripción del resultado del procesamiento.
codigoEvento	string	Código del evento. Ver Códigos de evento.
descripcionEvento	string	Nombre del evento.
tipoRechazo	string	Tipo de rechazo, cuando el evento es 031. Ver Tipos de rechazo.
nombreRechazo	string	Descripción del rechazo, cuando el evento es 031.
fechaHoraIngreso	datetime	Fecha y hora de registro en la plataforma.
fechaHoraEnvioAutoridad	datetime	Fecha y hora de envío a la DIAN.
fechaHoraUltProceso	datetime	Fecha y hora de la última actualización.
XML	string	XML del evento.

Consideraciones importantes

• Después de generar la aceptación tácita (034), vuelve a consultar este método para confirmar que el evento 034 aparece con estado EXITO; ver Aceptación tácita (evento 034).
• Si el documento no se ha sincronizado, ejecuta primero SincronizarEventosEmision.
• Usa codigoEvento para obtener un evento específico; vacío devuelve todos los eventos sincronizados.
• Para conocer solo el último evento registrado en la DIAN, usa EventosCUFE.