Documento de API

Objetivo

Efetuar renegociação de títulos por substituição

Funcionamento

Executar o programa API(utilizar o nome externo), da seguinte forma:

def var v_hdl_aux as Handle no-undo. 

run prgfin/acr/acr902zc.py persistent set v_hdl_aux.

run pi_main_code_api_integr_acr_renegoc_8 9 in v_hdl_aux

                                            (input table tt_integr_acr_renegoc,

...

                                             output table tt_log_erros_renegoc,

                                             input table tt_params_generic_api).      

for each tt_log_erros_renegoc:

...

            “       Ajuda:” tt_log_erros_renegoc.ttv_des_help VIEW-AS ALERT-BOX.

end.

delete procedure v_hdl_aux.

Parâmetro Entrada API Renegociação por Substituição:

Os paramentros de Entrada são os seguintes:

...

tt_log_erros_renegoc.................: retorna os dados com erros encontrados nas validações durante o processo de renegociação.

Tabelas Temporárias

;

tt_params_generic_api..............: conterá campos novos das temp-tables passadas como parâmetro..

Tabelas Temporárias

(*) A partir da 5.07A o estabelecimento passa a ter cinco dígitos.

def temp-table tt_integr_acr_renegoc no-undo

...

    field tta_cod_cond_cobr                as character format "x(8)" label "Condição Cobrança" column-label "Cond Cobrança".

Observações:

1. tta_num_renegoc_cobr_acr: Se deixar zero cria o número da renegociação considerando a última gerada mais um.
2. tta_ind_vencto_renegoc: Este campo define a periodicidade dos novos vencimentos “diária, mensal, semanal, quinzenal ou nr dias.
3. tta_num_dias_vencto_renegoc: Esta campo se torna obrigatória quando  o campo tta_ind_vencto_renegoc é igual a "nr dias"
4. tta_num_dia_mes_base_vencto: Este campo é apenas documentacional
5. tta_dat_primei_vencto_renegoc: Se a data do 1 vencto for menor que a de transação a data de emissão será igual a do 1 vencto, caso seja maior que a de transação a data de emissão será igual a data de transação.
6. tta_log_juros_param_estab_reaj: Quando o campo receber no determina que o percentual de juros será o da tta_val_perc_reaj_renegoc  caso seja Yes será utilizado o do programa prgfin/acr/acr009aa.r.
7. tta_cod_indic_econ_reaj_renegoc: Este campo é apenas documentacional.
8. ttv_log_atualiza_renegoc: Se seu valor for não a renegociação não será atualizada de forma automatica, porem poderá ser atualizada através do programa prgfin/acr/acr748aa.r.

...

(*) A partir da 5.07A o estabelecimento passa a ter cinco dígitos.

...

def temp-table tt_integr_acr_item_renegoc no-undo

...

          ttv_rec_renegoc_acr              ascending.

def temp-table tt_integr_acr_item_renegoc_new no-undo

...

    field tta_cod_proces_export            as character format "x(12)" label "Processo Exportação" column-label "Processo Exportação".   

...

(*) A partir da 5.07A o estabelecimento passa a ter cinco dígitos.

def def temp-table tt_integr_acr_fiador_renegoc no-undo

...

          ttv_rec_renegoc_acr              ascending. 

(*) A partir da 5.07A o estabelecimento passa a ter cinco dígitos.

def temp-table tt_log_erros_renegoc no-undo

...

          tta_num_mensagem                 ascending.

Def temp-table tt_params_generic_api no-undo

    field ttv_rec_id                       as recid format ">>>>>>9"

    field ttv_cod_tabela                   as character format "x(28)" label "Tabela" column-label "Tabela"

    field ttv_cod_campo                    as character format "x(25)" label "Campo" column-label "Campo"

    field ttv_cod_valor                    as character format "x(8)" label "Valor" column-label "Valor"

    index tt_idx_param_generic             is primary unique

          ttv_cod_tabela                   ascending

          ttv_rec_id                       ascending

          ttv_cod_campo                    ascending.

REINF:

Processo Jurídico (REINF):

Para os títulos que possuem INSS estão marcados como Mão-de-Obra ou Empreitada é possível informar o valor de imposto não retido em virtude desse processo.

Informações necessárias:

- Valor não retido (val_nao_retid): Este campo é opcional. Quando ele não for informado as novas duplicatas geradas assumem as informações das duplicatas substituídas.

Valor Crédito INSS, Valor Base Cálculo INSS:

São informações gravadas na tabela de extensão do título do contas a receber (ext_tit_acr) no momento que são implantados os títulos e/ou alterados. Na rotina de renegociação, as novas duplicatas geradas assumem as informações das duplicatas substituídas. Porém, o usuário pode informar manualmente na renegociação o Valor de Crédito INSS, Valor Base de Cálculo INSS e Valor Não Retido que deseja, não assumindo então os valores das duplicatas substituídas. Para isso, é necessário criar a temp-table tt_params_generic_api que possuirão essas informações. 

Obs: salvar o campo ttv_rec_renegoc_acr_novo da temp-table tt_integr_acr_item_renegoc_new com o recid da própria temp-table para que seja possível utilizar na tt_params_generic_api.

 tt_integr_acr_item_renegoc_new.ttv_rec_renegoc_acr_novo = recid(tt_integr_acr_item_renegoc_new).

Exemplo Criação temp-table tt_params_generic_api para campo Valor de Crédito INSS:

create tt_params_generic_api.

assign tt_params_generic_api.ttv_rec_id     = tt_integr_acr_item_renegoc_new.ttv_rec_renegoc_acr_novo

       tt_params_generic_api.ttv_cod_campo  = 'val_cr_inss':U

       tt_params_generic_api.ttv_cod_tabela = 'tt_integr_acr_item_renegoc_new':U

       tt_params_generic_api.ttv_cod_valor  = '885.78'.

Exemplo Criação temp-table tt_params_generic_api para campo Base de Cálculo INSS:

create tt_params_generic_api.
assign tt_params_generic_api.ttv_rec_id = tt_integr_acr_item_renegoc_new.ttv_rec_renegoc_acr_novo

            tt_params_generic_api.ttv_cod_campo = 'val_base_calc_inss':U

            tt_params_generic_api.ttv_cod_tabela = 'tt_integr_acr_item_renegoc_new':U

            tt_params_generic_api.ttv_cod_valor = '6500'.

Exemplo Criação temp-table tt_params_generic_api para campo Valor Não Retido:

create tt_params_generic_api.
assign tt_params_generic_api.ttv_rec_id = tt_integr_acr_item_renegoc_new.ttv_rec_renegoc_acr_novo

            tt_params_generic_api.ttv_cod_campo = 'val_nao_retid':U

            tt_params_generic_api.ttv_cod_tabela = 'tt_integr_acr_item_renegoc_new':U

            tt_params_generic_api.ttv_cod_valor = '5500'.

Obs. Campo utilizado para o REINF.