50% de descuento con el código BLACKFRIDAY5020% de descuento con el código BLACKFRIDAY20
Integraciones y APITodos los planes

Webhooks para pedidos nuevos

Un webhook envía cada pedido nuevo, y cada cambio en él, a tu propio sistema como un mensaje JSON firmado. Le das a Menuthere una dirección HTTPS y un secreto, y luego verificas la firma en cada solicitud. Un botón de prueba y un registro de entregas te permiten comprobar que funciona.

Dónde
Set up by Menuthere support
Plan
El panel no bloquea los webhooks por plan.
Tiempo
15 min
Actualizado

Configura un webhook

Paso 1: Envía tu dirección al soporte

Los webhooks todavía no están en el panel, así que el soporte de Menuthere los configura. Envía al soporte la dirección que recibirá los pedidos. Debe empezar con https:// y ser accesible desde internet. Direcciones como localhost o una red privada no se pueden llamar.

Paso 2: Guarda el secreto de firma

El soporte activa los webhooks de pedidos y te da un secreto de firma. Guárdalo solo en tu servidor. Lo usas para comprobar que cada solicitud realmente vino de Menuthere.

Paso 3: Pide un evento de prueba

Pide al soporte que envíe un evento de prueba. Envía un order.created de ejemplo a tu dirección, y el resultado muestra Delivered con el código de respuesta de tu endpoint, o lo que salió mal.

Qué envía Menuthere

EventoSe envía cuando
order.createdSe hace un pedido.
order.status_updatedCambia el estado de un pedido, por ejemplo aceptado, comida lista o completado.
payment.status_updatedUn pedido se marca como pagado, o cambia su forma de pago.
delivery.status_updatedSe asigna un repartidor o cambia el estado de la entrega.
EncabezadoValor
x-menuthere-eventEl nombre del evento.
x-menuthere-timestampHora Unix en segundos, que se define de nuevo en cada intento.
x-menuthere-signatureUn HMAC-SHA256 hexadecimal del cuerpo sin procesar de la solicitud, hecho con tu secreto.

El cuerpo es un sobre con event, un id único, created_at y data. Un evento de prueba también lleva "test": true, así que ignóralo en tu cocina. Para order.created, data contiene los campos de abajo.

CampoContenido
order_id, order_numberEl ID del pedido y el número que ve tu equipo.
status, type, placed_at, currencyEstado actual, tipo de pedido, hora en que se hizo y moneda.
totalssubtotal, delivery_charge, packing_charge, gst, discount, grand_total.
customername, phone, address.
tablenumber y name de la mesa en un pedido de mesa, y vacío en los demás.
itemsCada línea: name, quantity, unit_price, total_price, variant, notes.
notes, paymentLa nota del cliente, y el method de pago y si is_paid.

Verificación y confiabilidad

  • Verifica la firma contra el cuerpo sin procesar. Analizar y volver a codificar el JSON cambia los espacios y el orden, y la firma no coincidirá.
  • Sé idempotente. El mismo id puede llegar dos veces. Úsalo para evitar un segundo ticket de cocina.
  • Responde con un 2xx rápido. Menuthere espera 8 segundos por intento y prueba hasta tres veces, después de 1.5 segundos y luego de 5 segundos. Un tiempo agotado, un 5xx, un 408 o un 429 se reintenta. Cualquier otro 4xx se toma como un no deliberado y se detiene.
  • Revisa Recent deliveries. El panel lista los intentos de las últimas 24 horas, del más reciente al más antiguo, con el código de respuesta y la hora. Cada reintento es su propia fila.
Conviene saberUn endpoint que falla nunca detiene ni retrasa el pedido de un cliente.

Preguntas

¿Puedo apuntarlo a un servidor de mi propia red?
No directamente. La dirección debe ser HTTPS pública. Localhost y las direcciones de red privada se rechazan.
¿Puedo decirle a mi POS que el pedido fue aceptado?
Sí, con la API. Consulta API: actualizar el estado de un pedido.
¿El registro de entregas se guarda para siempre?
El panel muestra los intentos de las últimas 24 horas.

¿No lo encuentras? Escribe a help@mail.menuthere.com o chatea con nosotros, de 9 a. m. a 9 p. m.Centro de ayudaPreciosmenuthere.com