- El distribuidor puede añadir partidas con la referencia ya puesta a un presupuesto del taller, o leer las partidas aprobadas para preparar el pedido.
- El precio de cada partida lo decide el taller: lo que llega por la API es un borrador que alguien revisa antes de enviarlo al cliente.
- Por la API nunca salen el coste de compra, el proveedor ni el historial de compras del stock.
- Los permisos son por área: una clave de lectura de presupuestos ve todos los del taller, así que la finalidad y las IP importan.
- Leer es gratis en el plan Incluido; escribir y recibir avisos al momento es del plan Developer, 19 € al mes sin IVA.
Integrar a tu proveedor de recambios con el programa del taller significa que las referencias de las piezas dejen de copiarse a mano. Con la API de Programa Taller caben dos caminos: el distribuidor escribe en tu programa (abre un presupuesto o le añade partidas con la referencia ya puesta) o el distribuidor lee las partidas de una reparación aprobada para preparar el pedido. En ambos casos lo hace con una clave que crea la gerencia, con permisos acotados, y sin ver nunca tus costes ni tus otros proveedores.
Lo que sigue está escrito como lo preguntaría un gerente que ya ha visto muchas promesas de «integración» y desconfía. Cada respuesta tiene una parte para ti y, cuando hace falta, el detalle técnico para quien lo vaya a programar.
¿Qué puede hacer exactamente un distribuidor con la API del taller?
Dos cosas, y conviene no mezclarlas porque piden permisos y planes distintos.
| El distribuidor escribe | El distribuidor lee | |
|---|---|---|
| Qué pasa | Abre un presupuesto con las piezas en cada partida, o añade partidas a uno que ya existe | Consulta las partidas de los presupuestos aprobados para preparar el pedido |
| Endpoints | POST /budgets, POST /budgets/{id}/lines | GET /budgets, GET /budgets/{id} |
| Permiso | budgets:write | budgets:read |
| Plan de API | Developer (19 € al mes sin IVA) | Incluido (sin coste añadido) |
| Riesgo para ti | Partidas que alguien tiene que revisar antes de enviar | Solo lectura: no cambia nada |
Hay un tercer uso que no es del distribuidor sino tuyo: consultar tu propio stock por referencia o EAN con GET /stock. Lo vemos más abajo.
«¿Y si el distribuidor me llena el programa de presupuestos que no he pedido?»
No es lo habitual, y está controlado por varios lados. Primero, un presupuesto creado por API entra en estado «Pendiente» con canal «API», igual que uno que das de alta tú. No se envía al cliente salvo que la integración lo pida expresamente con permiso para comunicarse, y ese permiso no tiene por qué dárselo nadie a un distribuidor. Segundo, cada alta y cada cambio quedan en el historial como «API · nombre de la clave». Si un día ves algo raro, sabes de dónde viene y revocas la clave al momento.
En la práctica, el flujo más sano no es que el distribuidor cree presupuestos de la nada. Es que tu recambista prepare la lista de piezas en el catálogo del proveedor y, con un botón, esas piezas caigan como partidas en el presupuesto que tú ya tenías abierto:
curl -X POST "https://tu-taller.example/api/v1/budgets/4471/lines" \
-H "Authorization: Bearer pt_live_c51b…" \
-H "Idempotency-Key: 2f6c9a10-77de-4c1e" \
-H "Content-Type: application/json" \
-d '{"description": "Kit de embrague con volante",
"reference": "KE-62318",
"quantity": 1,
"unit_price": 412.90,
"group_title": "Embrague"}'La respuesta devuelve la partida con su id y el presupuesto con los totales recalculados en el servidor, con el impuesto de tu taller. Las demás partidas no se tocan. Si el presupuesto ya está facturado, cancelado, rechazado o desistido, la API contesta 409 budget_locked y no añade nada.
Un detalle que agradecerá tu informático: todo POST lleva la cabecera Idempotency-Key. Si la conexión se corta y el sistema del distribuidor reintenta, la partida no aparece dos veces.
«¿Quién pone el precio de la pieza en el presupuesto?»
Esta es la pregunta importante y la respuesta es: tú. La partida lleva un precio unitario y lo que viaja por la API es el número que la integración envíe. Si el distribuidor manda su precio de venta recomendado, ese será el que aparezca hasta que alguien lo cambie. Si manda tu precio neto, estarías regalando el margen.
Por eso lo razonable es acordar con el distribuidor qué precio envía y revisar siempre las partidas antes de enviar el presupuesto al cliente. Un presupuesto en «Pendiente» es un borrador de trabajo, no un documento comprometido. La decisión comercial, cuánto cobras y qué descuento haces, sigue siendo del taller.
Ejemplo inventado. Entra un Ford Focus con matrícula 7314 LPN y ruido al embragar. Tomás, el jefe de taller, confirma que hay que cambiar embrague y volante. Abre el presupuesto en el programa con la mano de obra y avisa a Elisa, que lleva los recambios.
Elisa busca el kit en el catálogo web de su distribuidor, comprueba que hay unidades en el almacén regional y pulsa «Pasar al taller». En diez segundos el presupuesto 4471 tiene una partida nueva, «Kit de embrague con volante», con la referencia KE-62318 en su campo. Tomás ajusta el precio a su tarifa y lo envía. Nadie ha copiado una referencia de doce caracteres a mano, que es justo donde nacen los pedidos equivocados.
«¿Va a ver el distribuidor mis costes o lo que compro a la competencia?»
No. La API está diseñada para que lo interno no salga en ninguna respuesta. En recambios, GET /stock devuelve existencias, referencias y precio de venta, pero el coste de compra, el proveedor y el historial de compras nunca salen. En presupuestos, tampoco aparecen costes, márgenes, notas internas ni los presupuestos de uso interno del taller. Del personal solo se ve el id y el nombre.
Lo que sí debes tener presente es que los permisos van por área, no por proveedor. Una clave con budgets:read ve los presupuestos del taller con sus partidas, el nombre del cliente y la matrícula del coche. No hay un filtro «solo los míos». Antes de darle lectura a un distribuidor, decide si te parece bien, escribe en la finalidad para qué la usará («preparación de pedidos de recambio») y limita la clave a sus IP. Todo eso se hace al crearla, y la finalidad queda registrada como pide el RGPD.
«¿Puede el distribuidor preparar el pedido en cuanto el cliente acepta?»
Sí, y es el uso en el que más tiempo se gana. Hay dos formas de hacerlo.
Preguntando cada cierto tiempo (plan Incluido)
El sistema del distribuidor consulta los presupuestos aprobados que han cambiado desde la última vez y lee sus partidas:
GET /api/v1/budgets?status=Aprobado&updated_since=2026-10-14T06:00:00Z
GET /api/v1/budgets/4471En el detalle, cada partida trae descripción, cantidad, referencia y tipo. Con eso el distribuidor sabe qué tiene que servir. Es solo lectura, así que entra en el plan gratuito, con un matiz: el plan Incluido da una sola clave live. Si esa clave ya la usa tu gestoría, necesitarás otro plan para darle una distinta al distribuidor. Mezclar dos usos en la misma clave es mala idea: pierdes la trazabilidad de quién hace qué.
Recibiendo un aviso al momento (plan Developer)
Con webhooks, el programa avisa a la URL del distribuidor en cuanto un presupuesto pasa a aprobado (evento budget.accepted). El aviso va firmado con HMAC-SHA256 y se reintenta hasta 5 veces si su servidor no contesta. Así el pedido puede salir a los pocos minutos del «sí» del cliente, en lugar de esperar a que alguien del taller llame.
Lo que la API no hace es enviar el pedido por ti: eso lo hace el sistema del distribuidor con la información que lee. Si necesitas algo que no está en la referencia de la API, escríbenos y lo valoramos.
«¿Y mi propio almacén? ¿Sirve de algo la API para eso?»
Sirve para consultarlo desde fuera. GET /stock busca por nombre, marca, referencias y EAN, y las referencias se comparan sin tener en cuenta espacios, puntos ni guiones, así que «A 654 090 78 01» y «A6540907801» encuentran la misma pieza. Puedes filtrar por piezas con unidades (in_stock=true) o agotadas, y pedir solo lo modificado desde una fecha.
Un caso práctico: el recambista tiene en el móvil una pequeña herramienta hecha por tu informático que, antes de pedir al distribuidor, mira si ya tienes la pieza en la estantería. La respuesta trae cantidad, ubicación («Estantería B3») y precio de venta. Pedir lo que ya tienes es dinero parado.
Conecta a tu distribuidor con permisos acotados y revisa cada partida antes de enviarla.
Ver la demo«¿Cuánto me cuesta esto al mes?»
Depende de lo que haga el distribuidor. Los planes de la API van aparte del plan del programa:
- Solo lectura (leer partidas para preparar pedidos, consultar stock): plan Incluido, 0 €, con una clave live y 2.000 peticiones al día.
- Escribir partidas o presupuestos y recibir webhooks: plan Developer, 19 € al mes sin IVA, con 5 claves live y 20.000 peticiones al día.
- Un distribuidor que quiera conectarse con muchos talleres a la vez: plan Partner, desde 5 € por taller al mes sin IVA, con cupo y permisos a medida.
Si el distribuidor es quien ofrece la integración a sus clientes, lo normal es que sea él quien hable con nosotros del plan Partner. Tú solo creas la clave para su producto.
«¿Cuándo no me compensa?»
Cuando el volumen es bajo o el distribuidor no tiene a nadie que programe. Si pides cinco piezas a la semana por teléfono a un recambista de confianza, ninguna integración te va a ahorrar tanto como para justificar el trabajo de montarla. Tampoco compensa si trabajas con muchos proveedores pequeños y cada uno tendría que hacer su propia conexión.
Y una limitación clara: la API no compara precios entre distribuidores ni elige la mejor oferta. Eso sigue siendo criterio de tu recambista. Lo que sí hace es quitar el paso más tonto y más propenso a errores, el de copiar referencias, y dejar rastro de cada partida que entra.
Cuando funciona, se nota en tres sitios: menos pedidos equivocados, presupuestos que salen antes hacia el cliente y un taller que puede crecer en reparaciones sin que el mostrador de recambios se convierta en el cuello de botella. Si quieres ver el resto de integraciones posibles, empieza por la portada de la API o por el artículo sobre qué son los webhooks y qué eventos avisa el taller. Y si lo que te preocupa es la seguridad de las claves, está contado en claves, permisos y RGPD en la API.
Preguntas frecuentes
¿Puede mi distribuidor de recambios meter piezas directamente en mis presupuestos?
Sí, si le das una clave con permiso para escribir presupuestos (plan Developer). Puede añadir partidas con descripción, referencia, cantidad y precio a un presupuesto abierto. Cada partida queda firmada con el nombre de su clave y el presupuesto no se envía al cliente hasta que tú lo decides.
¿El proveedor de recambios ve lo que compro a otros proveedores?
No. El listado de stock por API da existencias, referencias y precio de venta, pero nunca el coste, el proveedor ni el historial de compras. Los costes y márgenes tampoco aparecen en los presupuestos.
¿Puedo buscar una pieza de mi almacén por su EAN?
Sí. La consulta de stock busca por nombre, marca, referencias y EAN, y compara las referencias sin tener en cuenta espacios, puntos ni guiones. Devuelve la cantidad, la ubicación y el precio de venta.
¿Cómo se entera el distribuidor de que un cliente ha aceptado la reparación?
O bien su sistema consulta cada cierto tiempo los presupuestos aprobados, que es solo lectura, o bien recibe un aviso firmado en el momento de la aceptación mediante webhook, que es del plan Developer.
¿Qué pasa si el distribuidor intenta añadir piezas a un presupuesto ya facturado?
La API lo rechaza con el error budget_locked y no cambia nada. Tampoco admite partidas nuevas en presupuestos cancelados, rechazados o desistidos.
Soy distribuidor y quiero conectarme con muchos talleres, ¿cómo lo hago?
Con el plan Partner, desde 5 € por taller al mes sin IVA. Cada taller crea una clave para tu producto con los permisos que necesites y acordamos el cupo según el volumen.