Histórico da Página
Documento de API
Produto: | Datasul |
Ocorrência: | Documentação de API |
Nome Físico | prgfin/acr/acr711zv |
Objetivo
Efetuar a alteração dos títulos do contas a receber.
Parâmetro Entrada API Alteração Títulos/Contas a Receber:
...
tt_params_generic_api: Conterá campos novos das temp-tables passadas como parâmetro.
Funcionamento
Executar o programa API(utilizar o nome externo), da seguinte forma:
def var v_hdl_program as Handle no-undo.
run prgfin/acr/acr711zv.py persistent set v_hdl_program .
run pi_main_code_integr_acr_alter_tit_acr_novo_14 in v_hdl_program
...
Input table tt_params_generic_api).
Delete procedure v_hdl_program.
Tabelas Temporárias
Nos atributos das tabelas temporárias de entrada e saída:
Tabela Temporária | Descrição | Entrada/Saída |
tt_alter_tit_acr_base_5 | Conterá as informações do próprio título a serem atualizadas. | 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_num_id_tit_acr | integer | 9999999999 | Token Cta Receber |
tta_dat_transacao | date | 99/99/9999 | Data Transa‡Æo |
tta_cod_refer | character | x(10) | Referˆncia |
ttv_cod_motiv_movto_tit_acr_imp | character | x(8) | Motivo Impl |
tta_val_sdo_tit_acr | decimal | >>>,>>>,>>9.99 | Saldo T¡tulo |
ttv_cod_motiv_movto_tit_acr_alt | character | x(8) | Motivo Alter |
ttv_ind_motiv_acerto_val | character | X(12) | Motivo Acerto Valor |
tta_cod_portador | character | x(5) | Portador |
tta_cod_cart_bcia | character | x(3) | Carteira |
tta_val_despes_bcia | decimal | ->>>,>>>,>>9.99 | Vl Desp Banc |
tta_cod_agenc_cobr_bcia | character | x(10) | Agˆncia Cobran‡a |
tta_cod_tit_acr_bco | character | x(20) | Num T¡tulo Banco |
tta_dat_emis_docto | date | 99/99/9999 | Data EmissÆo |
tta_dat_vencto_tit_acr | date | 99/99/9999 | Vencimento |
tta_dat_prev_liquidac | date | 99/99/9999 | Prev Liquida‡Æo |
tta_dat_fluxo_tit_acr | date | 99/99/9999 | Fluxo |
tta_ind_sit_tit_acr | character | X(13) | Situa‡Æo T¡tulo |
tta_cod_cond_cobr | character | x(8) | Condi‡Æo Cobran‡a |
tta_log_tip_cr_perda_dedut_tit | logical | Sim/NÆo | Credito com Garantia |
tta_dat_abat_tit_acr | date | 99/99/9999 | Abat |
tta_val_perc_abat_acr | decimal | >>9.9999 | Perc Abatimento |
tta_val_abat_tit_acr | decimal | >>>>,>>>,>>9.99 | Vl Abatimento |
tta_dat_desconto | date | 99/99/9999 | Data Desconto |
tta_val_perc_desc | decimal | >9.9999 | Percentual Desconto |
tta_val_desc_tit_acr | decimal | >>>>,>>>,>>9.99 | Vl Desc |
tta_qtd_dias_carenc_juros_acr | decimal | >>9 | Dias Carenc Juros |
tta_val_perc_juros_dia_atraso | decimal | >9.999999 | Perc Jur Dia Atraso |
tta_qtd_dias_carenc_multa_acr | decimal | >>9 | Dias Carenc Multa |
tta_val_perc_multa_atraso | decimal | >9.99 | Perc Multa Atraso |
ttv_cod_portador_mov | character | x(5) | Portador Movto |
tta_ind_tip_cobr_acr | character | X(10) | Tipo Cobran‡a |
tta_ind_ender_cobr | character | X(15) | Endere‡o Cobran‡a |
tta_nom_abrev_contat | character | x(15) | Abreviado Contato |
tta_val_liq_tit_acr | decimal | >>>,>>>,>>9.99 | Vl L¡quido |
tta_cod_instruc_bcia_1_movto | character | x(4) | Instr Banc ria 1 |
tta_cod_instruc_bcia_2_movto | character | x(4) | Instr Banc ria 2 |
tta_log_tit_acr_destndo | logical | Sim/NÆo | Destinado |
tta_cod_histor_padr | character | x(8) | Hist¢rico PadrÆo |
ttv_des_text_histor | character | x(2000) | Hist¢rico |
tta_des_obs_cobr | character | x(40) | Obs Cobran‡a |
ttv_wgh_lista | widget-handle | >>>>>>9 |
tta_num_seq_tit_acr | integer | >>>9 | Sequˆncia |
ttv_cod_estab_planilha | character | x(3) / x(5)* |
ttv_num_planilha_vendor | integer | >>>,>>>,>>9 | Planilha Vendor |
ttv_cod_cond_pagto_vendor | character | x(3) | Condi‡Æo Pagto |
ttv_val_cotac_tax_vendor_clien | decimal | >>9.9999999999 | Taxa Vendor Cliente |
ttv_dat_base_fechto_vendor | date | 99/99/9999 | Data Base |
ttv_qti_dias_carenc_fechto | Integer | ->>9 | Dias Carˆncia |
ttv_log_assume_tax_bco | logical | Sim/NÆo | Assume Taxa Banco |
ttv_log_vendor | logical | Sim/NÆo |
tta_val_cr_pis | decimal | >>>,>>>,>>9.99 | Valor Cred PIS/PASEP |
tta_val_cr_cofins | decimal | >>>,>>>,>>9.99 | Valor Cr‚dito COFINS |
tta_val_cr_csll | decimal | >>>,>>>,>>9.99 | Valor Cr‚dito CSLL |
tta_val_base_calc_impto | decimal | >>>,>>>,>>9.99 | Base Calculo Impto |
tta_log_retenc_impto_impl | logical | Sim/NÆo | Ret Imposto Impl |
tta_cdn_repres | Integer | >>>,>>9 | Representante |
tta_cod_proces_export | character | X(12) | Código Processo Exportação |
tv_log_estorn_impto_retid | Logical | Sim/NÆo | Estorna Imposto Retido? |
...
def temp-table tt_alter_tit_acr_base_5 no-undo
...
tta_num_seq_tit_acr ascending.
Tabela Temporária | Descrição | Entrada/Saída |
tt_alter_tit_acr_cheq | Conterá as informações do rateio a serem atualizadas. | 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_num_id_tit_acr | integer | 9999999999 | Token Cta Receber |
tta_cod_banco | character | x(8) | Banco |
tta_cod_agenc_bcia | character | x(10) | Agˆncia Banc ria |
tta_cod_cta_corren_bco | character | x(20) | Conta Corrente Banco |
tta_num_cheque | integer | >>>>,>>>,>>9 | Num Cheque |
tta_dat_emis_cheq | date | 99/99/9999 | Data EmissÆo |
tta_dat_prev_apres_cheq_acr | date | 99/99/9999 | PrevisÆo Apresent |
tta_dat_prev_cr_cheq_acr | date | 99/99/9999 | PrevisÆo Cr‚dito |
tta_cod_id_feder | character | x(20) | ID Federal |
tta_nom_emit | character | x(40) | Nome Emitente |
tta_nom_cidad_emit | character | x(30) | Cidade Emitente |
tta_log_cheq_terc | logical | Sim/NÆo | Cheque Terceiro |
tta_cod_usuar_cheq_acr_terc | character | x(12) | Usu rio |
tta_ind_dest_cheq_acr | character | X(15) | Destino Cheque |
...
def temp-table tt_alter_tit_acr_cheq no-undo
...
tta_num_cheque ascending.
Tabela Temporária | Descrição | Entrada/Saída |
tt_alter_tit_acr_cobr_espec_2 |
Entrada |
...
(*) A partir da 5.07A o estabelecimento passa a ter cinco dígitos.
...
Atributo
...
Tipo
...
Formato
...
Descrição
...
Obrig.
...
Evol.
...
tta_cod_estab
...
...
(
...
Estabelecimento
...
...
**) Caso esteja alterando um título do Contas a Receber de tipo de cobrança normal para tipo de cobrança especial, deverá informar a sequência 0 (zero) no campo tt_alter_tit_acr_cobr_espec_2.tta_num_
...
seq_tit_acr
...
integer
...
9999999999
...
Token Cta Receber
...
...
...
. Caso esteja alterando um título do Contas a Receber já existente de cobrança especial, deverá informar a sequência já existente do título do Contas a Receber (exemplo: tit_acr_cobr_especial.num_seq_tit_acr).
Atributo |
Tipo |
Formato |
Descrição |
Obrig. |
Evol. |
tta_ |
cod_estab | character | x(3) / x(5)* | Estabelecimento | ||
tta_num_id_tit_acr | integer | 9999999999 | Token Cta Receber | ||
tta_num_seq_tit_acr | integer | >>>9 | Sequˆncia** | ||
tta_num_id_cobr_especial_acr | integer | 99999999 | Token Cobr Especial |
tta_val_tit_acr | decimal | >>>,>>>,>>9.99 | Valor |
tta_cod_portador | character | x(5) | Portador |
tta_cod_cart_bcia | character | x(3) | Carteira |
tta_cod_cartcred | character | x(20) | C¢digo CartÆo |
tta_cod_autoriz_cartao_cr | character | x(6) | C¢d Pr‚-Autoriza‡Æo |
tta_cod_mes_ano_valid_cartao | character | XX/XXXX | Validade CartÆo |
tta_dat_compra_cartao_cr | date | 99/99/9999 | Data Efetiv Venda |
tta_cod_banco | character | x(8) | Banco |
tta_cod_agenc_bcia | character | x(10) | Agˆncia Banc ria |
tta_cod_cta_corren_bco | character | x(20) | Conta Corrente Banco |
tta_cod_digito_cta_corren | character | x(2) | D¡gito Cta Corrente |
tta_num_ddd_localid_conces | integer | 999 | DDD |
tta_num_prefix_localid_conces | integer | >>>9 | Prefixo |
tta_num_milhar_localid_conces | integer | 9999 | Milhar |
tta_des_text_histor | character | x(2000) | Hist¢rico |
ttv_log_alter_tip_cobr_acr | logical | Sim/NÆo | Alter Tip Cobr |
tta_ind_sit_tit_cobr_especial | character | X(15) | Situa‡Æo T¡tulo |
ttv_cod_comprov_vda | character | x(12) | Comprovante Venda |
ttv_num_parc_cartcred | integer | >9 | Quantidade Parcelas |
ttv_val_tot_sdo_tit_acr | decimal | >>>,>>>,>>9.99 | Val Total Parcelas |
tta_cod_autoriz_bco_emissor | character | x(6) | Autorizacao Venda |
tta_cod_lote_origin | character | x(7) | Lote Orig Venda |
...
def temp-table tt_alter_tit_acr_cobr_espec_2 no-undo
...
tta_num_seq_tit_acr ascending.
Tabela Temporária | Descrição | Entrada/Saída |
tt_alter_tit_acr_comis_1 |
Entrada |
...
(*) A partir da 5.07A o estabelecimento passa a ter cinco dígitos.
Atributo | Tipo | Formato | Descrição | Obrig. | Evol. |
tta_cod_empresa | character | x(3) | Empresa |
tta_cod_estab | character | x(3) / x(5)* | Estabelecimento |
tta_num_id_tit_acr | integer | 9999999999 | Token Cta Receber |
ttv_num_tip_operac | integer | >9 |
tta_cdn_repres | Integer | >>>,>>9 | Representante |
tta_val_perc_comis_repres | decimal | >>9.9999 | % ComissÆo |
tta_val_perc_comis_repres_emis | decimal | >>9.99 | % Comis EmissÆo |
tta_val_perc_comis_abat | decimal | >>9.99 | % Comis Abatimento |
tta_val_perc_comis_desc | decimal | >>9.99 | % Comis Desconto |
tta_val_perc_comis_juros | decimal | >>9.99 | % Comis Juros |
tta_val_perc_comis_multa | decimal | >>9.99 | % Comis Multa |
tta_val_perc_comis_acerto_val | decimal | >>9.99 | % Comis AVA |
tta_log_comis_repres_proporc | logical | Sim/NÆo | Comis Proporcional |
tta_ind_tip_comis | character | X(15) | Tipo ComissÆo |
ttv_ind_tip_comis_ext | character | X(15) | Tipo de ComissÆo |
ttv_ind_liber_pagto_comis | character | X(20) | Lib Pagto Comis |
ttv_ind_sit_comis_ext | character | X(10) | Sit Comis Ext |
tta_val_base_calc_impto | decimal | >>>,>>>,>>9.99 | Base Calculo Impto |
Nota |
---|
...
|
def temp-table tt_alter_tit_acr_comis_1 no-undo
field tta_cod_empresa as character format "x(3)" label "Empresa" column-label "Empresa"
&IF "{&emsfin_version}" >= "" AND "{&emsfin_version}" < "5.07A" &THEN
field tta_cod_estab as character format "x(3)" label "Estabelecimento" column-label "Estab"
&ENDIF
| |
O campo ttv_num_tip_operac é utilizado para informar as operações permitidas pela API (0 para alteração, 1 para inclusão e 2 para exclusão) do movimento de comissões. Quando for utilizado a operação de Alteração, será permitido alterar a base de cálculo da comissão quando o Representante do Título estiver com a base de cálculo da comissão zerada. A regra de negócio deste campo utilizará o campo tipo de comissão tta_ind_tip_comis para definição do valor da base de cálculo da comissão: Se estiver informado Valor Bruto, irá utilizar o valor original do título do contas a receber. Se estiver Valor Liquido e informado o campo tta_val_base_calc_impto, irá utilizar o valor do campo tta_val_base_calc_impto. Se estiver Valor Liquido e informado o campo tta_val_base_calc_impto igual a zero, irá utilizar o o valor líquido do título do contas a receber. |
def temp-table tt_alter_tit_acr_comis_1 no-undo&IF "{&emsfin_version}" >= "5.07A" AND "{&emsfin_version}" < "9.99" &THEN
field tta_cod_estab empresa as Character character format "x(53)" label "EstabelecimentoEmpresa" column-label "EstabEmpresa"
&ENDIF&IF "{&emsfin_version}" >= "" AND "{&emsfin_version}" < "5.07A" &THEN
field tta_cod_estab as character format "x(3)" label "Estabelecimento" column-label "Estab"
&ENDIF
&IF "{&emsfin_version}" >= "5.07A" AND "{&emsfin_version}" < "9.99" &THEN
field tta_cod_estab as Character format "x(5)" label "Estabelecimento" column-label "Estab"
&ENDIF
field tta_num_id_tit_acr as num_id_tit_acr as integer format "9999999999" initial 0 label "Token Cta Receber" column-label "Token Cta Receber"
...
tta_num_id_tit_acr ascending.
Tabela Temporária | Descrição | Entrada/Saída |
tt_alter_tit_acr_impto_retid_2 | Conterá os dados do cheque a serem atualizados | 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_num_id_tit_acr | integer | 9999999999 | Token Cta Receber |
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_num_impto_refer_tit_acr | integer | >>>>>9 | Impto Refer |
ttv_num_tip_operac | integer | >9 |
tta_val_aliq_impto | decimal | >9.99 | Al¡quota |
tta_val_rendto_tribut | decimal | >,>>>,>>>,>>9.99 | Rendto Tribut vel |
def temp-table tt_alter_tit_acr_impto_retid_2 no-undo
...
tta_num_impto_refer_tit_acr ascending.
Tabela Temporária | Descrição | Entrada/Saída |
tt_alter_tit_acr_iva | Conterá os dados do IVA a serem atualizados | 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_num_id_tit_acr | integer | 9999999999 | Token Cta Receber |
tta_cod_refer | character | x(10) | Referˆncia |
tta_num_seq_refer | integer | >>>9 | Sequˆncia |
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_num_seq | integer | >>>,>>9 | Sequˆncia |
ttv_num_tip_operac | integer | >9 |
tta_val_rendto_tribut | decimal | >,>>>,>>>,>>9.99 | Rendto Tribut vel |
tta_val_aliq_impto | decimal | >9.99 | Al¡quota |
tta_val_imposto | decimal | >,>>>,>>>,>>9.99 | Valor Imposto |
...
def temp-table tt_alter_tit_acr_iva no-undo
...
tta_num_seq ascending.
Tabela Temporária | Descrição | Entrada/Saída |
tt_alter_tit_acr_ped_vda | Conterá os dados do Imposto Retido a serem atualizados | Entrada |
...
(*) A partir da 5.07A o estabelecimento passa a ter cinco dígitos.
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
tta_cod_estab | character | x(3) / x(5)* | Estabelecimento |
tta_num_id_tit_acr | integer | 9999999999 | Token Cta Receber |
ttv_num_tip_operac | integer | >9 |
tta_cod_ped_vda | character | x( |
15) | Pedido Venda |
tta_cod_ped_vda_repres | character | x( |
30) | Pedido Repres |
tta_val_perc_particip_ped_vda | decimal | >>9.99 | Particip Ped Vda |
tta_des_ped_vda | character | x(40) | Pedido Venda |
def temp-table tt_alter_tit_acr_ped_vda no-undo
...
field tta_cod_ped_vda as character format "x(1215)" label "Pedido Venda" column-label "Pedido Venda"
field tta_cod_ped_vda_repres as character format "x(1230)" label "Pedido Repres" column-label "Pedido Repres"
...
tta_cod_ped_vda ascending.
...
Tabela Temporária | Descrição | Entrada/Saída |
tt_alter_tit_acr_rateio | Conterá os dados de Cobrança Especial a serem atualizados | Entrada |
...
(*) A partir da 5.07A o estabelecimento passa a ter cinco dígitos.
(**) Liberado o centro de custo com 20 posições, a partir de maio/2011.
Atributo | Tipo | Formato | Descrição | Obrig. | Evol. |
tta_cod_estab | character | x(3) / x(5)* | Estabelecimento |
tta_num_id_tit_acr | integer | 9999999999 | Token Cta Receber |
ttv_ind_tip_rat_tit_acr | character | X(12) | Tipo Rateio |
tta_cod_refer | character | x(10) | Referˆncia |
tta_num_seq_refer | integer | >>>9 | Sequˆncia |
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_num_seq_aprop_ctbl_pend_acr | integer | >>>9 | Seq Aprop Pend |
tta_val_aprop_ctbl | decimal | ->>>,>>>,>>9.99 | Valor Aprop Ctbl |
tta_log_impto_val_agreg | logical | Sim/NÆo | Impto Val Agreg |
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_dat_transacao | date | 99/99/9999 | Data Transa‡Æo |
tta_num_id_tit_acr | integer | 9999999999 | Token Cta Receber |
ttv_ind_tip_rat_tit_acr | character | X(12) | Tipo Rateio |
...
def temp-table tt_alter_tit_acr_rateio no-undo
...
field tta_log_impto_val_agreg as logical format "Sim/NÆo" initial no label "Impto Val Agreg" column-label "Imp Vl Agr"
field tta_cod_pais as character format "x(3)" label "Pa¡s" column-label "Pa¡s"
field tta_cod_unid_federac as character format "x(3)" label "Unidade Federa‡Æo" column-label "UF"
field tta_cod_imposto as character format "x(5)" label "Imposto" column-label "Imposto"
field tta_cod_classif_impto as character format "x(05)" initial "00000" label "Class Imposto" column-label "Class Imposto"
field tta_dat_transacao as date format "99/99/9999" initial today label "Data Transa‡Æo" column-label "Dat Transac"
index tt_relac_tit_acr
tta_cod_estab ascending
tta_num_id_tit_acr ascending.
Tabela Temporária | Descrição | Entrada/Saída |
tt_alter_tit_acr_rat_desp_rec | Conterá os dados de rateio de valores de receita/despesa a serem alterados | Entrada |
(*) A partir da 5.07A o estabelecimento passa a ter cinco dígitos.
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_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_tip_abat | character | x(8) | Tipo de Abatimento |
|
|
tta_val_perc_rat_ctbz | decimal | >>9.99 | Perc Rateio |
|
|
tta_ind_tip_aprop_recta_despes | character | x(20) | Tipo Apropria‡Æo |
|
|
tta_num_id_tit_acr | integer | 9999999999 | Token Cta Receber |
|
|
tta_num_id_aprop_despes_recta | integer | 9999999999 | Id Apropria‡Æo |
|
|
tta_cod_tip_fluxo_financ | character | x(12) | Tipo Fluxo Financ |
|
|
tta_cod_livre_1 | character | x(100) | Livre 1 |
|
|
def temp-table tt_alter_tit_acr_rat_desp_rec no-undo
field tta_cod_empresa as character format "x(3)" label "Empresa" column-label "Empresa"
field tta_cod_estab as character format "x(5)" label "Estabelecimento" column-label "Estab"
field tta_cod_plano_cta_ctbl as character format "x(8)" label "Plano Contas" column-label "Plano Contas"
field tta_cod_cta_ctbl as character format "x(20)" label "Conta Cont bil" column-label "Conta Cont bil"
field tta_cod_unid_negoc as character format "x(3)" label "Unid Neg¢cio" column-label "Un Neg"
field tta_cod_tip_abat as character format "x(8)" label "Tipo de Abatimento" column-label "Tipo de Abatimento"
field tta_val_perc_rat_ctbz as decimal format ">>9.99" decimals 2 initial 0 label "Perc Rateio" column-label "% Rat"
field tta_ind_tip_aprop_recta_despes as character format "x(20)" label "Tipo Apropria‡Æo" column-label "Tipo Apropria‡Æo"
field tta_num_id_tit_acr as integer format "9999999999" initial 0 label "Token Cta Receber" column-label "Token Cta Receber"
field tta_num_id_aprop_despes_recta as integer format "9999999999" initial 0 label "Id Apropria‡Æo" column-label "Id Apropria‡Æo"
field tta_cod_tip_fluxo_financ as character format "x(12)" label "Tipo Fluxo Financ" column-label "Tipo Fluxo Financ"
field tta_cod_livre_1 as character format "x(100)" label "Livre 1" column-label "Livre 1"
index tt_aprpdspa_id is primary unique
tta_cod_estab ascending
tta_num_id_tit_acr ascending
tta_cod_plano_cta_ctbl ascending
tta_cod_cta_ctbl ascending
tta_cod_unid_negoc ascending
tta_cod_tip_fluxo_financ ascending
tta_num_id_aprop_despes_recta ascending
index tt_aprpdspa_token is unique
tta_cod_estab ascending
tta_num_id_aprop_despes_recta ascending.
Tabela Temporária | Descrição | Entrada/Saída |
tt_log_erros_alter_tit_acr | Retornara os erros que ocorreram no processamento | Saída |
Atributo | Tipo | Formato | Descrição | Obrig. | Evol. |
tta_cod_estab | character | x(5) | Estabelecimento |
|
|
tta_num_id_tit_acr | integer | 9999999999 | Token Cta Receber |
|
|
ttv_num_mensagem | integer | >>>>,>>9 | Número Mensagem |
|
|
ttv_cod_tip_msg_dwb | character | x(12) | Tipo Mensagem |
|
|
ttv_des_msg_erro | character | x(60) | Mensagem Erro |
|
|
ttv_des_msg_ajuda | character | x(40) | Mensagem Ajuda |
|
|
ttv_wgh_focus | widget-handle | >>>>>>9 |
|
|
|
def temp-table tt_log_erros_alter_tit_acr no-undo
field tta_cod_estab as character format "x(3)" label "Estabelecimento" column-label "Estab"
field tta_num_id_tit_acr as integer format "9999999999" initial 0 label "Token Cta Receber" column-label "Token Cta Receber"
field ttv_num_mensagem as integer format ">>>>,>>9" label "Número" column-label "Número Mensagem"
field ttv_cod_tip_msg_dwb as character format "x(12)" label "Tipo Mensagem" column-label "Tipo Mensagem"
field ttv_des_msg_erro as character format "x(60)" label "Mensagem Erro" column-label "Inconsistência"
field ttv_des_msg_ajuda as character format "x(40)" label "Mensagem Ajuda" column-label "Mensagem Ajuda"
field ttv_wgh_focus as widget-handle format ">>>>>>9"
index tt_relac_tit_acr
tta_cod_estab ascending
tta_num_id_tit_acr ascending
ttv_num_mensagem ascending.
Tabela Temporária | Descrição | Entrada/Saída |
tt_alter_tit_acr_cobr_esp_2_c | Conterá outras informações da cobrança especial a serem atualizadas. | Entrada |
Atributo | Tipo | Formato | Descrição | Obrig. | Evol. |
tta_cod_estab | character | x(5) | Estabelecimento |
|
|
tta_num_id_tit_acr | integer | 999999999 | Token Cta Receber |
|
|
tta_cod_admdra_cartao_cr | character | x(5) | Administradora |
|
|
tta_cod_band | character | x(10) | Bandeira |
|
|
tta_cod_tid | character | x(10) | TID |
|
|
tta_cod_terminal | character | x(8) | Nr Terminal |
|
|
def temp-table tt_alter_tit_acr_cobr_esp_2_c no-undo
field tta_cod_estab as Character format "x(5)" label "Estabelecimento" column-label "Estab"
field tta_num_id_tit_acr as integer format "999999999" initial 0 label "Token Cta Receber" column-label "Token Cta Receber"
field tta_cod_admdra_cartao_cr as character format "x(5)" label "Administradora" column-label "Administradora"
field tta_cod_band as character format "x(10)" label "Bandeira" column-label "Bandeira"
field tta_cod_tid as character format "x(10)" label "TID" column-label "TID"
field tta_cod_terminal as character format "x(8)" label "Nr Terminal" column-label "Nr Terminal".
Tabela Temporária | Descrição | Entrada/Saída |
tt_params_generic_api | Conterá campos novos das temp-tables passadas como parâmetro. | Input / Output |
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
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.
" column-label "Imp Vl Agr"
field tta_cod_pais as character format "x(3)" label "Pa¡s" column-label "Pa¡s"
field tta_cod_unid_federac as character format "x(3)" label "Unidade Federa‡Æo" column-label "UF"
field tta_cod_imposto as character format "x(5)" label "Imposto" column-label "Imposto"
field tta_cod_classif_impto as character format "x(05)" initial "00000" label "Class Imposto" column-label "Class Imposto"
field tta_dat_transacao as date format "99/99/9999" initial today label "Data Transa‡Æo" column-label "Dat Transac"
index tt_relac_tit_acr
tta_cod_estab ascending
tta_num_id_tit_acr ascending.
Tabela Temporária | Descrição | Entrada/Saída |
tt_alter_tit_acr_rat_desp_rec | Conterá os dados de rateio de valores de receita/despesa a serem alterados | Entrada |
(*) A partir da 5.07A o estabelecimento passa a ter cinco dígitos.
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_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_tip_abat | character | x(8) | Tipo de Abatimento | ||
tta_val_perc_rat_ctbz | decimal | >>9.99 | Perc Rateio | ||
tta_ind_tip_aprop_recta_despes | character | x(20) | Tipo Apropria‡Æo | ||
tta_num_id_tit_acr | integer | 9999999999 | Token Cta Receber | ||
tta_num_id_aprop_despes_recta | integer | 9999999999 | Id Apropria‡Æo | ||
tta_cod_tip_fluxo_financ | character | x(12) | Tipo Fluxo Financ | ||
tta_cod_livre_1 | character | x(100) | Livre 1 |
def temp-table tt_alter_tit_acr_rat_desp_rec no-undo
field tta_cod_empresa as character format "x(3)" label "Empresa" column-label "Empresa"
field tta_cod_estab as character format "x(5)" label "Estabelecimento" column-label "Estab"
field tta_cod_plano_cta_ctbl as character format "x(8)" label "Plano Contas" column-label "Plano Contas"
field tta_cod_cta_ctbl as character format "x(20)" label "Conta Cont bil" column-label "Conta Cont bil"
field tta_cod_unid_negoc as character format "x(3)" label "Unid Neg¢cio" column-label "Un Neg"
field tta_cod_tip_abat as character format "x(8)" label "Tipo de Abatimento" column-label "Tipo de Abatimento"
field tta_val_perc_rat_ctbz as decimal format ">>9.99" decimals 2 initial 0 label "Perc Rateio" column-label "% Rat"
field tta_ind_tip_aprop_recta_despes as character format "x(20)" label "Tipo Apropria‡Æo" column-label "Tipo Apropria‡Æo"
field tta_num_id_tit_acr as integer format "9999999999" initial 0 label "Token Cta Receber" column-label "Token Cta Receber"
field tta_num_id_aprop_despes_recta as integer format "9999999999" initial 0 label "Id Apropria‡Æo" column-label "Id Apropria‡Æo"
field tta_cod_tip_fluxo_financ as character format "x(12)" label "Tipo Fluxo Financ" column-label "Tipo Fluxo Financ"
field tta_cod_livre_1 as character format "x(100)" label "Livre 1" column-label "Livre 1"
index tt_aprpdspa_id is primary unique
tta_cod_estab ascending
tta_num_id_tit_acr ascending
tta_cod_plano_cta_ctbl ascending
tta_cod_cta_ctbl ascending
tta_cod_unid_negoc ascending
tta_cod_tip_fluxo_financ ascending
tta_num_id_aprop_despes_recta ascending
index tt_aprpdspa_token is unique
tta_cod_estab ascending
tta_num_id_aprop_despes_recta ascending.
Tabela Temporária | Descrição | Entrada/Saída |
tt_log_erros_alter_tit_acr | Retornara os erros que ocorreram no processamento | Saída |
Atributo | Tipo | Formato | Descrição | Obrig. | Evol. |
tta_cod_estab | character | x(5) | Estabelecimento | ||
tta_num_id_tit_acr | integer | 9999999999 | Token Cta Receber | ||
ttv_num_mensagem | integer | >>>>,>>9 | Número Mensagem | ||
ttv_cod_tip_msg_dwb | character | x(12) | Tipo Mensagem | ||
ttv_des_msg_erro | character | x(60) | Mensagem Erro | ||
ttv_des_msg_ajuda | character | x(40) | Mensagem Ajuda | ||
ttv_wgh_focus | widget-handle | >>>>>>9 |
def temp-table tt_log_erros_alter_tit_acr no-undo
field tta_cod_estab as character format "x(3)" label "Estabelecimento" column-label "Estab"
field tta_num_id_tit_acr as integer format "9999999999" initial 0 label "Token Cta Receber" column-label "Token Cta Receber"
field ttv_num_mensagem as integer format ">>>>,>>9" label "Número" column-label "Número Mensagem"
field ttv_cod_tip_msg_dwb as character format "x(12)" label "Tipo Mensagem" column-label "Tipo Mensagem"
field ttv_des_msg_erro as character format "x(60)" label "Mensagem Erro" column-label "Inconsistência"
field ttv_des_msg_ajuda as character format "x(40)" label "Mensagem Ajuda" column-label "Mensagem Ajuda"
field ttv_wgh_focus as widget-handle format ">>>>>>9"
index tt_relac_tit_acr
tta_cod_estab ascending
tta_num_id_tit_acr ascending
ttv_num_mensagem ascending.
Tabela Temporária | Descrição | Entrada/Saída |
tt_alter_tit_acr_cobr_esp_2_c | Conterá outras informações da cobrança especial a serem atualizadas. | Entrada |
Atributo | Tipo | Formato | Descrição | Obrig. | Evol. |
tta_cod_estab | character | x(5) | Estabelecimento | ||
tta_num_id_tit_acr | integer | 999999999 | Token Cta Receber | ||
tta_cod_admdra_cartao_cr | character | x(5) | Administradora | ||
tta_cod_band | character | x(10) | Bandeira | ||
tta_cod_tid | character | x(10) | TID | ||
tta_cod_terminal | character | x(8) | Nr Terminal |
def temp-table tt_alter_tit_acr_cobr_esp_2_c no-undo
field tta_cod_estab as Character format "x(5)" label "Estabelecimento" column-label "Estab"
field tta_num_id_tit_acr as integer format "999999999" initial 0 label "Token Cta Receber" column-label "Token Cta Receber"
field tta_cod_admdra_cartao_cr as character format "x(5)" label "Administradora" column-label "Administradora"
field tta_cod_band as character format "x(10)" label "Bandeira" column-label "Bandeira"
field tta_cod_tid as character format "x(10)" label "TID" column-label "TID"
field tta_cod_terminal as character format "x(8)" label "Nr Terminal" column-label "Nr Terminal".
Tabela Temporária | Descrição | Entrada/Saída |
tt_params_generic_api | Conterá campos novos das temp-tables passadas como parâmetro. | Input / Output |
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
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.
Exemplo Criação temp-table tt_params_generic_api para campo “val_perc_desc_antecip”:
create tt_params_generic_api.
assign tt_params_generic_api.ttv_rec_id = (Campo Recid da Tabela tit_acr)
tt_params_generic_api.ttv_cod_campo = '% Antecip':U
tt_params_generic_api.ttv_cod_tabela = 'tt_alter_tit_acr_base_5':U
tt_params_generic_api.ttv_cod_valor = (Valor Do % Dias Antecipado).
REINF:
Mão-de-Obra ou Empreitada (REINF):
Caso o título seja de um cliente do tipo Mão-de-Obra ou Empreitada será necessário informar alguns dados para o REINF. Para alterar essas informações através da API será necessário que o cliente do título esteja relacionado a uma pessoa jurídica e o tipo da espécie do título seja 'Normal' e a origem do título seja de implantação direto no módulo de Contas a Receber.
Informações necessárias:
- Mão de Obra ou Empreitada (log_mdo_emptda): Indica se o título representa um recebimento relacionado à mão-de-obra ou empreitada. Valores possíveis 'yes', 'no', 'sim' ou 'não'.
- Número do Tipo Serviço Mão-de-Obra (num_tip_serv_mdo ): Número corresponde ao tipo de serviço prestado. Esse campo é obrigatório caso o campo anterior seja 'yes' ou 'Sim'. O código deverá estar cadastrado no sistema na rotina Código de Serviço do INSS (CD1050).
- Tipo Inscrição Obra (num_tip_obra): Caso a obra esteja vinculada a um CNPJ deverá ser informado '1', caso esteja vinculada a um CNO deverá ser informado '4'.
- Código da Obra (cod_obra): Esse campo é opcional. Porém, caso informado deverá existir na rotina Códigos de obras (cd2023).
Processo Jurídico (REINF):
Para os títulos que possuem INSS estão marcados como Mão-de-Obra ou Empreitada é possível informar um processo jurídico e o valor de imposto não retido em virtude desse processo.
Informações necessárias:
- Número do Processo Jurídico (cod_process_judic): Esse campo é opcional. Porém, caso informado deverá existir no Cadastro de Processos (cd2021) e será necessário informar o valor não retido.
- Valor não retido (val_nao_retid): Este campo é opcional, quando informado será necessário informar o número do processo jurídico. Quando ele não for informado será calculado o valor não retido.
-INSS: Este campo é opcional no Contas a Receber. Caso informado o campo Base de Cálculo também deve ser informado.
-Base de Cálculo: Valor da Base de Cálculo do INSS. Este campo não é obrigatório.
Observação: Para todos campos valores da tabela temporária "tt_params_generic_api" ao informar valores com decimais a quebra deverá ser feita utilizando string(9.99).
Exemplo Criação temp-table tt_params_generic_api para campo Mão de Obra Empreitada:
create tt_params_generic_api.
assign tt_params_generic_api.ttv_rec_id = (Campo Recid da Tabela tit_acr)
tt_params_generic_api.ttv_cod_tabela = 'tt_alter_tit_acr_base_5':U
tt_params_generic_api.ttv_cod_campo = 'log_mdo_emptda':U
tt_params_generic_api.ttv_cod_valor = 'yes'.
Obs. Campo utilizado para o REINF.
Exemplo Criação temp-table tt_params_generic_api para campo Número Tipo Serviço Mão de Obra :
create tt_params_generic_api.
assign tt_params_generic_api.ttv_rec_id = (Campo Recid da Tabela tit_acr)
tt_params_generic_api.ttv_cod_tabela = 'tt_alter_tit_acr_base_5':U
tt_params_generic_api.ttv_cod_campo = 'num_tip_serv_mdo':U
tt_params_generic_api.ttv_cod_valor = '3'. /*deve existir no cd1050*/
Obs. Campo utilizado para o REINF.
Exemplo Criação temp-table tt_params_generic_api para campo Número Tipo Obra:
create tt_params_generic_api.
assign tt_params_generic_api.ttv_rec_id = (Campo Recid da Tabela tit_acr)
tt_params_generic_api.ttv_cod_tabela = 'tt_alter_tit_acr_base_5':U
tt_params_generic_api.ttv_cod_campo = 'num_tip_obra':U
tt_params_generic_api.ttv_cod_valor = '4'. /*válidos apenas 1 = CNPJ e 4 = CNO - caso não informar este campo o valor default assumido é 1*/
Obs. Campo utilizado para o REINF.
Exemplo Criação temp-table tt_params_generic_api para campo Código Obra:
create tt_params_generic_api.
assign tt_params_generic_api.ttv_rec_id = (Campo Recid da Tabela tit_acr)
tt_params_generic_api.ttv_cod_tabela = 'tt_alter_tit_acr_base_5':U
tt_params_generic_api.ttv_cod_campo = 'cod_obra':U
tt_params_generic_api.ttv_cod_valor = '12'. /*deve existir no cd2023*/
Obs. Campo utilizado para o REINF.
Exemplo Criação temp-table tt_params_generic_api para campo Código Processo Judicial:
create tt_params_generic_api.
assign tt_params_generic_api.ttv_rec_id = (Campo Recid da Tabela tit_acr)
tt_params_generic_api.ttv_cod_tabela ='tt_alter_tit_acr_base_5':U
tt_params_generic_api.ttv_cod_campo = 'cod_process_judic':U
tt_params_generic_api.ttv_cod_valor = '111222333'. /*deve existir no cd2021*/
Obs. Campo utilizado para o REINF.
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 = (Campo Recid da Tabela tit_acr)
tt_params_generic_api.ttv_cod_tabela = 'tt_alter_tit_acr_base_5':U
tt_params_generic_api.ttv_cod_campo = 'val_nao_retid':U
tt_params_generic_api.ttv_cod_valor = string(55.12).
Obs. Campo utilizado para o REINF.
Exemplo Criação temp-table tt_params_generic_api para campo Valor Base Cálculo INSS :
create tt_params_generic_api.
assign tt_params_generic_api.ttv_rec_id = (Campo Recid da Tabela tit_acr)
tt_params_generic_api.ttv_cod_tabela = 'tt_alter_tit_acr_base_5':U
tt_params_generic_api.ttv_cod_campo = 'val_base_calc_inss':U
tt_params_generic_api.ttv_cod_valor = string(6500.12).
Exemplo Criação temp-table tt_params_generic_api para campo Valor Crédito INSS:
create tt_params_generic_api.
assign tt_params_generic_api.ttv_rec_id = (Campo Recid da Tabela tit_acr)
tt_params_generic_api.ttv_cod_tabela = 'tt_alter_tit_acr_base_5':U
tt_params_generic_api.ttv_cod_campo = 'val_cr_inss':U
tt_params_generic_api.ttv_cod_valor = string(885.78).
PIX:
A modalidade de Cobrança PIX segundo os layouts dos bancos possuem informações diferentes da cobrança escritural normal e estas precisam estar disponíveis para alteração pelo usuário.
Informações necessárias:
- campo dsl_pix_link - Link gerado para pagamento do Qr Code estático ou dinâmico. Será retornado pelo Banco neste primeiro momento.
- campo des_url_loc_payload_json - URL presente no EMV do QR Code dinâmico e que contém os dados da cobrança
- campo dsl_emv_qr_code - EMV do QR Code dinâmico ou estático. Esse campo deve ser utilizado no processo de geração de imagem (base64).
Exemplo Criação temp-table tt_params_generic_api para campo Link:
create tt_params_generic_api.
assign tt_params_generic_api.ttv_rec_id = (Campo Recid da temp-table de Título de Alteração)
tt_params_generic_api.ttv_cod_tabela = 'tt_alter_tit_acr_base_5':U
tt_params_generic_api.ttv_cod_campo = 'v_dsl_pix_link':U.
E no campo tt_params_generic_api_id.ttv_cod_valor indicar pix link fornecido pelo banco.
Exemplo Criação temp-table tt_params_generic_api para campo URL :
create tt_params_generic_api.
assign tt_params_generic_api.ttv_rec_id = (Campo Recid da temp-table de Título de Alteração)
tt_params_generic_api.ttv_cod_tabela = 'tt_alter_tit_acr_base_5':U
tt_params_generic_api.ttv_cod_campo = 'v_des_url_localiz_json':U
tt_params_generic_api.ttv_cod_valor = char(100).
E no campo tt_params_generic_api_id.ttv_cod_valor indicar URL presente no EMV do QR Code fornecido pelo banco.
Exemplo Criação temp-table tt_params_generic_api para campo EMV:
create tt_params_generic_api.
assign tt_params_generic_api.ttv_rec_id = (Campo Recid da temp-table de Título de Alteração)
tt_params_generic_api.ttv_cod_tabela = 'tt_alter_tit_acr_base_5':U
tt_params_generic_api.ttv_cod_campo = 'v_dsl_emv_qrcode':U.
E no campo tt_params_generic_api_id.ttv_cod_valor indicar URL presente no EMV do QR Code fornecido pelo banco.
Alteração de Títulos de Antecipação - Função liberada a partir da 12.1.2301.
Para movimentos de Alteração de Valor a Menor ou Alteração de Valor a Maior será possível informar um portador e carteira do movimento.
A API foi preparada para receber os campos portador e carteira e gerar os valores no CMG quando informado um título de espécie de Antecipação.
Exemplo Criação temp-table tt_params_generic_api para campo Carteira MovExemplo Criação temp-table tt_params_generic_api para campo “val_perc_desc_antecip”:
create tt_params_generic_api .
assign tt_params_generic_api.ttv_rec_id id = (Campo Recid da Tabela tit_acr) tttemp-table de Título de Alteração)
tt_params_generic_api.ttv_cod_campo tabela = '% Anteciptt_alter_tit_acr_base_5':U tt
tt_params_generic_api.ttv_cod_tabela campo = 'ttv_altercod_titcart_acrbcia_base_5mov':U tt_params_generic_api.
Além disso, é necessário gravar o campo de portador de movto na tabela temporária:
...
- tt_alter_tit_acr_base_5.ttv_cod
...
- _portador_mov.