> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fire.rest/llms.txt
> Use this file to discover all available pages before exploring further.
# Terminais
> Registre os quiosques de cada loja em uma tela, e decida o que cada dispositivo cobra e quem pode desbloqueá-lo.
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**.
***
## 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.
| Mensagem | O que aconteceu | O que você faz |
| ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
| **Quiosque registrado** | Criado no Fire e no canal | Nada |
| **O quiosque já existia no canal e foi adotado** | Já estava do outro lado — o Fire assumiu em vez de duplicar. Daqui em diante o Fire está no comando | Nada |
| ⚠️ **Registrado no Fire, mas o canal ainda não o aceitou** | O registro está **meio feito** | Encontre o cartão na lista e pressione **Tentar novamente** |
**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](/pt/manuals/payments/store-configuration).
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.
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
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.
Cada forma carrega uma legenda dizendo de onde vem sua posição atual:
| Legenda | O que significa |
| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *Não é oferecida nos quiosques desta loja.* | A loja não a oferece. O interruptor está desabilitado aqui — ligá-lo habilitaria em **cada** quiosque na loja, e essa é uma decisão para [configuração por loja](/pt/manuals/payments/store-configuration) |
| *Segue a loja: cobra.* | Herdando, e cobrando |
| *Segue a loja: pausada.* | Herdando, e pausada no nível da loja |
| *Ajuste deste equipamento: cobra.* | Sobrescrita — cobra aqui mesmo que a loja tenha pausado |
| *Ajuste deste equipamento: não cobra.* | Sobrescrita — esta máquina não cobra, as outras ainda fazem |
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á.
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](/pt/manuals/pos/linking) para aquele fluxo.
Caixas POS aparecem nesta lista, e você pode administrá-las daqui — veja [Administração de terminais](/pt/manuals/pos/terminal-admin) para suspender, reativar e revogar.
O guia mais antigo [Quiosque → Vinculação](/pt/manuals/kiosk/linking) 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](/pt/manuals/payments/store-configuration).
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.
| | K-01 | K-02 | K-03 |
| --------------------------------------------- | --------------------- | ------------------------------------------ | --------------------- |
| **Antes** | Segue a loja: cobra | Segue a loja: cobra | Segue a loja: cobra |
| Desligar Datafast no K-02 | Segue a loja: cobra | **Ajuste deste equipamento: não cobra** | Segue a loja: cobra |
| A loja pausa Datafast por uma interrupção | Segue a loja: pausada | Ajuste deste equipamento: não cobra | Segue a loja: pausada |
| A loja retoma | Segue a loja: cobra | **Ajuste deste equipamento: não cobra** ⚠️ | Segue a loja: cobra |
| Pinpad consertado → **Voltar para a da loja** | Segue a loja: cobra | Segue a loja: cobra | Segue a loja: cobra |
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
| Termo | O que significa |
| --------------------- | ------------------------------------------------------------------------------------------------ |
| **ID do dispositivo** | O identificador que o quiosque mostra na tela de QR. O que o Fire usa para encontrá-lo no canal. |
| **Adoção** | O quiosque já existia no canal e o Fire assumiu em vez de duplicar. |
| **Provisionamento** | Criar ou adotar o quiosque do lado do canal. |
| **Sync** | Empurrar o que está configurado no Fire para o dispositivo. |
| **Sobrescrita** | Um valor definido em um terminal que o para de herdar da loja. |
| **Pareamento** | O fluxo do POS: um código de 6 dígitos inserido no dispositivo. Quiosques não usam. |
***
## 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](/pt/manuals/payments/store-configuration) — 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.