Getnet DocsGetnet Docs

Conectando via rede – Wi-Fi / Ethernet (CreateHttp)

Este guia explica como conectar um POS Integrado por uma rede usando comunicação HTTP.


Quando usar a conexão de rede

Use uma conexão de rede quando:

  • O terminal POS e o sistema de automação estiverem na mesma rede local
  • Houver conectividade Wi-Fi ou Ethernet disponível
  • For necessário posicionamento físico flexível dos dispositivos

Este é o modelo de conexão mais comum em implantações de POS Integrado.


Antes de começar

Antes de conectar pela rede, confirme que:

  • O terminal POS está ligado e configurado para o modo POS Integrado
  • O terminal está acessível pela rede
  • A biblioteca do POS Integrado está disponível na sua aplicação
  • As políticas de firewall ou de rede permitem a comunicação HTTP

Passo 1: Criar o HTTP Connector

Para estabelecer a conexão, crie um Connector usando CreateHttp.

Parâmetros

ParâmetroTipoObrigatórioDescrição
hostnamestringSimHostname, IPv4 ou IPv6 do terminal POS
portintNãoPorta TCP (padrão: 8080)

Exemplo

Connector connector = Connector.CreateHttp("192.168.0.10");

Neste ponto, o canal de comunicação está inicializado, mas o terminal ainda não foi validado.


Passo 2: Validar o terminal

Valide o terminal usando o comando Polling antes de executar qualquer operação:

var pollingResult = connector.PollingAsync();

Prossiga apenas se a resposta do Polling indicar prontidão.


Passo 3: Executar operações

Uma vez validado, use o Connector para executar operações como:

  • Sale
  • Refund
  • GetReports

As operações são processadas sequencialmente.


Passo 4: Fechar a conexão

Após finalizar todas as operações, feche o Connector:

connector.Close();

A instância do Connector não pode ser reutilizada após o fechamento.


Considerações sobre a conexão de rede

  • A instabilidade da rede pode exigir reconexão
  • O Polling deve ser executado novamente após a reconexão
  • Os parâmetros de configuração podem afetar o comportamento de reconexão

Próximos passos