Linha Datasul

Árvore de páginas

CPC-BOSAUBILLET

Produto:

TOTVS Saúde Planos - Linha Datasul

Módulo:HFP
Versão:Todas
Assuntos:

cpc-bosaubillet


Rotina para:

  • Executar ajustes nos dados que serão utilizados para gerar os boletos (Ex: agrupar eventos ou valores, alterar descrição de eventos, criptografia, etc ), para o ponto de chamada "FIM-BOLETO-HIST". Campos preenchidos tmp-cpc-bosaubillet-entrada:
    • nm-ponto-chamada-cpc = "FIM-BOLETO-HIST"
    • h-b-tmpInvoiceBillet
    • h-tmpBilletBenef
    • h-tmpInvoiceDebits               
    • h-tmpBilletIRDemonstrative  
    • h-tmpInvoiceInfo                 
    • h-tmpBilletMessage            
    • h-tmpBilletTypeMessage           
    • h-tmpBilletMessageSimpleLayout
    • h-tmpBilletTypeMessageSimpleLay
    • h-tmpBilletParameterGeneration    
    •  h-tmpBilletClientInfo            
    •  h-tmpBilletEvent                 
    •  h-tmpInvoiceBillet             
    •  h-tmpBilletMoviment           
    •  h-tmpBillet                    
    •  idi-tip-layout   


  • Executar ajustes nos totalizadores do lote, ou criar totalizadores específicos,  para o ponto de chamada "FIM-BOLETO-TOTA". Campos preenchidos tmp-cpc-bosaubillet-entrada:
    • nm-ponto-chamada-cpc = "FIM-BOLETO-TOTA"
    • cdd-boleto
    • h-tmpBilletTotalizers
    • lg-ign-fat-sem-reg


  • Executar ajustes no nosso número em boletos configurados para não apresentar os dados do boleto bancário ao realizar a impressão dos documentos, para o ponto de chamada "INI-BOLETO-NUME". Campos preenchidos tmp-cpc-bosaubillet-entrada:
    • nm-ponto-chamada-cpc = "INI-BOLETO-NUME"
    • cd-contratante
    • nr-fatura
    • config-financ-boleto-rowid


  • Tratar se para o contratante serão criados relatório de eventos por beneficiário e relatório de usos do beneficiário, para o ponto de chamada "INI-BOLETO-PROC".  Campos preenchidos tmp-cpc-bosaubillet-entrada:
    • nm-ponto-chamada-cpc = "INI-BOLETO-PROC"
    • cd-contratante


  • Realizar ajustes no final do processo de criação de dados dos boletos, para o ponto de chamada "FIM-BOLETO-PROC". Campos preenchidos tmp-cpc-bosaubillet-entrada:
    • nm-ponto-chamada-cpc = "FIM-BOLETO-PROC"
    • cdd-boleto
    • h-tmpInvoiceBillet
    • lg-ign-fat-sem-reg
    • nr-pedido-rpw
    • idi-programa-chamador


  • Realizar ajustes após deletar boleto do lote, para o ponto de chamada "FIM-BOLETO-REMO". Campos preenchidos tmp-cpc-bosaubillet-entrada:
    • nm-ponto-chamada-cpc = "FIM-BOLETO-REMO"
    • cdd-boleto
    • h-tmpInvoiceBillet


  • Realizar validações para boletos sem retorno do registro bancário (aguardando banco) no final do processo de criação de dados dos boletos, para o ponto de chamada "IGN-FAT-SEM-REG". Chamada realizada somente se o ponto FIM-BOLETO-PROC estiver desabilitado. Campos preenchidos tmp-cpc-bosaubillet-entrada:
    • nm-ponto-chamada-cpc = "IGN-FAT-SEM-REG"
    • cdd-boleto
    • h-tmpInvoiceBillet
    • lg-ign-fat-sem-reg
    • idi-programa-chamador


  • Utilizado pra tratamentos específicos após criar os dados financeiros da fatura, para o ponto de chamada "GRV-TIPO-ATEND". Campos preenchidos tmp-cpc-bosaubillet-entrada:
    • nm-ponto-chamada-cpc = "GRV-TIPO-ATEND"
    • config-financ-boleto-rowid
    • h-tmpInvoiceBillet
    • cd-contratante
    • nr-fatura


  • Realizar processos extras ao efetuar a leitura dos eventos da nota, para o ponto de chamada "EVENTO-PROG". Campos preenchidos tmp-cpc-bosaubillet-entrada:
    • nm-ponto-chamada-cpc = "EVENTO-PROG"
    • h-b-tmpBilletEventMerge
    • h-tmpBilletEventMerge

    • h-fatueven


  • Realizar validação no processo que busca as informações financeiras, para o ponto de chamada "PORT-CART-CRED". Campos preenchidos tmp-cpc-bosaubillet-entrada:
    • nm-ponto-chamada-cpc = "PORT-CART-CRED"

    • config-financ-boleto-rowid


  • Realizar o cadastro de portadores customizados no Cadastro de Configurações Financeiras - Boletos (hfp.billetBankConfigurations), para o ponto de chamada "GET-COLLECT-BNK". Campos preenchidos tmp-cpc-bosaubillet-entrada:
    • nm-ponto-chamada-cpc = "GET-COLLECT-BNK"
    • in-evento-programa = "VALIDA"
    • cd-portador
    • cdd-portad-modalid

    • nm-ponto-chamada-cpc = "GET-COLLECT-BNK"
    • in-evento-programa = "PORTADOR"
    • h-tmpBearer
    • cd-portador 

    • nm-ponto-chamada-cpc = "GET-COLLECT-BNK"
    • in-evento-programa = "MODALIDADE"
    • h-tmpModality
    • cd-portador


  • Realizar a geração dos dados de demonstrativo de IR, para o ponto de chamada "DEMONSTRATIV-IR". Campos preenchidos tmp-cpc-bosaubillet-entrada:
    • nm-ponto-chamada-cpc = "DEMONSTRATIV-IR"
    • h-tmpBilletIRDemonstrative
    • cd-contratante
    • nr-fatura

  • Ativar/Desativar a validação do retorno bancário através do ponto de chamada "ANT-VLD-RET-BAN". Campos preenchidos tmp-cpc-bosaubillet-entrada:
    • nm-ponto-chamada-cpc = "ANT-VLD-RET-BAN"
    • h-tmpBilletParameterGeneration
    • lg-valida-retorno-bancario


  • Campos preenchidos no ponto de chamada "APOS-HIST-BOLET":
    • nm-ponto-chamada-cpc = "APOS-HIST-BOLET"
    • h-tmpInvoiceBillet


  • Realizar ajustes em dados do boleto através do ponto de chamada "ANT-CRI-BIL-HIS". Campos preenchidos tmp-cpc-bosaubillet-entrada:
    • h-b-tmpInvoiceBillet
    • h-tmpInvoiceBillet
    • h-tmpBillet
    • h-tmpBilletMoviment
    • h-tmpBilletBenef
    • h-tmpBilletEvent
    • h-tmpInvoiceDebits
    • h-tmpBilletClientInfo
    • h-tmpBilletIRDemonstrative
    • h-tmpInvoiceInfo
    • h-tmpBilletMessage
    • h-tmpBilletTypeMessage
    • h-tmpBilletMessageSimpleLayout
    • h-tmpBilletTypeMessageSimpleLay
    • h-tmpBilletParameterGeneration

