Ferramentas do usuário

Ferramentas do site


manuais:easycash:crescevendas

Integração com a API da Cresce Vendas

A partir da versão 1.4.012.000 o sistema tornou-se integrado com a API da Cresce Vendas.

Dependências

Para acessar o sistema HTTPS da plataforma Cresce Vendas torna-se necessário adicionar na pasta Client do EasyCash as seguintes DLL:

  • libcrypto-1_1.dll (OpenSSL library 1.1.1.7)
  • libssl-1_1.dll (OpenSSL library 1.1.1.7)

Configuração

Será necessário que o cliente efetue o cadastro junto a plataforma e adicione os dados de e-mail e token para acesso do frente de caixa. Logo, no mesmo teremos a seguinte configuração:

Ao clicar no botão Alterar teremos:

Uma vez configurado, o cliente deve na plataforma do Cresce Vendas informar os descontos para itens, conforme a imagem:

Caso deseje cadastrar um vale compras para o cliente, também é possível, sendo que o EasyCash irá adicionar o referido desconto no subtotal do cupom. Na plataforma irá ser mostrado da seguinte maneira:

Funcionamento

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/crescevendas.txt · Última modificação: 2020/08/12 19:47 por amonteiro