CPC-API-MENS-PRE-PAGAMENTO.P

• Rotina utilizada para permitir a operadora controlar os valores dos beneficiários - faturamento pré-pagamento
• Caso o cliente não queira executar a chamada da CPC no seu cadastro deve colocar CPC Ativo como não.
• Será permitido para esta CPC apenas um registro na tabela temporária de saída. Caso possuir mais de um registro um erro será reportado.

Localização

• Dentro da rotina que executa o cálculo dos beneficiários - faturamento pré-pagamento.

Ponto de Utilização

• "CONSIDERAR-MODULO"
  
• "CALC-VALOR-ESPECIAL"
  
• "APOS-APL-DESCONTO"
• "INI-CRIA-EVENTO" - ponto disponível a partir da versão 12.1.2503

• "FIM-MENS-PROP" - ponto disponível a partir da versão 12.1.2503

• "FIM-MENS-ANT" - ponto disponível a partir da versão 12.1.2503

• "FIM-MENS-PROP-SAI" - ponto disponível a partir da versão 12.1.2503

• "MENS-BASICA" - ponto disponível a partir da versão 12.1.2503

•  "FIM-PRIM-MENS" - ponto disponível a partir da versão 12.1.2503

Include das definições das tabelas temporárias

• cpc-api-mens-pre-pagamento.i 

Tabelas de entrada e saída

Tabela de entrada tmp-cpc-api-mens-pre-pag-entrada

def temp-table tmp-cpc-api-mens-pre-pag-entrada no-undo

    field nm-ponto-chamada           as char 
    field cd-evento                  as integer
    field cd-modulo                  as integer
    field cd-usuario                 as integer
    field cd-grau-parentesco         as integer    
    field vl-evento                  as decimal
    field pc-desconto                as decimal
    field dt-emissao                 as date
    field aa-ref                     as int
    field mm-ref                     as int
    field cd-modalidade              as int
    field nr-proposta                as int
    field h-tmp-evento-benef         as handle
    field dt-exclusao-plano          as date.

Definição campo a campo da tabela de entrada

• • nm-ponto-chamada – Nome do ponto de chamada da cpc dentro do programa que a utiliza. 
  • cd-evento – Código do evento (HFP);
  • cd-modulo – Código do módulo de cobertura;
  • cd-usuario – Código do beneficiário;
  • cd-grau-parentesco – Código do grau de parentesco do beneficiário;
  • vl-evento – Valor do evento (HFP);
  • pc-desconto – Percentual de desconto que incidirá no valor do faturamento;
  • dt-emissao – Data de emissão da nota de serviço;
  • aa-ref – Ano de referência do faturamento;
  • mm-ref – Mês de referência do faturamentoNúmero da guia de atendimento;
  • cd-modalidade – Código da modalidade da proposta a ser faturada;
  • nr-proposta – Número da proposta a ser faturada.
  • h-tmp-evento-benef – Handle da tabela temporária de eventos x beneficiários
  • dt-exclusao-plano – Data da exclusão do plano do beneficiário

Tabela de saída tmp-cpc-api-mens-pre-pag-saida

def temp-table tmp-cpc-api-mens-pre-pag-saida no-undo

    field pc-proporcional            as dec format "999.9999"
    field lg-erro                    as log 
    field lg-return                  as log
    field lg-altera-parcial          as log
    field lg-cob-parcial             as log
    field lg-desc-mod                as log
    field lg-desconsidera-usuario    as log .
 

Definição campo a campo da tabela de saída 

• • pc-proporcional – Variável que o valor proprorcional que será faturado para  o beneficiário.
  • lg-erro – Variável que controla os erros que podem ocorrer na CPC.
  • lg-return – Variável que retorna ou não da CPC.     
  • lg-altera-parcial –  Variável que indica se deve alterar a cobrança para integral ou parcial
  • lg-cob-parcial – Variável que indica se deve cobrar integral ou parcial
  • lg-desc-mod – Variável que controla os módulos que serão considerados ou não no cálculo da mensalidade.                    
  • lg-desconsidera-usuario – Variável que controla os beneficiários que serão considerados ou não no cálculo da mensalidade.    

Tabela de entrada e saída tmp-evento-fat

def temp-table tmp-evento-fat no-undo