Localização

  • Dentro do programa BOSAUBILLET.P, o ponto de chamada "FIM-BOLETO-HIST" é chamado após carregar os dados que serão utilizados para criar os boletos
  • Dentro do programa BOSAUBILLET.P, o ponto de chamada "FIM-BOLETO-TOTA" é chamado após carregar os dados dos totalizadores do lote
  • Dentro do programa BOSAUBILLET.P, o ponto de chamada "INI-BOLETO-NUME" é chamado no início do processo que busca as informações financeiras da fatura
  • Dentro do programa BOSAUBILLET.P, o ponto de chamada "INI-BOLETO-PROC" é chamado no início do processo de faz a leitura das informações do contratante da fatura
  • Dentro do programa BOSAUBILLET.P, o ponto de chamada "FIM-BOLETO-PROC" é chamado no fim do processo de leitura e criação dos dados para os boletos
  • Dentro do programa BOSAUBILLET.P, o ponto de chamada "FIM-BOLETO-REMO" é chamado no final dos processos que excluem boletos (exclusão individual ou por lote) e no regerar
  • Dentro do programa BOSAUBILLET.P, o ponto de chamada "IGN-FAT-SEM-REG" é chamado no fim do processo de leitura e criação dos dados para os boletos quando ponto FIM-BOLETO-PROC não estiver ativo
  • Dentro do programa BOSAUBILLET.P, o ponto de chamada "GRV-TIPO-ATEND" é chamado no processo que busca as informações financeiras logo após criar os dados da fatura
  • Dentro do programa BOSAUBILLET.P, o ponto de chamada "EVENTO-PROG" é chamado no fim do processo que realiza a leitura dos eventos da nota
  • Dentro do programa BOSAUBILLET.P, o ponto de chamada "PORT-CART-CRED" é chamado no processo que busca as informações financeiras
  • Dentro dos programas BOSAU-BILLET-BANK-CONFIGURATIONS.P, BOSAU-BEARER.P e BOSAU-BEARER-MODALITY.P o ponto de chamada "GET-COLLECT-BNK" é chamado para permitir e validar o cadastro de portadores customizados no Cadastro de Configurações Financeiras - Boletos (hfp.billetBankConfigurations).
  • Dentro do programa BOSAUBILLET.P, o ponto de chamada "DEMONSTRATIV-IR" é chamado no processo que gera os dados do demonstrativo de IR
  • Dentro do programa BOSAUBILLET.P, o ponto de chamada "ANT-VLD-RET-BAN" é chamado antes de validar o retorno bancário
  • Dentro do programa BOSAUBILLET.P, o ponto de chamada "ANT-CRI-BIL-HIS" é chamado antes de criar o histórico do boleto
  • Dentro do programa BOSAUBILLET.P, o ponto de chamada "APOS-HIST-BOLET" é chamado após criar o histórico do boleto - liberação a partir da versão 12.1.2209
  • Dentro do programa BOSAUBILLET.P, o ponto de chamada "ANTES-AGRUPA" é chamado dentro do processamento dos registros - liberação a partir da versão 12.1.2301

