Exibir origem

Características do Requisito

Linha de Produto:

Microsiga Protheus®

Segmento:

Jurídico

módulo:

SIGAJURI

Rotina:

Rotina	Nome Técnico
JURA099	Despesa
JURIRM	Funções de Integração com RM_IwsDataServer
JURXFUNB	Função genérica do jurídico
TJURPESQDES	Classe de pesquisa de Despesa
TJURPESQGAR	Classe de pesquisa de Garantias

Cadastros Iniciais:

CFGA020 - Adapter EAI

APCFG070 - De\Para Conteúdos Mensagens Únicas

APCFG050 - De\Para Empresas Mensagens Únicas

País(es):

Todos

Banco(s) de Dados:

Todos

Tabelas Utilizadas:

NT2 - Garantias
NT3 - Despesas
SE2 - Contas a Pagar
XXF - De\Para Conteúdos Mensagens Únicas

Sistema(s) Operacional(is):

Windows

Descrição

Possibilitar a integração financeira (Contas a Pagar) do Protheus (módulo SIGAJURI) com o RM, por meio das Despesas e Garantias do SIGAJURI.

Para esta integração serão utilizados os WebServices da RM wsDataServer e wsProcess.

Utilizaremos também o EAI para efetuar a integração dos cadastros básicos envolvidos na geração do título a pagar, tais como:

Centro de Custo;
Natureza Financeira;
Moeda;
Fornecedor;
Cliente;

Estes cadastros vem do RM para o Protheus, para mais informações acesse o documento de integração: http://tdn.totvs.com/x/thwNF

Atualizações do Compatibilizador

O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.

Aplique o patch do requisito e execute uma vez a rotina UPDDISTR.

Logo após a execução desta rotina é alterado o dicionário de dados da base, conforme especificações abaixo:

Criação dos Parâmetros no arquivo SX6 – Parâmetros:

Parâmetro	Tipo	Descrição
MV_JURLRM	Caractere	Informar a url do webservice da RM (wsDataServer)
MV_JUSRRM	Caractere	Nome do usuário que será utilizado para conectar no webservice da RM (wsDataServer)
MV_JPSWRM	Caractere	Senha do usuário que será utilizado para conectar no wbservice da RM. (wsDataServer)
MV_JINFIRM	Lógico	Define que a integração financeira (títulos a pagar) entre Sigajuri e RM esta ativa.

Procedimento para Configuração

No Configurador (SIGACFG), acesse Base de Dados/Dicionários/Base de Dados/Parâmetros (CFGX031) e configure o(s) parâmetro(s) a seguir:

