Consultar los eventos de un documento recibido

El método ExtraerEventosRecepcion permite consultar y descargar los eventos generados para un documento electrónico recibido, identificado por su CUFE o CUDE. Es útil para conocer el estado del documento en el proceso de recepción (acuse, aceptación, rechazo, etc.).

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

Endpoint

Dato	Valor
Método HTTP	POST
Operación	ExtraerEventosRecepcion

Parámetros de entrada

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

Parámetro	Tipo	Obligatorio	Descripción
guidEmpresa	string	Sí	Identificador único de la empresa receptora. Se asigna al configurar e implementar el cliente.
codigoTransaccion	string	Sí	CUFE o CUDE del documento cuyos eventos se desean consultar.
periodo	string	Sí	Año y mes de emisión del documento, en formato yyyyMM (por ejemplo, 202501). Debe coincidir con la fecha de emisión del documento.

Ejemplo de solicitud

{
  "solicitud": {
    "guidEmpresa": "<GUID de la empresa receptora>",
    "codigoTransaccion": "2a378536a1c8988289fc4794c79baf8f26e2033423106de0be9e7d713bd25152",
    "periodo": "202501"
  }
}

Estructura de la respuesta

Ejemplo de respuesta

{
  "ExtraerEventosRecepcionResult": {
    "Estado": "OK",
    "DetalleEstado": "Consulta exitosa",
    "guidEmpresa": "<GUID de la empresa receptora>",
    "codigoTransaccion": "<CUFE del documento>",
    "periodo": "202501",
    "eventos": [
      {
        "idSegmento": 202501,
        "tipoTransaccion": "R_FAC",
        "codigoEvento": "030",
        "descripcionEvento": "Acuse de recibo del documento",
        "estado": "EXITO",
        "codigoTransaccion": "<CUDE del evento>",
        "XML": "<ApplicationResponse>"
      }
    ]
  }
}

Campos de la respuesta

Campo	Tipo	Descripción
Estado	string	Resultado de la operación: OK o ERROR.
DetalleEstado	string	Mensaje descriptivo del resultado o del error presentado.
guidEmpresa	string	Identificador de la empresa receptora.
codigoTransaccion	string	CUFE o CUDE del documento.
periodo	string	Periodo consultado.
eventos	array	Eventos del documento. Ver EventoDocumentoType.

Consideraciones importantes

• Permite consultar tanto eventos en proceso como finalizados.
• El campo XML de cada evento contiene el ApplicationResponse generado.
• Para los eventos de rechazo (031) se devuelven los campos tipoRechazo y nombreRechazo.
• Para conocer solo el último evento de un documento, usa EventosCUFE.