Getnet DocsGetnet Docs

Modo POS Integrado e ciclo de vida do terminal

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page
Connect to CursorUse these docs in CursorConnect to VS CodeUse these docs in VS Code

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.

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