Getnet DocsGetnet Docs

Polling e reconexão

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 explica como o POS Integrado trata validação, reconexão e resiliência quando a comunicação é interrompida ou o estado do terminal é incerto.

O que são Polling e reconexão

Polling é o comando usado para verificar se o terminal POS está disponível e pronto para receber comandos do sistema de automação. Reconexão se refere ao comportamento e aos fluxos que se aplicam quando a comunicação é perdida ou quando você usa parâmetros de configuração (por exemplo, friendly name) na criação do Connector em conexões via SDK. O tratamento robusto desses cenários mantém a integridade transacional e evita estados inconsistentes do terminal.

Execução do Polling

Chame o método Polling na instância do Connector antes de iniciar qualquer operação no dispositivo. Uma resposta bem-sucedida — Code 0 com Connected true — confirma que o terminal está disponível e pronto para processar operações. Execute o Polling antes de cada operação para não enviar comandos a um terminal que não está pronto.

Cenários de reconexão

O terminal pode reiniciar seu estado de conexão — por exemplo, após um reboot, uma queda de rede, uma desconexão do USB ou uma interrupção temporária da nuvem ou do serviço. Quando isso acontece, uma operação no dispositivo (como Sale) retorna o código 5. O código 5 é o sinal de reconexão e pode ocorrer em qualquer momento após uma queda — não somente na inicialização.

Para recuperar a comunicação, mantenha a mesma instância do Connector — não crie uma nova:

  1. Chame Polling novamente no Connector existente.
  2. Quando o Polling retornar o código 0, reenvie os parâmetros de configuração, porque a reconexão redefine a configuração do terminal.
  3. Reenvie o comando que retornou o código 5.

Esse fluxo é idêntico nos modos SDK (USB / HTTP) e Cloud2Cloud.

Recursos relacionados

  • Guia de Início Rápido — o Passo 2 usa o Polling para validar o terminal antes de uma venda.
  • Modelos de Conexão — escolha USB, rede ou nuvem; o comportamento de reconexão varia conforme o modelo.
  • Para detalhes dos parâmetros e do retorno do Polling e do fluxo de reconexão, consulte as seções de conectividade e de tratamento de erros desta documentação.