API para taller mecánico: qué es y seis usos reales en tu negocio

Una API es una puerta controlada por la que otros programas leen o escriben datos de tu taller sin que nadie tenga que exportar una hoja de cálculo ni copiar nada a mano. En un taller mecánico se usa para que la gestoría descargue las facturas cada mes, para que el ERP de un grupo reciba los presupuestos, para que el gestor de una flota sepa cuándo está listo su coche o para que tu web proponga citas con los huecos reales de la agenda.

En Programa Taller la API ya viene dentro del programa: el plan Incluido da una clave de solo lectura y 2.000 peticiones al día sin coste añadido. Lo que tienes que decidir no es si «tener API», sino qué problema quieres que resuelva y quién va a usar esa puerta. De eso va esta guía: qué es, seis usos concretos y la lista de decisiones que conviene llevar pensadas antes de hablar con tu informático.

¿Qué es una API, explicado sin tecnicismos?

Piensa en el mostrador de un almacén de recambios. Tú no entras a las estanterías a coger lo que quieres: pides en el mostrador, el dependiente comprueba que tienes cuenta abierta y te da justo lo que has pedido. Si pides algo que tu cuenta no cubre, te dice que no. Y cada retirada queda apuntada.

Una API funciona igual. El otro programa (la aplicación de tu gestoría, por ejemplo) no entra en tu base de datos. Hace una petición a una dirección concreta, presenta una clave que la identifica, y la API le devuelve solo lo que esa clave tiene permitido ver. Si la clave es de solo lectura, no puede cambiar nada. Si intenta leer algo que no le toca, recibe un error. Y cada petición queda registrada con la hora, la IP de origen y el resultado.

La alternativa que casi todos los talleres usan hoy es la exportación: alguien saca un Excel a final de mes, lo manda por email y otra persona lo vuelve a teclear en su sistema. Funciona, pero depende de que alguien se acuerde, se equivoca con facilidad y nunca está al día. Con una API los datos se piden cuando hacen falta y llegan tal cual están en el programa.

Hay una segunda pieza que conviene conocer desde ya: los webhooks. La API responde cuando alguien pregunta; un webhook es el aviso que manda el taller cuando pasa algo («presupuesto aceptado», «vehículo listo»), sin esperar a que nadie pregunte. Lo explicamos a fondo en qué son los webhooks, con eventos reales de un taller.

¿Para qué usan la API otros talleres? Seis casos concretos

Estos son los usos que más nos piden. Para cada uno verás qué gana el gerente y qué necesita saber quien lo programe. No hace falta entender lo segundo para decidir lo primero.

1. La gestoría se descarga las facturas sola

Qué ganas: se acaban los emails de «¿me mandas las facturas de septiembre?». La asesoría descarga cada mes las facturas emitidas con su PDF original, los totales por tipo de IVA y los cobros anotados.

Para tu informático: basta una clave con invoices:read, que entra en el plan Incluido. Los endpoints son GET /invoices, GET /invoices/{id} y GET /invoices/{id}/pdf. Si también quieres que un sistema externo facture un presupuesto aprobado, hace falta el permiso invoices:write y el plan Developer; la factura sale con la serie, la numeración y el registro Verifactu del propio programa.

2. El ERP del grupo o del concesionario se mantiene al día

Qué ganas: si tu taller forma parte de un grupo, la central ve los clientes, vehículos y presupuestos sin que nadie los duplique, y se entera en cuanto se emite una factura.

Para tu informático: lectura de /clients, /vehicles y /budgets (con updated_since para traer solo lo modificado) y un webhook a invoice.issued. Los webhooks y la escritura requieren el plan Developer.

3. El gestor de la flota sabe en qué punto está cada coche

Qué ganas: menos llamadas de «¿cómo va lo nuestro?». La empresa de renting o el cliente con flota consulta el estado de cada vehículo y la fecha de vencimiento de la ITV, y recibe un aviso cuando el coche entra, cuando está listo y cuando se entrega.

Para tu informático: GET /vehicles devuelve el último kilometraje y itv_expiry_date; los eventos son vehicle.checked_in, vehicle.ready y vehicle.delivered. Una clave por flota, con su finalidad escrita, deja cada integración separada.

4. El proveedor de recambios abre presupuestos con las referencias puestas

Qué ganas: un distribuidor con el que trabajas puede crear el presupuesto con las referencias de recambio ya en cada partida, o leer las partidas de una reparación para preparar el pedido sin que nadie le dicte nada por teléfono.

Para tu informático: POST /budgets con lines (cada partida admite reference) y el permiso budgets:write. Un detalle que tranquiliza al gerente: el coste y el proveedor de tus recambios nunca salen por la API, ni tus márgenes ni tus notas internas.

