Inicio›API para programas de taller

EN · English
Gratis Pruébala hoy, sin contratar nada

Pide 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.

REST + JSONOpenAPI 3.1Webhooks firmadosEspañol e inglés
+1.500ficheros servidos en esta misma cola
8avisos por webhook a lo largo del pedido
5 minlo que tarda un pedido de pruebas en completarse
0 €por probarla de principio a fin
GET /api/v1/orders/3f9c1a7e-…
// 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" }
  }
}
Entorno de pruebas gratis

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.

sandbox · clave rp_test_…05:00
  1. 00:00TúPOST /uploads → 200 · upload_url firmada
  2. 00:02TúPUT original.bin → 200 · lectura subida
  3. 00:04TúPOST /orders → 201 · status «queued», test: true
  4. 01:00Avisoorder.created llega a tu URL, firmado
  5. 02:00Estadoprocessing un técnico simulado lo coge
  6. 03:00Avisoorder.processing
  7. 05:00Estadocompleted fichero de muestra disponible
  8. 05:00Avisoorder.completed
  9. 05:02TúGET /orders/{id}/file → 200 · enlace de descarga de 1 hora
Reproducción acelerada. Los avisos pueden llegar hasta cinco minutos después de cada cambio.

Cómo empezar a probar

  1. Date de alta como taller en el panel. Revisamos cada alta a mano.
  2. En Panel › API, crea una clave de pruebas. Se muestra una sola vez.
  3. Lanza tus llamadas y registra tu URL de avisos; el botón «Probar» te envía uno al momento.
  4. 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 quién

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.

Cómo funciona

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.

1

Permiso de subida

POST /uploads devuelve una URL firmada y tu programa sube la lectura con un PUT, hasta 50 MB.

2

Crear el pedido

POST /orders con el vehículo, la centralita, la herramienta de lectura y los servicios que quieres.

3

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
Qué puedes hacer

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

order.createdPedido recibido order.processingUn técnico se pone con él order.needs_infoFalta un dato order.messageEl técnico te escribe order.completedFichero listo order.revisionRevisión aceptada order.cancelledPedido cancelado order.refundedCréditos devueltos
Seguridad y fiabilidad

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.

Planes

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

API TallerHasta 50 ficheros al mes por la API. Los ficheros, aparte, con tus créditos.
Para probar

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
Crear clave de pruebas
Un taller

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
Contratar
Volumen

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
Contratar
A medida

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
Pedir oferta

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.

Antes de contratar

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.

¿Tienes tu propia red?

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.

Preguntas frecuentes

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

¿En qué te podemos ayudar?

Nuestro equipo estará encantado de atenderte.

Pide presupuesto