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.
- 38endpoints en la v1
- 27eventos 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
- Facturas solo desde el 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. Por la API las facturas solo se consultan; se emiten desde el sistema para que la numeración fiscal sea correcta.
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.
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_ leen los datos del taller pero no crean, modifican 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 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}
Cotizaciones
Crear cotizaciones con sus conceptos, cambiar el estado y adjuntar fotos o PDF. Aceptarlas, 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 conceptos, totales por tasa de impuesto, cobros y el PDF original. Solo lectura.
- GET
/invoices - GET
/invoices/{id} - GET
/invoices/{id}/pdf
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}
Catálogo
Servicios y tarifas del taller, para que tu web o tu cotizador muestren 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 un envío de prueba cuando lo necesites.
Algunos eventos
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_ leen datos reales pero no pueden crear ni modificar nada, y no consumen cupo. Cuando la integración ya funciona, se crea una pt_live_.
Webhooks firmados
Promec avisa a tu URL cuando pasa algo: 27 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.
El cliente firma, no la API
La aprobación de una cotización siempre la da el cliente desde su enlace firmado; la API no puede aprobar por él.
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
- 20,000 solicitudes al día
- Claves ilimitadas
- Todo lo de Developer
- Envío de email y SMS por API (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?
No. Las facturas se consultan con su PDF y sus cobros, pero se emiten desde el sistema para que la numeración y el timbrado o envío al fisco de tu país sigan siendo correctos.
¿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?
No. La aceptación siempre la firma el cliente desde su enlace de seguimiento. Si una integración intenta marcar una cotización como aprobada, recibe un 403 con el enlace que hay que hacerle llegar.
¿Ya tienes una integración en mente?
Cuéntanos qué quieres conectar y te decimos qué endpoints usar y qué plan te conviene.