Parâmetro	Tipo	Descrição	Conteúdo
MV_JINTVAL	Caractere	Utiliza a integração de valores com os módulos Financeiro e Contábil? 1- Sim; 2- Não.	1
MV_JURLRM	Caractere	Informar a url do webservice da RM e sua porta. (Ex: http://127.0.0.1:8051)	(informe url e porta)
MV_JUSRRM	Caractere	Nome do usuário que será utilizado para conectar no webservice da RM (wsDataServer)	(informe o usuario)
MV_JPSWRM	Caractere	Senha do usuário que será utilizado para conectar no wbservice da RM. (wsDataServer)	(informe o senha)
MV_JINFIRM	Lógico	Define que a integração financeira (títulos a pagar) entre Sigajuri e RM esta ativa.	.T.

Ainda no Configurador (SIGACFG), acesse Base de Dados/Dicionários/Base de Dados/Dicionário de Dados (CFGX031), localize a tabela SE2 e configure o campo a seguir:
Campo Usado Browse
E2_IDMOV Sim Sim
Este campo é utilizado para salvar o Id do lançamento que foi gerado no RM, na inclusão do título a pagar.
No Gestão Jurídica (SIGAJURI), acesse Atualizações/Configurações/Pesquisas (JURA163) e selecione o tipo de Assunto Jurídico que deseja configurar e clique em Alterar.
Selecione a aba Campos e inclua o campo como descrito abaixo:
Campo Descrição
NSZ_CCUSTO Centro de Custo

Procedimento para Utilização

As melhorias aqui descritas também estão disponiveis na rotina Garatias(JURA098) no Protheus.
Todos os dados utilizados, nos exemplos abaixo, são meramentes ilustrativos.
Importante que seja liberado acesso a URLS de uso interno do Protheus para que o objeto de troca de mensagens de XML possa fazer os parses. A lista de URLS que precisam ser liberadas estão no endereço (URLs acessadas pela TWsdlManager).
Para mais detalhes de como habilitar o dataserver no RM, consultar documento (Como Expor os Web Services do RM através do Host (recomendado)#-2064216139)

Incluindo uma Despesa:

No módulo Gestão Jurídica (SIGAJURI), acesse Atualizações / Assunto Jurídico / Pesquisa;

2. Selecione o Tipo de Assunto Jurídico onde foi incluído o campo Centro de Custo tal como solicitado;

3. Pesquise o Processo que deseja utilizar e clique em Alterar;

4. Preencha o campo Centro de Custo e clique em Confirmar, para salvar a alteração;

5. Este campo é utilizado no momento da geração da Despesa para gerar o financeiro (título a pagar) e assim enviar para o RM;

Lembrando que o Centro de Custo utilizado, deve estar integrado pelo EAI vindo do RM para o Protheus.

6. Ainda no módulo Gestão Jurídica (SIGAJURI), acesse Atualizações / Assunto Jurídico / Despesas e Custas;

7. Clique em Incluir, preencha as informações necessarias para a Despesa, lembrando que o tipo da Despesa deve estar com a integração contabil e financeira ativa;

Linha Microsiga Protheus > DJURDEP-1177 DT Integração SIGAJURI vs RM > image2018-2-8_12-3-9.png

8. Preencha as demais informações para incluir a Despesa e clique em Confirmar;

Linha Microsiga Protheus > DJURDEP-1177 DT Integração SIGAJURI vs RM > image2018-2-8_12-10-58.png

Lembrando que as informações preenchidas nos campos de Moeda, Natureza e Fornecedor devem ter sido integradas pelo EAI vindo do RM para o Protheus.
Já o campo Tipo título (NT3_CTIPOT) deve ter seu cadastro feito de forma manual nas duas pontas, Protheus e RM, com o mesmo código.

9. Após o termino é presentada a mensagem informando que o registro foi inserido com sucesso.

10. Volte para a tela de Pesquisa de Despesa, selecione a Despesa e clique em títulos, para visualizar o título a pagar que foi gerado.

Linha Microsiga Protheus > DJURDEP-1177 DT Integração SIGAJURI vs RM > image2018-2-8_12-18-1.png

11. No título a pagar, nos campos Histórico (E2_HIST) e Id.Mov.(E2_IDMOV), pode ser visto o código do lançamento gerado no RM.

12. Acessando o RM rotina BackOffice / Gestão Financeira / Contas a Pagar e Receber / Lançamentos, visualize o Lançamento RM gerado a partir do Título a Pagar Protheus.

Linha Microsiga Protheus > DJURDEP-1177 DT Integração SIGAJURI vs RM > image2018-2-8_14-21-19.png

13. Clique 2 vezes no lançamento para acessa-lo e visualizar suas informações;

Linha Microsiga Protheus > DJURDEP-1177 DT Integração SIGAJURI vs RM > image2018-2-8_14-22-51.png

14. Informações como Centro de Custo e Natureza podem ser vistas acessando o botão Rateio;

Excluindo uma Despesa já Baixada:

Caso a Despesa a ser excluida, já tenha sido baixada no RM, o Protheus não permite prosseguir nesta ação.

Acesse o RM rotina Lançamentos e pesquise se lançamento já está baixado - Lançamento 6978, já baixado no RM.

Linha Microsiga Protheus > DJURDEP-1177 DT Integração SIGAJURI vs RM > image2018-2-8_14-34-46.png

2 No módulo Gestão Jurídica (SIGAJURI), acesse Atualizações / Assunto Jurídico / Despesas e Custas.

3. Selecione a Despesa que teve o título a pagar já baixado no RM, e clique em Excluir e Confirme a operação.

Neste momento é consultado o RM para verificar se este título já foi pago, em caso afirmativo visualize a mensagem:

Linha Microsiga Protheus > DJURDEP-1177 DT Integração SIGAJURI vs RM > image2018-2-8_14-39-58.png

Alterando uma Despesa:

Ao selecionar uma Despesa para alteração e que tenha gerado o título a pagar, o sistema faz o bloqueio, para manter a consistência da informação entre os módulos e sistemas.
Se for necessario efetuar esta operação, faça primeiro a exclusão e novamente a inclusão da Despesa.

1. Ao tentar alterar a Despesa, é apresentada a mensagem:

Atualizando status do título para baixado:

Quando um título a pagar é baixado no RM, esta baixa atualiza o Protheus.

1. Acesse o módulo Gestão Jurídica (SIGAJURI), em Atualizações / Assunto Jurídico / Despesas e Custas;

2. Pesquise e selecione uma Despesa que tenha gerado o título a pagar e que ainda não esteja baixado;

3. Clique em títulos para verificar aqueles gerados para a Depesa, e certifique-se que ainda não foram baixados:

Linha Microsiga Protheus > DJURDEP-1177 DT Integração SIGAJURI vs RM > image2018-2-15_11-44-49.png

Lançamento RM: 6986

4. Acesse o RM rotina Lançamentos e pesquise o Lançamento 6986, para efetuarmos a baixa. Marque o Lançamento 6986 e clique em Baixa.

Linha Microsiga Protheus > DJURDEP-1177 DT Integração SIGAJURI vs RM > image2018-2-15_14-1-29.png

5. Após o termino do processo efetue a baixa o Lançamento no RM e veja se o status é modificado para Baixado.;

Linha Microsiga Protheus > DJURDEP-1177 DT Integração SIGAJURI vs RM > image2018-2-15_14-4-8.png

6. Retorne ao Protheus e acesse o módulo Gestão Jurídica (SIGAJURI),Atualizações / Assunto Jurídico / Despesas e Custas,;

7. Localize a Despesa Protheus que gerou o Lançamento 6986 no RM e clique em títulos;

8. Nesta tela pode ser visto que o título a Pagar Protheus referente ao Lançamento 6986 RM foi baixado.
Linha Microsiga Protheus > DJURDEP-1177 DT Integração SIGAJURI vs RM > image2018-2-15_14-10-17.png

Excluir uma Despesa:

Ao excluir uma Despesa em que o título a Pagar esteja aberto, o Protheus envia o cancelamento do título à RM, e o Lançamento no RM fica como Cancelado.

1. Acesse o módulo Gestão Jurídica (SIGAJURI), em Atualizações / Assunto Jurídico / Despesas e Custas;

2. Pesquise e selecione uma Despesa que já tenha gerado o título a pagar e que ainda não esteja baixado;

3. Clique em títulos para verificar os títulos gerados para a Depesa e certificar-se que ainda não foram baixados:

Linha Microsiga Protheus > DJURDEP-1177 DT Integração SIGAJURI vs RM > image2018-2-15_14-26-58.png

4. Lançamento RM: 6983;

5. Volte à tela da Despesa, e clique em Excluir com a Despesa selecionada;

6. O registro da Despesa é aberto em modo de Exclusão, confirme a operação clicando em Confirmar;

Linha Microsiga Protheus > DJURDEP-1177 DT Integração SIGAJURI vs RM > image2018-2-15_14-29-28.png

7.Veja a mensagem apresentada, informando que o processo foi feito corretamente.

8. Acesse o RM na rotina Lançamentos e pesquise o Lançamento 6983, para verificar o status.

9. O lançamento deve estar com o status Cancelado.

Linha Microsiga Protheus > DJURDEP-1177 DT Integração SIGAJURI vs RM > image2018-2-15_15-22-24.png

Ponto de Entrada

Nome:

JRMCOXML

Descrição:

Ponto de entrada para inserir campos ou tags pcionais ao XML enviado ao RM dentro das entidades o XML.

Localização:

Gestão Jurídica em Atualizações \ Assuntos Jurídicos \ Garantias e Alvarás ou Despesas e Custas

Programa Fonte:

JURIRM.prw

Função:

JiRmInTiPg()

Momento:

Este ponto de entrada é executado logo após a integração do módulo Gestão Jurídica (SIGAJURI) com o módulo do Financeiro (SIGAFIN).

Retorno:

Nome	Tipo	Descrição	Obrigatório
cXml	Caractere	Xml com as TAGs que deseja acrescentar ao XML enviado ao RM.	Sim

Exemplo:

#INCLUDE "PROTHEUS.CH"

//-------------------------------------------------------------------
/*/{Protheus.doc} JRMCOXML()
Ponto de entrada para inserir campos ou tags opcionais ao XML enviado ao RM.

@param aSE2 - Campos utilizados para gerar o título.

@param cTagPai - Tag à qual será adicionado o(s) campo(s) ou tag(s) opcional(is).

@return cXml - Campos opcionais que serão inseridos no XML

@author SIGAJURI
@since 17/05/2020
/*/
//-------------------------------------------------------------------

User Function JRMCOXML()

Local aSE2       := ParamIxb[1]
Local cTagPai    := ParamIxb[2]
Local cFLan      := ""
Local cFinLan    := ""
Local cFLanRatCC := ""
Local aXML       := {}

    Do CASE
        CASE cTagPai == "<FLAN>"
            cFLan := "<CODTB1FLX>01.99</CODTB1FLX>"
            aXML := {"<FLAN>", cFLan}

        CASE cTagPai == "<FLANRATCCU>"
            cFLanRatCC := "<CMPOPC>X</CMPOPC>"
            aXML := {"<FLANRATCCU>", cFLanRatCC}

        CASE cTagPai == "<FinLAN>"
            cFinLan := " <TAGNOVA> "
            cFinLan +=  " <CAMPO1>1</CAMPO1> "
            cFinLan +=  " <CAMPO2>2</CAMPO2> "
            cFinLan +=  " <CAMPO3>3</CAMPO3> "
            cFinLan += " </TAGNOVA> "
            aXML := {"<FinLAN>", cFinLan}
    End

Return aXML