Fire Docs

Archives
Log in
Subscribe
October 13, 2026

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:write and kiosks: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-key wins.
  • List menus and Get menu now link to the guide for the menu:read scope 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:write y kiosks: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, gana x-api-key.
  • Listar menús y Obtener menú ahora enlazan a la guía para el scope menu:read y 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:write e kiosks: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-key vale.
  • Listar menus e Obter menu agora apontam para o guia sobre o scope menu:read e 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

Don't miss what's next. Subscribe to Fire Docs:
← Newer 21 October 2026 — Import and export the catalog Older → 6 October 2026 — New endpoint: list a store's terminals
Powered by Buttondown, the easiest way to start and grow your newsletter.