# Casos de uso del servidor MCP

Conecta tu asistente de IA (Claude, por ejemplo) al [servidor MCP de Ticketbai WS](https://ticketbaiws.eus/es/desarrolladores/mcp/) y factura hablando. Estas son conversaciones de ejemplo, con las herramientas reales que usa el asistente en cada caso.

### 1. El conector de Ticketbai WS

Añade el [servidor MCP](https://ticketbaiws.eus/es/desarrolladores/mcp/) a tu asistente con el token y el NIF de tu empresa. Empieza en el entorno de pruebas.

### 2. Un conector de correo (opcional)

Para enviar facturas por email, tu asistente necesita también su conector de correo (Gmail, Outlook…). El correo sale desde tu cuenta, no desde Ticketbai WS.

### 3. Revisa antes de emitir

En producción las facturas tienen validez fiscal: pide al asistente que te enseñe los datos y confirma antes de emitir.

   Asistente de IA · Ticketbai WS Ejemplo simulado

Hazme una factura para **Talleres Ejemplo S.L.** (B01000012, Calle Mayor 12, 48001 Bilbao) por la reparación de su bomba de agua: 2 horas de mano de obra a 45 € y un rodete nuevo de 60 €. IVA al 21 %.

IA

Esta es la factura que voy a emitir en la serie A:

Mano de obra · 2 h × 45,00 € **90,00 €**

Rodete para bomba de agua · 1 × 60,00 € **60,00 €**

Base imponible **150,00 €**

IVA 21 % **31,50 €**

Total **181,50 €**

¿La emito?

Sí, emítela.

IA

✓ `ticketbai_post` POST /tbai/ · PENDING

✓ `ticketbai_get` GET /tbai/ · OK

¡Hecho! He emitido la factura y **Hacienda la ha aceptado**.

Factura A-2026-0157 ACEPTADA

Cliente **Talleres Ejemplo S.L.**

Total **181,50 €**

 `TBAI-B01010101-041126-3fKq8Lw2pXnZ9-153`

¿Quieres que se la envíe por email al cliente?

Caso 1

## «Hazme una factura de la reparación de la bomba»

Le describes la factura como se la describirías a una persona y el asistente rellena los datos, calcula los importes y te los enseña antes de emitir.

### Qué pasa por debajo

1. `ticketbai_post` crea la factura: Ticketbai WS la firma, la encadena y devuelve al momento la huella y el QR.
2. El envío a Hacienda va en segundo plano (`PENDING`), así que el asistente confirma el resultado con `ticketbai_get`.

**Ver la llamada a la API**

```
POST /tbai/
{
  "fecha": "04/11/2026", "hora": "10:24:00",
  "serie": "A", "numero": "2026-0157",
  "simplificada": false, "rectificativa": false,
  "nif": "B01000012", "nombre": "Talleres Ejemplo S.L.",
  "direccion": "Calle Mayor 12", "cp": "48001",
  "lineas": [
    { "descripcion": "Mano de obra", "cantidad": 2, "importe_unitario": 45.00, "tipo_iva": 21, "tipo_req": 0 },
    { "descripcion": "Rodete para bomba de agua", "cantidad": 1, "importe_unitario": 60.00, "tipo_iva": 21, "tipo_req": 0 }
  ],
  "retencion": 0, "total_factura": 181.50
}
```

   Asistente de IA · Ticketbai WS Ejemplo simulado

Registra en el LROE esta factura de mi proveedor.

📎 factura-suministros-octubre.pdf

IA

Es la factura F-2026-0981 de Suministros Hidráulicos Ejemplo S.A.: 600,00 € + 126,00 € de IVA, por «compra de rodetes y juntas». Para el LROE necesito saber de qué tipo es:

**¿Compra de bienes corrientes, adquisición de bienes de inversión o gasto?**

Compra de bienes corrientes: son piezas para las reparaciones.

IA

✓ `lroe_recibidas_post` POST /lroe-recibidas/ · Batuz

Listo: he registrado la factura en el **LROE de Batuz** como compra de bienes corrientes del ejercicio 2026 y Hacienda la ha dado por correcta.

F-2026-0981 · Suministros Hidráulicos Ejemplo S.A. CORRECTA

Fecha **28/10/2026**

Descripción **Compra de rodetes y juntas**

Base imponible **600,00 €**

IVA soportado 21 % **126,00 €**

Total **726,00 €**

Caso 2 · Bizkaia

## «Envía esta factura al LROE»

Si tu empresa está en Bizkaia, las facturas que recibes de tus proveedores también van a Hacienda, en el LROE de Batuz. Pasa al asistente el PDF de la factura y él extrae los datos y la registra.

### Qué pasa por debajo

1. El asistente lee el PDF y prepara los datos: proveedor, número, fecha, descripción y bases imponibles.
2. El LROE pide el tipo de cada factura recibida (`compras`, `inversion` o `gasto`). Si la factura no lo deja claro, el asistente te lo pregunta.
3. `lroe_recibidas_post` registra la factura en el capítulo de facturas recibidas del LROE.

**Ver la llamada a la API**

```
POST /lroe-recibidas/
{
  "ejercicio": 2026,
  "facturas": [{
    "fecha": "28/10/2026",
    "nif": "B01000020", "nombre_social": "Suministros Hidráulicos Ejemplo S.A.",
    "num_factura": "F-2026-0981",
    "descripcion": "Compra de rodetes y juntas",
    "tipo_factura": "compras", "importacion": false, "rectificativa": false,
    "importe_total": 726.00,
    "bases": [{ "base_imponible": 600.00, "tipo_iva": 21, "tipo_req": 0 }]
  }]
}
```

   Asistente de IA · Ticketbai WS + correo Ejemplo simulado

Envía a mi gestoría (gestoria@ejemplo.com) las facturas del tercer trimestre.

IA

✓ `ticketbai_list_get` 01/07/2026 – 30/09/2026 · 48 facturas

✓ `Correo · enviar mensaje` tu conector de email

Enviado. He mandado a tu gestoría el resumen del tercer trimestre con el listado de facturas adjunto:

3.er trimestre 2026 ENVIADO

Facturas emitidas **48**

Base imponible **12.480,00 €**

IVA repercutido **2.620,80 €**

Aceptadas por Hacienda **48 de 48**

 facturas-2026-T3.csv

Caso 3

## «Envía las facturas del trimestre a mi gestoría»

Al cerrar el trimestre, pide al asistente que reúna tus facturas y se las mande a quien te lleva la contabilidad, con el resumen ya hecho.

### Qué pasa por debajo

1. `ticketbai_list_get` devuelve las facturas del periodo con su importe y su estado en Hacienda.
2. El asistente calcula el resumen, prepara el listado y lo envía con **tu conector de correo**. Ticketbai WS no envía el email.

**Ver la llamada a la API**

```
GET /tbai-list/?fecha_inicio=01/07/2026&fecha_fin=30/09/2026
```

   Asistente de IA · Ticketbai WS + correo Ejemplo simulado

Sí, mándale la factura A-2026-0157 a admin@talleres-ejemplo.es.

IA

✓ `tbai_pdf_get` GET /tbai-pdf/ · A-2026-0157

✓ `Correo · enviar mensaje` tu conector de email

Enviada. Le he mandado la factura en PDF, con el código QR de TicketBAI:

Para admin@talleres-ejemplo.es

Asunto Factura A-2026-0157 · Reparación de bomba de agua

Mensaje Hola, os adjuntamos la factura de la reparación. Un saludo.
 factura-A-2026-0157.pdf

Caso 4

## «Envía la factura al cliente por email»

Justo después de emitirla, o semanas más tarde: el asistente descarga el PDF de la factura y se lo envía al cliente desde tu correo.

### Qué pasa por debajo

1. `tbai_pdf_get` descarga el PDF de la factura, con su QR.
2. El asistente escribe el mensaje y lo envía con **tu conector de correo**, adjuntando el PDF.

**Ver la llamada a la API**

```
GET /tbai-pdf/?serie=A&numero=2026-0157
```

## Más ideas

- «¿Ha aceptado Hacienda todas las facturas de ayer? Dime cuáles han dado error y por qué.»
- «El cliente ha devuelto el rodete: haz la rectificativa de la factura A-2026-0157.»
- «Convierte en factura completa los tickets 0412 y 0413 para Talleres Ejemplo.»
- «Anula la factura A-2026-0160, la emití por error.»

Las conversaciones de esta página son ejemplos simulados: las respuestas reales dependen de tu asistente y de los datos de tu empresa. Revisa siempre importes, clientes e IVA antes de emitir en producción.

[Configura el servidor MCP →](https://ticketbaiws.eus/es/desarrolladores/mcp/)

Fuente: https://ticketbaiws.eus/es/desarrolladores/casos-de-uso-mcp/