Ferramentas do usuário

Ferramentas do site


manuais:easycash:mercafacil

Essa é uma revisão anterior do documento!


Integração com a API da Mercafacil

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:

Configuração

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

  1. API;
  2. Loja;
  3. ID;
  4. Token.

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

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.

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

IWS → PVD → Exportação para o PDV

A exportação deve-se do modo: “Com requisição do operador”.

Frente de caixa:

No Easycash deveremos verificar se as configurações estão conformes a do retaguarda. Se caso estiver com divergência nos dados, realizar a configuração.

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

Deve-se verificar as configurações em todos os PDV's.

Sincronizador:

Primeiramente iremos configurar o arquivo: conexao.ini

Devemos nos atentar aos seguintes pontos:

  1. Ip do banco de dados do Intellicash;
  2. Aliaes do banco de dados do Intellicash;
  3. Número da empresa;
  4. Porta configurada.

Devemos configurar o arquivo: SincrIntegracao.ini

O arquivo deve estar configurado conforme a imagem abaixo:

Iremos realizar a primeira carga do Sincronizador:

Obs. Se caso a primeira carga apresentar algum erro no primeiro envio, deve-se entrar em contato com o mercafacil.

Deve-se atentar nos seguintes pontos:

  1. Checkbox do produtos deve estar marcado;
  2. Checkbox do operadores deve estar marcado;
  3. Período de vendas anteriores deve ser de um mês da data atual;
  4. Checkbox “Gerar DUMP de envio” deve estar marcado.

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

A carga inicial só pode ser gerada uma única vez. Caso na primeira vez apresente algum erro, entrar em contato com o suporte do mercafacil.

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

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:

Uma vez configurado o login de acesso a plataforma ao identificar um cliente no frente de caixa, será mostrado na parte superior da tela o logo da API e habilitado o atalho Shift + F5, conforme a imagem:

Ao pressionar os botões de atalho serão mostrados o total de pontos e o saldo total que o referido cliente possui na plataforma da Cresce Vendas, conforme a imagem abaixo:

Uma vez que o cupom foi registrado no frente de caixa ao pressionar F2 o sistema irá efetuar o envio inicial de compra para a Cresce Vendas para poder obter a listagem de descontos a serem aplicados para o referido cliente. Logo, será mostrado a seguinte tela para o operador:

Na tela de fechamento será mostrado abaixo do campo Valor Pago a quantidade total de descontos(itens + vale compras) aplicados no cupom retornados pela API da Cresce Vendas. Segue a imagem:

No DANFE da NFC-e será impresso a quantidade de pontos obtidos utilizando o referido cupom junto com a quantidade total de pontos do referido cliente. Segue a imagem:

Observe que o valor impresso é o mesmo que é apresentado na tela da plataforma do Cresce Vendas para o usuário. Segue a imagem:

No EasyCash foi criado também a pasta Integracao para contemplar os registros de envio e recebimento do webservice conforme a imagem:

A mesma pode ser utilizada para retirar qualquer dúvida sobre os dados trafegados para a plataforma Cresce Vendas.
Foi também efetuada uma alteração para que o EasyCash importe dos produtos as seguintes características apartir do IntelliCash:

Contingência

Neste caso em especial, é tratado as seguintes situações:

  1. É efetuado o envio inicial de itens e recebido o desconto, em seguida, o sistema tenta efetuar o envio final e neste momento ocorre um problema.
  2. É efetuado um cancelamento de cupom no sistema após a venda ser finalizada e ao tentar cancelar o mesmo no sistema da CRESCE VENDAS recebemos algum tipo de erro.

No envio inicial, caso ocorra algum tipo de problema, ao pressionar F2 novamente o sistema tentará reenviar, logo não teremos problema.

Caso uma das situações acima venha a acontecer o sistema adicionará o registro a ser enviado para a plataforma Cresce Vendas em uma tabela de pendências que poderá ser acessada pelo menu na tela principal do EasyCash conforme a imagem:

Caso na transmissão tenha erro do tipo 4XX, ou seja, erro de configuração ou de formação incorreta de dados será apresentada a seguinte mensagem ao abrir a interface:

Os erros do tipo 4XX não serão reenviados por orientação da própria Cresce Vendas e deve-se entrar em contato com SUPORTE TÉCNICO da IWS para validar a causa da não transmissão. Abaixo uma imagem da tela de pendências:

Ao clicar em Processar o sistema tentará reenviar as transmissões pendentes. No final do processo será mostrada a seguinte mensagem:

Nesta mesma interface temos o botão Visualizar LOG que permite visualizar o log específico criado para esta integração que mostra as informações do sistema ao manipular os dados da API.

Ao abrir o sistema caso tenha alguma pendência de envio o sistema irá mostrar a seguinte tela:

Será também mostrado na tela principal do sistema no canto superior direito conforme a imagem:

Também irá constar um registro na parte inferior da tela na área de log do sistema conforme a imagem:

Retaguarda

Na retaguarda nas Configurações do PDV foi acrescentada a seguinte tela:

Ao clicar no botão Alterar teremos:

Ao exportar CONFIGURAÇÃO as informações acima serão enviadas para o frente de caixa.

manuais/easycash/mercafacil.1642169678.txt.gz · Última modificação: 2022/01/14 14:14 por elaurelli