field cd-modulo                                            as integer 
field cd-rotina                                              as integer
field cd-evento                                            as integer
field cdn-lotac                                              as integer
field cdn-respons-financ                              as integer 
field cdn-respons-origem                             as integer
field log-demit-apos                                     as log
field dt-vencimento                                      as date
field ct-codigo                                              as char format "x(20)"
field sc-codigo                                             as char format "x(20)"
field cd-especie                                           as char
field lg-valor                                                as log

field pc-princ-aux                                       as dec
field lg-modulo-agregado                          as log
field lg-prop-evento                                   as log
field in-programa                                      as char format "x(12)"
field in-classe-rotina                                as integer
field lg-modulo                                        as log
field lg-cred-deb                                     as log
field lg-destacado                                  as log
field in-classe-evento                            as char

lg-sem-troca                                         as log
field lg-modulo-obrigatorio                    as log
field vl-evento                                       as dec format 999999999999.99
field vl-evento-cart-nv                           as dec format 999999999999.99
field pc-desconto                                  as dec format 999.99
field pc-acrescimo                                as dec format 999.99
field pc-desc-prom-pl                           as dec format 999.99
field lg-cred-deb-mens                         as log
field qt-evento                                      as integer
field pc-negociacao-mens                    as dec format 999.99
field ds-obs                                          as character
field nr-rowid-evt-prog                         as rowid.

Definição campo a campo da tabela de entrada e saída tmp-evento-fat

• • cd-modulo – Código do módulo de cobertura;
  • cd-rotina –  Rotina de cálculo;
  • cd-evento – Código do evento (HFP);
  • cdn-lotac – Código da lotação;
  • cdn-respons-financ – Código do responsável financeiro ;
  • cdn-respons-origem – Código do responsável financeiro origem;
  • log-demit-apos – Log que identifica se o usuário é demitido ou aposentado;      
  • dt-vencimento – Data de vencimento da nota de serviço;
  • ct-codigo – Conta contábil;
  • sc-codigo  – Centro de custo;
  • cd-especie – Espécie da nota de serviço;
  • lg-valor  – Log que indica se o evento parametrizado possuirá algum valor associado a ele. ;
  • pc-princ-aux – Percentual de proporção ao qual o evento será calculado;
  • lg-modulo-agregado – Indicador (Sim/Não) serve para informar se o módulo dentro da estrutura do produto é um módulo agregado ou não, para módulos que não são obrigatórios.;
  • lg-prop-evento – Log que identifica que os eventos parametrizados para o cálculo do faturamento possuem um percentual;
  • in-programa – Este campo possui o nome do programa a ser executado. Pode ser específico ou padrão do sistema; 
  • in-classe-rotina – Este campo possui a classe a que a rotina pertence. Quando a classe for zero indica que a rotina de cálculo é específica; 
  • lg-cred-deb – Loq que indica se o evento é de débito ou crédito;
  • lg-destacado – Loq que indica se o evento será discriminado por grau de parentesco;
  • in-classe-evento – Este campo possui a classe a que o evento pertence. 
  • lg-sem-troca - Este campo indica se haverá ou não troca de faixa etária no faturamento
  • lg-modulo-obrigatorio – Indicador (Sim/Não) serve para informar se a cobertura do módulo é padrão, ou seja, caso o indicador estiver com “SIM” todos os contratos desta modalidade/plano/tipo terão cobertura do referido módulo caso contrário será opcional para cada contrato, podendo ainda para cada contrato ser padrão ou opcional, sendo opcional no contrato possibilita a cobertura ser por beneficiário. ;
  • vl-evento – Valor do evento (HFP);
  • vl-evento-cart-nv – Indica a quantidade da moeda para cálculo da cobrança da nova via do documento de identificação do beneficiário;
  • pc-desconto – Percentual de desconto que incidirá no valor do faturamento;
  • pc-acrescimo – Indica o percentual de acréscimo para a mensalidade;
  • pc-desc-prom-pl – Percentual de desconto;
  • lg-cred-deb-mens – Loq que indica crédito ou débito sobre a mensalidade;
  • qt-evento – Campo que indica a quantidade associada ao evento;   
  • pc-negociacao-mens – Percentual sobre a mensalidade (crédito ou débito);
  • ds-obs – Campo referente à observação;
  • nr-rowid-evt-prog – Identificador do evento programado (por termo ou por beneficiário).

