Histórico da Página
Documento de API
Produto: | Datasul |
Ocorrência: | Documentação de API |
Nome Físico | prgfin/apb/apb905zd |
Objetivo
Efetuar a implantação das Antecipações ou PEF Pendentes no Contas a Pagar.
Parâmetros de Entrada
num_vers_integr_api: será utilizado para determinar se o programa que está chamando está íntegro com as definições correntes da API;
...
run prgfin/apb/apb905zd.py persistent set v_hdl_aux.
run pi_main_block_antecip_pef_pend_5 in v_hdl_aux (Input 5,
...
A variável denominada v_hdl_aux irá receber o “handle” do programa, permitindo o acesso aos “métodos” internos da API.
Tabelas Temporárias
...
Tabela Temporária | Descrição | Entrada/Saída |
tt_integr_apb_antecip_pef_p1 | Conterá as informações das antecipações ou PEFs a serem integradas com o APB. | Entrada |
(*) A partir da 5.07A o estabelecimento passa a ter cinco dígitos.
(**) Liberado o número de documento com 16 posições e série com5, apartir de maio/2011.
Atributo | Tipo | Formato | Descrição | Obrig. | Evol. |
tta_cod_empresa | character | x(3) | Empresa |
tta_cod_estab | character | x(3) / x(5)* | Estabelecimento |
tta_cod_refer | character | x(10) | Referˆncia |
tta_cod_espec_docto | character | x(3) | Esp‚cie Documento |
tta_cod_ser_docto | character | x(3)/x(5)** | S‚rie Documento |
tta_cdn_fornecedor | Integer | >>>,>>>,>>9 | Fornecedor |
tta_cod_tit_ap | character | x(10)/x(16)** | T¡tulo |
tta_cod_parcela | character | x(02) | Parcela |
tta_cod_portador | character | x(5) | Portador |
tta_cod_indic_econ | character | x(8) | Moeda |
tta_num_talon_cheq | integer | >>>,>>>,>>9 | Talon rio Cheques |
tta_num_cheque | integer | >>>>,>>>,>>9 | Num Cheque |
tta_ind_favorec_cheq | character | X(15) | Favorecido |
tta_nom_favorec_cheq | character | x(40) | Nome Favorecido |
tta_val_tit_ap | decimal | ->>>,>>>,>>9.99 | Valor T¡tulo |
tta_val_cotac_indic_econ | decimal | >>>>,>>9.9999999999 | Cota‡Æo |
tta_dat_emis_docto | date | 99/99/9999 | Data EmissÆo |
tta_dat_vencto_tit_ap | date | 99/99/9999 | Data Vencimento |
tta_ind_tip_refer | character | X(22) | Tipo Referˆncia |
tta_cod_seguradora | character | x(8) | Seguradora |
tta_cod_apol_seguro | character | x(12) | Ap¢lice Seguro |
tta_cod_arrendador | character | x(6) | Arrendador |
tta_cod_contrat_leas | character | x(12) | Contrato Leasing |
tta_cod_histor_padr | character | x(8) | Hist¢rico PadrÆo |
tta_des_text_histor | character | x(2000) | Hist¢rico |
tta_ind_natur_cta_ctbl | character | X(08) | Natureza Cont bil |
tta_cod_usuar_gerac_movto | character | x(12) | Usuario Gerac Movto |
ttv_cod_empresa_ext | character | x(3) | C¢digo Empresa Ext |
tta_cod_estab_ext | character | x(8) | Estabelecimento Exte |
tta_cod_portad_ext | character | x(8) | Portador Externo |
tta_cod_modalid_ext | character | x(8) | Modalidade Externa |
ttv_rec_antecip_pef_pend | recid | >>>>>>9 |
tta_ind_origin_tit_ap | character | X(03) | Origem |
tta_cod_cart_bcia | character | x(3) | Carteira |
ttv_ind_tip_cod_barra | character | X(01) |
tta_cb4_tit_ap_bco_cobdor | Character | x(50) | Titulo Bco Cobrador |
tta_cod_tit_ap_bco_cobdor | character | x(20) | T¡tulo Banco Cobdor |
...
def temp-table tt_integr_apb_antecip_pef_p1 no-undo
...
ttv_rec_antecip_pef_pend ascending
.
Tabela Temporária | Descrição | Entrada/Saída |
tt_integr_apb_abat_prev_provis | Conterá as informações das previsões a serem abatidas. | Entrada |
...
(*) A partir da 5.07A o estabelecimento passa a ter cinco dígitos.
(**) Liberado o número de documento com 16 posições e série com5, apartir de maio/2011.
Atributo | Tipo | Formato | Descrição | Obrig. | Evol. |
ttv_rec_integr_apb_item_lote | recid | >>>>>>9 |
ttv_rec_antecip_pef_pend | recid | >>>>>>9 |
tta_cod_estab | character | x(3) / x(5)* | Estabelecimento |
tta_cod_espec_docto | character | x(3) | Esp‚cie Documento |
tta_cod_ser_docto | character | x(3)/x(5)** | S‚rie Documento |
tta_cdn_fornecedor | Integer | >>>,>>>,>>9 | Fornecedor |
tta_cod_tit_ap | character | x(10)/x(16)** | T¡tulo |
tta_cod_parcela | character | x(02) | Parcela |
tta_val_abat_tit_ap | decimal | ->>>,>>>,>>9.99 | Valor Abatimento |
ttv_rec_integr_apb_item_lote | recid | >>>>>>9 |
ttv_rec_antecip_pef_pend | recid | >>>>>>9 |
tta_cod_estab | character | x(3) / x(5)* | Estabelecimento |
tta_cod_espec_docto | character | x(3) | Esp‚cie Documento |
tta_cod_ser_docto | character | x(3)/x(5)** | S‚rie Documento |
tta_cdn_fornecedor | Integer | >>>,>>>,>>9 | Fornecedor |
tta_cod_tit_ap | character | x(10)/x(16)** | T¡tulo |
tta_cod_parcela | character | x(02) | Parcela |
tta_val_abat_tit_ap | decimal | ->>>,>>>,>>9.99 | Valor Abatimento |
def temp-table tt_integr_apb_abat_prev_provis no-undo
...
tta_cod_parcela ascending
.
Tabela Temporária | Descrição | Entrada/Saída |
tt_integr_apb_impto_impl_pend | Conterá as informações dos impostos utilizados pelas Antecipações ou PEF. | Entrada |
(**) Liberado o número de documento com 16 posições e série com5, apartir de maio/2011.
Atributo | Tipo | Formato | Descrição | Obrig. | Evol. |
ttv_rec_integr_apb_item_lote | recid | >>>>>>9 |
ttv_rec_antecip_pef_pend | recid | >>>>>>9 |
tta_cod_pais | character | x(3) | Pa¡s |
tta_cod_unid_federac | character | x(3) | Unidade Federa‡Æo |
tta_cod_imposto | character | x(5) | Imposto |
tta_cod_classif_impto | character | x(05) | Class Imposto |
tta_ind_clas_impto | character | X(14) | Classe Imposto |
tta_cod_plano_cta_ctbl | character | x(8) | Plano Contas |
tta_cod_cta_ctbl | character | x(20) | Conta Cont bil |
tta_cod_espec_docto | character | x(3) | Esp‚cie Documento |
tta_cod_ser_docto | character | x(3)/x(5)** | S‚rie Documento |
tta_cod_tit_ap | character | x(10)/x(16)** | T¡tulo |
tta_cod_parcela | character | x(02) | Parcela |
tta_val_rendto_tribut | decimal | >,>>>,>>>,>>9.99 | Rendto Tribut vel |
tta_val_deduc_inss | decimal | >,>>>,>>>,>>9.99 | Dedu‡Æo Inss |
tta_val_deduc_depend | decimal | >,>>>,>>>,>>9.99 | Dedu‡Æo Dependentes |
tta_val_deduc_pensao | decimal | >,>>>,>>>,>>9.99 | Deducao PensÆo |
tta_val_outras_deduc_impto | decimal | >,>>>,>>>,>>9.99 | Outras Dedu‡äes |
tta_val_base_liq_impto | decimal | >,>>>,>>>,>>9.99 | Base L¡quida Imposto |
tta_val_aliq_impto | decimal | >9.99 | Al¡quota |
tta_val_impto_ja_recolhid | decimal | >,>>>,>>>,>>9.99 | Imposto J Recolhido |
tta_val_imposto | decimal | >,>>>,>>>,>>9.99 | Valor Imposto |
tta_dat_vencto_tit_ap | date | 99/99/9999 | Data Vencimento |
tta_cod_indic_econ | character | x(8) | Moeda |
tta_val_impto_indic_econ_impto | decimal | ->>>,>>>,>>9.99 | Val Finalid Impto |
tta_des_text_histor | character | x(2000) | Hist¢rico |
tta_cdn_fornec_favorec | Integer | >>>,>>>,>>9 | Fornec Favorecido |
tta_val_deduc_faixa_impto | decimal | >,>>>,>>>,>>9.99 | Valor Deducao |
tta_num_id_tit_ap | integer | 1E+10 | Token Tit AP |
tta_num_id_movto_tit_ap | integer | 1E+10 | Token Movto Tit AP |
tta_num_id_movto_cta_corren | integer | 1E+10 | ID Movto Conta |
tta_cod_pais_ext | character | x(20) | Pa¡s Externo |
tta_cod_cta_ctbl_ext | character | x(20) | Conta Contab Extern |
tta_cod_sub_cta_ctbl_ext | character | x(15) | Sub Conta Externa |
ttv_cod_tip_fluxo_financ_ext | character | x(12) | Tipo Fluxo Financ |
tta_val_base_liq_impto | decimal | >,>>>,>>>,>>9.99 | Base L¡quida Imposto |
def temp-table tt_integr_apb_impto_impl_pend no-undo
...
tta_cod_classif_impto ascending
.
Tabela Temporária | Descrição | Entrada/Saída |
tt_integr_apb_aprop_ctbl_pend | Conterá as informações das Apropriações Contábeis utilizadas pelas Antecipações ou PEF. | Entrada |
(*) Liberado o centro de custo com 20 posições, a partir de maio/2011.
Atributo | Tipo | Formato | Descrição | Obrig. | Evol. |
ttv_rec_integr_apb_item_lote | recid | >>>>>>9 |
ttv_rec_antecip_pef_pend | recid | >>>>>>9 |
ttv_rec_integr_apb_impto_pend | recid | >>>>>>9 |
tta_cod_plano_cta_ctbl | character | x(8) | Plano Contas |
tta_cod_cta_ctbl | character | x(20) | Conta Cont bil |
tta_cod_unid_negoc | character | x(3) | Unid Neg¢cio |
tta_cod_plano_ccusto | character | x(8) | Plano Centros Custo |
tta_cod_ccusto | Character | x(11)/x(20)* | Centro Custo |
tta_cod_tip_fluxo_financ | character | x(12) | Tipo Fluxo Financ |
tta_val_aprop_ctbl | decimal | ->>>,>>>,>>9.99 | Valor Aprop Ctbl |
tta_cod_pais | character | x(3) | Pa¡s |
tta_cod_unid_federac | character | x(3) | Unidade Federa‡Æo |
tta_cod_imposto | character | x(5) | Imposto |
tta_cod_classif_impto | character | x(05) | Class Imposto |
ttv_cod_tip_fluxo_financ_ext | character | x(12) | Tipo Fluxo Financ |
tta_cod_cta_ctbl_ext | character | x(20) | Conta Contab Extern |
tta_cod_sub_cta_ctbl_ext | character | x(15) | Sub Conta Externa |
tta_cod_ccusto_ext | character | x(8)/x(20)* | Centro Custo Externo |
tta_cod_unid_negoc_ext | character | x(8) | Unid Neg¢cio Externa |
...
def temp-table tt_integr_apb_aprop_ctbl_pend no-undo
...
tta_cod_tip_fluxo_financ ascending
.
Tabela Temporária | Descrição | Entrada/Saída |
tt_log_erros_atualiz | Conterá as informações referentes aos erros encontrados durante as validações para a criação dos títulos. | Entrada |
...
(*) A partir da 5.07A o estabelecimento passa a ter cinco dígitos.
Atributo | Tipo | Formato | Descrição | Obrig. | Evol. |
tta_cod_estab | character | x(3) / x(5)* | Estabelecimento |
tta_cod_refer | character | x(10) | Referˆncia |
tta_num_seq_refer | integer | >>>9 | Sequˆncia |
ttv_num_mensagem | integer | >>>>,>>9 | N£mero |
ttv_des_msg_erro | character | x(60) | Mensagem Erro |
ttv_des_msg_ajuda | character | x(40) | Mensagem Ajuda |
ttv_ind_tip_relacto | character | X(15) | Tipo Relacionamento |
ttv_num_relacto | integer | >>>>,>>9 | Relacionamento |
def shared temp-table tt_log_erros_atualiz no-undo
...
field ttv_num_relacto as integer format ">>>>,>>9" label "Relacionamento" column-label "Relacionamento"
.
Tabela Temporária | Descrição | Entrada/Saída |
tt_1099 | Conterá os dados referentes aos impostos do tipo 1099, utilizado somente pelos clientes Datasul dos EUA. | Entrada |
Atributo | Tipo | Formato | Descrição | Obrig. | Evol. |
ttv_rec_table_parent | recid | >>>>>>9 |
ttv_val_1099 | decimal | ->>,>>>,>>>,>>9.99 | Valor |
tta_cod_tax_ident_number | character | x(15) | Tax Id Number |
tta_ind_tip_trans_1099 | character | x(50) | Tipo Transacao 1099 |
def temp-table tt_1099 no-undo
...
ttv_rec_table_parent ascending
.
Tabela Temporária | Descrição | Entrada/Saída |
tt_ord_compra_tit_ap_pend_1 | O dado para importação de Ordem Compra serão gravados nesta tabela | Entrada |
...
(*) A partir da 5.07A o estabelecimento passa a ter cinco dígitos.
Atributo | Tipo | Formato | Descrição | Obrig. | Evol. | |
tta_cod_estab | character | x(3) / x(5)* | Estabelecimento |
tta_cod_refer | character | x(10) | Referência |
tta_num_seq_refer | integer | >>>9 | Sequência |
tta_cod_ord_compra | character | x(8) | Ordem Compra |
tta_val_perc_ord_compra | decimal | >>9.99 | Perc Ordem Compra |
tta_val_origin_ord_compra | decimal | ->>,>>>,>>>,>>9.99 | Original Ordem Compr |
tta_val_sdo_ord_compra | decimal | ->>,>>>,>>>,>>9.99 | Saldo Ordem Compra |
...
def temp-table tt_ord_compra_tit_ap_pend_1 no-undo
...
tta_cod_ord_compra ascending
.
Tabela Temporária | Descrição | Entrada/Saída |
tt_params_generic_api | Conterá campos novos das temp-tables passadas como parâmetro. | Entrada / Saída |
Atributo | Tipo | Formato | Descrição | Obrig. | Evol. |
ttv_rec_id | recid | >>>>>>9 |
ttv_cod_tabela | character | X(28) | Tabela |
ttv_cod_campo | character | X(25) | Campo |
ttv_cod_valor | character | X(8) | Valor |
def temp-table tt_params_generic_api no-undo
...
ttv_cod_campo ascending
.
Exemplo Criação temp-table tt_params_generic_api:
...
tt_params_generic_api.ttv_cod_valor = (Valor Da Safra).
create tt_params_generic_api.
...
tt_params_generic_api.ttv_cod_valor = (Valor Do Contrato).
create tt_params_generic_api.
...
tt_params_generic_api.ttv_cod_valor = (Valor Do Zera Saldo).
Tratativa para permitir criar a pendência APF na execução da API
A rotina API de Antecipações/Pagamentos Extra-fornecedor Pendentes foi alterada para permitir criar a pendência APF quando o módulo APF ativo e estiver parametrizado com a opção "Geral' juntamente com a tabela de parâmetros tt_params_generic_api utilizando os campos 'Pendencia_APF' e valor 'SIM'. A pendência será criada conforme as demais regras de negócio do produto.
Deverá utilizar um novo parâmetro na tabela tt_params_generic_api para gerar a pendência para cada antecipação.
CREATE tt_params_generic_api.
ASSIGN tt_params_generic_api.ttv_rec_id = tt_integr_apb_antecip_pef_p1.ttv_rec_antecip_pef_pend /* (Campo Recid da temp-table) */
tt_params_generic_api.ttv_cod_campo = 'Pendencia_APF':U
tt_params_generic_api.ttv_cod_tabela = 'tt_integr_apb_antecip_pef_p1':U
tt_params_generic_api.ttv_cod_valor = 'SIM':U. /* Valor para criar a pendência */
Observação: O novo parâmetro será utilizado somente para o documento do tipo Antecipação, o módulo APF ativo e estiver parametrizada a Aprovação do Documento igual a "Geral".
A regra do negócio do produto com o parâmetro "Aprovação do Documento" igual a "Por Espécie" não foi alterado.
Tabela Temporária | Descrição | Entrada/Saída |
tt_ |
Tabela Temporária
Descrição
Entrada/Saída
docum_est_esoc_api | Conterá as informações do documento do ESocial. | Entrada |
...
Opções válidas para o campo “tta_cod_layout”: 1310, 1330, 1350 e 1370.
...
- tta_val_brut
- ttv_val_base_retenc
Quando o Layout for 1310 devem ser informados os valores para os campos abaixo:
...
- tta_ind_tip_inscr_cno
- tta_cod_num_inscr_cno
Quando o Layout for 1330 devem ser informados os valores para os campos abaixo:
...
- tta_cod_num_inscr_cno
- tta_ind_tip_inciden
Quando o Layout for 1350 devem ser informados os valores para os campos abaixo:
...
- tta_cod_num_proces_judic
Quando o Layout for 1370 devem ser informados os valores para os campos abaixo:
...
- tta_dat_repas
- tta_val_repas
Atributo | Tipo | Formato | Descrição | Obrig. | Evol. |
tta_cdd_num_docto_esoc | Decimal | >>>,>>>,>>>,>>>,>>9 | Documento eSocial |
ttv_num_origem | Integer | >9 | Origem Documento |
tta_cod_layout | Character | x(8) | Layout eSocial |
tta_cod_id_xml | Character | x(30) | Id Arquivo |
tta_cod_empresa | Integer | >>> | Código Empresa |
ttv_cod_estab | Character | x(5) | Código Estabelecimento |
tta_dat_transacao | Date | 99/99/9999 | Data Transação |
tta_cod_tit_ap | Character | x(16) | Código Título |
ttv_cod_emitente | Character | x(12) | Fornecedor |
tta_cod_ser_docto | Character | x(5) | Série documento |
tta_cod_docto | Character | x(16) | Nro Docto |
tta_cod_espec_docto | Character | !! | Espécie Documento |
tta_cod_natur_operac | Character | x(6) | Natureza de Operação |
tta_cod_parcela | Character | x(2) | Parcela |
tta_num_contrat_gfe | Integer | >>>>>>>>9 | Nr Contrato |
tta_num_roman | Integer | >,>>>,>>9 | Nr Romaneio |
tta_num_seq | Integer | >>>>9 | Nr Sequência |
tta_ind_tip_obra | Integer | 9 | Indicativo Obra |
tta_val_brut | Decimal | >>>,>>>,>>>,>>9.99 | Valor Bruto |
ttv_val_base_retenc | Decimal | >>>,>>>,>>>,>>9.99 | Valor Base Retenção |
tta_val_apurad | Decimal | >>>,>>>,>>>,>>9.99 | Valor Apurado |
tta_val_ret_subempr | Decimal | >>>,>>>,>>>,>>9.99 | Valor Retenção Subempreitada |
tta_val_retid | Decimal | >>>,>>>,>>>,>>9.99 | Valor Retenção |
tta_val_adic | Decimal | >>>,>>>,>>>,>>9.99 | Valor Adicional |
tta_val_tot_retid | Decimal | >>>,>>>,>>>,>>9.99 | Valor Total Retido |
tta_cdd_num_cno | Decimal | >>>>>>>>>>>9 | Nr Cadastro Nac Obras |
tta_ind_tip_inscr_cno | Integer | 9 | Tipo Proprietário |
tta_cod_num_inscr_cno | Character | X(19) | Proprietário CNO |
tta_val_serv_15 | Decimal | >>>,>>>,>>>,>>9.99 | Vlr Serviço 15 |
tta_val_serv_20 | Decimal | >>>,>>>,>>>,>>9.99 | Vlr Serviço 20 |
tta_val_serv_25 | Decimal | >>>,>>>,>>>,>>9.99 | Vlr Serviço 25 |
tta_cod_num_proces_judic | Character | x(20) | Nr Processo Judicial |
tta_val_nao_retid | Decimal | >>>,>>>,>>>,>>9.99 | Valor não Retido |
tta_val_mater_eqpto | Decimal | >>>,>>>,>>>,>>9.99 | Valor Materiais e Equipamentos |
tta_val_serv | Decimal | >>>,>>>,>>>,>>9.99 | Valor dos Servi‡os |
tta_val_deduc | Decimal | >>>,>>>,>>>,>>9.99 | Valor Dedução |
tta_val_base_cooperat | Decimal | >>>,>>>,>>>,>>9.99 | Valor Base Cooperativa |
tta_val_base_calc | Decimal | >>>,>>>,>>>,>>9.99 | Valor Base Cálculo |
tta_val_base_cooperat_15 | Decimal | >>>,>>>,>>>,>>9.99 | Valor Base Cooperativa 15 |
tta_val_base_cooperat_20 | Decimal | >>>,>>>,>>>,>>9.99 | Valor Base Cooperativa 20 |
tta_val_base_cooperat_25 | Decimal | >>>,>>>,>>>,>>9.99 | Valor Base Cooperativa 25 |
tta_ind_tip_inciden | Integer | 9 | Tipo Incidência |
tta_ind_tip_aquis | Integer | 9 | Tipo Aquisição |
tta_val_contrib_prev | Decimal | >>>,>>>,>>>,>>9.99 | Contribuição Prev |
tta_val_contrib_financ | Decimal | >>>,>>>,>>>,>>9.99 | Contribuição Financ |
tta_val_contrib_senar | Decimal | >>>,>>>,>>>,>>9.99 | Contribuicao Serviço Nac |
tta_ind_tip_repas | Integer | 9 | Tipo Repasse |
tta_dat_repas | Date | 99/99/9999 | Data Repasse |
tta_val_repas | Decimal | >>>,>>>,>>>,>>9.99 | Valor Repasse |
def temp-table tt_docum_est_esoc_api no-undo
...
field tta_val_repas as decimal format ">>>,>>>,>>>,>>9.99" decimals 2 initial 0 label "Valor Repasse" column-label "Vl Repasse"
.
Tabela Temporária | Descrição | Entrada/Saída |
tt_item_doc_est_esoc_api | Conterá as informações dos itens do documento do eSocial. | Entrada |
Atributo | Tipo | Formato | Descrição | Obrig. | Evol. |
tta_cdd_num_docto_esoc | Decimal | >>>,>>>,>>>,>>>,>>9 | Documento eSocial |
tta_num_seq_item | Integer | >>>>,>>9 | Seq Item |
tta_cdn_serv_inss | Integer | >9 | Cod Serv INSS |
tta_val_brut | Decimal | >>,>>>,>>>,>>>,>>9.99 | Valor Bruto |
ttv_val_base_retenc | Decimal | >>,>>>,>>>,>>>,>>9.99 | Valor Base Retenção |
...
def temp-table tt_item_doc_est_esoc_api no-undo
...