Histórico da Página
Integração SIGAJURI x Financeiro (Outros ERPs)
Características do Requisito
Linha de Produto: | Microsiga Protheus | |||||||||||||||||
Segmento: | Jurídico | |||||||||||||||||
Módulo: | SIGAJURI | |||||||||||||||||
Rotina: |
| |||||||||||||||||
País(es): | Todos | |||||||||||||||||
Banco(s) de Dados: | Todos | |||||||||||||||||
Tabelas Utilizadas: | O0J - Filtros Follow-up Automático / O0K - Modelos disparados O0U - Cadastro de Integrações Financeiras | |||||||||||||||||
Sistema(s) Operacional(is): | Windows |
Descrição
Inclusão de cadastro de Follow-ups automático, onde são informados os filtros e a movimentação desejada para cada modelo, sendo:
1- Inclusão de processo (ao incluir o processo, o follow-up é gerado automaticamente de acordo com as informações do modelo, podendo abrir o cadastro, quando o tipo de geração é com intervenção de usuário e;
2 - Alteração de correspondente (é gerado follow-ups de acordo com o cadastro, quando o correspondente for alterado no processo);Disponibilizar um mecanismo que possa efetuar a Integração Financeira a partir da geração de Despesas ou Garantias do SIGAJURI.
Foi disponibilizado o Cadastro de Integrações Financeiras. Este cadastro é responsável por registrar as integração financeira existentes
Toda a integração será iniciada a partir da inclusão\exclusão de uma Despesa ou Garantia no SIGAJURI.
Procedimento para Implantação
O sistema é atualizado logo após a aplicação do pacote de atualizações deste chamado.
- Aplique o patch do chamado 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:
Atualizações do Compatibilizador
- Criação de tabela no arquivo SX2– Tabelas:
Chave | Nome | Modo | PYME |
O0J | Follow-ups Automáticos | C | S |
Chave | Nome | Modo | PYME |
O0K | Modelos Disparados | C | S |
O0U | Configuração Integração | Compartilhado | Não |
Tabela O0U - Configuração Integração.
Criação de 2. Criação de Campos no arquivo SX3 – Campos:
- Tabela O0J - Follow-ups Automáticos
Campo |
O0U_FILIAL | |
Tipo | C |
Tamanho | 8 |
Decimal | 0 |
Formato | @! |
Título | Filial |
Descrição | Filial do Sistema |
Usado | Não |
Obrigatório | Não |
Browse | Sim |
Help | Filial do Sistema |
Campo |
O0U_COD | |
Tipo | C - Caracter |
Tamanho | 5 |
Decimal | 0 |
Formato | @! |
Título | Código |
Descrição |
Código Integração. | |
Nível | 1 |
Usado | Sim |
Obrigatório | Sim |
Browse |
Sim | |
Validação | ExistChav(' |
O0U',M- |
>O0U_COD,1) | |
Inicializador Padrão | GetSXENum(" |
O0U"," |
O0U_COD") | |
Visual | Visualizar |
Contexto | Real |
Modal | Sim |
Help | Código |
Integração. |
Campo |
O0U_ |
TIPO | |
Tipo | C - Caracter |
Tamanho |
1 | |
Decimal | 0 |
Formato | @! |
Título | Tipo |
|
Descrição |
Tipo Integração | |
Nível | 1 |
Usado | Sim |
Obrigatório |
Sim | |
Browse | Sim |
Validação |
Pertence(" |
12") | |
Visual | Alterar |
Contexto | Real |
Modal | Sim |
Help
Combo | 1=Garantia;2=Despesa |
Campo |
O0U_ |
ACAO | |
Tipo | C - Caracter |
Tamanho |
1 | |
Decimal | 0 |
Formato | @! |
Título |
Ação |
Descrição |
Ação da Integração | |
Nível | 1 |
Usado | Sim |
Obrigatório |
Sim |
Browse |
Sim |
Visual
Validação | Pertence("12") |
Visual | Alterar |
Contexto | Real |
Modal | Sim |
Help
Combo | 1=Inclusão de título;2=Consulta de Saldo;3=Exclusão de Título |
Campo |
O0U_ |
STATUS | |
Tipo | C - Caracter |
Tamanho |
1 | |
Decimal | 0 |
Título |
Status |
Descrição |
Status Integração | |
Nível | 1 |
Usado | Sim |
Obrigatório |
Sim | |
Browse | Sim |
Validação |
Pertence( |
"12") |
Inicializador Padrão |
"1" | |
Combo | 1=Ativa;2=Inativa |
Visual | Alterar |
Contexto | Real |
Modal |
Não |
Help |
Status da integração. Onde (1- Ativa ou 2-Inativa). |
Campo |
O0U_ |
WSDL | |
Tipo | C - Caracter |
Tamanho |
200 | |
Decimal | 0 |
Formato | |
Título |
Web Service |
Descrição |
WSDL do Web Service | |
Nível | 1 |
Usado | Sim |
Obrigatório |
Sim |
Browse |
Visual
Sim | |
Visual | Alterar |
Contexto | Real |
Modal |
Nâo |
Help |
Informe a URL do webservice para conexão |
Campo |
O0U_ |
OPERAC | |
Tipo | C - Caracter |
Tamanho |
200 | |
Decimal | 0 |
Formato | |
Título |
Oper. |
WSDL |
Descrição |
Operação WSDL | |
Nível | 1 |
Usado | Sim |
Obrigatório |
Sim | |
Browse | Sim |
Visual | Alterar |
Contexto | Real |
Modal | Não |
Help |
Informe a operação WSDL que será acionada no Web Service. |
Campo |
O0U_ |
USER | |
Tipo | C - Caracter |
Tamanho |
30 | |
Decimal | 0 |
Formato
@S30
Título |
Usuário |
Descrição |
Usuário de Autenticação | |
Nível | 1 |
Usado | Sim |
Obrigatório | Não |
Browse | Não |
Visual
Visual | Alterar |
Contexto | Real |
Modal |
Sim |
Help |
Nome do usuário que será utilizado para efetuar a autenticação no web-service externo. |
Campo |
O0U_ |
SENHA | |
Tipo | C - Caracter |
Tamanho |
30 | |
Decimal | 0 |
Título |
Senha |
Descrição |
Senha de Autenticação | |
Picture | @* |
Nível | 1 |
Usado |
Sim | |
Obrigatório | Não |
Browse | Não |
Visual | Alterar |
Contexto | Real |
Modal | Sim |
Help |
Senha do usuário que será utilizado para efetuar a autenticação no web-service externo. |
Campo |
O0U_ |
TAGSTA | |
Tipo | C - Caracter |
Tamanho |
100 | |
Decimal | 0 |
Título |
Tag Sta Ok |
Descrição |
Tag com status Ok | |
Nível | 1 |
Usado | Sim |
Obrigatório |
Não | |
Browse | Sim |
Visual | Alterar |
Visual
Contexto | Real |
Modal | Sim |
Help |
Informe o nome e o conteúdo da TAG de retorno que conterá o status da integração. Exemplo: <STATUS>ok</STATUS> |
Campo |
O0U_ |
TAGCOD | |
Tipo | C - Caracter |
Tamanho |
100 | |
Decimal | 0 |
Título |
Tag Msg Ok |
Descrição |
Tag com Mensagem Ok | |
Nível | 1 |
Usado | Sim |
Obrigatório |
Não | |
Browse | Sim |
Visual | Alterar |
Contexto | Real |
Modal | Sim |
Help |
Informe a TAG que terá o Código de retorno. |
Campo |
O0U_ |
CMPCOD | |
Tipo | C - Caracter |
Tamanho |
100 | |
Decimal | 0 |
Formato | @! |
Título |
Cmp Msg Ok |
Descrição |
Campo Salvar Mensagem Ok | |
Nível | 1 |
Usado | Sim |
Obrigatório |
Não | |
Browse | Sim |
Visual | Alterar |
Contexto | Real |
Modal |
Não |
Help |
Informe o campo que irá salvar o retorno da TAG COD (chave do título gerado no sistema destino). Campo da tabela NT3 (Despesas) ou NT2 (Garantias) |
Campo |
O0U_ |
TAGERR | |
Tipo | C - Caracter |
Tamanho |
100 | |
Decimal | 0 |
Formato | @! |
Título |
Tag Msg Erro |
Descrição |
Tag com Mensagem de Erro | |
Nível | 1 |
Usado | Sim |
Obrigatório |
Não | |
Browse | Sim |
Visual | Alterar |
Contexto | Real |
Modal |
Não |
Help |
Informe a TAG que contém a mensagem de erro, caso ocorra. |
Campo |
O0U_ |
CMPERR | |
Tipo | C |
Tamanho |
100 | |
Decimal | 0 |
Formato | @! |
Título |
Nível
1
Cmp Msg Erro |
Descrição |
Descrição tipo do modelo
Campo Salvar Mensagem Err |
Usado | Sim |
Obrigatório | Não |
Browse |
Sim |
Visual |
Contexto
Modal
Help
Descrição tipo do modelo
Importante:
O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.
3. Inclusão de Consulta Padrão no arquivo SXB – Consulta Padrão:
- Pesquisa O0KNRT:
Alias
O0KNRT
Tipo
1
Sequência
01
Coluna
DB
Descrição
Modelo
Contém
NRT
4. Criação ou Alteração de Índices no arquivo SIX – Índices:
Índice
O0J
Ordem
1
Chave
O0J_FILIAL+O0J_COD
Descrição
Código
Proprietário
S
Índice
O0J
Ordem
2
Chave
O0J_FILIAL+O0J_TIPOAS+O0J_CAREAJ+O0J_COBJET
Descrição
Tipo Assunto + Cod Area Jur + Cod. Assunto
Proprietário
S
Índice
O0K
Ordem
1
Chave
O0K_FILIAL+O0K_COD
Descrição
Código
Proprietário
S
5. Criação de Gatilhos no arquivo SX7 – Gatilhos:
- Tabela O0J – Follow-up Automático
Campo
O0J_CAREAJ
Sequência
001
Campo domínio
O0J_DAREAJ
Tipo
P
Regra
NRB->NRB_DESC
Posiciona?
S
Chave
xFilial('NRB')+M->O0J_CAREAJ
Proprietário
S
Campo
O0J_TIPOAS
Sequência
001
Campo domínio
O0J_DTIPAS
Tipo
P
Regra
NYB->NYB_DESC
Posiciona?
S
Chave
XFILIAL("NYB") + M->O0J_TIPOAS
Proprietário
S
Campo
O0J_COBJET
Sequência
001
Campo domínio
O0J_DOBJET
Tipo
P
Regra
NQ4->NQ4_DESC
Posiciona?
S
Chave
XFILIAL('NQ4')+M->O0J_COBJET
Proprietário
S
Campo
O0K_CODMOD
Sequência
001
Campo domínio
O0K_DESCRI
Tipo
P
Regra
IIF(!EMPTY(M->O0K_CODMOD),JADESCMOD(M->O0K_CODMOD),'')
Posiciona?
S
Chave
xFilial('O0K')+M->O0K_CODMOD
Proprietário
S
Alterar | |
Help | Informe o campo que irá salvar o retorno da TAG ERRO (terá a mensagem de erro). Campo da tabela NT3 (Despesas) ou NT2 (Garantias) |
Campo | O0U_LAYOUT |
Tipo | M - MEMO |
Tamanho | 10 |
Decimal | 0 |
Título | Layout |
Descrição | Layout XML |
Nível | 1 |
Usado | Sim |
Obrigatório | Sim |
Browse | Não |
Visual | Alterar |
Contexto | Real |
Modal | Sim |
Help | LAYOUT do XML que será enviado ao outro ERP, este campo deve ser enviado o XML inteiro. Quando o valor de alguma TAG deve ser preenchido com valores do SIGAJURI, a informação deve estar entre %. Exemplo: <DATA_FATURA>%NT3_DATA%</DATA_FATURA> Para executar alguma formula ou macro executar o conteúdo de uma TAG o valor deve estar entre $. Exemplo: <TEXTO>$M->NT3_CAJURI+'-'+U_PARTECON()+'-'+M->NT3_COD+'-'+M->NT3_CTIPOT+'-'+NSZ->NSZ_CCORRE$</TEXTO> Os campos das tabelas que podem ser utilizadas são: NT3, NT2, SA2 e NSZ. |
Criação de índices
Índice | Chave | Descrição |
---|---|---|
1 | O0U_FILIAL+O0U_COD | Código |
2 | O0U_FILIAL+O0U_TIPO+O0U_ACAO+O0U_STATUS | Tipo + Ação Integra + Status |
Procedimento para Utilização
Passo 01: Configuração de parâmetros
MV_JINTVAL = '1'
Passo 02: Cadastros Básicos
Módulo Financeiro
Natureza
Será necessário efetuar o cadastro de ao menos uma natureza no módulo Financeiro
Para maiores detalhes Acesse a documentação da rotina no seguinte link: http://tdn.totvs.com/x/qgBlDw
Forma de Pagamento
Será necessário efetuar o cadastro das formas de pagamento no módulo Financeiro
a) Acesse o módulo 06 - Financeiro, menu: Atualizações > Cadastros > Condições Pagamento e clique em Incluir.
b) Informe o código que será usado no sistema da integração
c) Informe o tipo = 1
d) No campo Cond.Pagto. Informe a quantidade de dias com 2 dígitos, caso seja parcelado separe as parcelas por vírgula.
Exemplo para pagamento à vista : 00
Exemplo para pagamento em 3x com entrada à vista mais duas parcelas para 30 e 60 dias : 00,30,60
e) informe os demais campos necessários para a rotina e salve.
Módulo Contábil
Centro de Custo
Será necessário cadastrar os centros de custo utilizados no sistema com o qual faremos a integração
Para maiores detalhes sobre cadastro de centros de custo, acesse a documentação da rotina pelo link: http://tdn.totvs.com/x/NIiqCQ
Módulo Jurídico
Cadastro de Integração Financeira
- No módulo
Procedimento para Utilização
Exemplo:
- Cadastro do modelo de Follow-Up
- No modulo Gestão Jurídica (SIGAJURI), acesse Atualizações / Jurídico / Follow-ups / Modelos. Configurações / Integrações;
- Clique na opção Incluir;
- Preencha os dados necessários para o Modelo e clique necessários e clique em Confirmar para finalizar a operação;
- Clique em Fechar na mensagem de Registro inserido.
- Cadastro do Follow-Up Automático
No modulo Gestão Jurídica (SIGAJURI), acesse Atualizações / Jurídico / Follow-ups / Follow-up Automático.
Escolha a opção Incluir
- Preencha os dados necessários para o Follow-Up Automático que serão iguais ao criar o processo
- Informe o Código da Movimentação que o FW executará ao ser Acionado
- Clique em Fechar na mensagem de Registro inserido.
- Inclusão de um Processo
No campo Layout, cadastraremos o XML a ser utilizado na integração
No corpo do xml podemos usar o símobo '%' para indigar que queremos pegar a informação de um determinado campo
Exemplo: <FORMA_PAGTO>%NT3__FORMPG%</FORMA_PAGTO>
No corpo do xml podemos usar o símobo '$' para indigar que queremos pegar a informação de um determinado campo
Exemplo: <FORMA_PAGTO>$iIF(M→MT3_TIPO == '001', M->NT3__FORMPG, '0001')$</FORMA_PAGTO>
Integrando uma Despesa
- No módulo No modulo Gestão Jurídica (SIGAJURI), acesse Atualizações / Assuntos Jurídicos / Pesquisas.
- Escolha o Tipo de Assunto Contencioso e clique em Incluir
- Informe os dados do Processo e para gerar o Follow-Up as informações tem que ser iguais ao informado no Cadastro de FW Automático e clique em Confirmar.
- Clique em Fechar na mensagem de Registro inserido.
- Para visualizar os Follow-Ups gerados clique em Outras Ações / Follow-Ups Será apresentada a tela com os Follow-Ups criados
- Despesas;
- Clique na opção Incluir;
- Preencha os dados necessários e clique em Confirmar para finalizar a operação;
- Neste momento será lida a tabela O0U (Integrações Financeiras), a procura da Integração Financeira de Despesa;
- Encontrando esta integração, o XML do campo Layout será atualizado com os valores dos Campos e as Formulas serão executadas e assim será enviado o XML para a integração;
- Após a execução da integração corretamente, será atualizado o campo Mensagem Ok e a Despesa será salva.
Este mesmo procedimento pode ser executado na Garantia.