☰ Menú · Restaurantes y cafeterías
Restaurantes y cafeterías
Tres cosas que el TPV de un local puede hacer con Loyaltyfy: mantener la carta QR sincronizada, recibir pedidos desde las mesas y gestionar la fidelización en la caja.
Sincronización de la carta
Normalmente el TPV es la fuente de verdad de los precios y de lo que está agotado. Asigna a cada plato tu SKU en external_id y refiérete a los platos por ese SKU; nunca necesitas guardar nuestros ids.
- 1Lee lo que hay
GET /v1/menudevuelve categorías, platos y modificadores en todos los idiomas. Añade?lang=enpara obtener textos simples en un solo idioma. - 2Crea lo que falta
POST /v1/menu/itemsconcategory(un id de categoría o tu código de categoría; un código desconocido crea la categoría),external_id,nameen uno o varios idiomas yprice. Si vuelves a enviar el mismoexternal_id, recibes el plato existente. - 3Envía los cambios
Con cada cambio, o cada pocos minutos, envía
POST /v1/menu/items/bulkcon precios y disponibilidad. Hasta 500 platos por llamada; los SKU desconocidos vuelven ennot_found.
curl https://loyaltyfy.io/api/v1/menu/items/bulk \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{
"items": [
{ "item": "1001", "price": 4800 },
{ "item": "2040", "available": false },
{ "item": "3017", "price": 9900, "old_price": 12000 }
]
}'{
"object": "menu_bulk_result",
"updated": ["1001", "2040"],
"unchanged": [],
"not_found": ["3017"],
"failed": []
}Productos agotados: available: false deja el plato visible con la etiqueta "agotado" y quita el botón de pedir; visible: false lo oculta. Los modificadores tienen su propio interruptor, así que puedes desactivar la leche de avena sin desactivar el café:
curl -X PATCH https://loyaltyfy.io/api/v1/menu/option_values/MOD-OAT \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{ "available": false }'Pedidos desde la mesa
Con los pedidos activados (Menú → Pedidos en el panel), los clientes que escanean el QR de la mesa pueden enviar su carrito al local. Cada mesa tiene su propio enlace con el número de mesa:
https://loyaltyfy.io/m/your-venue?table=12Calculamos el precio de cada pedido en nuestro lado a partir de la carta actual, así que el TPV puede fiarse de los importes. Los pedidos con un plato o un modificador agotado se rechazan antes de llegar a ti.
- 1Recibe los pedidos nuevos
Suscríbete al webhook
order.createdo consultaGET /v1/orders?status=newcada 10 o 15 segundos. - 2Acepta
Crea el pedido en el TPV y luego llama a
POST /v1/orders/{id}/acceptcon tu propio id de pedido comoexternal_id. Usa elexternal_idde cada línea para casar tus SKU. - 3Hazlo avanzar
PATCH /v1/orders/{id}conpreparing,ready,served,completed. OPOST /v1/orders/{id}/rejectcon un motivo si la cocina no puede prepararlo.
curl "https://loyaltyfy.io/api/v1/orders?status=new" \
-H "Authorization: Bearer sk_test_..."{
"object": "order",
"id": "0c69a81c-0fbc-4333-b26c-789566b9bea4",
"number": 10,
"day_number": 3,
"type": "table",
"status": "new",
"table": "7",
"location": null,
"pickup_at": null,
"pickup_lead_minutes": null,
"guest": null,
"note": "No onions, please",
"currency": "MDL",
"subtotal": 14000,
"item_count": 2,
"items": [
{
"item_id": "a48343bd-9f6e-424a-b003-fe790617f4d6",
"external_id": "2040",
"name": "Zeamă",
"quantity": 2,
"unit_price": 7000,
"total": 14000,
"options": []
}
],
"payment": { "method": "cash", "status": "unpaid", "provider": null, "reference": null, "paid_at": null },
"external_id": null,
"reject_reason": null,
"guest_language": "en",
"source": "qr_menu",
"loyalty_transaction_id": null,
"history": [],
"livemode": true,
"created_at": "2026-10-06T18:14:48.233+00:00",
"accepted_at": null,
"prepared_at": null,
"picked_up_at": null,
"completed_at": null,
"updated_at": "2026-10-06T18:14:48.233+00:00"
}curl -X POST https://loyaltyfy.io/api/v1/orders/0c69a81c-0fbc-4333-b26c-789566b9bea4/accept \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{ "external_id": "POS-ORDER-55821" }'Los estados solo avanzan: new → accepted → preparing → ready → served → completed; new también puede pasar a rejected, y cualquier pedido abierto puede pasar a cancelled. Puedes saltarte pasos (de aceptado directamente a completado no hay problema). Un paso hacia atrás recibe 409 invalid_status_transition. Los locales sin integración con TPV gestionan los mismos estados en la pantalla Pedidos, así que no pasa nada si tu TPV solo acepta y completa.
Pedidos para llevar
Con los pedidos para llevar activados (Menú → Pedidos), el cliente elige local, hora y deja su teléfono. Estos pedidos tienen type: pickup, location, pickup_at y guest. Van new → accepted → ready → completed, donde completed significa entregado; served no se usa. La entrega suma la fidelidad del cliente por teléfono y envía transaction.completed. El equipo también puede llevarlos desde Telegram, así que el estado puede cambiar sin ti. Filtro: GET /v1/orders?type=pickup&location={id}.
{
"object": "order",
"id": "5b1f0c2e-8d4a-4c1b-9a7e-2f3d6e8a1c90",
"number": 1184,
"day_number": 12,
"type": "pickup",
"status": "accepted",
"table": null,
"location": { "id": "e3c1a9b2-4f5d-4e6a-8b7c-1d2e3f4a5b6c", "name": "Centru", "address": "Ștefan cel Mare 120" },
"pickup_at": "2026-10-24T09:42:00.000+00:00",
"pickup_lead_minutes": 15,
"guest": { "name": "Ana", "phone": "+37369123456" },
"note": "Oat milk, please",
"currency": "MDL",
"subtotal": 9000,
"item_count": 2,
"items": [
{
"item_id": "7a2b3c4d-5e6f-4a1b-8c9d-0e1f2a3b4c5d",
"external_id": "1001",
"name": "Cappuccino",
"quantity": 2,
"unit_price": 4500,
"total": 9000,
"options": [{ "id": "9f8e7d6c-5b4a-4c3d-8e2f-1a0b9c8d7e6f", "external_id": "OAT", "name": "Oat milk", "price_delta": 500 }]
}
],
"payment": { "method": "cash", "status": "unpaid", "provider": "cash", "reference": null, "paid_at": null },
"external_id": null,
"reject_reason": null,
"guest_language": "ro",
"source": "qr_menu",
"loyalty_transaction_id": null,
"history": [{ "status": "accepted", "at": "2026-10-24T09:28:10.000+00:00", "by": "Ion", "via": "telegram" }],
"livemode": true,
"created_at": "2026-10-24T09:27:31.000+00:00",
"accepted_at": "2026-10-24T09:28:10.000+00:00",
"prepared_at": null,
"picked_up_at": null,
"completed_at": null,
"updated_at": "2026-10-24T09:28:10.000+00:00"
}Fidelización en la caja de la cafetería
Igual que cualquier integración con TPV: busca al cliente cuando escanea la tarjeta y envía el ticket cuando está pagado. En cafeterías con tarjeta de sellos («el 6.º café gratis»), el sello se gana con el ticket. Envía line_items con tus referencias para que el local vea qué productos compran sus clientes.