Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin

...

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

(**) 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. 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



...

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

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"



Nota
titleNota:

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

    field tta_cod_empresa                  as character format "x(3)" label "Empresa" column-label "Empresa"

&IF "{&emsfin_version}" &IF "{&emsfin_version}" >= "" AND "{&emsfin_version}" < "5.07A" &THEN

...

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(1215)

Pedido Venda



tta_cod_ped_vda_repres

character

x(1230)

Pedido Repres



tta_val_perc_particip_ped_vda

decimal

>>9.99

Particip Ped Vda



tta_des_ped_vda

character

x(40)

Pedido Venda



...

    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"

...

-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.

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 REINFObservaçã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 Número Tipo Serviço 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 = 'lognum_tip_serv_mdo_emptda':U
tt_params_generic_api.ttv_cod_valor = 'yes3'. /*deve existir no cd1050*/

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_mdoobra':U
tt_params_generic_api.ttv_cod_valor = '34'. /*deve existir no cd1050vá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 Número Tipo 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 = 'num_tipcod_obra':U
tt_params_generic_api.ttv_cod_valor = '412'. /*válidos apenas 1 = CNPJ e 4 = CNO - caso não informar este campo o valor default assumido é 1deve existir no cd2023*/

Obs. Campo utilizado para o REINF.

...

Exemplo Criação temp-table tt_params_generic_api para campo Código ObraProcesso 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_obrajudic':U
tt_params_generic_api.ttv_cod_valor = '12111222333'. /*deve existir no cd2023cd2021*/

Obs. Campo utilizado para o REINF.

...

Exemplo Criação temp-table tt_params_generic_api para campo Código Processo JudicialValor 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 = 'codval_processnao_judicretid':U
tt_params_generic_api.ttv_cod_valor = '111222333'. /*deve existir no cd2021*/string(55.12).

Obs. Campo utilizado para o REINF.

...

Exemplo Criação temp-table tt_params_generic_api para campo Valor Não RetidoBase 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_naocalc_retidinss':U
tt_params_generic_api.ttv_cod_valor = string(556500.12).

Obs. Campo utilizado para o REINF.


Exemplo Criação temp-table tt_params_generic_api para campo Valor Base Cálculo 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_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). 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 INSSLink:

create tt_params_generic_api.
assign tt_params_generic_api.ttv_rec_id = (Campo Recid da Tabela tit_acrtemp-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 = '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 v_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

':U.

E no campo tt_params_generic_api_id.ttv_cod_valor indicar pix link fornecido pelo banco.- 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 Linkcampo URL :

create tt_params_generic_api.
assign tt_params_generic_api.ttv_rec_id = (Campo Recid da Tabela tit_acrtemp-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_dsldes_url_pixlocaliz_linkjson':U

tt_params_generic_api.ttv_cod_valor = char(100).

E no campo tt_params_generic_api_id.ttv_cod_valor = char(600)indicar URL presente no EMV do QR Code fornecido pelo banco.

Exemplo Criação temp-table tt_params_generic_api para campo URL campo EMV:

create tt_params_generic_api.
assign tt_params_generic_api.ttv_rec_id = (Campo Recid da Tabela tit_acrtemp-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_desdsl_urlemv_localiz_jsonqrcode':U.

E no campo tt_params_generic_api.ttv_cod_valor = char(100)._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 tttable tt_params_generic_api para api para campo EMV Carteira Mov:

create tt_params_generic_api .
assign tt_params_generic_api.ttv_rec_id     =   (Campo Recid da Tabela tit_acr)
tttemp-table de Título de Alteração)
           tt_params_generic_api.ttv_cod_tabela =   'tt_alter_tit_acr_base_5':U
tt                               
           tt_params_generic_api.ttv_cod_campo  = 'v_dslcod_cart_emvbcia_qrcodemov':U .

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.