MCP - Integração DepsNet

Objetivo

Í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:

Open

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 de Pessoas, dos Títulos, Cheques e Notas Complementares sejam corretamente enviados, sendo que os mesmos serão enviados toda vez que a tarefa JobFilaDeps for executada.

Open

Foram criadas também configurações dentro do Plano de Contas e dentro do Cadastro de Pessoas que só serão apresentadas se as configurações de integração citadas acima estiverem configuradas. 

Dentro do cadastro de pessoas na aba Info Cliente foi criada a opção Tem renegociação (Sim/Não).

Esta opção do cadastro de pessoas será enviada por padrão como Não e será atualizada de acordo com a movimentação das analíticas que ocorrem nas duplicatas/cheques (esse processo será detalhado no decorrer da documentação).

Dentro do Plano de Contas na aba Dados Financeiros foi criada a opção Tem Renegociação (Sim/Não).

Essa opção deverá ser marcada como SIM nas analíticas utilizadas nos processos de renegociação, pois para o caso da JR existirão casos por exemplo em que a venda foi acertada em duplicata e o acerto desta duplicata será feito em cheque e este cheque deve ser considerado como pagamento normal, desta forma deverá ser informado ao gerar este cheque uma analítica que esteja configurada como o campo Tem Renegociação como Não. Caso o cheque gerado seja de fato oriundo de uma renegociação que houve com a duplicata, então ao gerar o cheque deve ser informada uma analítica que esteja configurada como Tem Renegociação como Sim.

Ao ser gerado uma duplicata ou cheque com uma analítica cujo renegociação estava marcada como Sim o sistema atualizará o cadastro de pessoas com a opção Tem Renegociação como Sim e enviará um JSON para o DEPS com o bloco Resposta Questionário conforme segue abaixo:

[

   {

      "tipo":"F",

      "documento":"81749693062",

      "nomeorigem":"GRUPO JR",

      "tipoRelacionamento":"C",

      "respostasQuestionarios":[

         {

            "pergunta":"Possui Negociacao?",

            "resposta":"Sim",

            "dataValidade":"Data atual + 365 dias"

         }

      ]

   }

]

Ao fazer baixas de duplicatas/cheques o sistema irá percorrer todos os documentos pendentes que sobraram e verificar se algum deles possui analítica configurada como Renegociação SIM, se encontrar alguma duplicata pendente com esta analítica ou algum cheque de situação (A - Pendente, D - Devolvido, E – Transferência de Entrada, T – Incluído como Devolvido, U - Custódia, P – Parcialmente Acertado) então não mudará a opção tem renegociação do cadastro da pessoa e ela permanecerá como SIM, caso não encontre mais nenhum documento pendente então mudará a opção tem renegociação do cadastro da pessoa para NÃO. Essas validações ocorrerão quando o acerto da duplicata/cheque for em dinheiro, cartão ou abatimento.

Se o acerto de uma duplicata/cheque que estiver com a analítica de renegociação como SIM for feito em duplicata ou cheque, mesmo que a inclusão do novo documento seja com uma analítica que esteja marcada como renegociação como Não o sistema manterá o cadastro da pessoa como tem renegociação SIM, visto que subentende-se que a renegociação ainda não foi quitada.

Caso esses novos documentos gerados ainda não sejam quitados com dinheiro, cartão ou abatimento será necessário gerar os próximos com uma analítica que esteja configurada como gera renegociação SIM, pois não tem como identificar no sistema se ainda é para manter a pessoa como renegociação sim visto que a analítica anterior foi gerada sem controle de renegociação, por esse motivo é importante que SEMPRE que o documento for de fato renegociado seja utilizado uma analítica com a opção Tem Renegociação marcada como SIM.

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, o que irá diferenciar um cheque de uma duplicata é o nome da categoria TIPO DOCUMENTO que no caso da duplicata o código sistema gestão dessa categoria será DUPLICATA conforme JSON abaixo:

    {

            "codigoSistemaGestao":"DUPLICATA",

            "nomeCategoria":"TIPO DOCUMENTO",

            "desassociar":"N"

         },

