> ## 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.

# Vinculação

> Como vincular um terminal POS a uma loja pelo backoffice do Fire.

Este guia descreve como cadastrar um terminal POS em uma loja. O cadastro é uma operação única por dispositivo: o administrador gera um código de uso único pelo backoffice e o operador o digita no app do POS. Uma vez vinculado, o terminal fica associado à loja e os caixas podem entrar com o PIN deles.

## Pré-requisitos

* Acesso ao backoffice do Fire em **[app.fire.rest](https://app.fire.rest)**, com permissões sobre a loja e a função **Fire POS Admin**.
* O dispositivo ligado, com conexão com a internet e um navegador compatível. Consulte os [requisitos do terminal](/pt/manuals/pos/hardware-requirements) para as especificações completas de hardware, sistema operacional, navegador e rede.

<Info>
  **O FIRE POS não se instala.** É uma aplicação web aberta no navegador do terminal — não há executável nem instalador. Opcionalmente, pode ser instalado como PWA pelo próprio navegador para abrir em tela cheia.

  Este guia usa duas aplicações distintas: o **backoffice**, onde você gera o código, e o **POS**, onde você o digita.

  | Ambiente     | Backoffice (passos 1-5)                        | FIRE POS (passos 6-8)                          |
  | ------------ | ---------------------------------------------- | ---------------------------------------------- |
  | **Produção** | [app.fire.rest](https://app.fire.rest)         | [pos.fire.rest](https://pos.fire.rest)         |
  | **Staging**  | [stg.app.fire.rest](https://stg.app.fire.rest) | [stg.pos.fire.rest](https://stg.pos.fire.rest) |
</Info>

<Warning>
  **As duas aplicações devem estar no mesmo ambiente.** Um código gerado no backoffice de produção não pode ser resgatado no POS de staging, nem o contrário — o POS o rejeita como código inválido.
</Warning>

Para terminais que imprimem comprovantes e vouchers, instale também o **Agente Fire** no dispositivo. Consulte a [guia do Agente Fire](/pt/manuals/fire-agent/installation) para a instalação completa.

<Card title="Baixar Agente Fire (Windows)" icon="download" href="https://drive.google.com/uc?export=download&id=1OiqSbD5flcsc6cV2ZjxxkHy-cmxwH5d1">
  Instalador do Windows para impressão térmica local.
</Card>

## 1. Selecione país e vendor

Entre no backoffice em **[app.fire.rest](https://app.fire.rest)** (ou [stg.app.fire.rest](https://stg.app.fire.rest) no staging). No canto superior direito, abra o seletor e escolha o país e o vendor em que você vai operar. Todas as ações deste guia acontecem dentro desse contexto.

<Frame>
  <img src="https://mintcdn.com/firepos/iHHtLmy85rEEiLUu/images/manuals/pos/linking/01-select-country-vendor.png?fit=max&auto=format&n=iHHtLmy85rEEiLUu&q=85&s=09ca21904ffd49bde5d9caee73c32c85" alt="Seletor de país e vendor no backoffice" width="272" height="367" data-path="images/manuals/pos/linking/01-select-country-vendor.png" />
</Frame>

## 2. Confirme o canal Fire POS

No menu lateral, certifique-se de que o canal **Fire POS** está selecionado. A seção de Terminais só está disponível dentro desse canal.

<Frame>
  <img src="https://mintcdn.com/firepos/iHHtLmy85rEEiLUu/images/manuals/pos/linking/02-confirm-channel.png?fit=max&auto=format&n=iHHtLmy85rEEiLUu&q=85&s=bdf8f724bb4cab0ed2c647406dbc8b21" alt="Seletor de canal com o Fire POS selecionado" width="548" height="434" data-path="images/manuals/pos/linking/02-confirm-channel.png" />
</Frame>

## 3. Escolha a loja de destino

No seletor de loja do cabeçalho, escolha a loja em que o terminal será cadastrado. O slot que você gerar no próximo passo fica preso a essa loja — não é possível reatribuí-lo depois.

<Frame>
  <img src="https://mintcdn.com/firepos/iHHtLmy85rEEiLUu/images/manuals/pos/linking/03-pick-store.png?fit=max&auto=format&n=iHHtLmy85rEEiLUu&q=85&s=5c8f922df99792526747be61c839396d" alt="Seletor de loja no cabeçalho do backoffice" width="312" height="337" data-path="images/manuals/pos/linking/03-pick-store.png" />
</Frame>

## 4. Abra a seção de Terminais

No menu lateral abra **POS → Terminais**. Você verá uma lista com os terminais já cadastrados, agrupados por status (Ativos, Slots pendentes, Suspensos, Revogados).

<Frame>
  <img src="https://mintcdn.com/firepos/iHHtLmy85rEEiLUu/images/manuals/pos/linking/04-terminals-section.png?fit=max&auto=format&n=iHHtLmy85rEEiLUu&q=85&s=043800bf30567b456aca86682db76c3f" alt="Submenu POS com a opção Terminais" width="288" height="912" data-path="images/manuals/pos/linking/04-terminals-section.png" />
</Frame>

## 5. Crie um slot de vinculação

1. No canto superior direito clique em **+ Criar slot**.

   <Frame>
     <img src="https://mintcdn.com/firepos/iHHtLmy85rEEiLUu/images/manuals/pos/linking/05-create-slot-button.png?fit=max&auto=format&n=iHHtLmy85rEEiLUu&q=85&s=a8fc44b9a34534011cad87ff72a00de1" alt="Página de Terminais com o botão Criar slot" width="144" height="60" data-path="images/manuals/pos/linking/05-create-slot-button.png" />
   </Frame>

2. **Modal Criar slot de vinculação.** Confira a loja de destino e escolha a validade do código (padrão **30 minutos**). Clique em **Gerar código**.

   <Frame>
     <img src="https://mintcdn.com/firepos/iHHtLmy85rEEiLUu/images/manuals/pos/linking/06-create-slot-modal.png?fit=max&auto=format&n=iHHtLmy85rEEiLUu&q=85&s=04cf7db1439790885eb658f7092db93d" alt="Modal Criar slot com a loja de destino e o campo de validade" width="448" height="362" data-path="images/manuals/pos/linking/06-create-slot-modal.png" />
   </Frame>

3. O backoffice mostra um **código de 6 dígitos** com a hora de expiração. Use o botão **Copiar** ou anote-o. O código é mostrado uma única vez e só pode ser usado para vincular um dispositivo.

   <Frame>
     <img src="https://mintcdn.com/firepos/NRvNyR3mABhD4tpM/images/manuals/pos/linking/07-slot-code.png?fit=max&auto=format&n=NRvNyR3mABhD4tpM&q=85&s=5baa089d148e262ff1c0e8d655621440" alt="Código de 6 dígitos gerado com o botão de copiar e a hora de expiração" width="910" height="906" data-path="images/manuals/pos/linking/07-slot-code.png" />
   </Frame>

<Note>
  Se o código expirar antes de ser usado, o slot fica inválido. Refaça este passo para gerar um novo.
</Note>

## 6. Abra o app do POS

No navegador do dispositivo, abra **[pos.fire.rest](https://pos.fire.rest)** — ou [stg.pos.fire.rest](https://stg.pos.fire.rest) se você gerou o código no staging. Se o terminal nunca foi vinculado, a tela inicial exibe o título **Vincular terminal** e um teclado numérico de 6 posições.

<Frame>
  <img src="https://mintcdn.com/firepos/NRvNyR3mABhD4tpM/images/manuals/pos/linking/08-open-pos-app.png?fit=max&auto=format&n=NRvNyR3mABhD4tpM&q=85&s=2b1c9dddb70ab1d421ba31bf4683819e" alt="Tela do POS com o título Vincular terminal e o teclado numérico" width="2986" height="1696" data-path="images/manuals/pos/linking/08-open-pos-app.png" />
</Frame>

## 7. Digite o código

Digite os 6 dígitos no teclado. Assim que o sexto dígito é digitado, o app valida o código automaticamente — não é necessário confirmar.

<Frame>
  <img src="https://mintcdn.com/firepos/NRvNyR3mABhD4tpM/images/manuals/pos/linking/09-type-code.png?fit=max&auto=format&n=NRvNyR3mABhD4tpM&q=85&s=57d0e4097d93e941d70fd4eac7b0b3d9" alt="Teclado numérico com os 6 dígitos digitados" width="832" height="1042" data-path="images/manuals/pos/linking/09-type-code.png" />
</Frame>

Enquanto o código é validado, a tela mostra um indicador de carregamento. Se o código for inválido ou tiver expirado, uma mensagem de erro aparece e o teclado é limpo para você tentar de novo.

## 8. O terminal fica vinculado

Quando a validação termina, o terminal recebe o nome, a loja e as credenciais internas, e redireciona automaticamente para a tela de **login do caixa**. A partir desse momento, o dispositivo opera de forma autônoma — os caixas podem entrar com o PIN sem usar o código novamente.

<Frame>
  <img src="https://mintcdn.com/firepos/NRvNyR3mABhD4tpM/images/manuals/pos/linking/10-cashier-signin.png?fit=max&auto=format&n=NRvNyR3mABhD4tpM&q=85&s=6eb06ed43debce5ec16b545f73081883" alt="Tela de login do caixa depois de vincular o terminal" width="2972" height="1688" data-path="images/manuals/pos/linking/10-cashier-signin.png" />
</Frame>

<Check>
  O terminal está vinculado à loja e pronto para operar.
</Check>

## Verificação pelo backoffice

Volte para **POS → Terminais** e abra a aba **Ativos**. O terminal recém-cadastrado aparece na lista com o nome, a hora da última conexão e o status **ATIVO**.

<Frame>
  <img src="https://mintcdn.com/firepos/NRvNyR3mABhD4tpM/images/manuals/pos/linking/11-terminal-active.png?fit=max&auto=format&n=NRvNyR3mABhD4tpM&q=85&s=dfbeee0c790b2b5881d2ed5a85455f56" alt="Lista de terminais com o novo dispositivo no status ATIVO" width="2396" height="1466" data-path="images/manuals/pos/linking/11-terminal-active.png" />
</Frame>

Na aba **Slots pendentes**, o slot que você gerou já não deve aparecer — passou para **CLAIMED** e é consumido automaticamente.
