Skip to main content
Registrar um quiosque recém-instalado costumava significar ir a outro sistema, criar um restaurante lá, voltar, e torcer para que as duas pontas batessem. Esta tela substitui tudo isso: você registra o quiosque no Fire com o ID na tela de QR dele, e o Fire o cria no canal — ou adota se já estava lá. Também é a lista mestra da conta. Cada terminal em cada loja, POS e quiosque, em um lugar com filtro por loja. Navegue até Operação → Terminais.
Lista de terminais com filtro de loja e abas de status

​
A versão curta

1. Registrar um quiosque precisa de duas coisas: a loja e o ID do dispositivo. Sem template de restaurante, sem formas de pagamento. Um quiosque nasce sem nada configurado, de propósito.2. Um registro pode meio que dar certo. “Registrado no Fire, mas o canal ainda não o aceitou” é um aviso, não um erro, e o diálogo fecha de qualquer jeito. Aquele quiosque não cobra até que alguém pressione Tentar novamente.3. Formas de pagamento e a senha de administrador funcionam do mesmo jeito: a loja define o padrão, um terminal pode sobrescrever, e sempre há um jeito de voltar a herdar.

​
O caminho simples

Alguém acabou de plugar um quiosque em uma loja e você quer que funcione:
  1. Novo terminal.
  2. Tipo de terminal: KIOSK.
  3. Loja: escolha da lista.
  4. ID do dispositivo: digite, ou pressione o botão QR e escaneie o código que o quiosque está mostrando.
  5. Registrar.
Leia a mensagem que aparece. Se diz Quiosque registrado ou que foi adotado, terminou — o dispositivo está na lista e pronto para ser configurado. Se está amarela, continue lendo: não terminou.
O quiosque mostra seu QR e seu ID do dispositivo na própria tela inicial. Você não precisa anotar nada: o scanner lê.

​
As três maneiras de um registro terminar

Esta é a parte mais importante da tela, porque duas das três parecem sucesso.
Diálogo de registrar um terminal com os campos de quiosque
O terceiro fecha o diálogo igual aos outros dois. O quiosque aparece na lista, parece normal, e não está operando: o canal nunca o recebeu. Nada retenta sozinho. Se você fechar a tela sem ler a mensagem, descobre quando a loja liga dizendo que o quiosque não cobra.
Adoção também não é um erro — é o caminho esperado para um dispositivo que já estava instalado. O Fire não cria um segundo; assume o existente e começa a dirigi-lo.

​
Por que não pede template ou formas de pagamento

Porque o registro acontece no campo, muitas vezes por quem está fisicamente instalando a máquina, e cada pergunta extra é uma chance de errar. Um quiosque sempre nasce sem formas de pagamento. Isso é proposital: se o formulário pré-preenchesse com o que quer que a loja tivesse naquele momento, dois registros idênticos feitos com uma semana de diferença produziriam dois quiosques diferentes, e ninguém saberia por quê. O que ele cobra é decidido depois, desta mesma tela ou de configuração por loja. O template de restaurante também não é exigido. Se existe no canal, o Fire o usa. Se não, o Fire constrói o mínimo dos próprios dados da loja e segue em frente. Parar ali significaria sair para criar um restaurante em outro sistema para registrar uma máquina que já está instalada e plugada. Há uma coisa que a loja precisa ter carregada: país e cidade. Sem eles o canal não pode criar o quiosque, e o registro volta com a mensagem amarela.

​
Sync falhou e Tentar novamente

O cartão só fala quando algo está errado. Não há banner verde dizendo que tudo está bem — isso transformaria a lista em ruído e o único cartão que precisa de atenção se perderia nele.
Cartão de terminal mostrando o aviso de falha de sincronização e o botão Tentar novamente
Um painel âmbar com Sync falhou — ou Não sincronizado — significa que Fire e canal discordam, e o último erro está impresso embaixo. Tentar novamente faz duas coisas em ordem: re-provisiona o quiosque no canal (criando-o, ou adotando-o, se não estava lá) e então empurra as formas de pagamento e a senha. Causas comuns, na ordem que vale verificar:
  1. A loja não tem país ou cidade. Corrija a loja e retente.
  2. O canal estava inacessível quando a mudança foi salva. Retentar geralmente basta.
  3. O quiosque não existe do outro lado — alguém o excluiu lá. A retentativa o recria.
Nada retenta sozinho. Não há retentativa automática e nem retentativa em massa: é um botão por cartão. Um quiosque deixado em Sync falhou continua cobrando com sua configuração anterior por tanto tempo quanto ninguém olhe para ele.

