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

# Vinculación

> Cómo vincular un terminal POS a una tienda desde el backoffice de Fire.

Esta guía describe cómo registrar un terminal POS contra una tienda. El registro es una operación única por dispositivo: el administrador genera un código de un solo uso desde el backoffice y el operador lo ingresa en la app del POS. Una vez vinculado, el terminal queda asociado a la tienda y los cajeros pueden iniciar sesión con su PIN.

## Requisitos previos

* Acceso al backoffice de Fire en **[app.fire.rest](https://app.fire.rest)**, con permisos sobre la tienda y rol **Fire POS Admin**.
* El dispositivo encendido, con conexión a internet y un navegador compatible. Consulta los [requisitos del terminal](/es/manuals/pos/hardware-requirements) para las especificaciones completas de hardware, sistema operativo, navegador y red.

<Info>
  **FIRE POS no se instala.** Es una aplicación web que se abre en el navegador del terminal — no hay ejecutable ni instalador. Opcionalmente se puede instalar como PWA desde el propio navegador para que abra a pantalla completa.

  Esta guía usa dos aplicaciones distintas: el **backoffice**, donde generas el código, y el **POS**, donde lo ingresas.

  | Entorno        | Backoffice (pasos 1-5)                         | FIRE POS (pasos 6-8)                           |
  | -------------- | ---------------------------------------------- | ---------------------------------------------- |
  | **Producción** | [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>
  **Ambas aplicaciones deben estar en el mismo entorno.** Un código generado en el backoffice de producción no se puede canjear en el POS de staging, ni al revés — el POS lo rechaza como código inválido.
</Warning>

Para terminales que imprimen tickets y vouchers, instala también el **Agente Fire** en el dispositivo. Consulta la [guía del Agente Fire](/es/manuals/fire-agent/installation) para la instalación completa.

<Card title="Descargar Agente Fire (Windows)" icon="download" href="https://drive.google.com/uc?export=download&id=1OiqSbD5flcsc6cV2ZjxxkHy-cmxwH5d1">
  Instalador de Windows para impresión térmica local.
</Card>

## 1. Selecciona país y vendor

Entra al backoffice en **[app.fire.rest](https://app.fire.rest)** (o [stg.app.fire.rest](https://stg.app.fire.rest) en staging). Desde la esquina superior derecha, abre el selector y elige el país y el vendor en el que vas a operar. Todas las acciones de esta guía se ejecutan dentro de ese 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="Selector de país y vendor en el backoffice" width="272" height="367" data-path="images/manuals/pos/linking/01-select-country-vendor.png" />
</Frame>

## 2. Confirma el canal Fire POS

En el menú lateral, asegúrate de tener seleccionado el canal **Fire POS**. La sección de Terminales solo está disponible dentro de ese 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="Selector de canal con Fire POS seleccionado" width="548" height="434" data-path="images/manuals/pos/linking/02-confirm-channel.png" />
</Frame>

## 3. Selecciona la tienda destino

En el selector de tienda del header, elige la tienda en la que vas a registrar el terminal. El slot que generes en el paso siguiente queda atado a esa tienda — no podrás reasignarlo después.

<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="Selector de tienda en el header del backoffice" width="312" height="337" data-path="images/manuals/pos/linking/03-pick-store.png" />
</Frame>

## 4. Abre la sección de Terminales

En el menú lateral abre **POS → Terminales**. Verás un listado con los terminales ya registrados, agrupados por estado (Activos, Slots pendientes, Suspendidos, Revocados).

<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="Submenú POS con la opción Terminales" width="288" height="912" data-path="images/manuals/pos/linking/04-terminals-section.png" />
</Frame>

## 5. Crea un slot de vinculación

1. En la esquina superior derecha haz clic en **+ Crear 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 Terminales con el botón Crear slot" width="144" height="60" data-path="images/manuals/pos/linking/05-create-slot-button.png" />
   </Frame>

2. **Modal Crear slot de vinculación.** Verifica la tienda destino y elige la validez del código (por defecto **30 minutos**). Haz clic en **Generar 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 Crear slot con la tienda destino y la validez del código" width="448" height="362" data-path="images/manuals/pos/linking/06-create-slot-modal.png" />
   </Frame>

3. El backoffice muestra un **código de 6 dígitos** con la fecha de expiración. Usa el botón **Copiar** o anótalo. El código solo se muestra una vez y solo se puede usar para vincular un único 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 generado con botón de copiar y fecha de expiración" width="910" height="906" data-path="images/manuals/pos/linking/07-slot-code.png" />
   </Frame>

<Note>
  Si el código expira antes de usarse, el slot queda inválido. Vuelve a este paso para generar uno nuevo.
</Note>

## 6. Abre la app del POS

En el navegador del dispositivo, abre **[pos.fire.rest](https://pos.fire.rest)** — o [stg.pos.fire.rest](https://stg.pos.fire.rest) si generaste el código en staging. Si el terminal nunca fue vinculado, la pantalla inicial muestra el título **Vincular terminal** y un teclado numérico de 6 posiciones.

<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="Pantalla del POS con el título Vincular terminal y el teclado numérico" width="2986" height="1696" data-path="images/manuals/pos/linking/08-open-pos-app.png" />
</Frame>

## 7. Ingresa el código

Tipea los 6 dígitos en el teclado. Al completar el sexto dígito, la app valida el código automáticamente — no hace falta 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 con los 6 dígitos ingresados" width="832" height="1042" data-path="images/manuals/pos/linking/09-type-code.png" />
</Frame>

Mientras se valida, la pantalla muestra un indicador de carga. Si el código es inválido o expiró, aparece un mensaje de error y el teclado se limpia para que ingreses uno nuevo.

## 8. El terminal queda vinculado

Cuando la validación termina, el terminal recibe su nombre, su tienda y sus credenciales internas, y redirige automáticamente a la pantalla de **inicio de sesión del cajero**. Desde ese momento el dispositivo opera de forma autónoma — los cajeros pueden iniciar sesión con su PIN sin volver a usar el código.

<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="Pantalla de inicio de sesión del cajero después de vincular el terminal" width="2972" height="1688" data-path="images/manuals/pos/linking/10-cashier-signin.png" />
</Frame>

<Check>
  El terminal quedó vinculado a la tienda y listo para operar.
</Check>

## Verificación desde el backoffice

Vuelve a **POS → Terminales** y abre la pestaña **Activos**. El terminal recién registrado aparece en la lista con su nombre, fecha de última conexión y estado **ACTIVO**.

<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="Listado de terminales con el nuevo dispositivo en estado ACTIVO" width="2396" height="1466" data-path="images/manuals/pos/linking/11-terminal-active.png" />
</Frame>

En la pestaña **Slots pendientes** ya no debería aparecer el slot que generaste — pasó al estado **CLAIMED** y se consume automáticamente.