Tabela de entrada e saída tmp-evento-benef

def temp-table tmp-evento-benef no-undo

field cd-usuario                                      as int
field cd-modulo                                      as int
field cd-evento                                       as int
field in-classe-evento                            as char
field cdn-lotac                                        as int
field cdn-respons-financ                        as int
field cd-grau-parentesco                       as int
field nr-faixa-etaria                                as int
field vl-evento                                       as dec format 999999999999.99
field vl-fat-repasse                               as dec format 9.9999
field nr-idade-atu                                  as int
field nr-idade-ant                                  as int
field nr-idade-exc                                 as int
field nr-idade-inc                                  as int
field nr-idade-sem-reaj                        as int
field cd-padrao-cobertura                    as char
field cd-sit-usuario                               as int
field dt-proporcao                                as date
field dt-inclusao-plano                         as date
field dt-reativa                                      as date
field dt-exclusao-plano                         as date
field dt-fim-vigencia                              as date
field aa-ult-fat                                       as int
field mm-ult-fat                                    as int
field lg-susp-mes-ant                          as log
field lg-cobra-insc                               as log
field cdd-regra                                    as dec
field dt-inicio-regra                             as date
field id-criter                                       as dec
field lg-processado                            as log
field lg-mod-agregado                       as log
field nr-rowid-evt-prog                       as rowid
field lg-sem-reajuste                          as log
field ct-nova-via                                 as int
field ct-transf                                     as int
field ds-obs                                      as character.

Definição campo a campo da tabela de entrada e saída tmp-evento-benef

• • cd-usuario – Código do beneficiário
  • cd-modulo – Código do módulo de cobertura;
  • cd-evento – Código do evento (HFP);
  • in-classe-evento – Este campo possui a classe a que o evento pertence.                  
  • cdn-lotac –   Código da lotação                                  
  • cdn-respons-financ  – Código do responsável financeiro;
  • cdn-respons-origem – Código do responsável financeiro origem;
  • cd-grau-parentesco – Código do grau de parentesco do beneficiário;            
  • nr-faixa-etaria – São os intervalos de idade dos beneficiários.           
  • vl-evento – Valor do evento (HFP);                   
  • vl-fat-repasse  – Valor do evento (HFP);     
  • nr-idade-atu – Identifica a idade atual do usuário;
  • nr-idade-ant – Identifica a idade no período anterior ao referência;
  • nr-idade-exc – Identifica a idade base do usuário na exclusão
  • nr-idade-inc – Identifica a idade base do usuário na inclusão;
  • nr-idade-sem-reaj – Identifica a idade sem reajuste do usuário;  
  • cd-padrao-cobertura – Código para definição dos possíveis padrões de cobertura.
  • cd-sit-usuario – Código da situação do usuário; 
  • dt-proporcao  – Data referente ao faturamento proporcional
  • dt-inclusao-plano  –  Data referente à inclusão no plano;
  • dt-reativa  – Data referente à reativação;
  • dt-exclusao-plano  – Data referente à exclusão no plano
  • dt-fim-vigencia  – Data referente ao fima da vigência;
  • aa-ult-fat – Ano de último faturamento;
  • mm-ult-fat – Mês de último faturamento;
  • lg-susp-mes-ant – Log que identifica se houve suspensão no mês anterior ao faturamento;
  • lg-cobra-insc – Log que identifica se deve ser cobrada taxa de inscrição;
  • cdd-regra – Código que identifica qual a regra a ser executada no cálculo do faturamento;
  • dt-inicio-regra – Data de início da validade da regra a ser executada no cálculo do faturamento;
  • id-criter – Código do critério da regra a ser executada no cálculo do faturamento;
  • lg-processado – Log que indica se o registro já foi processado ou não;
  • lg-mod-agregado – Indicador (Sim/Não) serve para informar se o módulo dentro da estrutura do produto é um módulo agregado ou não, para módulos que não são obrigatórios;
  • nr-rowid-evt-prog – identificador do evento programado (por termo ou por beneficiário);
  • lg-sem-reajuste – Log que indica se existe ou não reajuste;
  • ct-nova-via – Campo que armazena a quantidade de vias do documento de identificação do usuário que devem ser cobradas;
  • ct-transf – Campo que armazena a taxa de transferência do usuário;
  • ds-obs – Campo referente à observação.