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

# Requisitos do terminal

> Requisitos mínimos e recomendados de hardware, sistema operacional, navegador e rede para operar o FIRE POS em um terminal de ponto de venda.

O FIRE POS é uma aplicação web (PWA) servida pela nuvem: o terminal não executa a aplicação, apenas a abre em um navegador. Não há executável nem instalador para baixar — o acesso é por uma URL. O único componente instalado localmente é o **Agente Fire**, necessário para imprimir comprovantes e abrir a gaveta de dinheiro.

## Endereços

| Ambiente     | FIRE POS (terminal)                            | Backoffice                                     |
| ------------ | ---------------------------------------------- | ---------------------------------------------- |
| **Produção** | [pos.fire.rest](https://pos.fire.rest)         | [app.fire.rest](https://app.fire.rest)         |
| **Staging**  | [stg.pos.fire.rest](https://stg.pos.fire.rest) | [stg.app.fire.rest](https://stg.app.fire.rest) |

O staging é o ambiente de testes: use-o para treinamento, validações e testes de integração, nunca para operar uma loja real.

<Warning>
  Os dois ambientes são completamente separados. Um código de vinculação gerado no backoffice de produção **não funciona** no POS de staging, e vice-versa. Terminais, caixas, vendas e fechamentos de caixa também não são compartilhados entre ambientes.

  Antes de vincular um terminal, verifique se o backoffice e o POS estão no mesmo ambiente.
</Warning>

## Resumo

| Componente             | Mínimo                                    | Recomendado                                |
| ---------------------- | ----------------------------------------- | ------------------------------------------ |
| Sistema operacional    | Windows 10 (64 bits)                      | Windows 11 (64 bits)                       |
| Processador            | x64, 2 núcleos, 1.5 GHz                   | x64, 4 núcleos, 2.0 GHz                    |
| Memória RAM            | 4 GB                                      | 8 GB                                       |
| Armazenamento          | 64 GB, com 10 GB livres                   | 128 GB SSD, com 20 GB livres               |
| Portas                 | 2 USB livres + Ethernet                   | 4 USB livres + Ethernet                    |
| Tela                   | 1024 × 768, horizontal                    | 1366 × 768 ou superior, horizontal         |
| Entrada                | Tela sensível ao toque ou teclado e mouse | Tela capacitiva                            |
| Navegador              | Chrome / Edge 105, Firefox 110            | Última versão estável do Chrome ou Edge    |
| Conexão                | 5 Mbps download / 2 Mbps upload por loja  | 20 Mbps download / 10 Mbps upload por loja |
| Latência até o backend | RTT menor que 150 ms                      | RTT menor que 80 ms                        |

<Warning>
  O FIRE POS **exige conexão permanente com a internet**. Hoje não existe modo offline: sem rede o terminal não consegue autenticar caixas, carregar o catálogo nem registrar vendas.
</Warning>

## O que é executado no terminal

| Componente      | Onde roda                                 | Obrigatório                                  |
| --------------- | ----------------------------------------- | -------------------------------------------- |
| **FIRE POS**    | Navegador do terminal, na URL do ambiente | Sim                                          |
| **Agente Fire** | Executável local do Windows               | Somente se o terminal imprime ou abre gaveta |

O FIRE POS pode ser instalado como aplicativo pelo navegador (PWA) para abrir em tela cheia, sem barra de endereços.

O backoffice do Fire, onde se administram terminais, caixas e códigos de autorização, é uma aplicação distinta e não é aberto pelo terminal de venda. Consulte [Endereços](#endereços) para as URLs de cada ambiente.

## Sistema operacional

O FIRE POS opera sobre **Windows 10 ou Windows 11 de 64 bits**. É a única plataforma suportada, e a única em que funcionam a impressão térmica e a gaveta de dinheiro.

O terminal também precisa de:

* Permissões de **administrador** apenas durante a instalação ou desinstalação do Agente Fire.
* **PowerShell 5.1** ou superior (já incluído no Windows 10/11).
* O **driver da impressora térmica** já instalado no Windows.

<Note>
  O Agente Fire escuta apenas de forma local, portanto não é necessário abrir portas nem criar regras no Firewall do Windows. Consulte o [guia de instalação do Agente Fire](/pt/manuals/fire-agent/installation).
</Note>

## Processador, memória e armazenamento

| Recurso       | Mínimo                  | Recomendado                  |
| ------------- | ----------------------- | ---------------------------- |
| Processador   | x64, 2 núcleos, 1.5 GHz | x64, 4 núcleos, 2.0 GHz      |
| RAM           | 4 GB                    | 8 GB                         |
| Armazenamento | 64 GB, com 10 GB livres | 128 GB SSD, com 20 GB livres |

O FIRE POS não ocupa espaço próprio: usa o cache do navegador. O Agente Fire ocupa menos de 100 MB.

O tipo de disco é o que mais se nota na inicialização do terminal e do navegador:

| Tipo de disco         | Inicialização   |
| --------------------- | --------------- |
| **SSD** — recomendado | ▰▰▰▰▰ Excelente |
| HDD 7200 rpm          | ▰▰▰▱▱ Aceitável |
| HDD 5400 rpm          | ▰▱▱▱▱ Lento     |

<Warning>
  O navegador precisa ter **permissão para preservar os dados do site** entre sessões. Se uma política da loja os apagar ao fechar, ou se o terminal operar em modo anônimo/privado, o terminal **perde o vínculo** e precisa ser cadastrado novamente com um código novo.
</Warning>

## Portas e conectividade

| Porta             | Mínimo | Recomendado |
| ----------------- | ------ | ----------- |
| USB tipo A livres | 2      | 4 ou mais   |
| Ethernet (RJ-45)  | 1      | 1           |

As portas USB livres são contadas **além** das já ocupadas pela impressora térmica e pelo teclado. São necessárias para acrescentar leitor de código de barras, balança, teclado numérico, segunda impressora ou um adaptador de rede, sem depender de um hub externo.

<Tip>
  Um hub USB com alimentação própria resolve a falta de portas, mas acrescenta mais um ponto de falha no balcão. É preferível escolher um terminal com portas suficientes desde o início.
</Tip>

## Tela e resolução

O FIRE POS usa um layout de tela cheia, em **orientação horizontal**, sem rolagem de página. A grade de produtos acrescenta colunas conforme a largura disponível.

| Resolução                | Colunas de produtos | Avaliação             |
| ------------------------ | ------------------- | --------------------- |
| 1024 × 768               | 3                   | **Mínimo suportado.** |
| 1280 × 800 – 1366 × 768  | 4                   | Confortável.          |
| 1366 × 768 – 1600 × 900  | 5                   | Recomendado.          |
| 1920 × 1080 e superiores | 6 ou mais           | Ótimo.                |

* **Orientação horizontal (landscape).** O layout pressupõe mais largura que altura.
* **Altura mínima de 768 px.**
* **Escala do Windows em 100 %.** Uma escala maior reduz o espaço útil.
* **Zoom do navegador em 100 %.** O FIRE POS fixa o zoom e desativa o gesto de pinça.

### Entrada

O FIRE POS é operado com **tela sensível ao toque ou com teclado e mouse**. Os controles são dimensionados com área de toque de 56 px, pensada para operar com o dedo.

Recomenda-se tela capacitiva (a resistiva funciona, mas é menos precisa) e um teclado numérico para digitar o PIN do caixa e códigos de autorização.

## Navegador

<Note>
  Recomenda-se **Chrome ou Edge na última versão estável**. São os navegadores em que o FIRE POS é testado e os que confiam automaticamente no certificado do Agente Fire.
</Note>

### Versões mínimas

| Navegador       | Versão mínima | Recomendado           |
| --------------- | ------------- | --------------------- |
| Google Chrome   | 105           | Última versão estável |
| Microsoft Edge  | 105           | Última versão estável |
| Mozilla Firefox | 110           | 115 ESR ou superior   |

Essas são as primeiras versões que suportam os recursos web que o FIRE POS precisa. Em versões anteriores a aplicação não carrega corretamente.

<Warning>
  **Internet Explorer e Edge Legacy não são suportados.** Navegadores embutidos antigos de terminais POS também não: se o equipamento vem com um navegador próprio que não pode ser atualizado, instale Chrome ou Edge.
</Warning>

### Configuração obrigatória do navegador

| Requisito                              | Motivo                                                                                                                   |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| Acesso por **HTTPS**                   | Requisito de segurança do FIRE POS.                                                                                      |
| **Não usar modo anônimo ou privado**   | O terminal perde o vínculo ao fechar o navegador.                                                                        |
| **Não apagar dados do site ao fechar** | Mesmo motivo.                                                                                                            |
| Permitir conexões locais               | O POS se comunica com o Agente Fire de forma local. Algumas extensões de segurança e proxies bloqueiam isso.             |
| Confiar no certificado do Agente Fire  | Chrome, Edge, Brave e Opera fazem isso automaticamente. No Firefox é preciso ativar `security.enterprise_roots.enabled`. |
| Zoom em 100 %                          | Ver [Tela e resolução](#tela-e-resolução).                                                                               |

## Rede e banda

### Consumo

| Atividade                           | Frequência                                | Volume aproximado                                  |
| ----------------------------------- | ----------------------------------------- | -------------------------------------------------- |
| Carga inicial da aplicação          | Primeira abertura e após cada atualização | Cerca de 215 kB comprimidos. Depois fica em cache. |
| Sincronização do estado do terminal | A cada 60 segundos                        | Poucos kB.                                         |
| Download do catálogo                | Na abertura de caixa e quando o menu muda | Depende do tamanho do menu.                        |
| Registro de uma venda               | Uma requisição por pedido                 | Poucos kB.                                         |
| Impressão e gaveta                  | Por comprovante                           | Tráfego local, não consome internet.               |

### Requisitos do link

| Parâmetro                    | Mínimo           | Recomendado     |
| ---------------------------- | ---------------- | --------------- |
| Download por loja            | 5 Mbps           | 20 Mbps         |
| Upload por loja              | 2 Mbps           | 10 Mbps         |
| Adicional por terminal ativo | 512 kbps         | 1 Mbps          |
| Latência (RTT) até o backend | menor que 150 ms | menor que 80 ms |
| Perda de pacotes             | menor que 1 %    | menor que 0,1 % |
| Jitter                       | menor que 30 ms  | menor que 10 ms |

<Tip>
  Para o FIRE POS, **estabilidade e latência pesam mais que banda**. Recomenda-se cabo Ethernet em vez de Wi-Fi, e um link de backup (4G/5G) com comutação automática.
</Tip>

### Rede corporativa

Se a loja opera atrás de um proxy ou firewall corporativo, é preciso permitir:

* **HTTPS (443)** para os domínios do FIRE POS e do backend do Fire.
* **Tráfego local** do Agente Fire. Não sai da máquina, mas algumas suítes de segurança interceptam.
* **NTP** para manter o relógio do terminal sincronizado.

<Note>
  Solicite à equipe do Fire a lista de domínios do seu país e ambiente: eles variam conforme a região de implantação.
</Note>

## Periféricos

| Periférico                 | Requisito                                                   | Observações                                                                           |
| -------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| Impressora térmica         | Compatível com **ESC/POS**, com driver instalado no Windows | Recomenda-se o driver **"Generic / Text Only"** ou uma porta configurada em modo raw. |
| Gaveta de dinheiro         | Conectada à impressora térmica                              | Abre pela impressora, não ocupa uma porta USB própria.                                |
| Leitor de código de barras | USB, em modo emulação de teclado                            | Requer uma porta USB livre.                                                           |

## Recomendações de implantação

<Steps>
  <Step title="Instale o FIRE POS como aplicativo (PWA)">
    Abra a URL do ambiente ([pos.fire.rest](https://pos.fire.rest) em produção) no Chrome ou Edge e instale-o pelo navegador para que abra em tela cheia, sem barra de endereços.
  </Step>

  <Step title="Fixe a escala do Windows em 100 %">
    Verifique **Configurações → Sistema → Tela → Escala** em cada terminal.
  </Step>

  <Step title="Sincronize o relógio por NTP">
    O relógio do terminal afeta a validade das credenciais e o registro de horário das vendas.
  </Step>

  <Step title="Exclua o Agente Fire do antivírus">
    Adicione exclusões para `C:\Program Files\FireAgent` e `%APPDATA%\FireAgent`. Executáveis de Node empacotados geram falsos positivos.
  </Step>
</Steps>

## Próximo passo

<CardGroup cols={2}>
  <Card title="Vincular o terminal" icon="link" href="/pt/manuals/pos/linking">
    Cadastre o terminal em uma loja com um código de uso único.
  </Card>

  <Card title="Instalar o Agente Fire" icon="print" href="/pt/manuals/fire-agent/installation">
    Habilite impressão térmica e gaveta de dinheiro no terminal.
  </Card>
</CardGroup>
