3. Acúmulo de valores do Ano-Plantio

Este processo pode ser chamado à partir de três pontos do sistema:

1. Através do serviço de oficialização de contratos de cana (PIMSSERV EXE) que fica em execução constante;
2. Pela opção manual de execução do acúmulo (COCTAGR > Processos > Cálculo de Amortização > Geração);
3. Ou pela restauração manual dos valores de acúmulo (COCTAGR > Processos > Cálculos de Amortização > Restauração).

Isto posto, toda narrativa abaixo irá retratar exatamente o que se passa dentro do programa, ponto a ponto, de modo que tenhamos total noção das ações executadas. Vamos lá!

Obtenção da data de referência para o cálculo:

Tudo começa com o fechamento dos erros que foram abertos durante o processamento anterior. Depois, a rotina realiza a primeira checagem de parâmetro:

• Caso o status do processamento anterior seja igual a "Aberto" (COCTAGR / FG_STATUS_AC_PLAN = 'A'), então a data atual de processamento será a mesma da última execução (COCTAGR / DT_ULT_AC_PLAN).
• Do contrário, a data de processamento será a que foi informada na tela de argumentos do processo 2 ou 3 (vide acima), ou seja, rotinas manuais, ou será obtida automaticamente dentro do serviço de oficialização dos contratos. Veja a explicação a seguir.

Dentro do serviço de oficialização de contratos (PIMSSERV EXE):

• Se o mês da data da última execução do acúmulo for igual a 12 (dezembro), então a data de referência do cálculo será igual a 01/01 do ano seguinte.
• Do contrário, a data será o primeiro dia do mês seguinte (01/mês seguinte/ano atual) à partir da última execução.

Agora o sistema já grava a nova data de execução da rotina no parâmetro correspondente (COCTAGR / DT_ULT_AC_PLAN) e também ajusta o status do processamento (COCTAGR / FG_STATUS_AC_PLAN) para indicar que ele está em curso (E - Em andamento).

Seleção dos contratos com amortização:

Neste ponto, o sistema inicia a seleção dos contratos que irá trabalhar através das seguintes premissas:

1. O contrato deve estar ativo ou em aprovação.
2. Ele deve estar vigente.
3. O tipo de contrato associado a ele deve estar configurado para o controle de amortização.
4. E o processo de amortização em si não deve ter sido iniciado para este contrato.

Validações iniciais:

É obrigatório que a Folha de Pagamento mensal de parceria esteja fechada (consulta na tabela CT_PARAM). Sem isto, o sistema não saberia relacionar as parcelas de pagamento corretas, certo? Mas se ela estiver aberta, o sistema irá jogar esta informação em um arquivo de log que será exibido imediatamente. Por outro lado, as Notas Fiscais devem estar com o período em aberto (RCMP_PGTCP / FG_SIT_NF) para que o processo de acúmulo de valores tenha uma "linha de corte" quanto ao total já faturado e, assim, entender quais contratos já podem adentrar no cálculo da amortização. As Notas também não poderão estar processadas a frente da rotina de acúmulo (RCMP_PGTCP / DT_INI_PER_NF).

O próximo passo é entender qual será o método de cálculo da amortização do Ano-Plantio (COCTAGR / FG_METODO_AMORTIZA). A distribuição de valores pode acontecer linearmente (L), onde todas as safras de corte do contrato recebem a mesma quantidade de cana no rateio, por produção estimada (P), onde a distribuição é proporcional ao Objetivo de Safra ou informada pelo usuário (I), onde cada safra recebe um valor fixo. 

E para finalizar estas checagens iniciais, o sistema ainda (1) verifica se existe safra correspondente à data de processamento, (2) verifica se já não houve entrada de cana para as fazendas (busca na tabela HISTUPNV1, registros quinzenais) do contrato, tanto de origem como de destino de rateio, e (3) se existe safra cadastrada para o início de vigência do contrato.

Começando o acúmulo de valores:

Neste ponto do processo o sistema está reunindo dados das parcelas de pagamento (tabela HIST_CONTR_CANA) que foram realizadas até a data de execução desta rotina. Aqui há uma totalização do valor monetário, da quantidade de cana e a recuperação da última parcela paga, ou seja, estamos acumulando os valores adiantados aos parceiros. Se há sucesso na obtenção de valores, então a primeira ação, neste ponto, é remover da tabela de valores do Ano-Plantio (CONTR_CANA_VLPLANT) o registro anterior. Estamos falando de uma ação restrita ao contrato e à safra de plantio do mesmo.

Caso o método de amortização esteja configurado para ser proporcional à produção, o sistema irá consultar o contrato (tabela CONTRCANA_PROD_SAFRA) afim de saber se há estimativa nele. Se nada for encontrado, a rotina será abortada.

Agora, para cada safra de corte (loop) registrada no contrato de cana (tabela CONTRCANA_PERC_SAFRA) o sistema:

1. Verifica se a safra fechada no RCMP - Recepção de matéria-prima (GERAIS / CD_SAFRA_FECH) - não é superior à safra de corte do contrato. Caso seja, a safra em questão será ignorada.
2. Caso o item anterior não seja um impedimento, então o sistema insere informação na tabela de valor do Ano-Plantio (CONTR_CANA_VLPLANT). Observação: uma única vez.
3. Se o método de amortização for proporcional à estimativa de produção da safra, então a rotina encontra o percentual de representação dela e:
   1. Aplica o percentual encontrado no montante de adiantamentos financeiros do contrato.
   2. Aplica o percentual encontrado no montante de toneladas de cana do contrato.
4. Se o método de amortização for linear, então o sistema divide o total de cana e o total financeiro (adiantamentos) igualmente entre os anos de corte do contrato.
5. Insere estes dados na tabela de depreciação por safra (CONTR_CANA_PC_DEP). Veja o exemplo abaixo:

Abaixo nós temos uma representação visual do fluxo sistêmico até o momento:

Agora é a vez do rateio de cana:

Chegamos em um dos pontos fundamentais desta rotina que é a atualização do rateio de cana. Calcular e projetar valores sem onde depositá-los deixaria todo o processo na esfera do conceito. Com o rateio de cana a distribuição destes valores se materializa em todas as safras de Ano-Corte do contrato, o que efetivamente gera o controle de amortização dentro do ciclo de vida do contrato.

Para começar, é importante lembrar que os passos descritos nesta etapa são repetidos para cana safra registrada na guia de rateio (Ano-Corte) do contrato (PercSafra). E a primeira ação é a busca pelo total de toneladas previstas no planejamento de pagamento da safra/contrato. A seguir, o sistema também busca o total do percentual de participação entre os fundos do tipo parceria. Temos, então, (1) o total de toneladas previstas para pagamento naquela safra e (2) a representação total da parceria no rateio. Dito assim, fica claro que o sistema está preparado para trabalhar com mais de um fundo parceiro no mesmo contrato. E para cada fundo deste:

1. É feito o cálculo para descoberta do percentual de representação do fundo mediante o total de fundos parceiros (percentual rateio pelo percentual total de rateio entre os fundos parceiros).
2. Aplicado este percentual sobre o total de cana a amortizar naquela safra.
3. Aplicado o mesmo percentual sobre o total de toneladas previstas (planejamento) de pagamento.

Caso o contrato de cana possua talhões vinculados, então o percentual de participação é recalculado a nível de talhões de modo que haja distribuição da cana a amortizar neste nível, uma vez que existirá um contrato de rateio para cada talhão. O sistema utiliza a área produtiva para esta proporção, ou seja, quanto maior a área do talhão, maior será a fatia da cana a amortizar que sairá dele. O mesmo percentual também é utilizado para o total de toneladas previstas.

Por fim, o processo:

1. Atualiza o total de cana a ratear da linha do contrato de rateio com as toneladas a amortizar + as toneladas previstas nos pagamentos (parcelas).
2. Atualiza o campo de toneladas para amortização da linha do contrato de rateio.
3. Atualiza o cabeçalho do contrato de rateio com a data deste processo.

Veja este exemplo:

Representação visual desta etapa:

Como última tarefa de toda esta rotina de acúmulo de valores do Ano-Plantio, o sistema atualiza o status (COCTAGR / FG_STATUS_AC_PLAN) do processo para fechado.