5. Tu web propone citas con los huecos de verdad

Qué ganas: el cliente que entra en tu web ve horas libres reales, calculadas con tus horarios, tus boxes y tus festivos, y deja la cita propuesta. Tú la confirmas con un clic o, si trabajas en modo reserva, entra en firme.

Para tu informático: GET /appointments/availability para los huecos, POST /appointments para proponer y GET /catalog/rates si la web debe enseñar los mismos precios de tu tarifa. Si el taller está en modo «proponer», la API responde booking_mode_propose_only a quien intente reservar en firme.

6. Make, n8n o Zapier encadenan lo que se te ocurra

Qué ganas: pequeñas automatizaciones sin desarrollo a medida. Una tarea en tu CRM cuando se rechaza un presupuesto, una fila en una hoja cada vez que entra un cobro, un aviso en el canal interno cuando un cliente propone cita.

Para tu informático: estas herramientas reciben webhooks (lead.rejected, payment.received, appointment.proposed…) y hacen peticiones con la clave en la cabecera. Requiere el plan Developer por los webhooks.

Cómo cambia un mes cualquiera: el caso de Ramiro y su gestora

Un ejemplo inventado para aterrizarlo. Ramiro dirige un taller de chapa y mecánica con cuatro personas. Cada primer lunes de mes, Itziar, su gestora, le escribe:

Ramiro lo deja para la tarde. La tarde se complica con un coche que no arranca, y el envío sale el miércoles. Itziar detecta que falta una factura y vuelve a escribir. Nada grave, pero se repite doce veces al año y siempre cae en la persona que menos tiempo tiene: el gerente.

Con la API, Ramiro entra en «Desarrolladores / API», crea una clave llamada «Gestoría», escribe como finalidad «contabilidad y obligaciones fiscales del taller», marca solo invoices:read y se la pasa a Itziar por un canal seguro. A partir de ahí, la aplicación de la gestoría descarga facturas, PDF y cobros cuando le hace falta. Ramiro no vuelve a mandar nada.

¿Cuánto tiempo ahorra? Depende de tu caso, así que haz la cuenta con tus números. Supongamos que preparar y revisar el envío mensual te lleva una hora y media, más media hora de idas y vueltas por lo que falta. Son dos horas al mes, unas veinticuatro al año, que hoy salen de la agenda del gerente. Si en tu taller son veinte minutos, el ahorro es menor, pero sigue existiendo la otra ventaja: la gestoría trabaja con los datos tal cual están en el programa, sin erratas de copiar y pegar.

¿Cuánto cuesta usar la API del programa?

Los planes de la API van aparte del plan del programa y se contratan desde el propio programa. Precios sin IVA:

Las claves de prueba no cuentan para el cupo ni tienen coste. Si en un mes Developer o Business superan su cupo (cupo diario por días del mes), el exceso se cobra a 1 € por cada 1.000 peticiones. El precio del programa en sí está en la página de precios de Programa Taller.

Qué decidir antes de pedírsela a un informático

Un informático o una agencia te pueden montar casi cualquier integración. Lo que no pueden hacer es decidir por ti qué datos deben salir del taller. Lleva esta lista contestada a la primera reunión y te ahorrarás horas facturables.

1. ¿Qué problema concreto quieres quitarte? «Que la gestoría no me pida facturas» es un buen encargo. «Conectar el taller con todo» no lo es.
2. ¿Los datos salen, entran o las dos cosas? Solo leer cabe en el plan Incluido. Crear clientes, presupuestos o citas pide Developer.
3. ¿Quién usará la clave y para qué? Al crearla tendrás que escribir la finalidad del tratamiento, como pide el RGPD. Si no sabes explicarla en una frase, todavía no está clara la integración.
4. ¿Qué permisos mínimos necesita? La clave de la gestoría no tiene por qué ver la agenda. La de la web de citas no necesita facturas. Un permiso por área, y solo los imprescindibles.
5. ¿Desde dónde se va a usar? Puedes limitar la clave a las IPs del proveedor y ponerle fecha de caducidad. Para una integración de prueba o temporal, hazlo siempre.
6. ¿Quién aceptará presupuestos en nombre del cliente, si alguien lo hace? Ese permiso va aparte (budgets:accept) y exige indicar quién acepta y por qué canal. Queda en el historial como «Aceptado por API en nombre del cliente».
7. ¿Cómo se va a probar? Las claves pt_test_ de tu taller leen tus datos reales pero no pueden cambiar nada. Para probar escrituras está el entorno público de pruebas con datos ficticios.
8. ¿Quién vigila? El registro guarda 90 días de peticiones: qué clave, desde qué IP, a qué endpoint y con qué resultado. Alguien del taller debería echarle un ojo de vez en cuando.

