# Comprobantes de cobro

> Herramientas del MCP para listar los comprobantes de los cobros aprobados y reenviarle a un cliente el comprobante de su pago.

- kind: mcp-tool
- status: stable
- access: write
- last_verified: 2026-09-14
- url: https://www.tilopay.com/developers/agentes/mcp/comprobantes

## Qué cubre [#que-cubre]

Cada cobro aprobado que pasa por el agente genera un comprobante con su propio código, una página
para verlo y una imagen para compartir. Con estas dos herramientas el comercio lista los
comprobantes de un período y reenvía uno al cliente por WhatsApp.

El comprobante es un documento informativo del cobro. No es una factura electrónica.

## Herramientas [#herramientas]

### Listar comprobantes de cobro [#tilopay-list-receipts]

- `tilopay_list_receipts`
- Acceso: Sólo lectura

Lista los últimos comprobantes de cobro del comercio (monto, cliente, orden y código). Cada uno tiene una imagen lista para reenviar al cliente. No cobra nada.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `limit` | integer | — | Cuántos comprobantes listar (5 por defecto) |

**Devuelve**

`{ receipts[] }`

receipts = comprobantes de cobro con código, monto, moneda, cliente, número de orden, fecha de pago, enlace de la página del comprobante y enlace de la imagen.

### Reenviar el comprobante de un cobro al cliente [#tilopay-send-receipt]

- `tilopay_send_receipt`
- Acceso: Escritura

Prepara el reenvío del comprobante de un cobro por WhatsApp: devuelve un enlace wa.me con el mensaje y la imagen del comprobante ya listos. Si no se indica el código, usa el comprobante más reciente. Use send_now solo si el usuario pide que se envíe directamente.

**Parámetros**

| Parámetro | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `code` | string | — | Código del comprobante (8 caracteres) |
| `contact_name` | string | — | Nombre del contacto guardado o del cliente |
| `phone` | string | — | Teléfono de WhatsApp, ej. +50688887777 |
| `message` | string | — | Texto propio para acompañar el comprobante |
| `save_contact` | boolean | — | Guardar el contacto en la agenda |
| `send_now` | boolean | — | true envía el comprobante directamente al cliente; por defecto se entrega el enlace wa.me |

**Devuelve**

`{ sent | code, page_url, image_url, whatsapp_url }`

Reenvía el comprobante al cliente por WhatsApp: devuelve el código del comprobante, el enlace de su página, el de la imagen y, cuando no se envía directo, el enlace de WhatsApp listo para abrir.