Visão Geral

As APIs entre Equals e LinxERP permitem a integração entre as duas plataformas, permitindo o envio automatizado das informações de conciliação de vendas e pagamentos realizados por cartões de crédito.


Fluxo das APIs


LINX ERP – Versão 1.22.030 ou superior do Linx ERP. 

A partir da liberação do pacote 1.24.20, os objetos de banco das APIs/Serviços farão parte do pacote - não será mais apartado do ERP

Máquina para instalação:

Windows Server 2016 ou outro SO equivalente.

16gb – memória

Processador com 4 núcleos ou equivalente.

512 gb de armazenamento.

IIS – para instalação de api



API – Extrator de vendas

O domínio desta api, necessita estar público, pois a Equals irá buscar neste endereço os dados de vendas do cliente dentro ERP.

.NET 5.0 Instalado no servidor


Windows Service – Receptor de Vendas.NET 6.0 Instalado no servidor

Serviços Windows

A configuração é feita por appsettings.json - Arquivo separado por serviço, que salva a configuração de banco de dados e tokens para acesso ao ambiente Equals.

Service Status
Linx.ERP.Service.Status - Responsável pela consulta de status. Depois que o ERP faz a solicitação do relatório, este serviço verifica o status da solicitação.

AGUARDANDO_PROCESSAMENTO = 1,
EM_PROCESSAMENTO = 2,
CONCLUIDO = 3,
ERRO = 4,
RELATORIO_EXCLUIDO = 5,
DOWNLOAD_EM_ANDAMENTO = 6,
DOWNLOAD_CONCLUIDO = 7

Service Download
Linx.ERP.Service.Download - responsável pelo download dos relatórios.


1.EQUALS_BAIXA_VL

Quando o parâmetro estiver marcado como SIM a baixa de cartões realizada na tela 009254será realizada pelo valor líquido enviado pelo Equals e quando NÃO não pelo valor líquido do cartão no LinxErp.


2. EQUALS_CORRIGE_TICKET

Quando o parâmetro estiver marcado como SIM além de corrigir o cartão integrado no financeiro a conciliação de cartões do Equals fará a correção também do Ticket da Venda, quando NÃO será corrigido apenas o cartão.


3. EQUALS_END_API_RECEPTOR

Endereço para comunicação da API - Equals, deve ser informado o endereço configurado para acesso à API pelo Servidor do cliente.


4. EQUALS_ID_RELATORIO_FIN

Id informado pela Equals do relatório financeiro, este é o código único do relatório financeiro gerado para o cliente, necessário para busca das informações via API.


5. EQUALS_ID_RELATORIO_VEN

Id informado pela Equals do relatório de Vendas, este é o código único do relatório de vendas gerado para o cliente, necessário para busca das informações via API.