Á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 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

...

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 Ambientes/Configurações/Pesquisas (CFGX017). Configure oBase 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
    (wsDataServer
    e sua porta. (Ex: http://127.0.0.1:8051)(informe
    a
    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 AmbientesAtualizações/CadastrosConfigurações/Parâmetros 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 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 No modulo Gestão Jurídica (SIGAJURI), acesse Atualizações / Jurídico  / Assunto Jurídico / Auditoria / Campos Complementares.
    • Nesta rotina poderão ser cadastrados os campos\formulas relacionados a tabela de Assunto Jurídico(NSZ), que o cliente queira auditar. Estes campos\formulas serão apresentados no relatório em excel de comparação.
  2. Cadastre um campo\formula complementar clicando no botão Incluir.
  3. Insira as informações necessarias, tais como, campo ou formulas, titulo, e definindo se o campo será ou não historico.
  4. Confirme a operação.
  5. Ainda no modulo 
  6. 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 /

...

  • Esta rotina será responsável por cadastrar as Marcas da Auditoria. Cada Marca da Auditoria será uma chave utilizada posteiormente para Gerar e Comparar a auditoria.

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 Added

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


Image Added

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

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 Added

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

Image AddedImage Added
Image AddedImage Added

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.

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 Added


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 Added


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 Added

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

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

Image Added

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

...

  • Esta será a rotina onde a auditoria será gerada, ela será gerada por marca e gravará as tabelas de auditoria: O0C, O0F, O0G, O0H e O0I.

...

  • Lembrando que este processo de ver feito para cada marca, para que posteiormente elas possam ser comparada.

...

  1. Aqui serão fetias as comparações entre 2 marcas já geradas.

...

  • O arquivo será aberto desde que na maquina exista algum programa associado que possa abrir aquivos no formato excel.

...