Crear una API para conectar tu sistema

Al terminar tienes una API propia: una salida de solo consulta por la que tu sistema contable, tu ERP o tus reportes leen los datos de tu taller, con una llave que solo tú guardaste.

Antes de empezar#

• Necesitas el permiso de «Integraciones» con alcance de «Toda la empresa». De fábrica lo tienen el Superadministrador y el Administrador. Si administras solo algunas sucursales, la pantalla te dice «Tu alcance no llega a las integraciones»: pídele a un superadministrador que te dé ese alcance en Usuarios.
• Es del plan Empresarial y no tiene cobro aparte. En los demás planes la entrada del menú aparece con candado y la frase «Disponible en el plan Empresarial».
• La API es de la empresa, no de una sucursal. Si tienes varias razones sociales, creas una API en cada empresa.
• Decide antes dónde vas a guardar la llave: se muestra una sola vez.

Pasos#

1. En el menú, en el grupo «Control», entra a «Integraciones». Si tienes varias sucursales, abre primero el selector de arriba del menú y elige la fila «Todas las sucursales».
2. Pulsa «Generar API».
3. Escribe el «Nombre». Sirve para reconocerla en la lista; tu sistema no lo ve.
4. En «Qué expone», marca cada recurso que tu sistema va a leer —por ejemplo «Órdenes de servicio»— y, debajo, sus campos. Nada viene marcado: lo que no marques no existe para esta API.
5. Si quieres que Pitflo le avise a tu sistema cuando pase algo, llena el panel «Webhook». Es opcional y lo puedes agregar después.
6. Pulsa «Crear API». El botón se enciende cuando hay nombre y al menos un recurso marcado; si escribiste una URL en «Webhook», también necesita al menos un evento.
7. En «Confirma que eres tú», escribe tu «Contraseña actual» y pulsa «Confirmar». Si tu cuenta tiene passkey o código de la app, la ventana te deja 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».
9. Pulsa «Ya las guardé».

Resultado#

Se abre la ficha de tu API, con el estado «Activa». La llave ya no se vuelve a mostrar: en la ficha solo queda su identificador, que empieza con pfk_ y sirve para reconocerla, no para consultar. En «Integraciones» la API aparece en la lista con sus recursos, sus webhooks y su «Última llamada».

Preguntas frecuentes#

Cerré la ventana sin guardar la llave. ¿La puedo volver a ver? No. Pitflo no la puede volver a enseñar. Rota el token desde la ficha: sale una llave nueva y la anterior deja de servir al instante.

¿Mi sistema puede crear o cambiar algo en Pitflo con esta llave? No. La API es solo de consulta: lee lo que marcaste y nada más.

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

¿Necesito una API por sucursal? No. La API es de toda la empresa, y quien consulta puede acotar a una sucursal. Lo que sí se separa son las razones sociales: una API por empresa.