> ## 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 del terminal

> Requisitos mínimos y recomendados de hardware, sistema operativo, navegador y red para operar FIRE POS en un terminal de punto de venta.

FIRE POS es una aplicación web (PWA) que se sirve desde la nube: el terminal no ejecuta la aplicación, solo la abre en un navegador. No hay ejecutable ni instalador que descargar — se accede por una URL. Lo único que se instala localmente es el **Agente Fire**, necesario para imprimir tickets y abrir la gaveta de dinero.

## Direcciones

| Entorno        | FIRE POS (terminal)                            | Backoffice                                     |
| -------------- | ---------------------------------------------- | ---------------------------------------------- |
| **Producción** | [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) |

Staging es el entorno de pruebas: úsalo para capacitación, validaciones y pruebas de integración, nunca para operar una tienda real.

<Warning>
  Los dos entornos están completamente separados. Un código de vinculación generado en el backoffice de producción **no funciona** en el POS de staging, y viceversa. Terminales, cajeros, ventas y cierres de caja tampoco se comparten entre entornos.

  Antes de vincular un terminal, verifica que el backoffice y el POS estén en el mismo entorno.
</Warning>

## Resumen

| Componente          | Mínimo                                   | Recomendado                                |
| ------------------- | ---------------------------------------- | ------------------------------------------ |
| Sistema operativo   | Windows 10 (64 bits)                     | Windows 11 (64 bits)                       |
| Procesador          | x64, 2 núcleos, 1.5 GHz                  | x64, 4 núcleos, 2.0 GHz                    |
| Memoria RAM         | 4 GB                                     | 8 GB                                       |
| Almacenamiento      | 64 GB, con 10 GB libres                  | 128 GB SSD, con 20 GB libres               |
| Puertos             | 2 USB libres + Ethernet                  | 4 USB libres + Ethernet                    |
| Pantalla            | 1024 × 768, horizontal                   | 1366 × 768 o superior, horizontal          |
| Entrada             | Pantalla táctil o teclado y ratón        | Pantalla táctil capacitiva                 |
| Navegador           | Chrome / Edge 105, Firefox 110           | Última versión estable de Chrome o Edge    |
| Conexión            | 5 Mbps bajada / 2 Mbps subida por tienda | 20 Mbps bajada / 10 Mbps subida por tienda |
| Latencia al backend | RTT menor a 150 ms                       | RTT menor a 80 ms                          |

<Warning>
  FIRE POS **requiere conexión permanente a internet**. Hoy no existe modo offline: sin red el terminal no puede autenticar cajeros, cargar el catálogo ni registrar ventas.
</Warning>

## Qué se ejecuta en el terminal

| Componente      | Dónde corre                                   | Obligatorio                               |
| --------------- | --------------------------------------------- | ----------------------------------------- |
| **FIRE POS**    | Navegador del terminal, en la URL del entorno | Sí                                        |
| **Agente Fire** | Ejecutable local de Windows                   | Solo si el terminal imprime o abre gaveta |

FIRE POS se puede instalar como aplicación desde el navegador (PWA) para que abra a pantalla completa, sin barra de direcciones.

