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âmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
hostname | string | Sim | Hostname, IPv4 ou IPv6 do terminal POS |
port | int | Não | Porta 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:
SaleRefundGetReports
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
- Connector e Fluxos de Comunicação
- Reconexão, Polling e Resiliência
- Referência de Métodos e Parâmetros — Parâmetros do CreateHttp.