Page tree
Skip to end of metadata
Go to start of metadata

Características do Requisito

Linha de Produto:

Microsiga Protheus®

Segmento:

Jurídico

módulo:

SIGAJURI

Rotina:

Rotina

Nome Técnico

JURA099

Despesa

JURIRMFunções de Integração com RM_IwsDataServer
JURXFUNBFunção genérica do jurídico
TJURPESQDESClasse de pesquisa de Despesa
TJURPESQGARClasse 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:

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

    ParâmetroTipoDescrição
    MV_JURLRMCaractereInformar a url do webservice da RM (wsDataServer)
    MV_JUSRRMCaractereNome do usuário que será utilizado para conectar no webservice da RM (wsDataServer)
    MV_JPSWRMCaractereSenha do usuário que será utilizado para conectar no wbservice da RM. (wsDataServer)
    MV_JINFIRMLógicoDefine que a integração financeira (títulos a pagar) entre Sigajuri e RM esta ativa.

Procedimento para Configuração

  1. 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âmetroTipoDescriçãoConteúdo
    MV_JINTVALCaractereUtiliza a integração de valores com os módulos Financeiro e Contábil? 1- Sim; 2- Não.1
    MV_JURLRMCaractereInformar a url do webservice da RM e sua porta. (Ex: http://127.0.0.1:8051)(informe url e porta)
    MV_JUSRRMCaractereNome do usuário que será utilizado para conectar no webservice da RM (wsDataServer)(informe o usuario)
    MV_JPSWRMCaractereSenha do usuário que será utilizado para conectar no wbservice da RM. (wsDataServer)(informe o senha)
    MV_JINFIRMLógicoDefine que a integração financeira (títulos a pagar) entre Sigajuri e RM esta ativa..T.
  2. 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: 

    CampoUsadoBrowse
    E2_IDMOVSimSim

    Este campo é utilizado para salvar o Id do lançamento que foi gerado no RM, na inclusão do título a pagar.


  3. 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.
  4. Selecione a aba Campos e inclua o campo como descrito abaixo:

    CampoDescrição
    NSZ_CCUSTOCentro 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:

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


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


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


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.


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


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.

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

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:


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:


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


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

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.


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:


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;


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.



Ponto de Entrada


Nome:JRMCOXML

Descrição:

Ponto de entrada para inserir campos opcionais ao XML enviado ao RM dentro da entidade FLAN do 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 opcionais ao XML enviado ao RM
dentro da entidade FLAN.

@param aSE2 - Campos utilizados para gerar o título
@return cXml - Campos opcionais que serão inseridos no XML

@author Rafael Tenorio da Costa
@since 05/02/18
@version 1.0
/*/
//-------------------------------------------------------------------
User Function JRMCOXML()

Local aSE2 := ParamIxb[1]
Local cXml := "<CODTB1FLX>01.99</CODTB1FLX>"

Return cXml