# 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

```csharp
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:

```csharp
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:

```csharp
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](/pt/integrated-pos/core-concepts-pos/connector-communication-flows)
* [Reconexão, Polling e Resiliência](/pt/integrated-pos/core-concepts-pos/polling-reconnection)
* [Referência de Métodos e Parâmetros](/pt/integrated-pos/reference/methods-parameters) — Parâmetros do CreateHttp.