El backoffice de Fire, donde se administran terminales, cajeros y códigos de autorización, es una aplicación distinta y no se abre desde el terminal de venta. Consulta [Direcciones](#direcciones) para las URLs de cada entorno.

## Sistema operativo

FIRE POS opera sobre **Windows 10 o Windows 11 de 64 bits**. Es la única plataforma soportada, y la única en la que funcionan la impresión térmica y la gaveta de dinero.

El terminal también necesita:

* Permisos de **administrador** únicamente durante la instalación o desinstalación del Agente Fire.
* **PowerShell 5.1** o superior (ya incluido en Windows 10/11).
* El **driver de la impresora térmica** ya instalado en Windows.

<Note>
  El Agente Fire escucha solo de forma local, por lo que no hay que abrir puertos ni crear reglas en el Firewall de Windows. Consulta la [guía de instalación del Agente Fire](/es/manuals/fire-agent/installation).
</Note>

## Procesador, memoria y almacenamiento

| Recurso        | Mínimo                  | Recomendado                  |
| -------------- | ----------------------- | ---------------------------- |
| Procesador     | x64, 2 núcleos, 1.5 GHz | x64, 4 núcleos, 2.0 GHz      |
| RAM            | 4 GB                    | 8 GB                         |
| Almacenamiento | 64 GB, con 10 GB libres | 128 GB SSD, con 20 GB libres |

FIRE POS no ocupa espacio propio: usa la caché del navegador. El Agente Fire ocupa menos de 100 MB.

El tipo de disco es lo que más se nota en el arranque del terminal y del navegador:

| Tipo de disco         | Arranque        |
| --------------------- | --------------- |
| **SSD** — recomendado | ▰▰▰▰▰ Excelente |
| HDD 7200 rpm          | ▰▰▰▱▱ Aceptable |
| HDD 5400 rpm          | ▰▱▱▱▱ Lento     |

<Warning>
  El navegador debe tener **permitido conservar los datos del sitio** entre sesiones. Si una política de la tienda los borra al cerrar, o si el terminal opera en modo incógnito/privado, el terminal **pierde la vinculación** y hay que registrarlo de nuevo con un código nuevo.
</Warning>

## Puertos y conectividad

| Puerto            | Mínimo | Recomendado |
| ----------------- | ------ | ----------- |
| USB tipo A libres | 2      | 4 o más     |
| Ethernet (RJ-45)  | 1      | 1           |

Los puertos USB libres se cuentan **además** de los que ya ocupan la impresora térmica y el teclado. Se necesitan para agregar lector de código de barras, balanza, teclado numérico, segunda impresora o un adaptador de red, sin depender de un hub externo.

<Tip>
  Un hub USB con alimentación propia resuelve la falta de puertos, pero agrega un punto de falla más en el mostrador. Es preferible elegir un terminal con puertos suficientes desde el inicio.
</Tip>

## Pantalla y resolución

FIRE POS usa un diseño de pantalla completa, en **orientación horizontal**, sin desplazamiento de página. La grilla de productos agrega columnas según el ancho disponible.

| Resolución               | Columnas de productos | Evaluación            |
| ------------------------ | --------------------- | --------------------- |
| 1024 × 768               | 3                     | **Mínimo soportado.** |
| 1280 × 800 – 1366 × 768  | 4                     | Cómodo.               |
| 1366 × 768 – 1600 × 900  | 5                     | Recomendado.          |
| 1920 × 1080 y superiores | 6 o más               | Óptimo.               |

* **Orientación horizontal (landscape).** El diseño asume más ancho que alto.
* **Altura mínima de 768 px.**
* **Escala de Windows al 100 %.** Una escala mayor reduce el espacio útil.
* **Zoom del navegador al 100 %.** FIRE POS fija el zoom y desactiva el gesto de pinza.

### Entrada

FIRE POS se opera con **pantalla táctil o con teclado y ratón**. Los controles están dimensionados con un área táctil de 56 px, pensada para operar con el dedo.

Se recomienda pantalla táctil capacitiva (la resistiva funciona, pero es menos precisa) y un teclado numérico para el ingreso de PIN de cajero y códigos de autorización.

## Navegador

<Note>
  Se recomienda **Chrome o Edge en su última versión estable**. Son los navegadores en los que se prueba FIRE POS y los que confían automáticamente en el certificado del Agente Fire.
</Note>

### Versiones mínimas

| Navegador       | Versión mínima | Recomendado            |
| --------------- | -------------- | ---------------------- |
| Google Chrome   | 105            | Última versión estable |
| Microsoft Edge  | 105            | Última versión estable |
| Mozilla Firefox | 110            | 115 ESR o superior     |

Estas versiones son las primeras que soportan las funciones web que FIRE POS necesita. En versiones anteriores la aplicación no carga correctamente.

<Warning>
  **Internet Explorer y Edge Legacy no están soportados.** Tampoco los navegadores integrados antiguos de terminales POS: si el equipo trae un navegador propio que no se puede actualizar, instala Chrome o Edge.
</Warning>

### Configuración obligatoria del navegador

| Requisito                                 | Motivo                                                                                                                |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| Acceso por **HTTPS**                      | Requisito de seguridad de FIRE POS.                                                                                   |
| **No usar modo incógnito o privado**      | El terminal pierde la vinculación al cerrar el navegador.                                                             |
| **No borrar datos del sitio al cerrar**   | Misma razón.                                                                                                          |
| Permitir conexiones locales               | El POS se comunica con el Agente Fire de forma local. Algunas extensiones de seguridad y proxies lo bloquean.         |
| Confiar en el certificado del Agente Fire | Chrome, Edge, Brave y Opera lo hacen automáticamente. En Firefox hay que activar `security.enterprise_roots.enabled`. |
| Zoom al 100 %                             | Ver [Pantalla y resolución](#pantalla-y-resolución).                                                                  |

## Red y ancho de banda

### Consumo

| Actividad                             | Frecuencia                                 | Volumen aproximado                                 |
| ------------------------------------- | ------------------------------------------ | -------------------------------------------------- |
| Carga inicial de la aplicación        | Primera apertura y tras cada actualización | Cerca de 215 kB comprimidos. Luego queda en caché. |
| Sincronización de estado del terminal | Cada 60 segundos                           | Unos pocos kB.                                     |
| Descarga del catálogo                 | Al abrir caja y cuando cambia el menú      | Depende del tamaño del menú.                       |
| Registro de una venta                 | Una petición por orden                     | Unos pocos kB.                                     |
| Impresión y gaveta                    | Por ticket                                 | Tráfico local, no consume internet.                |

### Requisitos de enlace

| Parámetro                     | Mínimo         | Recomendado   |
| ----------------------------- | -------------- | ------------- |
| Bajada por tienda             | 5 Mbps         | 20 Mbps       |
| Subida por tienda             | 2 Mbps         | 10 Mbps       |
| Adicional por terminal activo | 512 kbps       | 1 Mbps        |
| Latencia (RTT) al backend     | menor a 150 ms | menor a 80 ms |
| Pérdida de paquetes           | menor a 1 %    | menor a 0.1 % |
| Jitter                        | menor a 30 ms  | menor a 10 ms |

<Tip>
  Para FIRE POS pesa más la **estabilidad y la latencia** que el ancho de banda. Se recomienda cable Ethernet en lugar de Wi-Fi, y un enlace de respaldo (4G/5G) con conmutación automática.
</Tip>

### Red corporativa

Si la tienda opera detrás de un proxy o firewall corporativo, hay que permitir:

* **HTTPS (443)** hacia los dominios de FIRE POS y del backend de Fire.
* **Tráfico local** del Agente Fire. No sale de la máquina, pero algunas suites de seguridad lo interceptan.
* **NTP** para mantener la hora del terminal sincronizada.

<Note>
  Solicita al equipo de Fire la lista de dominios de tu país y entorno: varían según la región de despliegue.
</Note>

## Periféricos

| Periférico                 | Requisito                                                   | Notas                                                                                  |
| -------------------------- | ----------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| Impresora térmica          | Compatible con **ESC/POS**, con driver instalado en Windows | Se recomienda el driver **"Generic / Text Only"** o un puerto configurado en modo raw. |
| Gaveta de dinero           | Conectada a la impresora térmica                            | Se abre a través de la impresora, no ocupa un USB propio.                              |
| Lector de código de barras | USB, en modo emulación de teclado                           | Requiere un puerto USB libre.                                                          |

## Recomendaciones de despliegue

<Steps>
  <Step title="Instala FIRE POS como aplicación (PWA)">
    Abre la URL del entorno ([pos.fire.rest](https://pos.fire.rest) en producción) en Chrome o Edge e instálalo desde el navegador para que abra a pantalla completa, sin barra de direcciones.
  </Step>

  <Step title="Fija la escala de Windows en 100 %">
    Verifica **Configuración → Sistema → Pantalla → Escala** en cada terminal.
  </Step>

  <Step title="Sincroniza la hora por NTP">
    La hora del terminal afecta la validez de las credenciales y el registro horario de las ventas.
  </Step>

  <Step title="Excluye el Agente Fire del antivirus">
    Agrega exclusiones para `C:\Program Files\FireAgent` y `%APPDATA%\FireAgent`. Los ejecutables de Node empaquetados generan falsos positivos.
  </Step>
</Steps>

## Siguiente paso

<CardGroup cols={2}>
  <Card title="Vincular el terminal" icon="link" href="/es/manuals/pos/linking">
    Registra el terminal contra una tienda con un código de un solo uso.
  </Card>

  <Card title="Instalar el Agente Fire" icon="print" href="/es/manuals/fire-agent/installation">
    Habilita impresión térmica y gaveta de dinero en el terminal.
  </Card>
</CardGroup>
