====== Integração com a API da Mercafacil ======

{{ :manuais:easycash:imagem_2022-01-13_153723.png |}}

A partir da versão 1.4.016.000 do Easycash, o sistema tornou-se integrado com a API da Mercafacil.

===== Dependências =====

Para realizar a sincronização dos dados do sistema para a plataforma do Mercafacil deve-se colocar o sincronizador dentro da pasta IWS:

{{ :manuais:easycash:imagem_2022-01-13_155250.png |}}


===== Configuração =====

Será necessário que o cliente disponibilize os seguintes dados para a configuração da aplicação:

  - API;
  - Loja;
  - ID;
  - Token.

{{ :manuais:easycash:imagem_2022-01-13_160920.png |}}

Após o recebimento dos dados, Devemos realizar a configuração no retaguarda e no frente de caixa.

==== Retaguarda ====

Caminho Intellicash: IWS -> PDV -> Easycash -> Configuração -> Configuração do PDV -> Aba PDV -> Aba Integração API -> Aba Mercafacil

{{ :manuais:easycash:imagem_2022-01-14_104620.png |}}

Deve-se preencher os campos com os dados fornecidos pelo cliente.

**Obs.:** Atentar ao link da api, onde deve-se inserir o link até a informação api, conforme a imagem acima.

<note important> Para base multi-empresas deve-se colocar um token para cada empresa, nas configurações do PDV.</note>

Após configurar, deve-se salvar e exportar as configurações:

Caminho: IWS -> PDV -> Exportação para o PDV

A exportação deverá ser: "Com requisição do operador".

==== Frente de Caixa ====

No Easycash, verificar se as configurações estão iguais a do Intellicash, se caso houver alguma divergência, realizar a alteração.

Caminho: Configurações -> Aba PDV -> Aba Integração - API -> Aba Mercafacil

{{ :manuais:easycash:imagem_2022-01-14_105845.png |}}

<note important> Deve-se verificar as configurações em todos os PDV's.</note>

==== Sincronizador ====

Primeiramente iremos configurar o arquivo: conexao.ini

{{ :manuais:easycash:imagem_2022-01-13_174140.png |}}

Devemos nos atentar aos seguintes pontos:

{{ :manuais:easycash:imagem_2022-01-13_175210.png |}}


  - Ip do banco de dados do Intellicash;
  - Aliases do banco de dados do Intellicash;
  - Número da empresa;
  - Porta configurada.

Devemos configurar o arquivo: SincrIntegracao.ini

O arquivo deve estar configurado conforme a imagem abaixo:
{{ :manuais:easycash:imagem_2022-01-13_175837.png |}}

O executável do sincronizador deve estar na inicialização do windows:

Comando: shell:common startup
{{ :manuais:easycash:imagem_2022-01-14_151657.png |}}

Devemos agora, realizar a primeira carga para o Mercafacil, onde serão enviados os dados para que possam ser geradas as promoções.

====Primeira carga do Sincronizador====


{{ :manuais:easycash:imagem_2022-01-14_102622.png |}}

Deve-se atentar nos seguintes pontos:

   - Checkbox do produtos deve estar marcado;
   - Checkbox do operadores deve estar marcado;
   - Período de vendas anteriores deve ser de um mês da data atual;
   - Checkbox "Gerar DUMP de envio" deve estar marcado.

Após realizar as marcações acima, deve-se gerar a carga inicial.

<note important>A carga inicial só pode ser gerada uma única vez. Caso na primeira vez apresente algum erro, entrar em contato com o suporte técnico.</note>

Na aba "Sincronizador", as configurações devem estar da forma conforme a figura abaixo:

{{ :manuais:easycash:imagem_2022-01-14_103947.png |}}

Observação: O tempo do campo "Intervalo de Exportações(h), vem como padrão o valor de 12 horas, porém, poderá ser trocado para 2 horas.



===== Funcionamento =====

Uma vez configurado, no ato da venda, ao informar o consumidor (F6) e o produto, se houver a promoção, na tela de confirmação de venda, a promoção irá ser exibida:

{{ :manuais:easycash:telavenda_01.jpg |}}

{{ :manuais:easycash:imagem_2022-01-14_172552.png |}}




<note important> O cliente que não possuir cadastro no sistema (possuindo cadastro no mercafacil), poderá ser cadastrado no frente de caixa, sendo necessário pelo menos cadastrar nome do cliente para que seja ativo o desconto..</note>

===== Transmissões Pendentes =====

Se houver algum problema de comunicação entre o frente de caixa e o servidor do Mercafácil, o cupom será enviado para transmissões pendentes:

{{ :manuais:easycash:transmissao_pendente3.jpg |}}

Para acessar as transmissões pendentes, deve-se acessar o caminho: Integração -> Mercafacil -> Transmite Pendentes.

É possível retransmitir, pressionando o botão "Processar".

{{ :manuais:easycash:transmissao_pendente4.jpg |}}


Ao inicializar o Easycash, será apresentado uma mensagem informando que há transmissões pendentes.

**Obs.:** Se caso houver algum problema na transmissão, acionar o suporte técnico.


<note important> Ao inserir as configurações no Easycash, deverá ser atualizado as dll's auxiliares, inserindo dentro da pasta Client (iws -> EC -> Client). As dll's atualizadas se encontram dentro do FTP.</note>