====== Integração com a API da Cresce Vendas ======

{{ :manuais:easycash:cresce_vendas_logo.png |}}

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:

{{ :manuais:easycash:cresce_vendas01.png |}}

Ao clicar no botão **Alterar** teremos:

{{ :manuais:easycash:cresce_vendas02.png |}}

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

{{ :manuais:easycash:cresce_vendas04.png |}}

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:

{{ :manuais:easycash:cresce_vendas03.png |}}
===== 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:

{{ :manuais:easycash:cresce_vendas05.png |}}

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:

{{ :manuais:easycash:cresce_vendas06.png |}}

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:

{{ :manuais:easycash:cresce_vendas07.png |}}

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:

{{ :manuais:easycash:cresce_vendas08.png |}}

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:

{{ :manuais:easycash:cresce_vendas09.png |}}

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

{{ :manuais:easycash:cresce_vendas11.png |}}

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

{{ :manuais:easycash:cresce_vendas10.png |}}

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:

{{ :manuais:easycash:cresce_vendas12.png |}}
===== Contingência =====

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

  - É 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__.
  - É 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:

{{ :manuais:easycash:cresce_vendas_contingencia01.png |}}

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:

{{ :manuais:easycash:cresce_vendas_contingencia02.png |}}

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:

{{ :manuais:easycash:cresce_vendas_contingencia03.png |}}

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

{{ :manuais:easycash:cresce_vendas_contingencia04.png |}}

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:

{{ :manuais:easycash:cresce_vendas_contingencia06.png |}}

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

{{ :manuais:easycash:cresce_vendas_contingencia05.png |}}

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

{{ :manuais:easycash:cresce_vendas_contingencia07.png |}}

===== Retaguarda =====

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

{{ :manuais:easycash:cresce_vendas_retaguarda01.png |}}

Ao clicar no botão **Alterar** teremos:

{{ :manuais:easycash:cresce_vendas_retaguarda02.png |}}

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