Histórico da Página
Documento de API
Produto: | Datasul |
Ocorrência: | Documentação de API |
Nome Físico | prgfin/apb/apb925za.py |
Objetivo
API para automatizar a substituição de notas por duplicatas, permitindo que sejam realizadas várias substituições ao mesmo tempo com as mesmas validações executadas pelo processo manual (on-line). Ou seja, efetuar a substituição de várias notas por uma única duplicata ou, substituir uma única nota em várias duplicatas em diferentes vencimentos de um mesmo fornecedor.
Parâmetros de Entrada
p_num_vers_integr_api : será utilizado para determinar se o programa que está chamando está íntegro com as definições correntes da API;
...
tt_params_generic_api: Conterá campos novos das temp-tables passadas como parâmetro.
Funcionamento
A sintaxe para executar a API/BO em modo persistente é:
...
A variável denominada v_hdl_apb925za irá receber o “handle” do programa, permitindo o acesso aos “métodos” internos da API.
Tabela Temporária
tt_integr_apb_lote_fatura_3 | Conterá as informações referentes aos lotes de Substituição da Nota Fiscal por Duplicata. | Entrada |
Atributo | Tipo | Formato | Descrição | Obrig. | Evol. |
tta_cod_estab | character | “x(3)” | Estabelecimento. |
|
|
tta_cod_refer | character | “x(10)” | Referência. |
|
|
tta_cod_espec_docto | character | “x(3)” | Espécie Documento. |
|
|
tta_dat_transacao | date | 99/99/9999 | Data de Transação. |
|
|
tta_ind_origin_tit_ap | character | “x(3)” | Indica Origem. Exemplo: “APB”. |
|
|
tta_cod_estab_ext | character | “x(8)” | Estabelecimento Externo. Não possui tratamento. |
|
|
tta_val_tot_lote_impl_tit_ap | decimal | ">>,>>>,>>>,>>9.99" | Valor Total do Movimento. |
|
|
tta_cod_empresa | character | “x(3)” | Empresa. |
|
|
ttv_cod_empresa_ext | character | “x(3)” | Empresa Externa. Não possui tratamento. |
|
|
tta_cod_finalid_econ_ext | character | “x(8)” | Finalidade Econômica Externa. Não possui tratamento. |
|
|
tta_cod_indic_econ | character | “x(8)” | Moeda. |
|
|
ttv_log_atualiza_refer_apb | logical | "Sim/Não" | Atualiza Referência. Se a Substituição deverá ser atualizada ou não. |
|
|
ttv_log_elimina_lote | logical | "Sim/Não" | Elimina Lote. Em caso de ser apresentado alguma validação, o lote será eliminado e não ficará pendente. |
|
|
tta_cdn_fornecedor | integer | ">>>,>>>,>>9" | Número Fornecedor. |
|
|
tta_num_fatur_ap | integer | ">>>>,>>>,>>9" | Número da Fatura. |
|
|
tta_qtd_parcela | decimal | "->9" | Quantidade de Parcelas. |
|
|
tta_cod_histor_padr | character | “x(8)” | Histórico Padrão. |
|
|
tta_cod_histor_padr_dupl | character | “x(8)” | Histórico Padrão da Duplicata. |
|
|
ttv_ind_matriz_fornec | character | “x(8)” | Permitirá ou não a seleção de títulos por Matriz. Exemplo: ‘Fornecedor’. |
|
|
ttv_rec_integr_apb_lote_impl | recid | ">>>>>>9" | Recid. Deverá ser informado: RECID(tt_integr_apb_lote_fatura_3). |
|
|
ttv_log_vinc_impto_auto | logical | "Sim/Não" | Vincula PIS/COFINS/CSLL automaticamente. |
|
|
ttv_log_fatur_emis_darf | logical | "Sim/Não" | Indica se a Fatura é de DARF DARF. |
|
|
ttv_log_fornec_dif | logical | "Sim/Não"Fornecedor Diferente | Indica se irá utilizar fornecedor diferente para as novas duplicatas |
Definição:
def temp-table tt_integr_apb_lote_fatura_3 no-undo
field tta_cod_estab as character format "x(3)" label "Estabelecimento" column-label "Estab"
...
Atributo | Tipo | Formato | Descrição | Obrig. | Evol. |
ttv_rec_integr_apb_lote_impl | recid | ">>>>>>9" | Identificador do lote. Receberá: tt_integr_apb_lote_fatura_3.ttv_rec_integr_apb_lote_impl. |
|
|
tta_num_seq_refer | integer | ">>>9" | Sequência. |
|
|
tta_cdn_fornecedor | Integer | “>>>,>>>,>>9” | Código do Fornecedor. Não receberá valor se for PEF ou Antecipação. |
|
|
tta_cod_ser_docto | character | “x(3”)/”x(5)”** | Código da Série Documento. Não receberá valor se for PEF ou Antecipação. |
|
|
tta_cod_tit_ap | character | “x(10)”/“x(16)”** | Código do Título. Não receberá valor se for PEF ou Antecipação. |
|
|
tta_cod_parcela | character | “x(02)” | Parcela. |
|
|
tta_dat_emis_docto | date | "99/99/9999" | Data de Emissão. |
|
|
tta_dat_vencto_tit_ap | date | "99/99/9999" | Data de Vencimento. |
|
|
tta_dat_prev_pagto | date | "99/99/9999" | Data Prevista de Pagamento. |
|
|
tta_dat_desconto | date | "99/99/9999" | Data de Desconto. |
|
|
tta_cod_indic_econ | character | "x(8)" | Moeda. |
|
|
tta_val_tit_ap | decimal | "->>>,>>>,>>9.99" | Valor do Título. |
|
|
tta_val_desconto | decimal | "->>>,>>>,>>9.99" | Valor de Desconto. |
|
|
tta_val_perc_desc | decimal | ">9.999999" | Percentual de Desconto. |
|
|
tta_num_dias_atraso | integer | ">9" | Dias de Atraso. |
|
|
tta_val_juros_dia_atraso | decimal | "->>>,>>>,>>9.99" | Valor de Juros. |
|
|
tta_val_perc_juros_dia_atraso | decimal | ">9.999999" | Percentual de Juros por Dia de Atraso. |
|
|
tta_val_perc_multa_atraso | decimal | ">9.99" | Percentual de Multa por Atraso. |
|
|
tta_cod_portador | character | "x(5)" | Portador. |
|
|
tta_cod_apol_seguro | character | "x(12)" | Apólice de Seguro. |
|
|
tta_cod_seguradora | character | "x(8)" | Seguradora. |
|
|
tta_cod_arrendador | character | "x(6)" | Arrendador. |
|
|
tta_cod_contrat_leas | character | "x(12)" | Contrato de Leasing. |
|
|
tta_des_text_histor | character | "x(2000)" | Histórico. |
|
|
tta_num_id_tit_ap | integer | "9999999999" | Identificador do Título. |
|
|
tta_num_id_movto_tit_ap | integer | "9999999999" | Identificador do Movimento do Título. |
|
|
tta_num_id_movto_cta_corren | integer | "9999999999" | Identificador do Movimento da Conta Corrente. |
|
|
ttv_qtd_parc_tit_ap | decimal | ">>9" | Quantidade de Parcelas. |
|
|
ttv_num_dias | integer | ">>>>,>>9" | Número de Dias. |
|
|
ttv_ind_vencto_previs | character | "x(4)" | Cálculo Vencimento. |
|
|
ttv_log_gerad | logical | "Sim/Não" | Gerado. |
|
|
tta_cod_finalid_econ_ext | character | "x(8)" | Finalidade Externa. |
|
|
tta_cod_portad_ext | character | "x(8)" | Portador Externo. |
|
|
tta_cod_modalid_ext | character | "x(8)" | Modalidade Externa. |
|
|
tta_cod_cart_bcia | character | "x(3)" | Carteira. |
|
|
tta_cod_forma_pagto | character | "x(3)" | Forma de Pagamento. |
|
|
tta_val_cotac_indic_econ | decimal | ">>>>,>>9.9999999999" | Cotação. |
|
|
ttv_num_ord_invest | integer | ">>>>>,>>9" | Ordem de Investimento. |
|
|
tta_cod_livre_1 | character | "x(100)" | Campo Livre. |
|
|
tta_cod_livre_2 | character | "x(100)" | Campo Livre. |
|
|
tta_dat_livre_1 | date | "99/99/9999" | Campo Livre. |
|
|
tta_dat_livre_2 | date | "99/99/9999" | Campo Livre. |
|
|
tta_log_livre_1 | logical | "Sim/Não" | Campo Livre. |
|
|
tta_log_livre_2 | logical | "Sim/Não" | Campo Livre. |
|
|
tta_num_livre_1 | integer | ">>>>>9" | Campo Livre. |
|
|
tta_num_livre_2 | integer | ">>>>>9" | Campo Livre. |
|
|
tta_val_livre_1 | decimal | ">>>,>>>,>>9.9999" | Campo Livre. |
|
|
tta_val_livre_2 | decimal | ">>>,>>>,>>9.9999" | Campo Livre. |
|
|
ttv_rec_integr_apb_item_lote | recid | ">>>>>>9" | Identificador do item. |
|
|
ttv_val_1099 | decimal | "->>,>>>,>>>,>>9.99" | Valor Imposto 1099 relacionado a localização EUA. |
|
|
tta_cod_tax_ident_number | character | "x(15)" | Tax Id Number. |
|
|
tta_ind_tip_trans_1099 | character | "x(50)" | Tipo Transação 1099. |
|
|
...
Atributo | Tipo | Formato | Descrição | Obrig. | Evol. |
ttv_rec_integr_apb_lote_impl | recid | ">>>>>>9" | Identificador do lote. Receberá: tt_integr_apb_lote_fatura_3.ttv_rec_integr_apb_lote_impl. |
|
|
tta_cod_estab_tit_ap_pai | character | "x(3)" | Estabelecimento do Título Pai. |
|
|
tta_cdn_fornec_pai | Integer | “>>>,>>>,>>9” | Código do Fornecedor do Título Pai. |
|
|
tta_cod_espec_docto_nf | character | "x(8)" | Espécie da Nota Fiscal. |
|
|
tta_cod_ser_docto_nf | character | "x(8)" | Série da Nota Fiscal. |
|
|
tta_cod_tit_ap | character | “x(10)” | Código do Título. |
|
|
tta_cod_parc_nf | character | “x(8)” | Parcela da Nota Fiscal. |
|
|
tta_ind_motiv_acerto_val | character | "x(12)" | Motivo do Acerto de Valor. |
|
|
ttv_log_bxo_estab_tit | logical | “Sim/Não” | Baixa no Estabelecimento do Título. |
|
|
...