Avisar a tu sistema cuando pase algo

Pitflo le avisa a tu sistema en el momento en que pasa algo en el taller —entra una orden, se registra un cobro, se timbra una factura—, para que no tenga que estar preguntando.

Antes de empezar#

• Necesitas el permiso de «Integraciones» con alcance de «Toda la empresa» (de fábrica, el Superadministrador y el Administrador) y el plan Empresarial.
• Necesitas una API ya creada y la dirección de tu sistema que va a recibir los avisos. Te la da quien te integra y tiene que empezar con https.
• Solo se avisan eventos de recursos que tu API expone. Para oír los cobros, por ejemplo, tu API tiene que exponer «Cobros».
• Cada API admite hasta 3 webhooks.

Pasos#

1. En el menú, en el grupo «Control», entra a «Integraciones» y abre tu API. Si tienes varias sucursales, elige primero la fila «Todas las sucursales» en el selector de arriba del menú.
2. En el panel «Webhooks», pulsa «Agregar webhook».
3. Escribe la dirección de tu sistema en «URL (https)».
4. En «Avisar cuando…», marca los eventos que quieres oír, por ejemplo «Entra una orden» o «Se registra un cobro». Están agrupados por recurso; «Elegir todos» marca el grupo completo.
5. Pulsa «Agregar webhook».
6. En «Webhook agregado», pulsa «Copiar» y guarda el secreto: se muestra una sola vez. Entrégaselo a quien te integra; con él su sistema comprueba que cada aviso viene de Pitflo.
7. Pulsa «Ya las guardé».

Si apenas vas a generar la API, los mismos dos campos están en el panel «Webhook» del alta. En ese caso el secreto aparece junto al token, en «Tu API quedó lista».

Resultado#

El webhook aparece en la tabla con el estado «Entregando». Desde ese momento, cada vez que pase algo de lo que marcaste, Pitflo lo manda a tu URL, firmado. Si tu sistema no contesta, el aviso se reintenta con esperas cada vez más largas —de un minuto a ocho horas—, hasta seis intentos.

Preguntas frecuentes#

¿Qué pasa si mi sistema se cae varios días? Cada aviso agota sus intentos y queda como no entregado. Si fallan diez seguidos, el webhook se apaga solo: su estado cambia a «Apagado» y te avisamos por correo. Cuando tu sistema vuelva, lo reactivas desde la misma tabla.

El evento que quiero sale apagado. Debajo dice, por ejemplo, «Expón Citas para oír este evento»: tu API no expone ese recurso. Cierra la ventana, marca el recurso en «Qué expone» y vuelve a agregar el webhook.

¿Pitflo avisa cuando borro algo? Sí, para clientes, vehículos y órdenes: «Se da de baja un cliente», «Se da de baja un vehículo», «Se da de baja una orden» y «Se restaura una orden». Sirven para que tu sistema borre también su copia; de los datos que ya se llevó, el responsable sigues siendo tú.

¿Me avisa cuando cierro o reabro un mes? Sí: «Se cierra un mes contable» y «Se reabre un mes contable», en el grupo «Cierres contables». Para oírlos, tu API tiene que exponer «Cierres contables». Sirven para que tu sistema pida la póliza del mes en cuanto quede cerrada, y deje de usarla si el mes se reabre.

¿Me avisa de las notas de crédito de mis proveedores? Sí: «Se registra una nota de crédito del proveedor» y «Se cancela una nota de crédito del proveedor», en el grupo «Notas de crédito del proveedor»; y «Se aplica una nota de crédito a una factura» y «Se reversa la aplicación de una nota de crédito», en el grupo «Aplicaciones de notas de crédito». Cada grupo exige exponer su recurso. Sirven para que tu sistema baje el saldo de la factura del proveedor sin esperar un pago.

Perdí el secreto del webhook. En la fila del webhook, abre el «⋯» que aparece al final de su primera columna y elige «Rotar secreto». Sale uno nuevo, y durante 24 horas las entregas van firmadas con los dos para que tu sistema cambie sin perder avisos.