Casos de uso del servidor MCP
Conecta tu asistente de IA (Claude, por ejemplo) al servidor MCP de Ticketbai WS 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 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.
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 %.
Esta es la factura que voy a emitir en la serie A:
¿La emito?
Sí, emítela.
ticketbai_post ticketbai_get ¡Hecho! He emitido la factura y Hacienda la ha aceptado.
TBAI-B01010101-041126-3fKq8Lw2pXnZ9-153¿Quieres que se la envíe por email al cliente?
«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
ticketbai_postcrea la factura: Ticketbai WS la firma, la encadena y devuelve al momento la huella y el QR.- El envío a Hacienda va en segundo plano (
PENDING), así que el asistente confirma el resultado conticketbai_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
}Registra en el LROE esta factura de mi proveedor.
📎 factura-suministros-octubre.pdfEs 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.
lroe_recibidas_post 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.
«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
- El asistente lee el PDF y prepara los datos: proveedor, número, fecha, descripción y bases imponibles.
- El LROE pide el tipo de cada factura recibida (
compras,inversionogasto). Si la factura no lo deja claro, el asistente te lo pregunta. lroe_recibidas_postregistra 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 }]
}]
}Envía a mi gestoría (gestoria@ejemplo.com) las facturas del tercer trimestre.
ticketbai_list_get Correo · enviar mensaje Enviado. He mandado a tu gestoría el resumen del tercer trimestre con el listado de facturas adjunto:
«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
ticketbai_list_getdevuelve las facturas del periodo con su importe y su estado en Hacienda.- 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/2026Sí, mándale la factura A-2026-0157 a admin@talleres-ejemplo.es.
tbai_pdf_get Correo · enviar mensaje Enviada. Le he mandado la factura en PDF, con el código QR de TicketBAI:
«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
tbai_pdf_getdescarga el PDF de la factura, con su QR.- 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-0157Má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.