Crear la llave de tu red para otro sistema

Abre una salida de solo consulta para que el sistema de tu marca lea los vínculos y las órdenes de tus talleres, con una llave que solo tú guardaste.

Antes de empezar#

• Tu empresa ya fundó su red y tú tienes acceso a ella, con el permiso de gobernar la red en tu rol (módulo «Red de franquicia»). Gobernar una red es del plan Empresarial.
• Esta llave es de la red, no de tu empresa. Si además quieres sacar los datos de tu propio taller, ésa es otra llave: Crear una API para conectar tu sistema.
• Decide antes dónde vas a guardar la llave: se muestra una sola vez.

Pasos#

1. Abre el selector de arriba del menú, elige tu red y, en el grupo «Control», entra a «Integraciones».
2. Pulsa «Generar API». Si es la primera, la pantalla dice «Todavía no hay ninguna API» y el botón está también ahí en medio.
3. Escribe el «Nombre». Sirve para reconocerla en la lista; tu sistema no lo ve.
4. En «Qué expone», marca lo que tu sistema va a leer y, debajo, sus campos. Tu red tiene dos recursos: «Talleres vinculados» (los vínculos vivos, como los pinta el panel) y «Órdenes de los talleres» (las mismas columnas que el panel de red, ni una más). Nada viene marcado: lo que no marques no existe para esta llave.
5. Si quieres que Pitflo le avise a tu sistema cuando algo pase, llena el panel «Webhook» con su «URL (https)» y marca en «Avisar cuando…» lo que te interese: «Entra una orden», «Una orden cambia de columna en el tablero», «El cliente decide el presupuesto», «Se entrega el vehículo» y las demás. Solo existen avisos de «Órdenes de los talleres», y solo si marcaste ese recurso arriba.
6. Pulsa «Crear API». Se enciende cuando hay nombre y al menos un recurso marcado; con URL en «Webhook», además necesita un evento.
7. En «Confirma que eres tú», escribe tu «Contraseña actual» y confirma. Si tu cuenta tiene passkey o código de la app, puedes confirmar con eso.
8. En «Tu API quedó lista», pulsa «Copiar» y guarda el «Token de consulta» en un lugar seguro. Con la flecha del mismo botón puedes elegir «Descargar .txt». Después pulsa «Ya las guardé».

Resultado#

Se abre la ficha de tu llave, con el estado «Activa». La llave ya no se vuelve a mostrar. En «Integraciones» aparece en la lista con sus «Recursos», sus webhooks y su «Última llamada».

Preguntas frecuentes#

¿Qué alcanza esta llave? Exactamente lo que tu red ya ve en su panel, y ni una columna más. De las órdenes de tus talleres no salen el cliente, la placa, los costos ni los márgenes: eso no es de la red ni con permiso.

Un taller se desvinculó ayer. ¿Sigue saliendo? No. Cada consulta y cada aviso vuelven a resolver los vínculos vivos y los permisos vigentes en ese momento: el taller que se fue desaparece al instante, aunque la llave sea la misma.

¿Mis franquiciatarios se enteran de estas consultas? Sí. Las consultas de red quedan registradas una por una en la bitácora de la empresa dueña de cada taller, igual que cuando abres su detalle a mano.

¿Mi sistema puede cambiar algo? No. Es una salida de solo consulta; la red nunca escribe sobre la operación de un franquiciatario.

Perdí la llave. Pitflo no la puede volver a enseñar. Se rota desde la ficha: sale una nueva y la anterior deja de servir al instante. Ver Rotar o revocar la llave de una API.

¿Dónde se pone? Solo en un servidor. Es una llave de servidor: nunca dentro de una página web ni de una app del teléfono, porque ahí cualquiera la lee.

¿Dónde están los campos y los ejemplos? En el portal de documentación, al que lleva el botón «Documentación» de esta misma pantalla.