> ## Documentation Index
> Fetch the complete documentation index at: https://tech.sedierp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Consulta general

El servicio permite a los usuarios consultar el listado de recibos de caja del cliente, es decir, los pagos registrados y las facturas a las que se aplicaron, en línea en formato JSON.

Solo se consultan los recibos de caja cuyo documento contable está contabilizado.

El método de solicitud es POST y se requiere un encabezado "Authorization" para la autenticación, que debe contener el **AccessToken** (JWT) obtenido previamente del servicio de [inicio de sesión](https://tech.sedierp.com/inicio-de-sesion.md).

## Prerequisitos

Antes de realizar la consulta de recibos de caja, se debe contar con los siguientes datos:

* AccessToken solicitado mediante el servicio de [inicio de sesión](https://tech.sedierp.com/inicio-de-sesion.md)
* Código único del cliente (TerceroID) obtenido del servicio de [datos del cliente](https://tech.sedierp.com/datos-del-cliente.md)

## Consultar recibos de caja

**Request URL:** [https://portal.sedierp.com/API\_FAC/api/Cartera/RecibosCajaConsultar](https://portal.sedierp.com/API_FAC/api/Cartera/RecibosCajaConsultar)\
**Tipo:** POST \
**Content Type:** application/json

**TerceroID** `int` *required*

Código único del cliente (ID) que inició sesión. Se obtiene del campo `TerceroID` del servicio de [datos del cliente](https://tech.sedierp.com/datos-del-cliente.md).

**Page** `int`

Página de consulta. Es obligatorio cuando se envía `Rows`.

**Rows** `int`

Cantidad de registros por página de consulta. Si no se envía (o es 0), el servicio retorna todos los registros sin paginar.

**FechaInicial** `date`

Filtro de búsqueda por fecha del recibo de caja, desde la fecha indicada (inclusive). Formato `yyyy-MM-dd`. Solo se tiene en cuenta la fecha, no la hora.

**FechaFinal** `date`

Filtro de búsqueda por fecha del recibo de caja, hasta la fecha indicada (inclusive). Formato `yyyy-MM-dd`. Solo se tiene en cuenta la fecha, no la hora.

**FechaRecaudo** `date`

Filtro de búsqueda por fecha exacta de recaudo del pago. Formato `yyyy-MM-dd`.

**Consecutivo** `int`

Filtro de búsqueda por consecutivo exacto del recibo de caja.

**Prefijo** `string`

Filtro de búsqueda por cualquier parte del prefijo del recibo de caja. Máximo 10 caracteres.

```bash theme={null}
curl --location 'https://portal.sedierp.com/API_FAC/api/Cartera/RecibosCajaConsultar' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--data '{
	"TerceroID": 48213,
	"Page": 1,
	"Rows": 10,
	"FechaInicial": "2026-10-01",
	"FechaFinal": "2026-10-31",
	"FechaRecaudo": null,
	"Consecutivo": null,
	"Prefijo": null
}'
```

### Respuesta

El servicio retorna el listado de recibos de caja ordenado por fecha de forma descendente. Si el AccessToken no se envía, es inválido o expiró, el servicio responde HTTP 401 (`{"Code": 401, "Message": "El TokenAcceso no es valido"}`).

Cada registro de `rows` contiene los siguientes campos:

**ReciboCajaID** `int`

Código único del recibo de caja (ID).

**Prefijo** `string`

Prefijo del documento contable del recibo de caja.

**Consecutivo** `int`

Consecutivo del recibo de caja.

**Fecha** `datetime`

Fecha del recibo de caja.

**FechaRecaudo** `datetime`

Fecha de recaudo del pago.

**Valor** `decimal`

Valor del recibo de caja.

**FormaPagoNombre** `string`

Nombre de la forma de pago.

**BancoNombre** `string`

Nombre del banco de la cuenta bancaria donde se recibió el pago.

**EstadoReciboCajaNombre** `string`

Nombre del estado del recibo de caja.

**Codigo** `string`

Código de referencia del recibo de caja.

**CodigoPlataformaRecaudo** `string`

Código de la transacción en la plataforma de recaudo, cuando el pago se realizó en línea.

**FacturaConsecutivo** `string`

Prefijos y consecutivos de los documentos a los que se aplicó el pago, separados por coma (ej. "FV-1520, FV-1533, ").

**UniqueID** `GUID`

Identificador único del documento contable del recibo de caja.

**TotalRows** `int`

Cantidad total de registros que cumplen con los filtros de la consulta.

```json Request theme={null}
{
  "TerceroID": 48213,
  "Page": 1,
  "Rows": 10,
  "FechaInicial": "2026-10-01",
  "FechaFinal": "2026-10-31",
  "FechaRecaudo": null,
  "Consecutivo": null,
  "Prefijo": null
}
```

```json Exitosa theme={null}
{
    "total": 1,
    "rows": [
        {
            "ReciboCajaID": 20871,
            "Valor": 1850000.0,
            "FechaRecaudo": "2026-10-05T14:22:00",
            "Fecha": "2026-10-05T15:01:37",
            "Codigo": "1450223",
            "CodigoPlataformaRecaudo": "112233-1759687320-41522",
            "Consecutivo": 5410,
            "UniqueID": "c309aab0-7dec-46e8-8c60-2684923b87ea",
            "Prefijo": "RC",
            "FormaPagoNombre": "Transferencia Débito Bancaria",
            "EstadoReciboCajaNombre": "Aplicado",
            "BancoNombre": "BANCOLOMBIA",
            "FacturaConsecutivo": "FV-1520, ",
            "TotalRows": 1
        }
    ],
    "result": 1
}
```

```json Error theme={null}
{
    "Message": "The offset specified in a OFFSET clause may not be negative., "
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.