# Modo POS Integrado e ciclo de vida do terminal

Esta página descreve o estado operacional controlado do terminal quando ele é conduzido pelo sistema de automação. Também apresenta os estados do ciclo de vida sob a perspectiva da integração.

## O que é o Modo POS Integrado

O **Modo POS Integrado** é um estado operacional controlado do terminal de pagamento. Nele, um sistema de automação comercial conduz programaticamente todas as interações relacionadas a pagamento. Com o Modo POS Integrado ativo, o terminal deixa de aceitar a navegação direta do usuário entre aplicativos. Ele atende exclusivamente aos comandos enviados pelo canal de comunicação do POS Integrado. Isso garante consistência transacional, segurança e sincronização entre o sistema de automação e o dispositivo POS.

## Modo POS Integrado

Quando um terminal entra no Modo POS Integrado:

* O terminal atende aos comandos emitidos pelo sistema de automação
* O acesso manual a outros aplicativos fica restrito
* As operações de pagamento só podem ser iniciadas programaticamente
* Todas as interações ocorrem por meio do Connector e dos Payment Apps

## Estados do ciclo de vida do terminal

Sob a perspectiva da integração, o terminal transita por estados de ciclo de vida bem definidos:

1. **Modo POS Normal (Standalone)** — O estado padrão, em que o terminal opera de forma independente e não aceita comandos integrados.
2. **Ativação** — O usuário habilita o Modo POS Integrado no terminal e escolhe um modelo de conexão.
3. **Em espera (Modo POS Integrado)** — O terminal está conectado, validado via Polling e aguardando comandos do sistema de automação.
4. **Processamento** — O terminal executa uma função específica (por exemplo, Sale, Refund ou Reports).
5. **Desativação** — O terminal sai do Modo POS Integrado e retorna ao Modo POS Normal, por meio de um comando `SwitchToNormalPos` ou manualmente.

**Reconexão (recuperação):** Se uma operação no dispositivo retornar o código `5`, o terminal redefiniu sua conexão — por exemplo, após um reboot ou uma queda de link — e precisa restabelecê-la. Isso pode ocorrer em qualquer momento após uma queda, não somente logo depois da ativação. Execute o `Polling` novamente no mesmo Connector, reenvie os parâmetros de configuração e repita o comando. Consulte [Polling e reconexão](/pt/integrated-pos/core-concepts-pos/polling-reconnection).

## O ciclo de vida do Connector

Você cria um Connector com um dos métodos de fábrica — `CreateHttp`, `CreateUsb` ou `CreateCloud` — e ele segue um ciclo de vida previsível:

1. **Create** — Abra a conexão com o terminal. No Cloud2Cloud, `CreateCloud` abre um canal para a nuvem da Getnet, que repassa os comandos ao terminal remoto.
2. **Polling** — Envie um comando `Polling` para validar a conexão e confirmar que o terminal chegou ao estado de espera (Standby).
3. **Operate** — Envie comandos de transação, como Sale, Refund ou Reports, enquanto o terminal permanece no Modo POS Integrado.
4. **Close** — Libere o Connector ao concluir o trabalho. O fechamento encerra a sessão de forma limpa.

Ao ler campos contábeis como `AccountingDate` nas respostas, trate-os como parte da fase de operação. O terminal os retorna enquanto processa comandos no Modo POS Integrado.

## Saída do Modo POS Integrado

O terminal retorna ao Modo POS Normal quando você envia um comando `SwitchToNormalPos` ou quando o usuário sai manualmente. Após a desativação, o terminal não aceita mais comandos integrados. Ele volta a aceitá-los quando você o ativa novamente e restabelece a conexão.

## Recursos relacionados

* [Arquitetura do POS](/pt/integrated-pos/first-steps-pos/pos-architecture) — Componentes e fluxo de execução.
* [Connector e Fluxos de Comunicação](/pt/integrated-pos/core-concepts-pos/connector-communication-flows) — Como o Connector é criado, usado e fechado.
* [Guia de Início Rápido](/pt/integrated-pos/first-steps-pos/quickstart-integrated-pos) — Criação do connector, Polling, Sale, Close.