Inicio›API para programas de taller
EN · EnglishPide ficheros ECU desde tu propio programa, sin abrir el panel
Una API REST para que tu programa de gestión, tu portal de reventa o tu software de taller envíe la lectura y recoja el fichero modificado sin que nadie tenga que entrar en el panel a copiar datos. Los pedidos entran en la misma cola que ya ha servido más de 1.500 ficheros, y cada uno lo prepara y lo revisa un ingeniero.
// 200 OK · tu programa pregunta por su pedido { "order": { "reference": "3F9C1A7E", "status": "completed", "external_ref": "OT-2026-0412", "vehicle": { "make": "Audi", "model": "A4", "engine": "2.0 TDI 150 CV" }, "ecu": "Bosch EDC17C74", "tool": "KESS3", "credits": 2, "files": { "original": true, "modified": true }, "links": { "file": "/api/v1/orders/3f9c…/file" } } }
Un pedido de pruebas de principio a fin, en cinco minutos y sin pagar nada
Con una clave de pruebas tu programa recorre el mismo camino que un pedido real, desde que crea el pedido con su lectura hasta que recibe los avisos y descarga un fichero de muestra. El pedido simulado avanza solo, así que puedes dejar la integración terminada antes de contratar ningún plan.
- 00:00TúPOST /uploads → 200 · upload_url firmada
- 00:02TúPUT original.bin → 200 · lectura subida
- 00:04TúPOST /orders → 201 · status «queued», test: true
- 01:00Avisoorder.created llega a tu URL, firmado
- 02:00Estadoprocessing un técnico simulado lo coge
- 03:00Avisoorder.processing
- 05:00Estadocompleted fichero de muestra disponible
- 05:00Avisoorder.completed
- 05:02TúGET /orders/{id}/file → 200 · enlace de descarga de 1 hora
Cómo empezar a probar
- Date de alta como taller en el panel. Revisamos cada alta a mano.
- En Panel › API, crea una clave de pruebas. Se muestra una sola vez.
- Lanza tus llamadas y registra tu URL de avisos; el botón «Probar» te envía uno al momento.
- Cuando todo funcione, contrata un plan y cambia la clave por una de producción.
Qué incluye el entorno de pruebas
- 1.000 llamadas al día y 2 webhooks
- Hasta 100 pedidos simulados al día, consultables 7 días
- Cancelar, pedir revisión y escribir al técnico también funcionan
- Nada real: ni pedidos, ni créditos, ni ficheros guardados
Para quien ya trabaja con su propio software y no quiere meter cada pedido dos veces
Talleres con programa de gestión
El pedido sale de la orden de trabajo y el fichero vuelve a ella cuando está listo, sin copiar matrículas ni bajar adjuntos a mano.
Redes y franquicias
Varias sucursales piden desde el mismo sistema, cada una con su referencia, y la central lo ve todo en un sitio.
Revendedores con portal propio
Tus clientes piden en tu web, nuestros ingenieros preparan el fichero por detrás y tú fijas tu precio de venta.
Quien desarrolla software de taller
Añade el servicio de ficheros a tu producto. Cada taller pega su propia clave en tu programa, así que los pedidos y los créditos son suyos.
Tres llamadas entre la lectura original y el fichero modificado
Tu programa no necesita nada especial: vale cualquier lenguaje que haga peticiones HTTPS. Cada pedido lleva tu número de orden de trabajo en external_ref, y si tu programa repite una llamada por error no se crea un segundo pedido.
Permiso de subida
POST /uploads devuelve una URL firmada y tu programa sube la lectura con un PUT, hasta 50 MB.
Crear el pedido
POST /orders con el vehículo, la centralita, la herramienta de lectura y los servicios que quieres.
Aviso y descarga
Llega order.completed a tu URL y descargas el fichero con GET /orders/{id}/file.
# 1) Permiso de subida curl -X POST https://app.repromatronic.es/api/v1/uploads \ -H "Authorization: Bearer rp_test_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_test_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 order.completed curl https://app.repromatronic.es/api/v1/orders/<id>/file \ -H "Authorization: Bearer rp_test_XXXXXXXX" # → { "url": "https://…", "filename": "…", "expires_in": 3600 }
// Cabecera X-Signature: t=<unix>,v1=<hex> · usa el cuerpo tal cual llega const crypto = require("node:crypto"); function verify(secret, header, rawBody) { const m = /t=(\d+),v1=([0-9a-f]+)/.exec(header || ""); if (!m) return false; const expected = crypto.createHmac("sha256", secret.replace(/^rpwh_/, "")) .update(m[1] + "." + rawBody).digest("hex"); const fresh = Math.abs(Date.now() / 1000 - Number(m[1])) < 300; return fresh && expected.length === m[2].length && crypto.timingSafeEqual(Buffer.from(expected, "hex"), Buffer.from(m[2], "hex")); }
// Cabecera X-Signature: t=<unix>,v1=<hex> $body = file_get_contents('php://input'); $header = $_SERVER['HTTP_X_SIGNATURE'] ?? ''; $secret = preg_replace('/^rpwh_/', '', getenv('RP_WEBHOOK_SECRET')); if (!preg_match('/t=(\d+),v1=([0-9a-f]+)/', $header, $m)) { http_response_code(400); exit; } $expected = hash_hmac('sha256', $m[1] . '.' . $body, $secret); $ok = hash_equals($expected, $m[2]) && abs(time() - (int) $m[1]) < 300; http_response_code($ok ? 200 : 400);
# Cabecera X-Signature: t=<unix>,v1=<hex> import hashlib, hmac, re, time def verify(secret: str, header: str, body: bytes) -> bool: m = re.match(r"t=(\d+),v1=([0-9a-f]+)", header or "") if not m: return False t, v1 = m.groups() key = secret.removeprefix("rpwh_").encode() expected = hmac.new(key, t.encode() + b"." + body, hashlib.sha256).hexdigest() return hmac.compare_digest(expected, v1) and abs(time.time() - int(t)) < 300
Todo lo que hace un taller en el panel, hecho desde tu programa
La API no es una versión recortada del panel. Cubre el pedido de punta a punta, incluida la conversación con el técnico, y además te da el catálogo de vehículos para que tu programa rellene los datos del coche sin que nadie tenga que teclearlos.
Pedidos y ficheros
Crear pedidos y listarlos con filtros por estado, fecha, matrícula o referencia. De cada uno descargas el modificado o recuperas tu original.
Conversación con el técnico
Leer y escribir en el hilo del pedido. Si el técnico necesita un dato, te llega order.needs_info con el motivo.
Revisiones y cancelaciones
Pedir revisión de un fichero entregado, gratis durante 30 días, o cancelar un pedido que todavía está en cola.
Catálogo de vehículos
Del tipo de vehículo al motor concreto, con su potencia y par de serie, y para cada motor las etapas que hay y con qué herramientas se lee.
Servicios y créditos
Cada servicio con su coste en créditos y sus complementos. Y en /me, el saldo de tu cuenta junto al consumo del mes.
Panel para el integrador
En Panel › API ves tus claves, las últimas llamadas con su código de respuesta y los últimos avisos enviados, con su resultado.
Los ocho avisos que puede recibir tu programa
Pensada para que una clave filtrada o un servidor caído no te cuesten un disgusto
Claves que no guardamos
Cada clave se enseña una sola vez al crearla; nosotros solo guardamos su huella, no la clave. Si se filtra, la revocas en el panel y creas otra en un minuto.
Avisos firmados y con reintentos
Cada aviso lleva una firma HMAC-SHA256 con marca de tiempo. Si tu servidor no responde en 8 segundos, lo reintentamos hasta 7 veces, de un minuto a doce horas.
Errores que tu programa entiende
Cada error trae un código fijo y un mensaje en español o en inglés, según la cabecera Accept-Language, con los campos que fallan cuando hay un dato mal.
Las URL de los avisos tienen que ser https y públicas: no aceptamos direcciones internas ni privadas, y lo volvemos a comprobar antes de cada envío. Cada clave admite 120 llamadas por minuto, además del límite diario de su plan.
El plan paga la integración; cada fichero se paga con créditos, al precio del panel
Sin cuota de alta ni permanencia. Se contrata en el panel con pago mensual, cada cuota lleva su factura con Verifactu y, si un mes cambias de idea, lo das de baja desde el mismo sitio.
40 ficheros al mes
Pruebas
Para dejar la integración hecha antes de pagar.
0 € sin plan
- Claves de pruebas sin contratar nada
- 1.000 llamadas al día
- 2 webhooks
- Pedidos simulados que avanzan solos
API Taller
Para conectar tu programa de gestión.
59 € /mes
- Hasta 50 ficheros al mes por API
- 1 clave de producción
- 2 webhooks
- 2.000 llamadas al día
- Soporte por correo
API Pro
Para talleres grandes y revendedores.
149 € /mes
- Hasta 250 ficheros al mes por API
- 5 claves de producción
- 10 webhooks
- 10.000 llamadas al día
- Soporte prioritario
API Empresa
Para redes y grandes consumos.
desde 349 € /mes
- Ficheros sin límite
- Varias sucursales bajo una cuenta
- Acuerdo de nivel de servicio
- Integración asistida
Precios al mes sin IVA. El límite de ficheros de cada plan es lo que puedes enviar por la API; cada fichero se descuenta de tus créditos cuando el técnico lo entrega, al mismo precio que si lo pidieras desde el panel.
Lo que conviene saber, aunque no luzca en un folleto
La API está siempre, los técnicos no
La API responde las 24 horas, pero los ficheros los preparan personas, todos los días de 08:00 a 22:00 (hora peninsular). Un pedido de madrugada se coge por la mañana.
Los avisos salen en tandas
Los webhooks se envían cada cinco minutos como mucho. Si tu programa necesita el estado al segundo, puede consultarlo cuando quiera con GET /orders/{id}.
El plan no trae ficheros
Los 59 o 149 euros pagan el acceso. Cada fichero se paga aparte con créditos, como en el panel, y sin saldo suficiente el pedido se rechaza con un error claro.
La cuenta de taller va primero
Las claves cuelgan de una cuenta de taller aprobada. Revisamos cada alta a mano, así que el primer día puede haber unas horas de espera antes de crear tu clave.
Esta misma API, con tu marca, para tus talleres
Con la plataforma con marca propia, tus talleres tienen su API en tu dominio y con tu nombre, y los pedidos los sirves tú o nuestros ingenieros, según el servicio.
Lo que nos preguntan los que van a integrarla
¿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 cuando el técnico entrega el fichero; el plan mensual solo cubre el acceso a la API.
¿Puedo probarla sin pagar?
Sí. Con una cuenta de taller aprobada creas claves de pruebas sin contratar nada, y con ellas recorres el pedido entero con pedidos simulados que avanzan solos. No se crea nada real ni se gasta un crédito.
¿Mi programa tiene que ser especial?
No. Vale cualquier programa que haga peticiones HTTPS, ya sea en PHP, .NET, Node, Python o Java. Si usas un programa comercial, pásale la documentación a su proveedor, que es quien tendrá que hacer la integración.
¿Cómo sé cuándo está listo el fichero?
Registras una URL y te llega el aviso order.completed, firmado con tu secreto. Después descargas el fichero con GET /orders/{id}/file, que te da un enlace válido durante una hora.
¿Qué pasa si mi servidor está caído cuando sale un aviso?
Lo reintentamos hasta 7 veces con esperas que van de un minuto a doce horas. Y en cualquier momento puedes consultar el estado del pedido directamente.
Desarrollo software para talleres, ¿cómo lo hago con varios clientes?
Cada taller crea su propia clave en su panel y la pega en tu programa. Así los pedidos y los créditos son de cada taller, y tú no tienes que manejar el dinero de nadie.
¿Puedo revenderlo con mi marca?
Sí. El plan Empresa admite varias sucursales bajo una cuenta. Si quieres el panel entero con tu marca para tus talleres, eso es la plataforma con marca propia.
¿Hay permanencia o cuota de alta?
No. Pago mensual y baja desde el panel cuando quieras.
Deja la integración hecha esta semana, y paga solo cuando la uses
Crea una clave de pruebas y mira cómo un pedido simulado llega a «completado» desde tu propio programa. Si te atascas, escríbenos con la hora de la llamada y la ruta.
WhatsApp y teléfono +34 627 21 91 30 · info@repromatronic.es · Especificación OpenAPI 3.1
EN · Read in English