Conecta el taller con el resto de tus programas
La API REST de Programa Taller permite que tu gestoría, tu ERP, el gestor de flotas de un cliente o tu propia web lean y escriban datos del taller sin exportar hojas de cálculo. La activa la gerencia del taller, con permisos por área y un registro de cada petición.
- 38endpoints en la v1
- 27eventos de webhook
- 60peticiones por minuto y clave
curl https://tu-taller.example/api/v1/ping \ -H "Authorization: Bearer pt_test_9f2c…"
{
"ok": true,
"key": { "name": "CRM", "environment": "test",
"scopes": ["clients:read", "budgets:read"] },
"rate_limit": {
"per_minute": { "limit": 60, "remaining": 59 },
"per_day": { "limit": 2000, "remaining": 1999 }
},
"version": "v1"
}- RGPD: finalidad en cada clave
- Clave atada a un solo taller
- Webhooks firmados HMAC-SHA256
- Registro de peticiones 90 días
- Idempotency-Key en escrituras
- Facturas solo desde el programa (Verifactu)
Para qué la usan los talleres
Integraciones que nos piden de verdad. Si la tuya no aparece, cuéntanosla: casi siempre se resuelve con los endpoints que ya existen.
Gestoría y contabilidad
Tu asesoría descarga cada mes las facturas emitidas con su PDF y los cobros, sin pedirte nada por email. Las facturas se leen; emitirlas sigue siendo cosa del programa, para que Verifactu cuadre.
ERP del grupo o concesionario
Si el taller forma parte de un grupo, sincroniza clientes, vehículos y presupuestos con el sistema central y recibe un aviso en cuanto se emite una factura.
Flotas y renting
El gestor de la flota consulta en qué punto está cada coche y cuándo le vence la ITV, y recibe un webhook cuando entra en el taller, cuando está listo y cuando se entrega.
Proveedores de recambios
Un distribuidor puede abrir presupuestos con las referencias de recambio ya puestas en cada partida, o leer las partidas de una reparación para preparar el pedido.
Tu web o tu app
Tu web consulta los huecos libres de la agenda real y propone la cita. Tú la confirmas con un clic o, si trabajas en modo reserva, entra directamente en firme.
Make, n8n o Zapier
Recibe los eventos por webhook y encadena lo que necesites: una tarea en tu CRM cuando se rechaza un presupuesto o una fila en una hoja cada vez que entra un cobro.
Cómo funciona
De la primera clave a la integración en producción, sin tocar servidores. La API ya está en tu programa.
- Crea una clave de pruebaEn «Desarrolladores / API», la gerencia crea la clave con un nombre, la finalidad del uso y los permisos por área. La clave completa se ve una sola vez.
- Llama a /pingCon la URL de tu taller (https://<su-dominio>/api/v1). Te devuelve los permisos de la clave y el cupo que te queda hoy.
- Desarrolla con datos realesLas claves pt_test_ leen los datos del taller pero no crean, cambian ni envían nada, y no gastan cupo. Puedes equivocarte sin consecuencias.
- Pasa a live y suscribe webhooksCuando todo cuadra, creas una clave pt_live_ y das de alta la URL que recibirá los eventos. Cada cambio queda firmado como «API · nombre de la clave».
curl -X POST https://tu-taller.example/api/v1/budgets \ -H "Authorization: Bearer pt_live_4b7e…" \ -H "Idempotency-Key: 7c1d0e52-9a3f-4f0b" \ -H "Content-Type: application/json" \ -d '{"client_id": 1204, "vehicle_id": 871, "lines": [{"description": "Cambio de aceite y filtro", "quantity": 1, "unit_price": 65, "line_type": "labor"}]}'
{
"id": 5821,
"status": "Pendiente",
"channel": "API",
"client_id": 1204,
"totals": { "base": 65, "tax": 13.65, "total": 78.65 },
"tracking_url": "…/public/seguimiento?id=…"
}Recursos disponibles
Lo que puede leer y escribir una integración en la versión 1. Cada recurso tiene su permiso, así que cada clave ve solo lo que necesita.
Clientes
Búsqueda por nombre, teléfono o email, alta y edición de fichas con sus datos de contacto.
- GET
/clients - POST
/clients - GET
/clients/{id} - PATCH
/clients/{id}
Vehículos
Búsqueda por matrícula o por cliente, alta y edición, con kilómetros y vencimiento de la ITV.
- GET
/vehicles - POST
/vehicles - GET
/vehicles/{id} - PATCH
/vehicles/{id}
Presupuestos
Crear presupuestos con sus partidas, cambiar el estado y adjuntar fotos o PDF. Aceptar, solo el cliente desde su enlace.
- GET
/budgets - POST
/budgets - GET
/budgets/{id} - POST
/budgets/{id}/lines - +4 más
Facturas y PDF
Facturas emitidas con sus líneas, totales por tipo de IVA, cobros y el PDF original. Solo lectura.
- GET
/invoices - GET
/invoices/{id} - GET
/invoices/{id}/pdf
Citas
Huecos libres con la lógica de la agenda (horarios, boxes y festivos), propuestas y reservas en firme.
- GET
/appointments - POST
/appointments - GET
/appointments/availability - DELETE
/appointments/{id}
Catálogo
Servicios y tarifas del taller, para que tu web o tu configurador enseñen los mismos precios.
- GET
/catalog/services - GET
/catalog/rates
Comunicaciones
Registro de emails, SMS, WhatsApp y llamadas. Con el plan Business, envío de email y SMS.
- GET
/communications - GET
/logs - POST
/email - POST
/sms
Webhooks
Suscripciones por evento, con firma HMAC-SHA256, reintentos y una entrega de prueba a demanda.
Algunos eventos
Pensada para integraciones que no fallan
Los detalles que suelen dar guerra en una integración, resueltos de serie.
Claves que crea la gerencia
El responsable del taller crea cada clave con un nombre, la finalidad del uso y sus permisos. La clave completa se enseña una sola vez; después solo se ve su prefijo.
Permisos por área
Clientes, vehículos, presupuestos, facturas, citas, catálogo y comunicaciones, con lectura y, donde tiene sentido, escritura. La clave de la gestoría no necesita ver la agenda.
Prueba y producción
Las claves pt_test_ leen datos reales pero no pueden crear ni cambiar nada, y no gastan cupo. Cuando la integración funciona, se crea una pt_live_.
Webhooks firmados
El programa avisa a tu URL cuando pasa algo: 27 eventos, de «presupuesto aceptado» a «vehículo listo». Cada envío va firmado con HMAC-SHA256 y se reintenta hasta 5 veces si tu servidor no contesta.
Límites a la vista
60 peticiones por minuto por clave (ampliable a 600) más el cupo diario del plan. Cada respuesta trae X-RateLimit-Remaining y, si te pasas, un 429 con Retry-After.
Escrituras sin duplicados
Todo POST lleva Idempotency-Key: si tu sistema reintenta la misma operación por un corte de red, no aparece un segundo cliente ni un segundo presupuesto.
Seguridad y RGPD
Una integración no debería abrir más puertas de las necesarias. Así está planteada:
Cada clave es de un solo taller
Solo se guarda su huella, atada a la instancia del taller: no sirve en ningún otro y nadie puede recuperarla, tampoco nosotros.
Finalidad obligatoria
Al crear la clave hay que escribir para qué se van a tratar los datos, como pide el RGPD. Queda junto a la clave y en el registro.
Lo interno no sale
Costes, márgenes, notas internas y presupuestos de uso interno no aparecen en ninguna respuesta. Del personal del taller solo se ve el id y el nombre.
Registro de cada petición
Qué clave, desde qué IP, a qué endpoint y con qué resultado. Se guarda 90 días y se consulta desde la misma sección.
IPs permitidas y caducidad
Puedes limitar una clave a las IPs del proveedor que la usa y ponerle fecha de fin. Revocarla tiene efecto inmediato.
La firma es del cliente
La aceptación de un presupuesto la da siempre el cliente desde su enlace firmado; la API no puede aprobar en su nombre.
Planes de la API
Van aparte del plan del programa. Empiezas con el Incluido y subes solo si necesitas escribir datos, recibir webhooks o más volumen.
- 1 clave live
- Solo lectura, todas las áreas
- 2.000 peticiones al día
- Al llegar al cupo, pausa hasta las 00:00 UTC
- 5 claves live
- Lectura y escritura
- Webhooks
- 20.000 peticiones al día
- Claves ilimitadas
- Todo lo de Developer
- Envío de email y SMS por API (los mensajes se pagan aparte)
- 100.000 peticiones al día
- Soporte por email
- Para empresas que conectan su producto con varios talleres
- Cupo, claves y permisos a medida
- Precio por volumen
Precios sin IVA. Las claves de prueba no tienen coste ni cuentan para el cupo, igual que las pruebas desde el panel. Si en un mes Developer o Business superan su cupo (cupo diario × días del mes), el exceso se cobra a 1 € por cada 1.000 peticiones.
Preguntas frecuentes
¿Tengo que pagar para usar la API?
No. El plan Incluido viene con cualquier plan del programa: una clave de solo lectura y 2.000 peticiones al día. Solo pagas si necesitas escribir datos, webhooks o más volumen.
¿Dónde encuentro la URL de la API de mi taller?
En la sección «Desarrolladores / API» del programa. Cada taller trabaja en su propio dominio, así que la URL base tiene la forma https://<su-dominio>/api/v1.
¿Se pueden emitir facturas por la API?
No. Las facturas se consultan con su PDF y sus cobros, pero se emiten desde el programa para que la numeración y el registro Verifactu sean correctos.
¿Y si la integración se equivoca?
Con una clave de prueba no puede cambiar nada. Con una live, cada cambio queda en el historial del cliente o del presupuesto como «API · nombre de la clave», y la clave se revoca al momento.
¿Hay SDK o colección de Postman?
El fichero OpenAPI 3.1 sirve para generar un cliente en cualquier lenguaje. Dentro del programa tienes además la colección de Postman y un panel para probar cada endpoint con tu clave.
Desarrollo un software para talleres, ¿puedo conectarme a muchos?
Sí, con el plan Partner: cada taller crea su clave para tu producto y acordamos el precio por taller según el volumen. Escríbenos y lo vemos.
¿Qué pasa si supero el límite de peticiones?
Cada clave admite 60 peticiones por minuto. Si te pasas, la API responde 429 con la cabecera Retry-After y tu sistema solo tiene que esperar esos segundos. En el plan Incluido, al agotar el cupo diario se pausa hasta las 00:00 UTC; en Developer y Business se sigue atendiendo y el exceso se cobra a 1 € por cada 1.000 peticiones.
¿La API puede aceptar un presupuesto en nombre del cliente?
No. La aceptación la firma siempre el cliente desde su enlace de seguimiento. Si una integración intenta pasar un presupuesto a «Aprobado», recibe un 403 con el enlace que hay que hacerle llegar.
¿Tienes una integración en mente?
Cuéntanos qué quieres conectar y te decimos qué endpoints usar y qué plan te encaja.