Integração Planejamento e Controle Orçamentário x Módulos Origem (SIGAPCO)

CONTEÚDO

01. VISÃO GERAL

Esta documentação visa abordar aspectos técnicos gerais das integrações com o módulo Planejamento e Controle Orçamentário (SIGAPCO).

O módulo Planejamento e Controle Orçamentário desempenha um papel crucial na gestão financeira de uma organização, sendo responsável por monitorar, planejar e controlar os recursos financeiros disponíveis. No entanto, é importante destacar que este módulo não interfere no modo como os módulos de origem integram seus dados.

Em outras palavras, o Planejamento e Controle Orçamentário não tem a função de ditar como cada módulo de origem deve lidar com os planejamentos e controles orçamentários. Cada módulo de origem, de acordo com sua própria regra de negócio e estrutura interna, é responsável por definir como irá tratar, processar, validar e assim por diante, as informações pertinentes ao orçamento por meio das funções principais PcoIniLan, PcoVldLan, PcoDetLan e PcoFinLan.

Essa independência é fundamental, pois permite que os módulos de origem atuem de acordo com suas especificidades e necessidades internas. Por exemplo, um módulo de origem relacionado às vendas pode ter requisitos diferentes de um módulo de origem relacionado à produção ou recursos humanos.

Dessa forma, cabe a cada módulo de origem determinar como irá interagir com o módulo de Planejamento e Controle Orçamentário, garantindo uma integração eficaz e alinhada com as particularidades de cada processo. Essa abordagem flexível permite uma maior adaptação às demandas específicas de cada área da organização, promovendo uma gestão orçamentária mais eficiente e personalizada.

02. FUNÇÕES UTILIZADAS PELOS MÓDULOS DE ORIGEM

A integração é ativada a partir da configuração do parâmetro MV_PCOINTE.

PcoIniLan:

A função PcoIniLan é utilizada na abertura de uma transação que pode gerar lançamentos de integração com o módulo SIGAPCO, sendo que nela são inicializadas algumas variáveis de controle interno.

Todos os processos que devem ser escriturados nos movimentos/lançamentos no SIGAPCO necessitam da chamada à função PcoInilan(...) com parâmetro informando o "código do processo", e em processos que estejam utilizando bloqueio passar o parâmetro lógico .T. ("lDelBlq") que verificará se existem lançamentos de bloqueios inválidos pendentes, que se não estiverem em uso serão excluídos.

PCOINILAN-Lançamentos_de_Integração

PcoVldLan:

A função PcoVldLan tem como finalidade validar se o lançamento de origem tem verba orçamentária disponível, efetuando um pseudo-lançamento na movimentação orçamentária e conforme parametrização, no tipo de bloqueio, compara os valores orçados ou previstos com os realizados efetivamente, e sendo o valor orçado maior ou igual ao do realizado, libera o lançamento, caso contrário bloqueia.

PCOVLDLAN-Validação_de_Lançamentos

PcoDetLan:

A função PcoDetLan é responsável pela geração dos movimentos/lançamentos orçamentários com base nas regras estabelecidas nas respectivas configurações no cadastro de Lançamentos por Processo. Cada processo é identificado por um código e tem um conjunto de itens que compõe o processo denominados Pontos de Lançamento.
PCODETLAN-Movimentos_lançamentos_orçamentários

PcoFinLan:

A função PcoFinLan serve para finalizar uma transação de um processo que gera movimentos/lançamentos no módulo SIGAPCO e é de caráter obrigatório. Esta função é responsável por destruir as instâncias de variáveis efetuadas pela função PcoIniLan(...) e chamar a rotina de alteração dos lançamentos (PCOA050) para validar os mesmos e atualizar os saldos de cubos.

PCOFINLAN-Finalização_de_Movimentos_Lançamentos