Documento de API

Objetivo

Efetuar a importação de ocorrência bancária para títulos do Contas a Receber que já tiveram entrada confirmada no banco. A API aceita as ocorrências bancárias de "Pedido de Baixa", "Baixa cobrança sem título", "Protestar imediatamente", "Cancelar protesto", "Não cobrar juros mora" e "Pedido de Devolução".

Funcionamento

...

Na forma padrão, realiza-se a chamada do programa em modo persistente, sem a passagem de parâmetros, e em seguida, através de um comando RUN normal, executa-se seu método padrão passando-se os parâmetros com as informações necessárias.

def var v_hdl_program as Handle format ">>>>>>9":U no-undo.

run prgfin/acr/

...

acr741zb.py persistent set v_hdl_program.
run pi_main_api_integr_ocor_bcia_2 in v_hdl_program (input

...

2,
                                                   input table tt_integr_ocor_bcia,

...

                                                   input table tt_integr_item_ocor_bcia,

...

                                                   output table tt_log_erros_ocor_bcia).

if valid-handle(v_hdl_program) then
    delete procedure v_hdl_program.

Parâmetro Entrada API Alteração Títulos/Contas a Receber:

num_vers_integr_api: será utilizado para determinar se o programa que está chamando está íntegro com as definições correntes da API;

...

tt_log_erros_estorn_cancel_apb: conterá os dados dos erros ocorridos durante a execusão do programa.

Tabelas Temporárias

...

def temp-table tt_integr_item_ocor_bcia no-undo
        field tta_cod_estab                    as estab                    as character format "x(53)" label "Estabelecimento" column-label "Estab"
        field tta_num_id_tit_acr               acr               as integer format "9999999999" initial 0 label "Token Cta Receber" column-label "Token Cta Receber"
        field ttv_cod_recid_ocor_bcia                as recid format ">>>>>>9"    bcia             as character format "x(80)"
    field tta_cod_portador                 portador                 as character format "x(5)" label "Portador" column-label "Portador"
        field tta_cod_cart_bcia                as bcia                as character format "x(3)" label "Carteira" column-label "Carteira"
        index tt_id_item                       item                       is primary unique
                    tta_cod_estab                    ascending          estab                    ascending
          tta_num_id_tit_acr               ascendingacr               ascending
    .

...

def temp-table tt_integr_ocor_bcia no-undo
        field ttv_cod_tip_ocor_bcia            as bcia            as character format "x(8)"
        field ttv_dat_movto                    as movto                    as date format "99/99/9999" label "Data Movimento" column-label "Data Movimento"
        field ttv_log_tit_sdo                  as sdo                  as logical format "Sim/NÆo" initial no label "T¡tulos com Saldo"
        field ttv_cod_recid_ocor_bcia                as recid format ">>>>>>9"    bcia             as character format "x(80)"
    field ttv_log_bloq_tit_envdo_bcia      as bcia      as logical format "Sim/NÆo" initial yes
        index tt_id_ocor_bcia                  is bcia                  is primary unique
                    ttv_cod_tip_ocor_bcia            ascending          ttv_rec_ocor_bcia                ascendingbcia            ascending
          ttv_cod_id_ocor_bcia             ascending
    .

...