API y webhooks¶
Conecta Kitchfly con otros programas: Zapier, Make, Google Sheets, tu contador o un programador.
- Una llave de acceso deja que otro programa lea tus datos (ventas, pedidos, menú…).
- Un webhook hace que Kitchfly avise al instante a otro programa cuando algo pasa (se cierra una venta, llega un pedido, un cliente acepta promociones…).
Está incluido en los planes Básico y Pro. Solo el admin puede crear llaves y webhooks, y cada sucursal tiene los suyos.
Crear una llave¶
- Ve a Configuración → Integraciones → API y webhooks.
- Toca Nueva llave, ponle un nombre (por ejemplo, "Zapier" o "Mi contador") y marca qué puede ver. Los permisos de Clientes y Turnos del equipo incluyen datos personales: dalos solo si de verdad hacen falta.
- Toca Crear llave y cópiala. Es la única vez que se ve completa.
Cuida tu llave como una contraseña
Quien la tenga puede leer los datos que permite. Si crees que alguien más la tiene, toca Revocar y crea otra. Por ahora las llaves solo leen: no pueden cambiar nada en Kitchfly.
Crear un webhook¶
- En la misma pantalla toca Nuevo webhook.
- Pega la dirección que te dio el otro programa (debe empezar con
https://) y elige cuándo avisar. - Guarda. Kitchfly te muestra el secreto para verificar la firma (lo necesita quien programa el destino).
- Toca Probar para mandar un aviso con datos de ejemplo y ver si llegó.
En Registro ves los últimos avisos (se guardan 30 días): si llegaron, la respuesta del destino y lo que se mandó. Si uno falla, Kitchfly lo reintenta a los 1, 5, 30, 120 y 360 minutos. Si un webhook falla 25 veces seguidas, se desactiva y te llega un aviso.
Los webhooks que crea Zapier también aparecen aquí con la etiqueta Zapier. Si borras la llave de Zapier, se borran también.
Eventos¶
| Evento | Cuándo se manda | Permiso |
|---|---|---|
order.closed |
Se cierra (cobra) una venta | Ventas |
online_order.created |
Llega un pedido en línea | Pedidos en línea |
customer.created |
Se agrega un cliente nuevo | Clientes |
customer.opted_in |
Un cliente acepta recibir promociones | Clientes |
catering.requested |
Llega una solicitud de catering | Catering |
catering.confirmed |
Se confirma un catering | Catering |
inventory.low_stock |
Un ingrediente queda por debajo de su mínimo | Inventario |
shift.ended |
Alguien termina su turno en el reloj checador | Turnos del equipo |
Para programadores¶
La documentación técnica está en inglés: API & webhooks. En resumen:
- Dirección base:
https://app.kitchfly.com/api/v1 - La llave va en el encabezado
X-API-Key(oAuthorization: Bearer …). - Respuestas en JSON y en inglés, montos en dólares, fechas ISO 8601.
- Hasta 120 consultas por minuto por llave.
- Cada webhook va firmado en
X-Kitchfly-Signature(HMAC-SHA256 con el secreto).
Preguntas frecuentes¶
¿Puedo conectar Kitchfly con Google Sheets sin programar? Sí, con Zapier o Make: crea una llave para ellos y elige el evento que quieras mandar a tu hoja. Mira las recetas en Kitchfly + Zapier.
¿Se mandan datos de tarjetas? No. Nunca salen números de tarjeta; a lo más, la marca y los últimos 4 dígitos.
¿Cuántas llaves y webhooks puedo tener? Hasta 20 llaves activas y 100 webhooks por sucursal.