MenuNode para desarrolladores
Conecta la caja, el stock, el delivery o una automatización con un restaurante en MenuNode. Todo lo que sigue funciona hoy y lo describe la especificación OpenAPI.
Abrir la especificación OpenAPI
La API (/api/v1)
Una API REST para un restaurante: leer la carta, los pedidos, las reservas y las opiniones, y cambiar precios o platos agotados. La dirección base es https://menunode.com/api/v1.
- Cada llamada lleva
Authorization: Bearer <clave>. Las cookies del panel nunca sirven para esta API. - Límite: 120 llamadas por minuto por clave. Cada respuesta trae
X-RateLimit-Limit,X-RateLimit-RemainingyX-RateLimit-Reset; al pasarte, 429 conRetry-After. - Los errores siempre son
{"error": {"code": "...", "message": "..."}}. Un id de otro restaurante responde 404, igual que uno que no existe. Un método que la ruta no acepta responde 405 con el encabezadoAllow. - Los montos son texto con dos decimales (
"12.50") en la moneda del restaurante. - Las listas van por páginas: manda el
next_cursorde la respuesta comocursorpara traer la siguiente.
curl https://menunode.com/api/v1/restaurant \
-H "Authorization: Bearer pat_…"| Ruta | Método | Qué hace | Permiso |
|---|---|---|---|
/restaurant | GET | El restaurante de la clave. Sirve con cualquier permiso. | — |
/hours | GET | Horarios, días especiales, horario de pedidos y reglas de reserva de un local (branch_id). | — |
/menu | GET | La carta entera con el precio y la disponibilidad de este momento. | menu:read |
/items/{id} | PATCH | Cambiar el precio de un plato o marcarlo agotado (sold_out_today, sold_out, available). | menu:write |
/orders | GET | Pedidos confirmados, del más nuevo al más viejo, con filtros por fecha, estado y pago. | orders:read |
/order-links | POST | Un link a la página de pedido con el carrito ya cargado: el comensal confirma y paga ahí. | menu:read |
/reservations | GET | Reservas confirmadas en orden de calendario. | reservations:read |
/reviews | GET | Las respuestas de los clientes a "¿Cómo te fue?". | reviews:read |
/webhooks | GET POST | Listar y crear direcciones de aviso. | webhooks:write |
/webhooks/{id} | GET PATCH DELETE | Ver, cambiar (eventos, local, pausa) o borrar una dirección de aviso. | webhooks:write |
/webhooks/{id}/test · /rotate-secret | POST | Mandar un aviso de prueba o cambiar la clave de firma. | webhooks:write |
/webhooks/{id}/deliveries · …/resend | GET POST | Historial de envíos y reenviar uno. | webhooks:write |
/feeds/menu.json · /feeds/menu.csv | GET | La carta en columnas fijas, JSON o CSV, con los platos ocultos. | menu:read |
Cómo sacar una clave
El dueño la crea en el panel, en Configuración → Integraciones → API para integraciones: le pone un nombre y elige los permisos. La clave empieza con pat_ y se muestra una sola vez; MenuNode guarda solo su huella, así que si se pierde se crea otra y se borra la vieja.
- Una clave es de un restaurante. Ningún parámetro la apunta a otro.
- Un permiso de escritura incluye el de lectura (
menu:writetambién lee la carta). - Una clave de un solo local ve solo los pedidos y reservas de ese local. No puede cambiar el precio ni el agotado de toda la carta (403
branch_scoped) ni manejar avisos (403branch_token_not_allowed).
| Permiso | Qué hace |
|---|---|
menu:read | Leer la carta, los horarios y los archivos de carta. |
menu:write | Lo anterior y cambiar precios y platos agotados. |
orders:read | Leer pedidos y recibir los avisos de pedidos y de cuentas de mesa. |
reservations:read | Leer reservas y la lista de espera. |
reviews:read | Leer opiniones (llevan nombre y mail del cliente). |
webhooks:write | Crear y manejar direcciones de aviso. |
Servidores MCP para asistentes de IA
MCP es el protocolo con el que un asistente de IA (Claude, ChatGPT y otros) usa herramientas. MenuNode tiene dos servidores.
El público, en https://menunode.com/mcp, no pide clave. Sirve para buscar restaurantes, leer su carta e información, preguntar algo que la carta no responde, ver horarios libres y, donde el restaurante lo activó, pedir, reservar o anotarse en la lista de espera. Pedidos, reservas y lista de espera siempre se confirman con un código de 6 números que le llega por mail al comensal.
- Lectura:
search_restaurants,get_restaurant_info,get_menu,get_menu_structured(conavoid, los alérgenos que el comensal evita),quote_group,list_available_slots,check_availability. - Pedidos:
prepare_order_link,create_orderyconfirm_order,get_order_status. - Reservas:
create_reservationyconfirm_reservation,get_reservation,change_reservation,cancel_reservation,create_availability_alertyconfirm_availability_alert. - Lista de espera:
get_waitlist_status,join_waitlistyconfirm_waitlist,get_waitlist_position,leave_waitlist. - Preguntas:
ask_restaurant(la respuesta del restaurante se publica enget_restaurant_info).
El del dueño, en https://menunode.com/mcp/owner, pide una clave (Authorization: Bearer pat_…). Con menu:write el asistente arma y edita la carta: secciones, platos, precios por horario, agotados, traducciones, importar una carta desde texto (import_menu_from_raw_text) o cargarla entera (bulk_upsert_menu). Otras herramientas piden su propio permiso: pedidos y reservas (orders:read, orders:status, reservations:read, reservations:status), opiniones, clientes (customers:read), lista de espera, pausa de pedidos, días especiales y números de la carta. En el panel, Configuración → Integraciones → Enseñale a tu IA a usar tu restaurante arma la clave y los pasos para conectarla.
Avisos a tu sistema (webhooks)
MenuNode manda un POST a una dirección https tuya cada vez que pasa algo. Se registra desde el panel (Configuración → Integraciones) o con POST /webhooks. Hasta 10 direcciones por restaurante; cada una elige sus avisos y, si el restaurante tiene varios locales, uno solo: entonces le llegan los pedidos, reservas, lista de espera, cuentas, horarios, opiniones y agotados de ese local, y los cambios de toda la carta.
El cuerpo es {id, type, api_version, timestamp, restaurant_id, data}. Una clave solo puede suscribirse a los avisos que podría leer con sus permisos.
- Para atar una dirección a un local: elígelo en "Qué local" del panel, o manda
branch_idal crear o cambiar la dirección (null= todos los locales). - Firma (Standard Webhooks): los encabezados
webhook-id,webhook-timestampywebhook-signature. La firma esv1,y el HMAC-SHA256 en base64 deid.timestamp.cuerpo, con la parte en base64 de tu clavewhsec_…como llave. Rechaza horas con más de 5 minutos de diferencia. - Responde con un 2XX en menos de 10 segundos. Si no, se reintenta 5 veces (1 min, 5 min, 30 min, 2 h y 12 h) con el mismo
webhook-id: úsalo para no procesar dos veces lo mismo. Las redirecciones no se siguen. - Una dirección que responde 410, o que falla sin parar por más de un día, se apaga sola y el dueño recibe un mail.
menu.updatedse junta: muchos cambios seguidos mandan uno, más o menos un minuto después del último (a lo sumo 5 minutos después del primero).hours.updatedse junta por local unos 10 segundos.- Desde el panel o la API puedes mandar un aviso de prueba, ver los últimos envíos y reenviar uno. La clave de firma se muestra una sola vez; si se pierde, se cambia por otra.
const { createHmac, timingSafeEqual } = require('node:crypto');
// headers: the request headers; rawBody: the body exactly as received (before JSON.parse).
function verify(secret, headers, rawBody) {
const id = headers['webhook-id'];
const ts = headers['webhook-timestamp'];
if (Math.abs(Date.now() / 1000 - Number(ts)) > 300) return false;
const key = Buffer.from(secret.slice('whsec_'.length), 'base64');
const expected = createHmac('sha256', key).update(id + '.' + ts + '.' + rawBody).digest();
return headers['webhook-signature'].split(' ').some((part) => {
const given = Buffer.from(part.split(',')[1] ?? '', 'base64');
return part.startsWith('v1,') && given.length === expected.length && timingSafeEqual(given, expected);
});
}| Aviso | Qué hace | Permiso |
|---|---|---|
order.created | Pedido nuevo | orders:read |
order.status_changed | Cambio de estado de un pedido | orders:read |
reservation.created | Reserva nueva | reservations:read |
reservation.updated | Cambios en una reserva | reservations:read |
waitlist.joined | Alguien se anotó en la lista de espera | reservations:read |
waitlist.updated | Cambios en la lista de espera | reservations:read |
menu.updated | Cambios en el menú (agrupados por minuto) | menu:read |
item.sold_out | Plato agotado | menu:read |
item.available | Plato disponible otra vez | menu:read |
order.payment_changed | Pago de un pedido (avisado, recibido, devuelto) | orders:read |
hours.updated | Cambió el horario | menu:read |
review.received | Llegó una opinión | reviews:read |
order.updated | Pedido cambiado (falta un plato o se sacó) | orders:read |
bill.issued | Se hizo la cuenta de una mesa | orders:read |
bill.paid | Se pagó la cuenta de una mesa | orders:read |
bill.voided | Se anuló la cuenta de una mesa | orders:read |
Archivos de carta y calendario
- Públicos, sin clave:
/m/<restaurante>/menu.jsony/m/<restaurante>/menu.csv, con lo mismo que muestra la carta (langpara el idioma,branchpara un local). - Con clave
menu:read:/api/v1/feeds/menu.jsony.csv, con los platos ocultos ybranch_idpara un local.format=metadevuelve el formato del catálogo de Meta (WhatsApp e Instagram). - Un calendario de reservas (.ics) con dirección secreta, que el dueño crea y anula en el panel.
- Los archivos responden
ETagy 304 cuando nada cambió.
Recetas para n8n y Make
Para automatizar sin programar. En el panel, Configuración → Integraciones, cada receta baja una plantilla para n8n o para Make y la conecta a un aviso:
- Cada pedido nuevo a una planilla de Google (
order.created). - Cada reserva nueva a un grupo de Telegram (
reservation.created). - Cada pedido nuevo por mail a otra persona (
order.created). - Cada pago de un pedido a una planilla de Google (
order.payment_changed). - Cada cambio de horario por mail a quien actualiza tus otras páginas (
hours.updated).
Las plantillas de n8n salen con una dirección propia para cada descarga.
¿Te falta algo?
Si una integración necesita un dato o una ruta que no está, escríbenos desde contacto o a support@menunode.com.