---
title: "Consultar eventos electrónicos de un documento recibido"
method: POST
path: "/consultarEventosDocumento"
tags: ["Facturación Electrónica"]
---

# Consultar eventos electrónicos de un documento recibido

`POST /consultarEventosDocumento`

## Request

- Base URL: `{urlServicio}`
- URL: `{urlServicio}/consultarEventosDocumento`
- Auth: none declared

**Url Servicio**: Al correo electrónico registrado como usuario para el consumo de los servicios te enviamos una URL. Debes reemplazar el valor {urlServicio} por la URL que recibiste en tu correo electrónico. Ejemplo: Si la URL recibida en el correo es https://feprb.loggro.com/FacturacionElectronica/RecepcionDocumentoElectronicoValidacionPrevia?wsdl Entonces, la Url para el consumo del servicio será: https://feprb.loggro.com/FacturacionElectronica/RecepcionDocumentoElectronicoValidacionPrevia?wsdl/consultarEventosDocumento

Este servicio SOAP permite consultar los eventos electrónicos que han sido generados y confirmados por la DIAN para un documento electrónico recibido, por ejemplo los eventos de Acuse de recibo, Recibo del bien o prestación del servicio, Aceptación expresa o Reclamación. Por cada evento se retorna el **AttachedDocument** firmado, que contiene el evento y la respuesta de la DIAN, para que lo conserves como soporte.

**Importante:** el servicio retorna únicamente los eventos que ya fueron **confirmados por la DIAN**. Los eventos que aún están en cola para su transmisión y los eventos rechazados por la DIAN no aparecen en la respuesta.

## Ten en cuenta
- Si el documento no tiene ningún evento procesado, el servicio retorna `operacionExitosa = false` con un mensaje indicando que el documento no se encuentra disponible. Si solo tiene eventos rechazados, retorna `operacionExitosa = true` con la lista vacía.
- El campo `operacionExitosa` de cada evento no es confiable para distinguir éxito de error. Valida cada evento con `mensajeError` y con `attachedDocumentBase64`.
- Para los eventos generados antes de noviembre de 2022, el evento se retorna con un `mensajeError` que indica que la acción solo está disponible para eventos posteriores.
- `attachedDocumentBase64` puede retornar vacío cuando no fue posible generar el documento, sin que se reporte un error.
- La respuesta puede ser extensa, porque cada evento incluye un documento XML en Base64. Evita invocar el servicio de forma repetida sobre el mismo documento.

## Request body `application/xml`

- object
  - `nitFacturador` string, required: Identificación (NIT) de tu compañía como receptor del documento electrónico. Debe coincidir con la del usuario autenticado en el servicio.
  - `idDocumento` string, required: Identificador del documento electrónico recibido. Corresponde al valor `idDocumento` que se retorna al consultar los documentos recibidos, por ejemplo con el servicio **Consultar Documentos Recibidos Por Origen**.

## Response `200`

Respuesta del servicio. El servicio responde 200 tanto cuando la consulta se ejecuta como cuando se presenta un error; el resultado se indica en el campo `operacionExitosa`.

## Other responses

- `429`: Se superó el límite de solicitudes permitidas. La respuesta no incluye cuerpo SOAP. Reintenta más tarde.
- `500`: Error interno del servidor

## Changes

- **2026-11-03** `c55741cc650b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/loggro/apis/documentos-electr-nicos/changes/consultarEventosDocumento/post.md)

---

[API](https://skmtc.dev/loggro/apis/documentos-electr-nicos.md) - [All operations](https://skmtc.dev/loggro/apis/documentos-electr-nicos/llms.txt) - [OpenAPI document](https://skmtc.dev/loggro/apis/documentos-electr-nicos/revisions/c55741cc650b?raw)