Skip to main content
Propuesta — todavía no implementada en XMART_BACKOFFICE. Este tab documenta un diseño, no un contrato en vivo. No construyas contra esto hasta que se lance. Hoy, menu.updated es la única forma en que Fire publica menús, y lleva el catálogo completo en cada evento.

​
Objetivo

menu.updated envía el menú completo — cada categoría, producto y grupo de modificadores — en cada publicación. Eso es simple de consumir, pero significa que una tienda con un catálogo grande paga el mismo tamaño de payload por un cambio de precio de una línea que por una re-publicación completa, y cada suscriptor recibe datos que puede no haber pedido. La entrega híbrida divide la misma información en dos pasos:
  1. Un webhook de notificación — menu.list_ready — le dice a tu sistema que un menú está listo para leerse, con solo los ids necesarios para identificarlo. Sin datos de catálogo.
  2. Un fetch a demanda — GET /v1/menus/{syncId} — tu sistema lo llama cuando realmente necesita el menú, usando el syncId del evento de notificación.

​
Alcance

Este patrón está acotado a menús solamente. menu.updated sigue funcionando exactamente igual que hoy, para siempre — esto es una alternativa, no un reemplazo. Elegí lo que más te convenga:

​
Catálogo de métodos

​
Entrega

menu.list_ready se entrega exactamente igual que cualquier otro webhook de Fire — mismo mecanismo, solo un body más liviano. Fire lo envía como application/json al endpoint que configurás por integración desde el dashboard (Agregadores → Herramientas de desarrollo → Integraciones de agregadores), por ejemplo https://tuapp.com/webhooks/menu-list-ready. No hay un canal de entrega nuevo acá, solo un tipo de evento nuevo.

​
Headers de la petición

GET /v1/menus/{syncId} se autentica distinto — tu sistema llama a Fire, así que necesita una credencial de API en vez de una firma. Ver Autenticación en esa página.