​
Herança e sobrescrita: o padrão que roda a visão de detalhe

Abra o cartão de um terminal — o menu ⋮, então Ver detalhes — e você encontrará duas seções que se comportam identicamente. Em ambas, a loja define o padrão e cada quiosque nela herda. Quando uma máquina precisa diferir, você define o valor naquele terminal e ele se torna uma sobrescrita que só se aplica ali. E em ambas há um jeito explícito de voltar a herdar, porque uma sobrescrita que você não pode desfazer é uma armadilha. Aprenda uma vez, e ambas as seções se leem sozinhas.

​
Senha de administrador

Detalhe do quiosque com as seções de senha de administrador e formas de pagamento
Isto é o que desbloqueia a tela de administração no próprio dispositivo. A linha no topo diz onde o quiosque está atualmente: Herdada da loja, Própria deste terminal, ou Não configurada — este quiosque não tem senha em âmbar. Para mudar, digite sob Nova senha e escolha Aplica-se a:
  • Todos os quiosques desta loja — o padrão, e o que você quer quase sempre.
  • Somente este terminal — cria a sobrescrita.
Voltar à da loja aparece apenas quando há uma sobrescrita, e a remove. A senha nunca é exibida. Você pode ver se uma está definida, não qual é — colocar uma credencial em uma resposta HTTP a deixaria no histórico do navegador. Deve ter pelo menos 6 caracteres; se for menor, o erro volta do servidor depois que você pressiona Salvar senha.
Limpá-la não desbloqueia um dispositivo que já tem uma. O Fire simplesmente para de impor uma senha; não tira a chave que um quiosque já recebeu. Para realmente mudar o que a máquina pede, defina uma nova.

​
Formas de pagamento

Mesma forma, aplicada ao que o quiosque cobra.
Forma de pagamento expandida com os próprios valores do terminal
Cada forma carrega uma legenda dizendo de onde vem sua posição atual: Virar o interruptor cria a sobrescrita para só este dispositivo. Voltar para a da loja a remove e a forma volta a fazer o que quer que a loja faça. O caso para o qual isso existe: três quiosques em uma loja, um com pinpad quebrado. Você desliga a forma de cartão naquele e os outros dois continuam cobrando. Antes, essa era uma decisão que você só podia tomar para a loja inteira. Expandir uma forma mostra Valores deste terminal: os campos que a forma declarou no nível Terminal — um IP de pinpad, um número de série de dispositivo. Se não declara nenhum, diz isso.

​
Caixas POS não são criadas aqui

Escolher POS no seletor de tipo substitui o formulário com um aviso: As caixas POS são pareadas. Um POS é pareado do próprio dispositivo com um código de 6 dígitos, então é criado de sua própria tela — Ir para terminais do POS leva você lá.
Diálogo de registro com POS selecionado mostrando o aviso de pareamento
Os dois caminhos são genuinamente diferentes: um quiosque já carrega sua identidade no QR, então pedir que pareie seria inventar um passo que não protege nada. Veja POS → Vinculação para aquele fluxo. Caixas POS aparecem nesta lista, e você pode administrá-las daqui — veja Administração de terminais para suspender, reativar e revogar.
O guia mais antigo Quiosque → Vinculação descreve registrar quiosques do outro sistema, com template de restaurante e formas de pagamento no modal. É o fluxo anterior. O que este manual descreve é o atual.

​
Receitas: como lidar com casos do mundo real

  1. Novo terminal → digite KIOSK.
  2. Escolha a Loja.
  3. Pressione o botão QR e escaneie o código que o quiosque está mostrando, ou digite o ID do dispositivo manualmente.
  4. Deixe Nome vazio a menos que tenha uma convenção de nomes — o Fire o nomeia pela loja.
  5. Registrar, e leia a mensagem.
Se voltou amarelo, vá ao cartão e pressione Tentar novamente.
Nesta ordem:
  1. Há um painel âmbar no cartão dele? Se sim, Tentar novamente e leia o erro.
  2. Abra o detalhe → Formas de pagamento. Olhe as legendas: Não é oferecida nos quiosques desta loja é um problema da loja, Ajuste deste equipamento: não cobra é uma sobrescrita que alguém deixou.
  3. Se diz Segue a loja: pausada, a pausa é no nível da loja — corrija em configuração por loja.
  4. Se cobra mas falha contra o provedor, a forma provavelmente está faltando um valor obrigatório: procure o chip âmbar na tela da loja.
  1. Abra o detalhe daquele terminal.
  2. Formas de pagamento → desligue a forma de cartão.
  3. Verifique que a legenda agora lê Ajuste deste equipamento: não cobra.
