13 October 2026 — API keys guide and sale prices in the backoffice
A new guide covers API keys end to end: where to create one, what vendor scope means, and which scope each endpoint needs.
- API keys — create keys under Developers → API Management with Create API Key: pick a name, the scopes and an optional expiration. Select a vendor in the dashboard before you create the key: with All vendors selected the key has no vendor binding, and endpoints that require one answer
403. - Scopes — every scope in the dashboard, mapped to the endpoints it unlocks, including
cash-management:writeandkiosks:write. - Managing keys — you can edit a key's scopes without changing its secret; name, description and expiration are fixed once created, and there is no built-in rotation (create a new key, switch, then revoke the old one).
- Header — send the key in
x-api-key.Authorization: Bearer pk_live_...still works as a legacy alias; if you send both,x-api-keywins. - List menus and Get menu now link to the guide for the
menu:readscope and the vendor binding.
The backoffice manuals for the catalog are rewritten around sale prices and prices by fulfillment type:
- Price lists — sale prices now live here, next to the price, and also apply inside combos. How far a sale reaches, and why a suggested price is only a struck price, never charged.
- Menus — a menu no longer has a fulfillment type of its own: it takes the one from the assignment row. Three lenses (day, fulfillment type, prices) and the new Overrides tab.
- Menu assignment — sale prices travel with Sync, batches drop from 50 to 20 rows, and price edits saved from the preview only reach aggregators, not POS or Kiosk.
- Modifier groups — adding a group to a product copies it: later edits to the group don't reach products that already have it. Different questions per fulfillment type.
- Products — combos have no price of their own: the customer pays the sum of the options picked. The "from" reference price, sales inside a combo and prices by fulfillment type.
Updated in EN / ES / PT.
Español
13 de octubre de 2026 — Guía de API keys y precios de oferta en el backoffice
Una guía nueva cubre las API keys de principio a fin: dónde crear una, qué significa el vendor scope y qué scope necesita cada endpoint.
- API keys — las keys se crean en Developers → API Management con Create API Key: eliges un nombre, los scopes y una expiración opcional. Selecciona un vendor en el dashboard antes de crear la key: con All vendors seleccionado la key queda sin vínculo de vendor, y los endpoints que lo exigen responden
403. - Scopes — todos los scopes del dashboard, con los endpoints que habilita cada uno, incluidos
cash-management:writeykiosks:write. - Administrar keys — puedes editar los scopes de una key sin cambiar su secreto; el nombre, la descripción y la expiración quedan fijos al crearla, y no hay rotación integrada (crea una key nueva, cambia y luego revoca la anterior).
- Header — envía la key en
x-api-key.Authorization: Bearer pk_live_...sigue funcionando como alias legacy; si envías ambos, ganax-api-key. - Listar menús y Obtener menú ahora enlazan a la guía para el scope
menu:ready el vínculo de vendor.
Los manuales del backoffice para el catálogo se reescribieron en torno a los precios de oferta y los precios por tipo de entrega:
- Listas de precios — las ofertas ahora viven aquí, junto al precio, y también aplican dentro de los combos. Hasta dónde llega una oferta y por qué un precio sugerido es solo un precio tachado que nunca se cobra.
- Menús — un menú ya no tiene tipo de entrega propio: toma el de la fila de asignación. Tres lentes (día, tipo de entrega, precios) y la nueva pestaña Overrides.
- Asignación de menús — los precios de oferta viajan con Sync, las tandas bajan de 50 a 20 filas y los cambios de precio guardados desde la vista previa solo llegan a los agregadores, no a POS ni Kiosco.
- Grupos de modificadores — agregar un grupo a un producto lo copia: los cambios posteriores al grupo no llegan a los productos que ya lo tienen. Preguntas distintas por tipo de entrega.
- Productos — los combos no tienen precio propio: el cliente paga la suma de las opciones que elige. El precio de referencia "desde", las ofertas dentro de un combo y los precios por tipo de entrega.
Actualizado en EN / ES / PT.
Português
13 de outubro de 2026 — Guia de API keys e preços promocionais no backoffice
Um novo guia cobre as API keys de ponta a ponta: onde criar uma, o que significa o vendor scope e qual scope cada endpoint exige.
- API keys — as keys são criadas em Developers → API Management com Create API Key: você escolhe um nome, os scopes e uma expiração opcional. Selecione um vendor no dashboard antes de criar a key: com All vendors selecionado a key fica sem vínculo de vendor, e os endpoints que o exigem respondem
403. - Scopes — todos os scopes do dashboard, com os endpoints que cada um libera, incluindo
cash-management:writeekiosks:write. - Gerenciar keys — você pode editar os scopes de uma key sem mudar o segredo dela; nome, descrição e expiração ficam fixos depois de criada, e não há rotação integrada (crie uma key nova, troque e depois revogue a antiga).
- Header — envie a key em
x-api-key.Authorization: Bearer pk_live_...continua funcionando como alias legacy; se você enviar ambos,x-api-keyvale. - Listar menus e Obter menu agora apontam para o guia sobre o scope
menu:reade o vínculo de vendor.
Os manuais do backoffice para o catálogo foram reescritos em torno dos preços promocionais e dos preços por tipo de entrega:
- Listas de preços — as promoções agora ficam aqui, ao lado do preço, e também valem dentro dos combos. Até onde uma promoção chega e por que um preço sugerido é só um preço riscado que nunca é cobrado.
- Menus — um menu não tem mais tipo de entrega próprio: ele usa o da linha de atribuição. Três lentes (dia, tipo de entrega, preços) e a nova aba Overrides.
- Atribuição de menus — os preços promocionais viajam com o Sync, os lotes caem de 50 para 20 linhas e as alterações de preço salvas na pré-visualização só chegam aos agregadores, não ao POS nem ao Quiosque.
- Grupos de modificadores — adicionar um grupo a um produto o copia: alterações posteriores no grupo não chegam aos produtos que já o têm. Perguntas diferentes por tipo de entrega.
- Produtos — combos não têm preço próprio: o cliente paga a soma das opções que escolhe. O preço de referência "a partir de", as promoções dentro de um combo e os preços por tipo de entrega.
Atualizado em EN / ES / PT.
Read the full changelog · Ver el registro completo · Ver o registro completo