Objetivo
Integrar Pessoas, Produtos, Duplicatas, Baixas de Duplicatas, Cheques, Baixas/Acertos, Devoluções de Cheques, Pedidos e Retorno de Limite e de Pedido, com o sistema Deps NET, a fim de automatizar a liberação de pedidos no que diz respeito a validação de limite de crédito.
A integração será feita por API, usando o servidor XE.
Índice
Passo a passo
Criado dentro das configurações gerais do sistema dentro de Filial >> Integrações alguns campos necessários para a integração funcionar, conforme imagem abaixo:
1- Origem Cliente: Nome utilizado como apelido para a integração, utilizado no JSON da maioria dos registros.
2- URL DEPS : Será o endereço de comunicação do servidor da DEPS (obter junto a Deps), exemplo: http://192.168.0.42:74
3- Ramo de Atividade: O sistema não enviará para a DEPS as duplicatas/cheques vinculados a pessoas que possuem esse ramo de atividade.
Estando esses campos devidamente configurados será necessário configurar também o servidor XE para que a integração dos títulos e cheques sejam corretamente enviados.
Títulos/Cheques:
Serão enviadas todas as inclusões/alterações/baixas de títulos e cheques para a DEPS, no caso dos cheques do Construshow os mesmos devem ser enviados para o mesmo cadastro de títulos do DEPS.
Foram criadas as tabelas DUPRECEXC , DUPRECACERFINEXC e CHEQRECEXC para gravar a exclusão de Duplicatas, Estorno de Acertos e Cheques quando estiver configurada a URL DEPS, a fim de que essas informações possam ser posteriormente enviadas para a DEPS. Como o DEPS não excluí os títulos e cheques que estão lá, caso um título seja excluído do Construshow, o mesmo será enviado com o Status EXCLUSÃO para o DEPS.
Foram feitos tratamentos para os casos em que uma duplicata é acertada com cheque ou mesmo renegociada com outra duplicata seja enviada para o DEPS como renegociação, a fim de que o DEPS possa considerar apenas um dos documentos como movimento do cliente, visto que os demais são consequências do acerto e não movimentações que devam impactar no crédito do mesmo.
OBS: Foi deixado fixo nas consultas de carga inicial 18 meses, sendo assim ao dar a primeira carga serão enviados os títulos e cheques dos últimos 18 meses e todos os títulos e cheques pendentes (que não estão quitados).
Foi desenvolvido uma tela de acompanhamento da integração que pode ser acessada pelo menu Processos >> Importações/Exportação >> Consultar Integração DEPS.
Através dessa tela também será possível dar a carga inicial de Pessoas, Produtos, Duplicatas e Cheques (botão Inserir Registros) e também acompanhar como está a integração, registros Enviados, registros Pendentes, Com Erro e Ignorados (registros ignorados são registros que não são enviados para o DEPS por algum motivo, exemplo uma duplicata que está vinculada a uma pessoa com o ramo de atividade das gerais).
Através desta tela também é possível verificar o erro que está dando caso algum registro de erro e verificar o JSON desse registro para validar o mesmo.
Pedidos:
Para a utilização da integração de Pedidos é necessário primeiramente que tenha sido configurado as informações de integração citadas na tarefa MCP-3887.
Para ativar o funcionamento da integração de Pedidos é necessário primeiramente criar um usuário de sistema chamado DEPS.
Posteriormente para o grupo de vendedores deve ser marcado para Executar a Ação 147 – Valida Integração Deps NET.
Com essas duas configurações prontas ao tentar finalizar o carrinho no Construshow será apresentada a ação 147 - Valida Integração DEPS NET, caso o acerto do carrinho tenha sido feito em dinheiro, cartão ou abatimento, a ação será automaticamente liberada de acordo com o timer configurado na tela da ação.
Caso o carrinho tenha sido acertado em Cheque/Duplicata o sistema também irá apresentar a validação 147 e a DEPS irá receber o pedido para fazer análise de crédito do mesmo e retornar a Liberação ou Bloqueio para o Construshow, quando liberado o pedido segue o fluxo normal do sistema e caso bloqueado dependerá de uma nova análise ou ficará com a situação Bloqueado mesmo, sendo possivelmente Cancelado, porém essa ação deverá ser feita pelo USUÁRIO.
Será enviado para o DEPS cada situação diferente do Pedido, por exemplo ao ser lançado um Pedido será enviado o bloco com Situação PENDENTE, ao ser liberado deve ser enviado o bloco com situação LIBERADO, ao ser faturado no Construshow deverá ser enviado o mesmo bloco com situação FINALIZADO. Quando ocorrer cancelamento do pedido seja por cancelamento manual ou automático de acordo com parametrização das configurações gerais deve ser enviado a situação CANCELADO, e assim por diante.
OBS: O processo atual do cliente hoje é utilizar nota de transporte sem renegociação de títulos, sendo assim a integração será desenvolvida considerando este processo, caso o mesmo seja alterado será necessário rever a integração. O processo atual do cliente também não permite alteração de pagamentos ou inclusão de produtos no caixa, quando ocorrer necessidade de alterar pagamento ou incluir produto o caixa deve retornar o pedido para o carrinho e o vendedor fará as devidas alterações, se existir alterações no pedido será disparado novamente uma solicitação para o DEPS, a fim de que o pedido seja reavaliado. Ou seja, o ponto de integração do pedido será apenas no carrinho, caso esse processo sofra alteração é necessário rever a integração.
A integração de pedidos também contempla o envio de produtos do pedido.
Ao finalizar o pedido no carrinho após enviar a solicitação da ação 147 para o DEPS o sistema busca o Limite de Crédito da pessoa do carrinho lá no DEPS e atualiza o Limite de Crédito do Construshow no cadastro da Pessoa.
Tarefas envolvidas no desenvolvimento da Integração:
- MCP-3887Getting issue details... STATUS
- MCP-5020Getting issue details... STATUS
- MCP-5425Getting issue details... STATUS
Versão
Versão do Sistema | Versão do Banco de Dados | Versão da Documentação | Autor/Revisor |
---|---|---|---|
22090 | 22090 | 1.0 | Daiana |