Os outros quiosques na loja seguem cobrando. Quando o pinpad for consertado: Voltar para a da loja, e volta a fazer o que a loja faz.
  1. Abra o detalhe de qualquer quiosque naquela loja.
  2. Senha de administrador → digite sob Nova senha.
  3. Aplica-se a: Todos os quiosques desta loja.
  4. Salvar senha.
Cada quiosque na loja a herda, incluindo os registrados depois. Os que têm sua própria sobrescrita mantêm a sua — para trazer esses de volta à linha, abra cada um e use Voltar à da loja.
  1. Abra o detalhe do terminal → Formas de pagamento.
  2. Expanda a forma com a divisa.
  3. Preencha Valores deste terminal e Salvar valores.
Apenas campos que a forma declarou no nível Terminal aparecem aqui. Os de nível de conta e loja não são editáveis daqui de propósito: mudá-los do detalhe de um dispositivo afetaria os outros sem estar visível.
Use o seletor de loja no cabeçalho. As abas então dividem o que sobra por status: Ativos, Suspensos, Revogados, mais Excluídos se você marcar Mostrar excluídos.Não há caixa de busca: o filtro de loja e as abas são as ferramentas. A lista é ordenada mais novo primeiro, então um dispositivo que você acabou de registrar está no topo.

​
Três quiosques em uma loja, seguidos de ponta a ponta

Laboratorio tem K-01, K-02 e K-03. A loja oferece Dinheiro e Datafast. O pinpad do K-02 quebra. A linha que vale ler duas vezes é a quarta. A sobrescrita sobrevive às mudanças da loja — é exatamente para isso que serve, e também é como uma máquina acaba não cobrando semanas depois que todo mundo esqueceu que o pinpad já foi quebrado. Uma sobrescrita é uma decisão que fica até que alguém a desfaça.

​
Erros que custam dinheiro

Fechar o diálogo de registro sem ler a mensagem. “Registrado no Fire, mas o canal ainda não o aceitou” é amarelo, fecha como sucesso, e deixa um quiosque que não cobra.
Deixar uma sobrescrita no lugar depois que a razão para ela se foi. A máquina para de seguir a loja para sempre. Semanas depois uma forma está cobrando em todo lugar exceto naquele único quiosque, e nada na tela da loja explica por quê. Use Voltar para a da loja.
Ignorar um cartão Sync falhou. Não há retentativa automática. Aquele quiosque continua operando com a configuração que tinha antes da mudança — preços antigos de uma forma de pagamento, uma senha antiga, uma forma que não deveria mais ser oferecida.
Assumir que limpar a senha bloqueia o dispositivo. Não bloqueia. O Fire para de impor uma; o quiosque mantém a chave que já tem. Para mudar o que pede, defina uma nova senha.

​
Glossário

​
Perguntas frequentes

Olhe seu cartão. Se há um painel âmbar, pressione Tentar novamente e leia o erro. A causa mais comum é a loja faltando país ou cidade — com esses carregados, a retentativa passa.
O Fire não deixa: diz qual terminal já está usando. Um ID de dispositivo não pode ser repetido dentro de uma conta.
Não. O interruptor no detalhe de um terminal só cria uma sobrescrita para aquele dispositivo. Para mudar o que a loja inteira oferece, use configuração por loja — que é para o que serve o link no topo da seção.
Porque fazer isso daqui habilitaria em cada quiosque na loja, e essa decisão pertence à tela da loja. Habilite lá e o quiosque herda.
Não. Você pode ver se está definida, herdada ou ausente, nunca o valor. Se ninguém lembra, defina uma nova.
Não. Aquela seção só aparece para quiosques. O POS ainda recebe suas formas de pagamento através de seu próprio snapshot.

​
O que vem por aí

Coisas que esta tela não faz hoje:
  • Sem retentativa automática de sync, e sem retentativa em massa: é um Tentar novamente por cartão.
  • Sem filtro de tipo POS/quiosque. O filtro é por loja, e as abas por status.
  • Sem busca e sem paginação. Tudo na conta — ou na loja selecionada — é carregado de uma vez.
  • Fechar caixa manual está visível mas desabilitado, marcado Em breve.
  • Caixas POS não são criadas aqui: são pareadas do dispositivo.
  • Um registro que meio que dá certo não é revertido. O quiosque fica no Fire esperando uma retentativa, de propósito: desfazê-lo significaria refazer o registro inteiro por causa de um timeout.