# Modo TPV Integrado y ciclo de vida del terminal

Esta página describe el estado operativo controlado del terminal cuando lo dirige el sistema de automatización. También describe los estados del ciclo de vida desde la perspectiva de la integración.

## ¿Qué es el Modo TPV Integrado?

El **Modo TPV Integrado** es un estado operativo controlado del terminal de pago. En ese estado, un sistema de automatización comercial dirige de forma programática todas las interacciones de pago. Cuando el Modo TPV Integrado está activo, el terminal deja de aceptar la navegación directa del usuario entre aplicaciones. Solo escucha los comandos que llegan por el canal de comunicación del TPV Integrado. Esto garantiza la consistencia transaccional, la seguridad y la sincronización entre el sistema de automatización y el dispositivo TPV.

## Modo TPV Integrado

Cuando un terminal entra en Modo TPV Integrado:

* El terminal escucha los comandos que emite el sistema de automatización
* El acceso manual a otras aplicaciones queda restringido
* Las operaciones de pago solo se inician de forma programática
* Todas las interacciones ocurren a través del Connector y las Payment Apps

## Estados del ciclo de vida del terminal

Desde la perspectiva de la integración, el terminal pasa por estados del ciclo de vida bien definidos:

1. **Modo TPV normal (Autónomo)** — El estado predeterminado. El terminal funciona de forma independiente y no acepta comandos integrados.
2. **Activación** — El usuario activa el Modo TPV Integrado en el terminal y elige un modelo de conexión.
3. **En espera (Modo TPV Integrado)** — El terminal está conectado, validado mediante Polling y a la espera de comandos del sistema de automatización.
4. **En procesamiento** — El terminal ejecuta una función específica (por ejemplo, Sale, Refund o Reports).
5. **Desactivación** — El terminal sale del Modo TPV Integrado y vuelve al Modo TPV normal. Esto ocurre con un comando `SwitchToNormalPos` o de forma manual.

**Reconexión (recuperación):** Si una operación del dispositivo devuelve el código `5`, el terminal reinició su conexión y necesita restablecerla. Esto pasa, por ejemplo, tras un reinicio o una caída del enlace. Puede ocurrir en cualquier momento después de una caída, no solo justo después de la activación. Vuelve a ejecutar `Polling` en el mismo Connector, reenvía los parámetros de configuración y reintenta el comando. Consulta [Polling y reconexión](/es/integrated-pos/core-concepts-pos/polling-reconnection).

## El ciclo de vida del Connector

Creas un Connector con uno de los métodos de fábrica — `CreateHttp`, `CreateUsb` o `CreateCloud` — y sigue un ciclo de vida predecible:

1. **Create** — Abre la conexión con el terminal. En Cloud2Cloud, `CreateCloud` abre un canal hacia la nube de Getnet, que retransmite los comandos al terminal remoto.
2. **Polling** — Envía un comando `Polling` para validar la conexión y confirmar que el terminal llegó a En espera.
3. **Operate** — Emite comandos de transacción, como Sale, Refund o Reports, mientras el terminal permanece en Modo TPV Integrado.
4. **Close** — Libera el Connector cuando termina el trabajo. El cierre finaliza la sesión de forma limpia.

Cuando leas campos contables como `AccountingDate` en las respuestas, considéralos parte de la fase Operate. El terminal los devuelve mientras procesa comandos en Modo TPV Integrado.

## Salir del Modo TPV Integrado

El terminal vuelve al Modo TPV normal cuando envías un comando `SwitchToNormalPos` o cuando el usuario sale de forma manual. Después de la desactivación, el terminal ya no acepta comandos integrados. Debes activarlo de nuevo y restablecer la conexión.

## Recursos relacionados

* [Arquitectura del TPV](/es/integrated-pos/first-steps-pos/pos-architecture) — Componentes y flujo de ejecución.
* [Connector y flujos de comunicación](/es/integrated-pos/core-concepts-pos/connector-communication-flows) — Cómo se crea, se usa y se cierra el Connector.
* [Inicio rápido](/es/integrated-pos/first-steps-pos/quickstart-integrated-pos) — Creación del connector, Polling, Sale, Close.