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:
Acesse o menu acima no EMSys.
Clique na opção "Ativar Serviço Transação Cartão neste computador".
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).