E no caso do cheque o código sistema gestão será CHEQUE, conforme JSONs abaixo.

         {

            "codigoSistemaGestao":"CHEQUE",

            "nomeCategoria":"TIPO DOCUMENTO",

            "desassociar":"N"

         },

No caso da Inclusão da duplicata/cheque também será enviado uma categoria com o nome STATUS com o código sistema de gestão ATIVO e uma categoria com o nome RENEGOCIACAO com o código sistema gestão como NOR, conforme JSONs abaixo:

         {

            "codigoSistemaGestao":"ATIVO",

            "nomeCategoria":"STATUS",

            "desassociar":"N"

         },

    {

            "codigoSistemaGestao":"NOR",

            "nomeCategoria":"RENEGOCIACAO",

            "desassociar":"N"

         },

Além das categorias citadas acima são enviadas outras que estão descritas na tarefa.

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 o 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 a categoria STATUS com o nome EXCLUSÃO para o DEPS, conforme JSON abaixo:

   {

            "codigoSistemaGestao":"EXCLUSAO",

            "nomeCategoria":"STATUS",

            "desassociar":"N"

         },

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

No caso de uma duplicata/cheque que gerou outro documento de duplicata/cheque enviaremos a categoria RENEGOCIACAO com o nome RENEGOCIACAO, conforme JSON abaixo, desta forma o DEPS consegue diferenciar esses documentos para não duplicar os valores.

    {

            "codigoSistemaGestao":"RENEGOCIACAO",

            "nomeCategoria":"RENEGOCIACAO",

            "desassociar":"N"

         },

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 tenham sido configuradas as informações de integração já citadas anteriormente.

Para ativar o funcionamento da integração de Pedidos é necessário primeiramente criar um usuário de sistema chamado DEPS. E é necessário marcar que o Grupo deste usuário autorize a ação 147, conforme imagens abaixo:

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.

Quando um pedido retornar do DEPS com a situação Liberado também retornará o Limite de Crédito do cliente utilizado no carrinho e desta forma o Limite de Crédito do cadastro dessa pessoa será atualizado com o Limite que veio do DEPS.

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.

O envio do pedido não é feito por JOB como ocorre com as duplicatas/cheques, ele é feito por comunicação direta, ao finalizar o pedido já envia.

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.

Notas Complementares:

As notas complementares não são nada mais que o crédito que os clientes possuem junto à empresa, esses créditos podem ser gerados por notas de devoluções de compra ou por notas de adiantamento, e só serão considerados créditos acertos em duplicatas a pagar.

Para este controle foi criado a tabela DUPPAGEXC para gravar as exclusões de duplicatas a pagar com vínculo em notas de devolução e adiantamento.

Ao fazer uma devolução ou uma nota de adiantamento com acerto em duplicatas será gravado um registro da duplicata a pagar na tabela FILADEPS para ser enviada para a integração no JSON de Notas complementares, na inclusão será enviado a categoria "NC ATIVA".

O tipo dela será enviado como DUPLICATA A PAGAR para diferenciá-la das duplicatas a receber.

Ao fazer o estorno ou exclusão das notas quando o título for deletado será gravada a exclusão dele também na tabela DUPPAGEXC para enviar para a Deps, e neste caso será enviado no JSON de integração de notas complementares uma categoria "NC CANCELADA"

Serão enviados apenas títulos a pagar oriundos de notas com a operação DV (Devolução de Venda), OE (Outras Entradas) e AC (Adiantamento de Cliente).

Nos títulos a pagar não serão enviadas as baixas do título, somente o saldo dele atualizado ao fazer uma baixa.

Fluxograma DEPS ok.png

Tarefas envolvidas no desenvolvimento da Integração:

https://nimitz.atlassian.net/browse/MCP-3887

https://nimitz.atlassian.net/browse/MCP-5020

https://nimitz.atlassian.net/browse/MCP-5425

https://nimitz.atlassian.net/browse/MCP-5645

Versão