Ponto de Utilização

  • "FIM-BOLETO-HIST", "FIM-BOLETO-TOTA","INI-BOLETO-NUME","INI-BOLETO-PROC","FIM-BOLETO-PROC","FIM-BOLETO-REMO","IGN-FAT-SEM-REG","GRV-TIPO-ATEND","EVENTO-PROG","PORT-CART-CRED", "GET-COLLECT-BNK", "DEMONSTRATIV-IR", "ANT-VLD-RET-BAN", "ANT-CRI-BIL-HIS, "FIM-BUSCA-INST", "APOS-HIST-BOLET" e "ANTES-AGRUPA".


Include das definições das tabelas temporárias


Tabelas de entrada e saída

Tabela de entrada tmp-cpc-bosaubillet-entrada

    def temp-table tmp-cpc-bosaubillet-entrada no-undo
        field nm-ponto-chamada-cpc               as char format "x(15)"
        field in-evento-programa                 as char format "x(15)"
        field cdd-boleto                         as dec
        field h-tmpBilletClientInfo              as handle
        field h-tmpBilletEvent                   as handle
        field h-tmpBilletEventMerge              as handle
        field h-b-tmpBilletEventMerge            as handle
        field h-tmpBilletTotalizers              as handle
        field h-tmpInvoiceBillet                 as handle
        field h-tmpBilletMoviment                as handle
        field h-tmpCollectingBank                as handle
        field h-tmpBillet                        as handle 
        field h-tmpBilletIRDemonstrative         as handle 
        field h-fatueven                         as handle
        field h-tmpBearer                        as handle
        field h-tmpModality                      as handle
        field cd-contratante                     as integer
        field nr-fatura                          as integer
        field config-financ-boleto-rowid         as rowid
        field nm-usuario-logado                  as char
        field lg-ign-fat-sem-reg                 as log
        field idi-tip-layout                     as int
        field log-criptografar                   as log
        field cd-portador                        as char
        field cdd-portad-modalid                 as char
        field nr-pedido-rpw                      as dec
        field idi-programa-chamador              as char
        field h-tmpBilletParameterGeneration     as handle
        field h-tmpBilletBenef                   as handle
        field h-tmpInvoiceDebits                 as handle
        field h-tmpInvoiceInfo                   as handle
        field h-tmpBilletMessage                 as handle
        field h-tmpBilletTypeMessage             as handle
        field h-tmpBilletMessageSimpleLayout     as handle
        field h-tmpBilletTypeMessageSimpleLay    as handle
        field h-b-tmpInvoiceBillet               as handle
        field lg-valida-retorno-bancario         as log
        field h-tmpBilletParameterGeneration     as handle
        field h-tmpBilletBenef                   as handle
        field h-tmpInvoiceDebits                 as handle
        field h-tmpInvoiceInfo                   as handle
        field h-tmpBilletMessage                 as handle
        field h-tmpBilletTypeMessage             as handle
        field h-tmpBilletMessageSimpleLayout     as handle
        field h-tmpBilletTypeMessageSimpleLay    as handle
        field h-b-tmpInvoiceBillet               as handle
        field lg-valida-retorno-bancario         as log.


