Skip to main content

​
Qué es

Un dispositivo POS es una terminal registrada para operar dentro de una sucursal. El emparejamiento le indica a qué empresa y local pertenece, y permite que descargue empleados, catálogo, stock y configuración. Desde el back office también podés reconocer equipos atrasados, cambiar su etiqueta o sucursal y archivar dispositivos que dejaron de usarse.

​
Dónde está

La ruta es Back office → Configuración → Sucursales y POS → Dispositivos. La página está agrupada así:
  • Hardware: la tabla de POS (Estado, ID, Sucursal, Etiqueta, Última sync, Última actividad). Usá Mostrar archivados para consultar equipos fuera de servicio.
  • Impresión y tickets: si el comercio usa comanda de cocina y si los tickets llevan un logo. El archivo del logo solo aparece cuando Imprimir logo está encendido.
  • Comportamiento del POS: Mostrar fotos en el catálogo (apagado por defecto) es el valor de la empresa. Cada caja puede forzar otro valor en Editar POS.
A la derecha, Así lo ve el cajero es una simulación del recibo, la comanda y la grilla del catálogo.

​
Cómo se usa

1

Prepará el comercio

Creá al menos una sucursal y un empleado activo con PIN. El primer POS no se puede vincular si todavía no existe un empleado.
2

Generá el código

Tocá Agregar POS, elegí la Sucursal del POS y seleccioná Generar código. La pantalla muestra el código y su vencimiento.
3

Ingresalo en la terminal

En el equipo sin vincular, abrí Registrar punto de venta, escribí el código y tocá Continuar. Mantené la conexión mientras se realiza la primera descarga.
4

Identificá el equipo

En la fila del POS, usá el ícono de edición para agregar una Etiqueta, como “Caja principal”, o cambiarlo de sucursal.
5

Archivá un POS fuera de uso

Tocá Archivar POS y confirmá. Para recuperarlo, mostrá los archivados y elegí Restaurar.

​
Configuración

  • Sucursal: determina el stock y la disponibilidad que recibe el equipo.
  • Etiqueta: nombre visible para distinguir cajas o terminales.
  • Fotos en el catálogo: el interruptor Mostrar fotos en el catálogo del POS (apagado por defecto) es el valor de la empresa. En Editar POS, heredá ese valor (Default empresa) o forzá Mostrar fotos / Ocultar fotos en esa caja.
  • Mostrar comanda: encendido por defecto. Apagalo en comercios que no preparan pedidos (kiosco, almacén). El POS oculta comanda en cobro, reimpresión y configuración, y las tarjetas restantes se estiran para no dejar un hueco. El catálogo deja de ofrecer Comanda en los presets de producto y categoría. Los valores guardados no se borran: si lo volvés a encender, reaparecen.
  • Logo de ticket: subí un JPEG, PNG o WebP (máx. 5 MB) al bucket público, con vista previa y Quitar. Imprimir logo en los tickets lo pone centrado arriba del encabezado en recibo, comanda y ticket fiscal térmico. Si falta el archivo o falla la descarga, el POS imprime el ticket sin logo.
  • Estado y Última sync: ayudan a detectar equipos que no están recibiendo cambios.
  • Última actividad: indica cuándo se comunicó recientemente el POS.
El código es temporal y se usa para una vinculación. Guiate por el vencimiento que muestra el diálogo; si la terminal indica Código inválido o vencido, generá uno nuevo.

​
Cambiar tenant (local y staging)

En tablets con build debug o staging, mantené presionado el logo / nombre del comercio (o el título de Registrar punto de venta / PIN). Se abre Cambiar tenant: listá empresas y POS del backend de desarrollo y confirmá. Confirmar borra catálogo, ventas y sesión locales y vuelve a emparejar. Reutilizar un POS rota su secreto: la tablet anterior queda fuera. Esto no está en el back office. El menú habla con GET /dev/pairing/catalog y POST /dev/pairing/claim. En producción esto es imposible, no solo está oculto:
  • El flavor prodRelease no compila el menú: el código vive en src/devPairing (debug + stg) y prodRelease usa un stub vacío. No hay flag de runtime en src/main.
  • El backend no registra /dev/pairing/* si TERO_DEPLOY_ENV es prod o un valor desconocido (fail-closed), o si DEV_PAIRING_SECRET está vacío (staging). Cada handler vuelve a rechazar con 404.
  • POST /pos/pairing/redeem solo acepta el código oficial de 8 caracteres; un JWT o un terokiosk-dev://… da invalid_code y no se hashea.
  • El corte de APK de staging exige TERO_DEV_PAIRING_SECRET y CI falla si el APK de prod trae el menú (tero.kiosk.dev-pairing.v1.marker).

​
Tips y advertencias

Archivar hace que el POS deje de sincronizar y lo oculta de la lista principal. Hacelo solo cuando el equipo ya no deba operar; restaurarlo vuelve a habilitar su registro.
  • No envíes códigos de emparejamiento por canales públicos.
  • Después de cambiar un POS de sucursal, sincronizalo y comprobá que muestra el local y el stock correctos.
  • Un equipo sin Última sync puede no haber terminado la descarga inicial.
  • El ID sirve para identificar la terminal ante soporte; no hace falta modificarlo.

​
Relacionado

Vincular la terminal

Usá el código de un solo uso.

Estado de sync

Última sync, actividad y pendientes.

Sucursales

Elegí el local antes de generar el código.

Empleados

Hace falta al menos uno para el primer POS.

Impresión en el POS

Comanda, recibo, fiscal y logo.
Last modified on October 22, 2026