---
title: "Consultar estado de un documento recibido"
method: POST
path: "/consultarEstadoDocumentoRecibido"
tags: ["Facturación Electrónica"]
---

# Consultar estado de un documento recibido

`POST /consultarEstadoDocumentoRecibido`

## Request

- Base URL: `{urlServicio}`
- URL: `{urlServicio}/consultarEstadoDocumentoRecibido`
- 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/consultarEstadoDocumentoRecibido

Este servicio SOAP permite consultar el estado de un documento electrónico recibido, incluyendo el resultado del proceso de los eventos electrónicos generados sobre él. Es el servicio que debes usar después de **Generar Eventos Electrónicos sobre facturas a crédito** para saber si la DIAN procesó el evento o lo rechazó.

Cuando generas un evento, el documento pasa a un estado **pendiente** (`PAc`, `PRe`, `PAp` o `PRc`). Cuando la DIAN responde, el documento pasa al estado **final** correspondiente (`Acu`, `Reci`, `A` o `Rech`). Si la DIAN rechaza el evento, la respuesta incluye el código del evento rechazado y los mensajes de error de la DIAN.

## Ten en cuenta
- Si el documento no está registrado, el servicio retorna `operacionExitosa = true`, sin `estadoDocumento` y con un mensaje en `mensajesError` indicando que no se tiene registro del documento.
- Si el último evento fue rechazado por la DIAN, el servicio continúa retornando ese rechazo, con `tipoEvento` y los mensajes de la DIAN en `mensajesError`, hasta que un evento posterior sea confirmado o rechazado por la DIAN. Mientras el evento reenviado siga pendiente, se continúa mostrando el rechazo anterior.
- Para los documentos que no son facturas electrónicas de venta, el servicio retorna siempre `estadoDocumento = Tram`, sin que esto signifique que requieran trámite.
- El campo `notificadoDIAN` no refleja si el evento fue notificado a la DIAN: retorna `true` por defecto y `false` solo cuando el documento no está registrado o el último evento fue rechazado. No lo uses para determinar el resultado del evento; usa `estadoDocumento`.
- El `idDocumento` también puede corresponder a un documento recibido con errores de recepción. En ese caso, `mensajesError` incluye los errores registrados.

## 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` y en la lista `mensajesError`.

## 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/consultarEstadoDocumentoRecibido/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)