# Liquidaciones, depósitos y facturación

> Herramientas del MCP para consultar la próxima liquidación, el historial de liquidaciones, los depósitos de garantía y las facturas que Tilopay le emite al comercio.

- kind: mcp-tool
- status: stable
- access: write
- last_verified: 2026-10-07
- url: https://tilopay.com/developers/agentes/mcp/liquidaciones

## Qué cubre [#que-cubre]

Este grupo cubre el dinero que Tilopay le liquida al comercio: el balance por liquidar y la fecha del
próximo depósito, las liquidaciones ya procesadas con sus transacciones, los depósitos de garantía
(preautorizaciones retenidas a clientes) y las facturas que Tilopay emite por el uso de la
plataforma. Todo es de lectura salvo extender un depósito de garantía, que exige un código de seis
dígitos que llega por correo.

## Herramientas [#herramientas]

### Próxima liquidación y balance por liquidar [#tilopay-settlement-balance]

- `tilopay_settlement_balance`
- Acceso: Sólo lectura

Dato OFICIAL de Tilopay: fecha del próximo depósito (next_settlement), frecuencia de liquidación, cuenta IBAN destino y, por moneda, el balance acumulado pendiente con su desglose (subtotal, commission, iva_commission, retention, retention_iva, cost, iva_tilopay, transfer, transfer_iva, total neto). Úsala para «¿cuándo me depositan?», «¿cuánto me van a liquidar?», «¿cuánto me cobran de comisión?».

**Parámetros**

Sin parámetros.

**Devuelve**



### Historial de liquidaciones [#tilopay-settlements-list]

- `tilopay_settlements_list`
- Acceso: Sólo lectura

Liquidaciones ya procesadas por Tilopay: fecha de depósito (date_to_report), periodo, monto bruto, deducciones y total transferido. Úsala para «¿ya me depositaron lo del viernes?» o «¿cuánto me depositaron el mes pasado?».

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `page` | integer | — | Página (por defecto 1) |
| `limit` | integer | — | Registros por página (por defecto 20) |
| `search` | string | — | Texto a buscar |

**Devuelve**



### Transacciones de una liquidación [#tilopay-settlement-transactions]

- `tilopay_settlement_transactions`
- Acceso: Sólo lectura

Transacciones incluidas en una liquidación ya procesada (id obtenido de tilopay_settlements_list).

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `settlement_id` | string | sí | Id de la liquidación |

**Devuelve**



### Depósitos de garantía (preautorizaciones) [#tilopay-deposits-list]

- `tilopay_deposits_list`
- Acceso: Sólo lectura

Depósitos de garantía o preautorizaciones retenidas a clientes (renta de autos, hotelería, depósitos de seguridad): monto, estado y vencimiento. No confundir con liquidaciones.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `page` | integer | — | Página (por defecto 1) |
| `limit` | integer | — | Registros por página (por defecto 20) |
| `search` | string | — | Texto a buscar |

**Devuelve**



### Detalle de un depósito de garantía [#tilopay-deposit-detail]

- `tilopay_deposit_detail`
- Acceso: Sólo lectura

Detalle de un depósito de garantía (id de tilopay_deposits_list).

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `deposit_id` | string | sí | Id del depósito |

**Devuelve**



### Extender un depósito de garantía [#tilopay-deposit-extend]

- `tilopay_deposit_extend`
- Acceso: Escritura

Extiende la vigencia de la autorización de un depósito de garantía. Requiere el código de seis dígitos que llega por correo.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `deposit_id` | string | sí | Id del depósito |

**Devuelve**



### Facturas del servicio Tilopay [#tilopay-billing-list]

- `tilopay_billing_list`
- Acceso: Sólo lectura

Facturas que Tilopay le emite al comercio por el uso de la plataforma (no son ventas del comercio). Úsala para «¿cuánto me cobró Tilopay este mes?» o «¿dónde está mi factura de Tilopay?».

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `page` | integer | — | Página (por defecto 1) |
| `limit` | integer | — | Registros por página (por defecto 20) |
| `search` | string | — | Texto a buscar |

**Devuelve**