| Painel |
|---|
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. |
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
|
Conceito
O time da Equals desenvolveu uma API para receber as vendas (transações) de cartões realizadas nas automações visando interpretar os dados e facilitar na 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 emduplicidade 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âmetoparâ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.
| Nota |
|---|
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
Para fazer ativação do serviço acessede 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
Dê um clique nesta opção e aguarde o serviço ser executado a cada 30 segundos.
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 pode ocorrer algum impedimento, para resolver está questão , podem ocorrer impedimentos. Para auxiliar na identificação e correção desses problemas, foi implementado o menuLog de errosErros, onde o usuário vai receber poderá visualizar as informações de dos erros e fazer o ajuste necessáriorealizar os ajustes necessários.
Acesse Acesso o menucaminho: Gerencial → Vendas → Equals → Log de erros no processo de integração equals.
Pode "Atualizar ou Excluir os Logs".
- Quando for ativado este processo, neste menu será apresentado as informações na parte inferior.
O Host da maquina que fez o ultimo processamento, a versão do sistema, date e hora.
Processo será executado É 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 que serão enviadas para equals neste processo é somente as vendas que foram utilizado a Equals nesse processo são exclusivamente as vendas realizadas com cartão.
No EMSys a tabela referente a este processo é Tabela Equals ", os dados dessa integração são armazenados na tabela:
Tab_equals_crtl_transacao_tect"(Tabela Equals).