Tempo aproximado para leitura: 00:19:00 min
Dúvida
Como é utilizado o Configurador de Regras nas integrações do ERP Datasul com o SIGAGFE?
Ambiente
TOTVS Logística - TOTVS Frete Embarcador (Linha Protheus) - Gestão de Frete Embarcador (SIGAGFE) - Todas as Versões
Solução
Quando é feita a integração do ERP Datasul com o SIGAGFE - Gestão de Frete Embarcador ou vice-versa, os seguintes pontos tem chamada para o CD0024 - Configurador de Regras.
- Notas Fiscais de Saída - ERP Datasul para o SIGAGFE. Veja mais detalhes no link Logística - Linha Protheus - GFE - Configurador de Regras na integração das Notas Fiscais de Saída - ERP Datasul para o SIGAGFE
- Documentos de Entrada - ERP Datasul para o SIGAGFE. Veja mais detalhes no link Logística - Linha Protheus - GFE - Configurador de Regras na integração das Notas Fiscais de Entrada - ERP Datasul para o SIGAGFE
- Integração do Documento de Frete - SIGAGFE com o Fiscal do ERP Datasul. Veja mais detalhes no link Logística - Linha Protheus - GFE - Configurador de Regras na Integração do Documento de Frete - SIGAGFE com o Fiscal do ERP Datasul
- Integração do Documento de Frete - SIGAGFE com o Recebimento do ERP Datasul - Apropriar Despesa. Veja mais detalhes no link Logística - Linha Protheus - GFE - Configurador de Regras na Integração do Documento de Frete - SIGAGFE com o Recebimento do ERP Datasul - Apropriar Despesa
- Integração do Contrato de RPA - SIGAGFE com o Financeiro do ERP Datasul. Veja mais detalhes no link Logística - Linha Protheus - GFE - Configurador de Regras na integração da Fatura - SIGAGFE com o Financeiro do ERP Datasul
- Integração do Contrato de RPA - SIGAGFE com o HCM do ERP Datasul. Veja mais detalhes no link Logística - Linha Protheus - GFE - Configurador de Regras na integração de Contratos de RPA - SIGAGFE com o HCM do ERP Datasul
- Integração do Contrato de RPA - SIGAGFE com o Recebimento do ERP Datasul. Veja mais detalhes no link Logística - Linha Protheus - GFE - Configurador de Regras na integração de Contratos de RPA - SIGAGFE com o Recebimento do ERP Datasul
- Alterar o Tipo de Documento de Carga com Notas de Saída - ERP Datasul para o SIGAGFE. Veja mais detalhes no link Logística - Linha Protheus - GFE - Configurador de Regras na alteração do Tipo de Documento de Carga em Notas Fiscais de Saída - ERP Datasul para o SIGAGFE
- Alterar o Tipo de Documento de Carga com Notas de Entrada - ERP Datasul para o SIGAGFE. Veja mais detalhes no link Logística - Linha Protheus - GFE - Configurador de Regras na alteração do Tipo de Documento de Carga em Notas Fiscais de Entrada - ERP Datasul para o SIGAGFE
- Alterar o Item de Serviço no Fiscal - ERP Datasul ao apropriar despesa. Veja mais detalhes no link Logística - Linha Protheus - GFE - Alterar o item fiscal, no OF0305, ao Apropriar Despesa
A utilização da regra é opcional. Veja alguns exemplos de utilização:
- Atribuir uma natureza de operação ao integrar um Documento de Frete com o Recebimento do Datasul.
- Filtrar notas de saída e entrada que não devem integrar com o SIGAGFE.
- Alterar o Tipo de Documento de Carga no SIGAGFE ao integrar uma nota de saída ou entrada.
- Outros.
Como cadastrar o Configurador de Regras
Para utilizar o Configurador de Regras, devemos cadastrar o Tipo de Operação no programa CD0025 e Configurar a Regra no CD0024. Mais detalhes e exemplos de criação poderão ser consultados nos links acima.
Dica 01: Simulador de Configurador de Regras - CD0026
Podemos utilizar o programa CD0026 para simular as regras cadastradas.
Neste exemplo foi testado a regra da Natureza de Operação igual a 111xxx, Tipo de Documento igual a 1:
Dica 02: Uso do Clientlog durante a investigação de algum incidente:
Durante a execução das integrações do SIGAGFE que utilizam-se de conceito de Configurador de Regras, há a execução da API cdp/cdapi034 responsável em executar o cadastro da regra, sendo possível consultar alguns parâmetros no clientlog:
RUN cdp/cdapi034.p (<empresa do usuário, visível>,
<temp-table, não é visível>,
<código da operação, visível>,
<temp-table, não e visível>,
<código da regra encontrada e que foi aplicada, visível. Quando não for encontrada a regra, o conteúdo será zero(0)>,
<temp-table, não e visível>,
<temp-table, não e visível>,
<temp-table, não e visível>).
Dica 03: Arquivo de log da API cdp/cdapi034
Durante a execução das integrações do SIGAGFE que utilizam-se de conceito de Configurador de Regras, há a execução da API cdp/cdapi034 responsável em executar o cadastro da regra. Esta API, gera no diretório temporário da sessão Progress um arquivo de log onde é possível comparar o cadastro das variáveis da condição registradas no CD0024, com os valores recebidos.
Segue exemplo de como interpretar o conteúdo apresentado neste arquivo. No arquivo cdapi034.txt consta as seguintes linhas:
Regra: 20
if ('2352'='2352')AND (LOGICAL('yes')=LOGICAL('yes'))AND (INTEGER('1')=INTEGER('1'))AND (LOGICAL('no')=LOGICAL('yes')) then YES else NO
Para a interpretação recomenda-se que seja também executado o programa de Cadastro de Configurador de Regras - CD0024, consultando-se a regra, no exemplo é a regra 20, onde se tem a sequência das variáveis utilizadas com o respectivo cadastro. Para cada condição existente, no log é apresentado primeiramente o conteúdo recebido e depois o conteúdo cadastrado na condição onde então, pode-se conferir se a condição é verdadeira ou não.
Ilustrando:
nat-operacao: 2352(RECEBIDO) = 2352(CONDIÇÃO) AND * satisfaz a condição
l-trib-pc...: yes(RECEBIDO) = yes(CONDIÇÃO) AND * satisfaz a condição
cb-trib-icm.: 1(RECEBIDO) = 1(CONDIÇÃO) AND * satisfaz a condição
l-crdicms...: no(RECEBIDO) = YES(CONDIÇÃO) * como está sendo enviado NO e esta condição espera YES, fará com que esta regra não seja aplicada.
Saiba mais
Para detalhes de um fluxo do Configurador de Regras, poderá ser visualizado o vídeo How To | Engine de Regras do ERP Datasul x Frete Embarcador - #TOTVSBackoffice_Linha_DATASUL
Glossário
ERP - Enterprise Resource Planning
GFE ou SIGAGFE - Gestão de Frete Embarcador
0 Comentários