Olá, seja bem-vindo à página da Integração com Equals – API de Vendas com EMSys!

A equipe da Equals desenvolveu uma API para receber as transações de vendas por cartão realizadas nas automações, com o objetivo de interpretar os dados e simplificar o processo de conciliação das vendas.




Pré-Requisitos para Funcionamento da Integração

Antes de ativar o processo no EMSys, alguns passos externos são obrigatórios para garantir o funcionamento adequado da integração:

1. Habilitação com a Equals

É necessário solicitar ao time da Equals a liberação do recebimento das vendas por API. Sem essa habilitação, ocorrerá erro "Acesso Negado" ao tentar enviar as transações.

2. Integração com DTEF (caso aplicável)

Caso o cliente utilize integração de vendas via DTEF, será necessário desabilitar essa funcionalidade. Se não for desativada, o mesmo dado poderá ser enviado duas vezes (via EMSys e via DTEF), resultando em duplicidade de vendas na Equals.

3. Configuração do Critério de Conciliação no Portal Equals

No portal da Equals, é obrigatório configurar corretamente o critério de conciliação, que define como as vendas serão associadas com os dados da adquirente.

Os campos geralmente utilizados são:

  • Data da Transação

  • Valor da Transação

  • Número de Autorização

  • Bandeira do Cartão

Parâmetro

Para habilitar este processo faça ativação do parâmetro: 

  • Acesse o Parâmetros Empresa selecione a opção "Ativar integração das vendas de cartões para o  equals".
  • Informe a data que será iniciado o processo de integração das vendas.
  • Clique na opção Confirmar.


Por padrão o parâmetro vai ficar desativado.

O Campo Data Início precisa ter atenção, o sistema não vai registrar as vendas antes da data informada.



Ativar o Serviço de Envio de Transações

Para iniciar o envio automático das vendas por cartão para a Equals, é necessário ativar o serviço no computador responsável pela operação.

Acesso o caminho: Gerencial → Vendas → Equals → Ativar Serviço Transação Cartão neste computador.

Como ativar:

  1. Acesse o menu acima no EMSys.

  2. Clique na opção "Ativar Serviço Transação Cartão neste computador".

  3. Após ativar, o serviço será executado automaticamente em intervalos de 30 segundos, enviando as transações elegíveis para a Equals.


Log

Durante o envio das transações, podem ocorrer impedimentos. Para auxiliar na identificação e correção desses problemas, foi implementado o menu Log de Erros, onde o usuário poderá visualizar as informações dos erros e realizar os ajustes necessários.

Acesso o caminho: Gerencial → Vendas → Equals → Log de erros no processo de integração equals.


 

É possível atualizar ou excluir os logs conforme necessário.

Após a ativação do processo, as informações serão exibidas na parte inferior da tela, incluindo:

  • Host da máquina que realizou o último processamento.

  • Versão do sistema.

  • Data e hora da execução.

O processo de envio e atualização será executado automaticamente a cada 30 segundos.

As transações enviadas para a Equals nesse processo são exclusivamente as vendas realizadas com cartão.

No EMSys, os dados dessa integração são armazenados na tabela:
Tab_equals_crtl_transacao_tect (Tabela Equals).