- Antes de conectar nada, decide campo a campo qué sistema manda: normalmente el ERP en clientes y contabilidad, el taller en reparaciones y facturas de posventa.
- La API permite al ERP dar de alta clientes y vehículos sin duplicarlos, leer los presupuestos cambiados y recibir un aviso con cada factura emitida.
- La lectura periódica es gratis con el plan Incluido; escribir datos y recibir webhooks requiere el plan Developer.
- La factura de posventa se emite en un solo sistema; emitirla en los dos rompe la numeración.
- Costes, márgenes, proveedores y notas internas no salen por la API.
Integrar el ERP de un concesionario o de un grupo con el programa del taller consiste en decidir qué sistema manda en cada dato y hacer que el otro se entere solo. Lo habitual es que el sistema central sea la referencia de clientes y contabilidad, y que el taller sea la referencia de presupuestos, reparaciones y facturas de posventa. Con la API de Programa Taller, el ERP puede dar de alta y actualizar clientes y vehículos en el taller, leer los presupuestos que han cambiado desde la última vez y recibir un aviso en cuanto se emite una factura, con su PDF original.
Lo que no conviene hacer es sincronizarlo todo en las dos direcciones «por si acaso». Es la receta para tener clientes duplicados, matrículas a nombre de quien no toca y dos facturas para la misma reparación. Vamos por partes.
¿Quién manda en cada dato: el ERP o el programa del taller?
Antes de hablar de conectores hay que contestar a esta pregunta campo a campo. Es la reunión más aburrida del proyecto y la que más problemas evita. Esta es la propuesta con la que solemos empezar, y que cada grupo ajusta:
| Dato | Manda | Cómo viaja |
|---|---|---|
| Cliente (nombre, NIF, contacto) | El ERP, si el cliente nace en la exposición; el taller, si nace en posventa | Alta y edición por API en un sentido; avisos client.created y client.updated en el otro |
| Vehículo (matrícula, bastidor, titular) | El ERP al venderlo; el taller después (kilómetros, ITV) | Alta por API al vender; avisos vehicle.created y vehicle.updated |
| Presupuestos y reparaciones | El taller | El ERP lee los cambios con updated_since o escucha budget.accepted |
| Factura de posventa | El taller (numeración, serie y Verifactu) | Aviso invoice.issued; el ERP descarga datos y PDF |
| Cobros | Donde se cobre | Aviso payment.received, o el ERP anota el cobro por API |
| Contabilidad del grupo | El ERP | Se alimenta de las facturas y cobros anteriores |
La regla de fondo es sencilla: cada dato se escribe en un solo sitio y se copia al otro. Cuando los dos sistemas pueden editar lo mismo, tarde o temprano alguien corrige un teléfono en uno y lo pisa el otro.
Tres formas de conectar el taller con el sistema central
No todos los grupos necesitan lo mismo. Un concesionario pequeño con un taller puede vivir con menos que un grupo con cinco sedes. Esta comparativa te ayuda a situarte:
| Exportar y reimportar | Lectura periódica por API | Integración en los dos sentidos | |
|---|---|---|---|
| Qué es | Alguien baja un fichero del taller y lo sube al ERP | El ERP pregunta cada cierto tiempo qué ha cambiado | El ERP escribe clientes y vehículos y recibe avisos al momento |
| Plan de la API | Ninguno | Incluido (gratis, solo lectura, 2.000 peticiones al día) | Developer (19 € al mes sin IVA, escritura y webhooks) |
| Retraso | Días | Lo que tarde la siguiente consulta | Segundos |
| Riesgo de duplicados | Alto | Bajo (solo lee) | Bajo si se respeta quién manda |
| Quién lo mantiene | Una persona, cada semana | El informático del grupo, una vez | El informático del grupo, una vez |
| Para quién | Casi nadie, ya | Grupos que solo necesitan ver la posventa y facturas | Grupos que venden coches y quieren que el cliente llegue al taller ya dado de alta |
La segunda opción es un buen primer paso: no escribe nada en el taller, no cuesta nada y ya quita el fichero de los lunes. Los precios y límites de cada plan están en la página de la API.
Lo que cambia en el día a día de posventa
Pongamos un grupo inventado con exposición y taller en la misma parcela. Carla Moya es la jefa de posventa y Germán Olmedo lleva los sistemas del grupo. Antes de la integración, cuando un vendedor entregaba un coche, Carla recibía un email con los datos del comprador para darlo de alta «cuando pudiera». A veces lo hacía. A veces el cliente aparecía en la primera revisión y había que pedirle todo otra vez en el mostrador.
Ahora, al cerrarse la venta en el ERP, Germán ha programado tres llamadas a la API:
- Crear el cliente o recuperar el que ya existe, sin duplicarlo.
- Dar de alta el vehículo a su nombre, con bastidor, fecha de matriculación y vencimiento de la ITV.
- Nada más. El taller no necesita un presupuesto hasta que el cliente lo pida.
Cuando Jacinto Ferrán, el comprador del ejemplo, llama un año después para la primera revisión, el asistente de voz ya le reconoce por su número, sabe qué coche tiene y le abre la solicitud. Si prefiere escribir por WhatsApp o en otro idioma, lo mismo. Carla no ha tocado el teclado. Y cuando el taller emite la factura de esa revisión, la contabilidad del grupo la recibe sola, con el mismo PDF que se llevó el cliente.
El ahorro no está en un gran momento: está en decenas de altas manuales, correos reenviados y facturas tecleadas dos veces que desaparecen. Con más sedes o más volumen de ventas, esa diferencia es la que permite crecer sin añadir a alguien que solo pasa datos de un sistema a otro.
Cómo se hace, recurso a recurso
Esta parte es para el informático del grupo. Todo lo que sigue está en la referencia pública de la API.
Clientes sin duplicados
El alta nunca fusiona fichas. Si el NIF, el email o el teléfono ya existen en otro cliente, responde 409 client_exists con el id existente. Para una sincronización, lo práctico es pedir que te devuelva el que ya existe:
curl -X POST "https://tu-taller.example/api/v1/clients?on_conflict=return_existing" \
-H "Authorization: Bearer pt_live_4b7e…" \
-H "Idempotency-Key: 9b2e7f10-cc41-4a8e" \
-H "Content-Type: application/json" \
-d '{"name": "Jacinto Ferrán", "phone": "611222333",
"email": "jacinto@example.com", "tax_id": "00000000T"}'Guarda en tu ERP el id que devuelve el taller. Será tu llave para todo lo demás. Si un cliente ejerció su derecho de supresión, su ficha aparece anonimizada y no admite cambios (409 client_erased): tu sistema debe respetarlo, no intentar recrearla.
Vehículos y cambios de titular
El vehículo siempre se da de alta a nombre de un cliente existente. Si la matrícula ya está en la ficha de otro cliente, la API responde 409 vehicle_belongs_to_other_client y no la mueve sola: decide el taller. Es justo el caso del coche usado que el concesionario recompra y revende. Cuando el cambio de titular está confirmado, un PATCH /vehicles/{id} con el nuevo client_id lo pasa al comprador; lo que no admite es dejar un vehículo sin titular.
Presupuestos que han cambiado
Para leer la posventa sin descargarla entera cada vez, el listado de presupuestos acepta updated_since. Guarda la hora de tu última consulta y pide solo lo nuevo:
curl "https://tu-taller.example/api/v1/budgets?updated_since=2026-10-14T06:00:00Z&limit=200" \ -H "Authorization: Bearer pt_live_4b7e…"
Los listados van paginados por cursor y nunca incluyen presupuestos de uso interno ni datos de coste.
Facturas: el taller emite, el ERP recibe
Suscribe invoice.issued y payment.received. Con cada aviso, tu sistema pide la factura (líneas, totales por tipo de IVA y cobros) y su PDF con el QR de Verifactu. Si es el ERP quien cierra la venta de posventa, también puede pedir al programa que facture un presupuesto aprobado y anotar el cobro; lo contamos en cómo facturar por API un presupuesto aprobado.
Errores frecuentes al integrar un taller en un grupo
- Emitir la factura en los dos sitios. Si el ERP genera su propia factura de la reparación y el taller también, tienes dos numeraciones para una misma operación. La factura de posventa debe salir de un único sistema de facturación, y el otro la recibe.
- Usar el nombre como llave. «Juan García» hay muchos. La llave es el id que devuelve el taller, guardado junto al del ERP.
- Corregir datos en los dos lados. Si el teléfono manda en el ERP, que el taller no lo edite, o que el aviso
client.updatedvuelva al ERP y alguien decida. - Una sola clave para todo y para siempre. Mejor una clave por uso (sincronización de clientes, lectura de facturas), con los permisos justos, la finalidad escrita y las IPs del servidor del grupo.
- Olvidar que cada taller es una instancia. Cada clave está atada a un solo taller. Un grupo con tres talleres necesita una clave en cada uno y un id de taller en su ERP.
- Reintentar sin Idempotency-Key. Si la red se corta a mitad de un alta y tu sistema repite la llamada, la cabecera evita el segundo cliente. Es obligatoria en todo POST por algo.
Crea una clave de prueba y comprueba con tus datos reales qué verá el ERP, sin cambiar nada.
Prueba 3 meses por 1 €¿Qué no sale del taller aunque lo pida el ERP?
Hay datos que un controller de grupo querría y que la API no da, a propósito:
- Costes y márgenes. Ni el coste de compra de los recambios, ni el proveedor, ni el margen de cada partida. Del stock sale el precio de venta y las existencias.
- Notas internas y presupuestos de uso interno. Lo que el taller apunta para sí se queda en el taller.
- Datos del personal. Solo el id y el nombre del responsable o del mecánico.
Si el grupo necesita rentabilidad de posventa, la tiene que calcular con lo que sí sale (facturación, partidas, horas) o consultarla dentro del programa. Y si vuestro caso pide un dato que no está en la referencia, escríbenos y lo valoramos; no inventamos un endpoint en una reunión.
Cuándo no compensa integrarlo
No todos los grupos lo necesitan. Si el taller hace pocas reparaciones a clientes que vienen de la exposición, y la contabilidad se cierra una vez al mes, la lectura periódica o incluso la descarga mensual de facturas que ya hace tu gestoría pueden bastar. Tampoco compensa si nadie en el grupo puede mantener la integración: una conexión que se rompe en silencio es peor que un fichero que alguien sube a mano, porque nadie sabe que ha dejado de funcionar.
Y hay cosas que ninguna integración resuelve: si posventa y ventas no se ponen de acuerdo sobre quién atiende al cliente después de la entrega, el ERP solo repartirá el desacuerdo más rápido. Eso lo decide la dirección, no el conector.
Cuando sí compensa, el efecto se nota en el cliente antes que en las cuentas: llega a su primera revisión y el taller ya le conoce. Y en la gerencia de posventa, que deja de ser la que persigue datos para ser la que decide cómo llenar la agenda. Si el grupo tiene varias sedes, merece la pena leer también cómo dar la misma atención en varios talleres y, para la parte de seguridad, claves, permisos y RGPD en la API.
Preguntas frecuentes
¿Qué datos se pueden sincronizar entre el ERP del concesionario y el taller?
Clientes, vehículos (con kilómetros e ITV), presupuestos con sus partidas y estado, facturas emitidas con su PDF y cobros. Lo que no sale son costes, márgenes, proveedores y notas internas.
¿Cómo evito clientes duplicados al dar de alta desde el ERP?
El alta por API nunca fusiona fichas y responde con un conflicto si el NIF, el email o el teléfono ya existen. Con la opción de devolver el existente recibes ese cliente en lugar de un error, y guardas su id en el ERP como llave.
¿Qué pasa si el concesionario revende un coche que ya estaba en el taller?
Si la matrícula está a nombre de otro cliente, la API no la mueve sola y devuelve un aviso de conflicto. Cuando el cambio de titular está confirmado, se modifica el vehículo indicando el nuevo cliente; un vehículo nunca se queda sin titular.
¿Puede el ERP recibir las facturas del taller en cuanto se emiten?
Sí, suscribiéndose al aviso de factura emitida. Con él, el ERP descarga las líneas, los totales por tipo de IVA y el PDF original con el QR de Verifactu. Requiere el plan Developer de la API.
Tenemos tres talleres en el grupo, ¿basta con una clave?
No. Cada clave está atada a un solo taller, así que hace falta una clave en cada uno. El ERP debe guardar de qué taller viene cada dato.
¿Es obligatorio pagar un plan de la API para integrar el ERP?
Para leer datos, no: el plan Incluido viene con el programa y da 2.000 peticiones al día. Para escribir clientes o vehículos y recibir avisos automáticos hace falta el plan Developer, de 19 € al mes sin IVA.