Aqui você vê as diferenças entre duas revisões dessa página.
manuais:easycash:mercafacil [2022/01/14 14:14] elaurelli |
manuais:easycash:mercafacil [2024/07/10 12:03] (atual) qualidade01 |
||
---|---|---|---|
Linha 3: | Linha 3: | ||
{{ :manuais:easycash:imagem_2022-01-13_153723.png |}} | {{ :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. | + | A partir da versão 1.4.016.000 do Easycash, o sistema tornou-se integrado com a API da Mercafacil. |
===== Dependências ===== | ===== Dependências ===== | ||
Linha 25: | Linha 25: | ||
Após o recebimento dos dados, Devemos realizar a configuração no retaguarda e no frente de caixa. | Após o recebimento dos dados, Devemos realizar a configuração no retaguarda e no frente de caixa. | ||
- | **__Retaguarda:__** | + | ==== Retaguarda ==== |
Caminho Intellicash: IWS -> PDV -> Easycash -> Configuração -> Configuração do PDV -> Aba PDV -> Aba Integração API -> Aba Mercafacil | Caminho Intellicash: IWS -> PDV -> Easycash -> Configuração -> Configuração do PDV -> Aba PDV -> Aba Integração API -> Aba Mercafacil | ||
Linha 33: | Linha 33: | ||
Deve-se preencher os campos com os dados fornecidos pelo cliente. | 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. | + | **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: | Após configurar, deve-se salvar e exportar as configurações: | ||
- | IWS -> PVD -> Exportação para o PDV | + | Caminho: IWS -> PDV -> Exportação para o PDV |
- | A exportação deve-se do modo: "Com requisição do operador". | + | A exportação deverá ser: "Com requisição do operador". |
- | **__Frente de caixa:__** | + | ==== 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. | + | 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 | Caminho: Configurações -> Aba PDV -> Aba Integração - API -> Aba Mercafacil | ||
Linha 51: | Linha 53: | ||
<note important> Deve-se verificar as configurações em todos os PDV's.</note> | <note important> Deve-se verificar as configurações em todos os PDV's.</note> | ||
- | **__Sincronizador:__** | + | ==== Sincronizador ==== |
Primeiramente iremos configurar o arquivo: conexao.ini | Primeiramente iremos configurar o arquivo: conexao.ini | ||
Linha 63: | Linha 65: | ||
- Ip do banco de dados do Intellicash; | - Ip do banco de dados do Intellicash; | ||
- | - Aliaes do banco de dados do Intellicash; | + | - Aliases do banco de dados do Intellicash; |
- Número da empresa; | - Número da empresa; | ||
- Porta configurada. | - Porta configurada. | ||
Linha 72: | Linha 74: | ||
{{ :manuais:easycash:imagem_2022-01-13_175837.png |}} | {{ :manuais:easycash:imagem_2022-01-13_175837.png |}} | ||
+ | O executável do sincronizador deve estar na inicialização do windows: | ||
- | Iremos realizar a primeira carga do Sincronizador: | + | 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==== | ||
- | Obs. Se caso a primeira carga apresentar algum erro **no primeiro envio**, deve-se entrar em contato com o mercafacil. | ||
{{ :manuais:easycash:imagem_2022-01-14_102622.png |}} | {{ :manuais:easycash:imagem_2022-01-14_102622.png |}} | ||
Linha 88: | Linha 95: | ||
Após realizar as marcações acima, deve-se gerar a carga inicial. | 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 do mercafacil.</note> | + | <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: | Na aba "Sincronizador", as configurações devem estar da forma conforme a figura abaixo: | ||
Linha 94: | Linha 101: | ||
{{ :manuais:easycash:imagem_2022-01-14_103947.png |}} | {{ :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. | ||
Linha 103: | Linha 111: | ||
{{ :manuais:easycash:telavenda_01.jpg |}} | {{ :manuais:easycash:telavenda_01.jpg |}} | ||
- | {{ :manuais:easycash:imagem_2022-01-14_111415.png |}} | + | {{ :manuais:easycash:imagem_2022-01-14_172552.png |}} |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | 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 |}} | + | <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> |
- | 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. | + | ===== Transmissões Pendentes ===== |
- | Ao abrir o sistema caso tenha alguma pendência de envio o sistema irá mostrar a seguinte tela: | + | 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:cresce_vendas_contingencia06.png |}} | + | {{ :manuais:easycash:transmissao_pendente3.jpg |}} |
- | Será também mostrado na tela principal do sistema no canto superior direito conforme a imagem: | + | Para acessar as transmissões pendentes, deve-se acessar o caminho: Integração -> Mercafacil -> Transmite Pendentes. |
- | {{ :manuais:easycash:cresce_vendas_contingencia05.png |}} | + | É possível retransmitir, pressionando o botão "Processar". |
- | Também irá constar um registro na parte inferior da tela na área de log do sistema conforme a imagem: | + | {{ :manuais:easycash:transmissao_pendente4.jpg |}} |
- | {{ :manuais:easycash:cresce_vendas_contingencia07.png |}} | ||
- | ===== Retaguarda ===== | + | Ao inicializar o Easycash, será apresentado uma mensagem informando que há transmissões pendentes. |
- | Na retaguarda nas **Configurações do PDV** foi acrescentada a seguinte tela: | + | **Obs.:** Se caso houver algum problema na transmissão, acionar o suporte técnico. |
- | {{ :manuais:easycash:cresce_vendas_retaguarda01.png |}} | ||
- | Ao clicar no botão **Alterar** teremos: | + | <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> |
- | {{ :manuais:easycash:cresce_vendas_retaguarda02.png |}} | ||
- | Ao exportar **CONFIGURAÇÃO** as informações acima serão enviadas para o frente de caixa. |