Definição campo a campo da tabela de entrada

  • nm-ponto-chamada-cpc - Nome do ponto de chamada da cpc

  • in-evento-programa -  Identificador para tratamento interno no ponto de chamada
  • cdd-boleto - Número do lote do boleto
  • h-tmpBilletClientInfo - Handle da tabela temporária tmpBilletClientInfo
  • h-tmpBilletEvent - Handle da tabela temporária tmpBilletEvent
  • h-tmpBilletEventMerge - Handle da tabela temporária tmpBilletEventMerge
  • h-tmpBilletTotalizers - Handle da tabela temporária tmpBilletTotalizers
  • h-tmpInvoiceBillet - Handle da tabela temporária tmpInvoiceBillet
  • h-tmpBilletMoviment - Handle da tabela temporária tmpBilletMoviment
  • h-tmpCollectingBank - Handle da tabela tmpCollectingBank
  • h-tmpBillet - Handle da tabela temporária tmpBillet
  • h-tmpBilletIRDemonstrative - Handle da tabela temporaria tmpBilletIRDemonstrative
  • h-fatueven  - Handle da tabela fatueven
  • h-tmpBearer - Handle da tabela temporária tmpBearer
  • h-tmpModality - Handle da tabela temporária tmpModality
  • cd-contratante - Código do contratante
  • nr-fatura - Número da fatura 
  • config-financ-boleto-rowid - Rowid da tabela config-financ-boleto
  • nm-usuario-logado - Nome do usuário logado
  • lg-ign-fat-sem-reg - Indica se o ponto IGN-FAT-SEM-REG esta ativo
  • idi-tip-layout - Identifica o tipo do layout 
  • log-criptografar - Indica se utiliza criptografia 
  • cd-portador  - Código do portador
  • cdd-portad-modalid - Código da modalidade do portador
  • nr-pedido-rpw - Número do pedido rpw referente a geração
  • idi-programa-chamador - Identifica qual processo chamou a geração de boletos
  • h-tmpBilletParameterGeneration - Handle da tabela temporária tmpBilletParameterGeneration
  • h-tmpBilletBenef- Handle da tabela temporária tmpBilletBenef
  • h-tmpInvoiceDebits- Handle da tabela temporária tmpInvoiceDebits
  • h-tmpInvoiceInfo- Handle da tabela temporária tmpInvoiceInfo
  • h-tmpBilletMessage- Handle da tabela temporária tmpBilletMessage
  • h-tmpBilletTypeMessage- Handle da tabela temporária tmpBilletTypeMessage
  • h-tmpBilletMessageSimpleLayout- Handle da tabela temporária tmpBilletMessageSimpleLayout
  • h-tmpBilletTypeMessageSimpleLay- Handle da tabela temporária tmpBilletTypeMessageSimpleLayout
  • h-b-tmpInvoiceBillet- Handle do buffer da tabela temporária tmpInvoiceBillet
  • lg-valida-retorno-bancario - Indicador se deve validar o retorno bancário


Tabela de saída tmp-cpc-bosaubillet-saida

    def temp-table tmp-cpc-bosaubillet-saida no-undo
        field lg-erro                        as log
        field lg-continua                    as log
        field ds-mensagem                    as char
        field ind-forma-envio                as integer
        field lg-permite-proc-benef          as log
        field lg-permite-proc-extrato-utliz  as log
        field nr-registros                   as int
        field lg-valida-retorno-bancario     as log.


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

  • lg-erro - Indica se ocorreu erro nos processos da CPC
  • lg-continua
    • Utilizado para validar o retorno da chamada do ponto PORT-CART-CRED. Indica se o contratante utiliza cartão de credito, caso sim são exibidas as instruções bancarias no boleto
    • Utilizado para validar o retorno da chamada do ponto GET-COLLECT-BNK, opção "VALIDA", indicando que encontrou o cadastro do portador customizado
  • ds-mensagem - Mensagem de erro no processo da cpc
  • lg-permite-proc-benef - Utilizado para validar o retorno da chamada do ponto INI-BOLETO-PROC. Indica se serão listados os eventos por beneficiário do contrato
  • lg-permite-proc-extrato-utliz - Utilizado para validar o retorno da chamada do ponto INI-BOLETO-PROC. Indica se serão listadas as utilizações dos beneficiários do contrato
  • nr-registros - Utilizado para retornar o total de registros encontrados no processamento de portadores customizados, no retorno da chamada do ponto "GET-COLLECT-BNK", opções "PORTADOR" e "MODALIDADE".
  • lg-valida-retorno-bancario - Indicador se deve validar o retorno bancário