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:

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

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

Conexão USB de saída

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:

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:

// 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.
• Consulte a assinatura de cada método e seus parâmetros em Métodos e parâmetros.