Conecta tu taller con los demás sistemas que usas
Con la API REST de Promec, tu contador, tu ERP, el administrador de flotillas de un cliente o tu propio sitio web leen y registran datos del taller sin mandar archivos de Excel de un lado a otro. La activa la dirección del taller, con permisos por área y un registro de cada solicitud.
- 56endpoints en la v1
- 42eventos de webhook
- 60solicitudes 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"
}- Propósito declarado en cada clave
- Cada clave ligada a un solo taller
- Webhooks firmados HMAC-SHA256
- Registro de solicitudes por 90 días
- Idempotency-Key en escrituras
- Facturación con la numeración fiscal del sistema
Para qué la usan los talleres
Integraciones que nos piden en serio. Si la tuya no está, cuéntanos: casi siempre se resuelve con los endpoints que ya existen.
Contador y contabilidad
Tu despacho contable descarga cada mes las facturas emitidas con su PDF y los cobros, sin tener que pedírtelos por correo. Tu sistema también puede facturar una cotización aprobada y registrar el cobro: la factura sale con la numeración fiscal del sistema.
ERP del grupo o la agencia
Si el taller es parte de un grupo o de una agencia, sincroniza clientes, vehículos y cotizaciones con el sistema central y recibe un aviso en cuanto se emite una factura.
Flotillas y arrendamiento
El administrador de la flotilla ve en qué etapa va cada unidad y cuándo le toca la revisión técnica, y recibe un webhook cuando entra al taller, cuando está lista y cuando se entrega.
Proveedores de repuestos
Un distribuidor puede abrir cotizaciones con el número de parte ya capturado en cada partida, o leer las partidas de una reparación para armar el pedido.
Tu sitio web o tu app
Tu sitio consulta los horarios libres de la agenda real y propone la cita. Tú la confirmas con un clic o, si trabajas en modo reserva, queda agendada directamente.
Make, n8n o Zapier
Recibe los eventos por webhook y arma la cadena que necesites: una tarea en tu CRM cuando rechazan una cotización o una fila en una hoja cada vez que entra un pago. Y si tienes tu propio bot o IA, puede contestar los WhatsApp, SMS, chats y correos del taller.
Cómo funciona
De la primera clave a la integración en producción, sin configurar servidores. La API ya viene en tu Promec.
- Crea una clave de pruebaEn «Desarrolladores / API», la dirección del taller crea la clave con un nombre, el propósito de la integración y los permisos por área. La clave completa se muestra una sola vez.
- Llama a /pingCon la URL de tu taller (https://<su-dominio>/api/v1). Te regresa los permisos de la clave y el cupo que te queda hoy.
- Desarrolla con datos realesLas claves pt_test_ de tu taller leen sus datos pero no crean, modifican ni envían nada, y no consumen cupo. Para probar también escrituras, aceptaciones, facturas y mensajes, usa el entorno de pruebas público.
- Pasa a live y suscribe webhooksCuando todo cuadra, creas una clave pt_live_ y registras la URL que va a 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 una integración puede leer y escribir en la versión 1. Cada recurso tiene su permiso, así cada clave ve solo lo que necesita.
Clientes
Búsqueda por nombre, teléfono o email, alta y edición de clientes con sus datos de contacto.
- GET
/clients - POST
/clients - GET
/clients/{id} - PATCH
/clients/{id}
Vehículos
Búsqueda por placa o por cliente, alta y edición, con kilometraje y vencimiento de la verificación.
- GET
/vehicles - POST
/vehicles - GET
/vehicles/{id} - PATCH
/vehicles/{id} - +1 más
Cotizaciones
Crear cotizaciones con sus conceptos, cambiar el estado y adjuntar fotos o PDF. Aceptarlas o rechazarlas en nombre del cliente, con la evidencia de quién y por qué canal.
- GET
/budgets - POST
/budgets - GET
/budgets/{id} - GET
/budgets/{id}/activity - +7 más
Facturas y PDF
Facturas emitidas con sus conceptos, totales por tasa de impuesto, cobros y el PDF original. Facturar una cotización aprobada y registrar cobros, con la numeración fiscal del sistema.
- POST
/budgets/{id}/invoice - GET
/invoices - GET
/invoices/{id} - GET
/invoices/{id}/pdf - +1 más
Citas
Horarios libres con la lógica de la agenda (horarios, bahías y días festivos), propuestas y reservas confirmadas.
- GET
/appointments - POST
/appointments - GET
/appointments/availability - DELETE
/appointments/{id} - +2 más
Catálogo
Servicios y tarifas del taller, para que tu web o tu cotizador muestren los mismos precios.
- GET
/catalog/services - GET
/catalog/rates
Refacciones
Existencias, referencias y precio de venta del inventario. El costo y el proveedor nunca salen por la API.
- GET
/stock - GET
/stock/{id}
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
Conversaciones
WhatsApp, SMS, chat y correo en una lista, como la Bandeja del sistema: lee el hilo y responde como el taller.
- GET
/conversations - GET
/conversations/{key}/messages - POST
/conversations/{key}/messages - GET
/messages/templates
Asistente externo
Elige en qué canales contesta tu bot o IA en lugar del asistente del sistema, con respaldo automático si no responde en 10 minutos.
- GET
/settings/assistant - PUT
/settings/assistant
Webhooks
Suscripciones por evento, con firma HMAC-SHA256, reintentos y un envío de prueba cuando lo necesites.
Algunos eventos
Entorno de pruebas
Instancia pública con datos ficticios para probar escrituras, aceptaciones, facturas y mensajes sin riesgo, con claves pt_test_ de 30 días.
- POST
/sandbox/keys - POST
/sandbox/simulate/message
Diseñada para integraciones que no fallan
Los detalles que suelen complicar una integración, resueltos desde el inicio.
Claves que crea la dirección
El dueño o el gerente del taller crea cada clave con un nombre, el propósito de uso y sus permisos. La clave completa se muestra una sola vez; después solo se ve su prefijo.
Permisos por área
Clientes, vehículos, cotizaciones, facturas, citas, catálogo y comunicaciones, con lectura y, donde tiene sentido, escritura. La clave del contador no necesita ver la agenda.
Pruebas y producción
Las claves pt_test_ de tu taller leen datos reales pero no pueden crear ni modificar nada, y no consumen cupo. Para probar escrituras, aceptaciones, facturas y mensajes hay un entorno de pruebas público con datos ficticios. Cuando la integración ya funciona, se crea una pt_live_.
Webhooks firmados
Promec avisa a tu URL cuando pasa algo: más de 40 eventos, desde «cotización aceptada» hasta «vehículo listo». Cada envío va firmado con HMAC-SHA256 y se reintenta hasta 5 veces si tu servidor no responde.
Límites a la vista
60 solicitudes por minuto por clave (ampliable a 600) más el cupo diario de tu plan. Cada respuesta incluye X-RateLimit-Remaining y, si te pasas, un 429 con Retry-After.
Altas sin duplicados
Todo POST lleva Idempotency-Key: si tu sistema reintenta la misma operación porque se cayó la red, no se crea un segundo cliente ni una segunda cotización.
Seguridad y protección de datos
Una integración no debería abrir más puertas de las necesarias. Así está diseñada:
Cada clave es de un solo taller
Solo se guarda su huella, ligada a la instancia del taller: no funciona en ningún otro y nadie puede recuperarla, ni nosotros.
Propósito obligatorio
Al crear la clave hay que escribir para qué se van a usar los datos. Queda junto a la clave y en el registro, por si un cliente pregunta.
Lo interno no sale
Costos, márgenes, notas internas y cotizaciones de uso interno no aparecen en ninguna respuesta. Del personal del taller solo se ve el id y el nombre.
Registro de cada solicitud
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 vencimiento
Puedes limitar una clave a las IPs del proveedor que la usa y ponerle fecha de vencimiento. Revocarla surte efecto al instante.
La aceptación deja huella
Aceptar o rechazar una cotización por API exige un permiso aparte (budgets:accept) y la evidencia de quién acepta y por qué canal. Queda en el historial como «Aceptada por API en nombre del cliente», con el nombre de la clave.
Planes de la API
Son aparte del plan de Promec. Empiezas con el Incluido y subes solo si necesitas registrar datos, recibir webhooks o más volumen.
- 1 clave live
- Solo lectura, todas las áreas
- 2,000 solicitudes al día
- Al llegar al cupo, se pausa hasta las 00:00 UTC
- 5 claves live
- Lectura y escritura
- Webhooks
- Aceptar cotizaciones y facturar
- 20,000 solicitudes al día
- Claves ilimitadas
- Todo lo de Developer
- Mensajes por API (correo, SMS, WhatsApp y chat) y asistente externo en tus canales (los mensajes se cobran aparte)
- 100,000 solicitudes al día
- Soporte por email
- Para empresas que conectan su producto con varios talleres
- Cupo, claves y permisos a la medida
- Precio por volumen
Precios sin impuestos, en euros como el resto de los planes de Promec. Las claves de prueba no tienen costo ni cuentan para el cupo, igual que las pruebas desde el panel. Si en un mes Developer o Business rebasan su cupo (cupo diario × días del mes), el excedente se cobra a 1 € por cada 1,000 solicitudes.
Preguntas frecuentes
¿Tengo que pagar para usar la API?
No. El plan Incluido viene con cualquier plan de Promec: una clave de solo lectura y 2,000 solicitudes al día. Solo pagas si necesitas registrar datos, webhooks o más volumen.
¿Dónde veo la URL de la API de mi taller?
En la sección «Desarrolladores / API» de Promec. Cada taller trabaja en su propio dominio, así que la URL base tiene la forma https://<su-dominio>/api/v1.
¿Puedo emitir facturas por la API?
Sí, con un permiso aparte (invoices:write), desde el plan Developer. La API usa la facturación del propio sistema: serie, numeración correlativa, registro fiscal y asiento contable. Se factura una cotización aprobada, nunca se crea una factura suelta, y las rectificativas se hacen desde el sistema.
¿Y si la integración se equivoca?
Con una clave de prueba no puede modificar nada. Con una live, cada cambio queda en el historial del cliente o de la cotización como «API · nombre de la clave», y la clave se revoca al instante.
¿Hay SDK o colección de Postman?
Con el archivo OpenAPI 3.1 generas un cliente en el lenguaje que uses. Dentro de Promec también tienes la colección de Postman y un panel para probar cada endpoint con tu clave.
Desarrollo software para talleres, ¿me puedo conectar a varios?
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 revisamos.
¿Qué pasa si rebaso el límite de solicitudes?
Cada clave admite 60 solicitudes por minuto. Si te pasas, la API responde 429 con el encabezado 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 excedente se cobra a 1 € por cada 1,000 solicitudes.
¿La API puede aceptar una cotización en nombre del cliente?
Sí, con el permiso budgets:accept (plan Developer o superior) y solo si indicas la evidencia: quién acepta y por qué canal (teléfono, en persona, correo, WhatsApp…). Pasa por la misma regla de aceptación del sistema y en el historial queda «Aceptada por API en nombre del cliente» con el nombre de la clave. El cliente sigue pudiendo aceptar desde su enlace de seguimiento; la API no entrega ese enlace.
¿Hay un entorno de pruebas?
Sí, público y gratuito: https://demo.programa-taller.es/desarrolladores-sandbox. Te da una clave pt_test_ de 30 días con escritura habilitada sobre datos ficticios que se restauran cada 2 horas. No sale nada de verdad (los envíos se registran como simulados) y los webhooks se emiten igual, así pruebas el ciclo completo. Tus claves y webhooks se conservan entre reinicios.
¿Mi propio bot puede contestarles a los clientes del taller?
Sí, desde el plan Business. Activas el «asistente externo» en los canales que quieras (WhatsApp, SMS, chat web o correo): cada mensaje del cliente te llega por el webhook message.received y respondes por la API. Si no contestas en 10 minutos, o tu clave o tu webhook dejan de funcionar, el asistente del sistema responde por ti.
¿Ya tienes una integración en mente?
Cuéntanos qué quieres conectar y te decimos qué endpoints usar y qué plan te conviene.