Skip to main content
A impressão fiscal e o cancelamento falam com a Fire com um host e uma API key. Se a cozinha usa o padrão da conta numa loja de outro vendor, o ticket não imprime e o cancelamento não chega — e na tela o pedido continua “pronto”. Esta página é para quem configura KDS → Credenciais Fire. O operador na TV da cozinha não vê este formulário.
O mínimo que você precisa saber
  • Vendor ID vazio = Padrão da conta. Uma linha com vendor ID substitui esse padrão só para esse vendor.
  • Base URL é só o host da Fire (https://br.app.fire.rest). Sem path, query ou hash: o fire-kds acrescenta sozinho as rotas de print e cancel.
  • A mesma key guardada serve para os dois trabalhos: fiscal print envia Bearer; cancel envia x-api-key.

​
O caminho simples

1

Abra Credenciais Fire

Vá em KDS → Credenciais Fire (/kds/admin/fire-credentials).
2

Adicione um padrão da conta

Clique em Adicionar credencial. Deixe Vendor ID vazio. Cole a Base URL (só host https) e a API key. Deixe Ativa ligada. Clique em Criar.
3

Adicione um override por vendor só se precisar

Se uma marca fala com outro host ou key da Fire, crie uma segunda linha e preencha Vendor ID. Essa linha vale para esse vendor; as demais lojas continuam no padrão da conta.
Lista de credenciais Fire API com padrão da conta e escopos por vendor
Se todas as lojas da conta usam o mesmo ambiente Fire, o padrão da conta basta. Você pode parar aqui.

​
Padrão da conta vs override por vendor

A resolução em runtime é sempre: linha de vendor → padrão da conta → variáveis de ambiente (FISCAL_PRINT_* para print; cancel pode cair em FIRE_*). Print nunca lê FIRE_API_*.
Formulário de nova credencial Fire API com vendor vazio para o padrão da conta
Formulário de credencial Fire API com um Vendor ID de override

​
Campos

​
Receitas

  1. Crie uma única linha com Vendor ID vazio.
  2. Use o host daquele país (por exemplo https://br.app.fire.rest).
  3. Deixe-a Ativa.
  4. Não crie linhas de vendor a menos que uma marca use outra key de verdade.
  1. Mantenha o padrão da conta para as demais lojas.
  2. Adicionar credencial, cole o Vendor ID dessa franquia e a key dela.
  3. Confirme que a lista mostra Vendor para esse id e Padrão da conta para o resto.
  1. Abra Editar na linha.
  2. Cole a API key nova (a anterior nunca aparece).
  3. Salve. O próximo print ou cancel usa a key nova.
  1. Desative ou Exclua a linha de vendor.
  2. Excluir é permanente: o runtime cai no padrão da conta e depois no env.
  3. Confirme que uma impressão de teste ainda funciona numa loja desse vendor.

​
Exemplo com números

​
Erros que saem caro

Um path na Base URL. Valores como https://br.app.fire.rest/v1/print são recusados. O fire-kds monta /fiscal-print e cancel sozinho. Se você forçar um path, print e cancel erram o endpoint.
Padrão da conta no vendor errado. Uma loja do vendor B que cai na key A recebe 401 / 403. Os comprovantes ficam na fila e o cancelamento mostra O Fire rejeitou o cancelamento.
http:// ou uma URL com query ou hash. Só se aceita host https:// (porta opcional). Userinfo (user:pass@) também é recusado.

​
Glossário

​
Perguntas frequentes

Não. Só o host. Os paths não se editam nesta tela.
Não. Uma key guardada. Print envia Bearer; cancel envia x-api-key.
O runtime usa as variáveis de ambiente do servidor fire-kds, se existirem. Se não, print e cancel falham até você criar outra linha.
Não. O backoffice responde conflito: já existe uma credencial para esse padrão da conta ou vendor.

​
O que esta página não faz

  • Não configura o Agente Fire (impressora local). Veja Periféricos, impressão e validação.
  • Não escolhe Brasil v1 versus Equador v2 — o fire-kds escolhe a versão pelo país da loja.
  • Não mostra um formulário ao operador da cozinha. Ele só vê o resultado de print/cancel.
Para a cascata e a chamada HTTP, veja Credenciais Fire do KDS (técnico).