Con esto resuelto, la primera prueba de tu informático es una sola línea. Crea una clave de prueba y llama a /ping con la URL de tu taller:

curl https://tu-taller.example/api/v1/ping \
  -H "Authorization: Bearer pt_test_9f2c…"

La respuesta le dice qué permisos tiene la clave y cuánto cupo le queda:

{
  "ok": true,
  "key": { "name": "Gestoria", "environment": "test",
           "scopes": ["invoices:read"] },
  "rate_limit": {
    "per_minute": { "limit": 60, "remaining": 59 },
    "per_day": { "limit": 2000, "remaining": 1999 }
  },
  "version": "v1"
}

Toda la referencia, con cada endpoint, sus errores y ejemplos, está en la documentación de la API para desarrolladores. Hay también un fichero OpenAPI 3.1 para generar un cliente en cualquier lenguaje y, dentro del programa, una colección de Postman y un panel para probar cada endpoint con tu clave.

¿Es seguro abrir los datos del taller a otro programa?

Es la pregunta correcta, y la respuesta depende de cómo esté planteada la puerta. En este caso hay varias cerraduras de serie:

• Cada clave es de un solo taller. Solo se guarda su huella: no sirve en otra instalación y nadie puede recuperarla después, tampoco nosotros. La clave completa se ve una única vez al crearla.
• Lo interno no sale. Costes, márgenes, notas internas y presupuestos de uso interno no aparecen en ninguna respuesta. Del personal solo se ve el id y el nombre.
• Escrituras sin duplicados. Cada POST lleva una Idempotency-Key: si el sistema de tu proveedor reintenta por un corte de red, no aparece un segundo cliente ni un segundo presupuesto.
• Rastro de cada cambio. Lo que hace una clave live queda en el historial como «API · nombre de la clave», y revocarla tiene efecto inmediato.

Eso no te libra de tus obligaciones. Si cedes datos de clientes a un tercero (una flota, un ERP de otra empresa), revisa con tu gestoría o tu asesor de protección de datos si hace falta un contrato de encargo del tratamiento.

¿Cuándo no compensa una integración por API?

No siempre merece la pena, y conviene decirlo:

• Si el volumen es pequeño. Si emites treinta facturas al mes y tu gestoría está contenta con un email, montar la descarga automática puede costar más de lo que ahorra el primer año.
• Si nadie va a mantenerla. Una integración es software: si tu proveedor cambia de sistema o tu informático desaparece, alguien tiene que saber dónde está la clave y quién la usa.
• Si lo que buscas ya está dentro del programa. Atender WhatsApp, devolver llamadas, avisar al cliente de que su coche está listo o recordarle la cita lo hace el propio programa en varios canales e idiomas, sin integrar nada. La API sirve para conectar con otros sistemas, no para sustituir lo que ya tienes.
• Si el endpoint que necesitas no existe. La versión 1 tiene 56 endpoints. Si tu caso no encaja en ellos, no lo fuerces: escríbenos y lo valoramos.

Hay cosas que la API no hace por diseño. No entrega el enlace de seguimiento que recibe el cliente (lo envía el taller), no crea facturas sueltas (se factura un presupuesto aprobado) y las rectificativas se hacen desde el programa. Son límites pensados para que una integración no pueda saltarse las reglas que sí sigue tu equipo.

La decisión que te toca a ti como gerente

Lo técnico se delega. Lo que no se delega es elegir qué parte del trabajo administrativo quieres que desaparezca de tu mesa. La API tiene sentido cuando un dato que ya está en tu programa se vuelve a teclear en otro sitio cada semana: facturas para la gestoría, estados para la flota, citas desde la web. Cada uno de esos traspasos es tiempo de alguien y una ocasión de equivocarse.

También tiene una lectura de crecimiento. Un taller que atiende a dos flotas puede gestionarlas a mano; con diez, el teléfono no da abasto. Una integración bien hecha permite asumir más clientes de empresa sin contratar a alguien solo para informarles. Y si mañana abres una segunda sede, cada instancia tiene su propia API y sus propias claves, sin mezclar datos.

Empieza por lo pequeño: una clave de solo lectura para la gestoría, que no cuesta nada. Si funciona y le ves la utilidad, el siguiente paso suele ser la web de citas o los avisos a una flota. Y si tienes dudas sobre qué parte de tu día a día se puede automatizar sin programar, la página de comunicación con IA del programa te da una idea de lo que ya viene hecho.

Preguntas frecuentes