# Biblioteca .NET

Integre o POS Integrado ao seu aplicativo usando a biblioteca .NET.

## Instalação

1. Coloque os arquivos `PosIntegrado.Api.dll` e `PosIntegrado.Api.xml` fornecidos no pacote de release no diretório `libs/` do seu projeto.
2. Adicione uma referência ao arquivo `PosIntegrado.Api.dll` dentro do seu projeto.

## Namespaces principais

Inclua os seguintes namespaces principais no seu código:

```csharp
using PosIntegrado.Api;
using PosIntegrado.Api.Abstractions;
```

## Criação do Connector

Crie uma instância de Connector para se comunicar por USB ou HTTP (rede) com os métodos correspondentes:

### Conexão HTTP de saída

```csharp
var connector = Connector.CreateHttp("192.168.1.100", 8080);
```

### Conexão USB de saída

```csharp
var connector = Connector.CreateUsb("COM3");
```

## Tratamento de erros

Consulte o padrão `Result<T>` para tratar a lógica de negócio esperada em vez de depender de exceções:

```csharp
var response = connector.SomeOperation(request);

if (response.IsSuccess)
{
    // Proceed with response.Value
}
else
{
    // Handle error with response.Error
}
```

## Exemplo de fluxo de venda

Revise o exemplo a seguir, que demonstra a estrutura de um fluxo de venda em passo único:

```csharp
// 1. Initialize connector
var connector = Connector.CreateHttp("192.168.1.100", 8080);

// 2. Build the request
var request = new SaleRequest 
{
    Amount = 15000,
    SaleType = SaleType.Card,
    PrintOnPos = true
};

// 3. Execute the sale
var result = connector.Sale(request);

// 4. Handle the result
if (result.IsSuccess)
{
    var saleResponse = result.Value;
    Console.WriteLine($"Sale Approved: {saleResponse.AuthorizationCode}");
}
else
{
    Console.WriteLine($"Sale Failed: {result.Error.Message}");
}
```

## Próximos passos

* Execute o fluxo completo de ponta a ponta com o guia de [Início rápido](/pt/integrated-pos/first-steps-pos/quickstart-integrated-pos).
* Consulte a assinatura de cada método e seus parâmetros em [Métodos e parâmetros](/pt/integrated-pos/reference/methods-parameters).