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

A partir da versão 1.4.013.001 o sistema tornou-se integrado com a API da DMCard.

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

Para acessar o sistema HTTPS da plataforma DMCard torna-se necessário adicionar na pasta __Client do EasyCash__ e no __diretório principal do Intellicash__ 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 =====

==== Retaguarda ====

=== Etapa 01 ===
A primeira configuração a ser realizada será na forma de recebimento do IntelliCash:

{{ :manuais:easycash:config01_dmcard.png?400 }}

Setar a configuração **Participa do programa DMOfertas** e setar os BIN da DMCard para a forma de recebimento que será utilizada:

{{ :manuais:easycash:config02_dmcard.png?400 }}

{{ :manuais:easycash:config03_dmcard.png?400 }}

Na tela principal do recebimento será mostrada a coluna adicional com a referida configuração checada, segue:

{{ :manuais:easycash:config04_dmcard.png?750 }}

<note important>A Listagem de BIN deverá ser fornecida pela própria DMCard.</note>

<note>Lembrando que a aba Listagem de BIN só irá aparecer se a opção Cartão estiver setada na tela de configuração.</note>

=== Etapa 02===

Na tela de formas de recebimento para o frente de caixa deverá ser associada a forma de pagamento normalmente, sendo que nas configurações teremos:

{{ :manuais:easycash:config01_etapa02.png?500 |}}

Observando que nessas telas as opções são **SOMENTE LEITURA**(não podem ser alteradas) pois a configuração foi herdade da forma PAI do IntelliCash.

Nesta tela também, foi adicionada a seguinte opção:

{{ :manuais:easycash:config02_etapa02.png?500 |}}

Esta opção permite que possa ser exportado toda a tabela de BINs para o frente de caixa.

{{ :manuais:easycash:config03_etapa02.png?500 |}}

=== Etapa 03 ===

Na tela de configuração do EasyCash foi adicionado uma nova aba de configuração conforme demonstrado na tela abaixo:

{{ :manuais:easycash:config01_etapa03.png?550 |}}

<note important>A URL da API e o ID da Rede/Loja serão fornecidos pela DMCard.</note>

==== PDV ====

=== Etapa 01 ===

No frente de caixa foi adicionado uma nova opção para importação, conforme o menu:

{{ :manuais:easycash:config01_etapa04.png?450 |}}

Na forma de recebimento do EasyCash teremos:

{{ :manuais:easycash:config02_etapa04.png?450 |}}

{{ :manuais:easycash:config03_etapa04.png?450 |}}

No frente de caixa as configurações da DMCard foram inseridas na tela conforme a imagem abaixo:

{{ :manuais:easycash:config04_etapa04.png?450 |}}

<note important>Com esta versão as formas de recebimento devem ser carregadas __pelo menos uma vez no frente de caixa__ para que o frente preencha a tabela auxiliar de ID do BIN.</note>

=== Etapa 02 ===

Na venda, ao identificar o consumidor e pressionar F2 será consultado a API da DMCard e caso o usuário tenha __preço diferenciado de cartão para um item da venda__ será mostrada a janela a seguir:

{{ :manuais:easycash:config01_etapa05.png?650 |}}

<note>Caso não tenha será mostrada uma mensagem de **SIM** ou **NÃO** padrão do sistema.</note>

Ao entrar na tela de fechamento a forma já estará selecionada permitindo o usuário ainda adicionar entrega ou dar um acréscimo/desconto se a forma permitir. Segue:

{{ :manuais:easycash:config02_etapa05.png?450 |}}

Para o caso da forma de recebimento ser do tipo TEF será validado o retorno 136 da CliSiTEF com os BIN configurados anteriormente. Caso não encontre o BIN o sistema irá cancelar os TEF pendentes e voltar para a tela de venda, permitindo entrar novamente pelo F2 e escolher não utilizar cartão. **Não irá cancelar o cupom.**

Caso possua mais de 1 forma de recebimento será mostrada a seguinte tela:

{{ :manuais:easycash:config03_etapa05.png?450 |}}

Na forma de recebimento **POS** ao entrar no fluxo da forma será pedido para o usuário digitar o BIN do cartão, conforme a imagem:

{{ :manuais:easycash:config04_etapa05.png?450 |}}

<note>Na pasta **LOG\Integracao** e **Integracao\DMCard** encontram-se arquivos auxiliares para o caso de precisar efetuar alguma validação de suporte.</note>