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. | ||