> ## 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.

# Estado de cuenta

El servicio permite a los usuarios generar en formato PDF el estado de cuenta de un cliente arrendatario para un contrato de arrendamiento y un rango de fechas. El PDF se puede descargar, visualizar en línea en el navegador u obtener codificado en base64 dentro de un JSON.

El método de solicitud es GET y no requiere el encabezado "Authorization": el cliente se identifica con el token de sesión (`Token`) y el identificador de la empresa (`UUID`) enviados en la URL, para que el estado de cuenta se pueda abrir directamente en el navegador.

## Prerequisitos

Antes de generar el estado de cuenta de arrendatarios, se debe contar con los siguientes datos:

* Código del cliente (TerceroID), identificador de la empresa (UUID) y token de sesión (Token), obtenidos del servicio de [datos del cliente](https://tech.sedierp.com/datos-del-cliente.md)
* Código del contrato de arrendamiento, obtenido del servicio de [contratos](https://tech.sedierp.com/consultar-contratos-GBI.md)

## Generar estado de cuenta de arrendatarios

**Request URL:** [https://portal.sedierp.com/API\_FAC/api/EstadosCuenta/GenerarEstadoCuentaArrendatariosGBI](https://portal.sedierp.com/API_FAC/api/EstadosCuenta/GenerarEstadoCuentaArrendatariosGBI)\
**Tipo:** GET \
**Respuesta:** application/pdf

Los parámetros se envían en la URL (query string).

**TerceroID** `int` *required*

Código único del cliente arrendatario (ID).

**ContratoID** `int` *required*

Código único del contrato de arrendamiento (ID) para el que se genera el estado de cuenta.

**FechaInicial** `string` *required*

Fecha inicial del estado de cuenta, en formato `dd-MM-yyyy` o `dd/MM/yyyy` (ej. 01-02-2026).

**FechaFinal** `string` *required*

Fecha final del estado de cuenta, en formato `dd-MM-yyyy` o `dd/MM/yyyy` (ej. 30-04-2026).

**Attachment** `string`

Forma de entrega del PDF.

| Valor | Respuesta |
| - | - |
| true | Descarga el PDF como archivo adjunto con el nombre "EstadoCuenta.pdf". |
| false | Visualiza el PDF en línea en el navegador. |
| (vacío) o null | Retorna un JSON con el PDF codificado en base64. |

Cualquier valor diferente de `true` (incluidos `1` y `0`) se trata como `false` y el PDF se visualiza en línea.

**UUID** `GUID` *required*

Identificador único de la empresa.

**Token** `GUID` *required*

Token de sesión del cliente.

```bash theme={null}
curl --location 'https://portal.sedierp.com/API_FAC/api/EstadosCuenta/GenerarEstadoCuentaArrendatariosGBI?TerceroID=48213&ContratoID=6045&FechaInicial=01-02-2026&FechaFinal=30-04-2026&Attachment=true&UUID=2be0e514-4eb7-4677-b4b0-4a08936bfbee&Token=8a3f1c52-6d7e-4b90-a1c4-2f5e9d7b3a10' \
--output estado-cuenta.pdf
```

### Validaciones

El servicio realiza las siguientes validaciones antes de generar el estado de cuenta. Si alguna no se cumple, no se genera el estado de cuenta y se retorna HTTP 400 con el mensaje correspondiente en texto plano.

* `TerceroID` es obligatorio, numérico y diferente de 0.
* `Token` es obligatorio. `UUID` y `Token` deben tener formato GUID.
* El `UUID` debe corresponder a una empresa; de lo contrario se retorna "No se encontraron datos para generar".

> [!NOTE]
>
> Las fechas en un formato diferente a `dd-MM-yyyy` o `dd/MM/yyyy` (por ejemplo `2026-02-01`) no generan error: se toman como no enviadas. Un `ContratoID` no numérico se toma como 0.

### Respuesta

Según el parámetro `Attachment`, el servicio retorna:

* **`Attachment=true`:** el archivo PDF (`Content-Type: application/pdf`) con el encabezado `Content-Disposition: attachment` y el nombre "EstadoCuenta.pdf", para que el navegador lo descargue.
* **`Attachment=false`:** el archivo PDF (`Content-Type: application/pdf`) sin nombre de archivo, para que el navegador lo muestre en línea.
* **`Attachment` vacío o null:** un JSON con los siguientes campos:

**File** `string`

Contenido del PDF codificado en base64.

**TypeFile** `string`

Tipo de contenido del archivo: "application/pdf".

```bash Request theme={null}
curl --location 'https://portal.sedierp.com/API_FAC/api/EstadosCuenta/GenerarEstadoCuentaArrendatariosGBI?TerceroID=48213&ContratoID=6045&FechaInicial=01-02-2026&FechaFinal=30-04-2026&Attachment=true&UUID=2be0e514-4eb7-4677-b4b0-4a08936bfbee&Token=8a3f1c52-6d7e-4b90-a1c4-2f5e9d7b3a10' \
--output estado-cuenta.pdf
```

```text Descarga theme={null}
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename=EstadoCuenta.pdf; filename*=UTF-8''EstadoCuenta.pdf

(contenido binario del PDF)
```

```json Base64 theme={null}
{
    "File": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PC9UeXBlL0NhdGFsb2cvUGFnZXMgMiAwIFI+PgplbmRvYmoK...",
    "TypeFile": "application/pdf"
}
```

```text Error theme={null}
El parametro TerceroID es obligatorio
```

```text Sin resultados theme={null}
No se encontraron datos para generar
```


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