API de ficheros ECU para programas de taller y revendedores
Pide ficheros ECU y TCU desde tu propio programa de gestión o tu portal de reventa, sin entrar en el panel. Los pedidos entran en la misma cola y los atienden los mismos ingenieros: cada fichero lo prepara y lo revisa una persona.
REST + JSON · Webhooks firmados · Claves de pruebas incluidas · OpenAPI 3.1
Qué hace la API
Tu programa crea el pedido, sube la lectura original, sigue la conversación con el técnico y descarga el fichero modificado. Cada pedido lleva tu número de orden de trabajo, así que el fichero vuelve a la ficha del coche sin copiar nada a mano. Es el mismo File Service de siempre, conectado a tu software.
Los ficheros se pagan igual que en el panel: con los créditos de tu cuenta, al mismo precio, y se descuentan cuando el técnico entrega. El plan mensual solo paga el acceso a la API (claves, webhooks y volumen de llamadas); no incluye ficheros.
En resumen
- Pedidos con lecturas de hasta 50 MB, enviados desde tu programa.
- Avisos firmados cuando el fichero está listo, cuando el técnico necesita un dato o cuando te escribe.
- Cada fichero se paga con créditos, al precio del panel; el plan cubre solo la integración.
- Claves de pruebas en todos los planes, que no crean pedidos ni gastan créditos.
A quién va dirigida
A quien ya trabaja con su propio software y no quiere duplicar cada pedido en dos sitios.
Talleres con programa de gestión
El pedido sale de la orden de trabajo y el fichero vuelve a ella cuando está listo.
Redes y franquicias
Varias sucursales pidiendo ficheros desde el mismo sistema, cada una con su referencia.
Revendedores con portal propio
Tus clientes piden en tu web y nuestros ingenieros preparan el fichero por detrás.
Desarrolladores de software de taller
Añade el servicio de ficheros a tu producto con una API documentada y una especificación OpenAPI.
Un pedido en tres pasos
Permiso de subida
POST /uploads devuelve una URL firmada y tu programa sube la lectura original con un PUT.
Crear el pedido
POST /orders con el vehículo, la centralita, la herramienta de lectura, los servicios y tu referencia.
Aviso y descarga
Llega el webhook order.completed y tu programa descarga el fichero con GET /orders/{id}/file.
Planes de acceso a la API
Sin cuota de alta ni permanencia. Se contratan en el panel con pago mensual y cada cuota emite su factura con Verifactu.
API Taller
59 € /mes
- Hasta 50 ficheros al mes por API
- 1 clave de producción + claves de pruebas
- 2 webhooks
- 2.000 llamadas al día
- Catálogo de vehículos y servicios
- Soporte por email
API Pro
149 € /mes
- Hasta 250 ficheros al mes por API
- 5 claves de producción + claves de pruebas
- 10 webhooks
- 10.000 llamadas al día
- Catálogo de vehículos y servicios
- Soporte prioritario
API Empresa
desde 349 € /mes
- Ficheros sin límite
- Claves y webhooks sin límite
- Varias sucursales bajo una cuenta
- Acuerdo de nivel de servicio
- Integración asistida
- Soporte prioritario
Precio al mes sin IVA. Los ficheros se pagan con los créditos de tu cuenta, al mismo precio que en el panel, y se descuentan al entregarlos: los planes no incluyen ficheros, solo el derecho a enviarlos por la API hasta el límite de cada uno. El plan Empresa se pide desde el panel, por WhatsApp o por email.
Las claves de pruebas (rp_test_) están incluidas en todos los planes: validan cada llamada y devuelven las mismas respuestas que en producción, sin crear pedidos ni gastar créditos.
Un pedido completo en tres llamadas
# 1) Permiso de subida
curl -X POST https://app.repromatronic.es/api/v1/uploads \
-H "Authorization: Bearer rp_live_XXXXXXXX" -H "Content-Type: application/json" \
-d '{"filename":"original.bin","size":1048576}'
# → { "file_path": "...", "upload_url": "https://...", "method": "PUT" }
# 2) Crear el pedido
curl -X POST https://app.repromatronic.es/api/v1/orders \
-H "Authorization: Bearer rp_live_XXXXXXXX" -H "Content-Type: application/json" \
-d '{"file_path":"<file_path>","vehicle_category_id":"<id>","plate":"1234ABC",
"make":"Audi","model":"A4","engine":"2.0 TDI 150 CV","year":2019,"power_hp":150,
"km":85000,"gearbox":"manual","tool":"KESS3","ecu":"Bosch EDC17C74",
"services":["<service_id>"],"external_ref":"OT-2026-0412"}'
# 3) Cuando llega el webhook order.completed
curl https://app.repromatronic.es/api/v1/orders/<id>/file \
-H "Authorization: Bearer rp_live_XXXXXXXX"
# → { "url": "https://…", "filename": "…", "expires_in": 3600 }La referencia external_ref (tu número de orden de trabajo) evita pedidos duplicados si tu programa repite una llamada.
Endpoints
Base: https://app.repromatronic.es/api/v1. Campos, errores y ejemplos en la documentación completa.
| Método | Ruta | Qué hace |
|---|---|---|
| GET | /me | Cuenta, saldo de créditos, plan y consumo del mes |
| GET | /services | Categorías, servicios con coste en créditos, complementos |
| GET | /vehicles/… | Marcas, modelos, generaciones y motores |
| POST | /uploads | Permiso de subida firmado |
| GET · POST | /orders | Listar (filtros status, since, plate, external_ref) y crear pedidos |
| GET | /orders/{id} · /file · /original | Detalle, fichero modificado y original |
| GET · POST | /orders/{id}/messages | Conversación con el técnico |
| POST | /orders/{id}/revision · /cancel | Revisión gratuita (30 días) o cancelar en cola |
| GET · POST · PATCH · DELETE | /webhooks | Gestionar webhooks y enviar un evento de prueba |
Límites: 120 llamadas por minuto por clave, más las llamadas diarias y los ficheros mensuales de cada plan.
Webhooks y seguridad
Registra una URL de tu programa y te avisamos de cada cambio: order.completed cuando el fichero está listo, order.needs_info cuando el técnico necesita un dato, order.message cuando te escribe y el resto de cambios de estado.
Cada aviso lleva la cabecera X-Repromatronic-Signature: t=…,v1=…: un HMAC-SHA256 de ${t}.${cuerpo} calculado con tu secreto sin el prefijo rpwh_. Comprueba la firma sobre el cuerpo tal como llega y descarta las que tengan más de 5 minutos.
Tu servidor debe contestar con un 2xx en menos de 8 segundos. Si no lo hace, reintentamos hasta 7 veces con esperas cada vez más largas, de 1 minuto a 12 horas, así que una caída corta de tu lado no te hace perder avisos.
Buenas prácticas
- Trata la clave de la API como una contraseña: nunca en el navegador ni en un repositorio.
- Si una clave se filtra, revócala en el panel y crea otra.
- Prueba primero con una clave
rp_test_y el evento de prueba de/webhooks. - Guarda tu número de orden en
external_refpara no duplicar pedidos.
Preguntas frecuentes
¿Cuánto cuesta cada fichero por API?
Lo mismo que en el panel: se paga con los créditos de tu cuenta y se descuenta al entregar el fichero. El plan solo cubre el acceso a la API.
¿Los 59 € incluyen ficheros?
No. Incluyen el acceso a la API y el derecho a enviar hasta 50 ficheros al mes por ella. Cada fichero se paga aparte con créditos.
¿Mi programa tiene que ser especial?
No. Vale cualquier programa que haga peticiones HTTPS: PHP, .NET, Node, Python, Java… Si usas un programa comercial, pásale la documentación a su proveedor.
¿Cómo sé cuándo está listo el fichero?
Te llega el webhook order.completed y lo descargas con GET /orders/{id}/file.
¿Puedo probar sin gastar créditos?
Sí, con las claves de pruebas rp_test_: no crean pedidos ni gastan créditos.
¿Puedo revenderlo con mi marca?
Sí. El plan Empresa admite varias sucursales bajo una cuenta, y el certificado de reprogramación sale con tu marca si activas la marca propia en el panel.
¿Hay permanencia o cuota de alta?
No. Pago mensual y baja desde el panel cuando quieras.
Móntalo esta semana
Abre la documentación, crea una clave de pruebas en el panel y envía tu primer pedido de prueba. Si necesitas ayuda con la integración, escríbenos.
info@repromatronic.es · WhatsApp +34 627 21 91 30 · Técnicos de 8:00 a 22:00, todos los días