Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Linha de Produto:

Microsiga Protheus®

Segmento:

Jurídico

Módulomódulo:

SIGAJURI

Rotina:

Rotina

Nome Técnico

JURA099

Despesa

JURIRMFunções de Integração com RM_IwsDataServer
JURXFUNBFunção genéricas 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 Contas a pagarPagar) do Protheus (módulo SIGAJURI) com o RM, através por meio das Despesas e Garantias do SIGAJURI.

Para esta integração será utilizado o webservice RM_IwsDataServerserã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 titulo título a pagar, tais como:

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

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

Atualizações do Compatibilizador

...

  1. No Configurador (SIGACFG), acesse Base de Dados/Dicionários/Base de Dados/Parâmetros (CFGX031) . Configure oe 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 , localize a tabela SE2 e configure o campo a seguir: 

    CampoUsadoBrowse
    E2_IDMOVSimSim

    Este campo será é 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) . Selecione e selecione o tipo de Assunto Jurídico que desaja deseja configurar e clique em Alterar.
  4. Selecione a aba Campos e incluao 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 de 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 modulo 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

...

;


Image Modified

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

...

;


Image Modified

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


Image Modified

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.


Image Modified

13. Clique 2 vezes no

...

lançamento para acessa-lo e visualizar suas informações

...

;

Image ModifiedImage Modified
Image ModifiedImage Modified

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 e Lançamento que ja tenha sido baixado.
    Image Removed
    se lançamento já está baixado - Lançamento 6978, já baixado no RM.

Image Added

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:

Image Modified


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:

Image Modified


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:


Image Modified

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


Image Modified

...

5. Após o termino do processo

...

efetue a baixa o Lançamento no RM

...

e veja se o status é modificado para Baixado.;

Image Modified

...

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


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:


Image Added

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;


Image Added

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.


Image Added


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