Histórico da Página
...
(*) 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"
&IF "{&emsfin_version}" >= "" AND "{&emsfin_version}" < "5.07A" &THEN
field tta_cod_estab as character format "x(3)" label "Estabelecimento" column-label "Estab"
&ENDIF
| Nota | ||
|---|---|---|
| ||
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 integer format "9999999999" initial 0 label "num_id_tit_acr as integer format "9999999999" initial 0 label "Token Cta Receber" column-label "Token Cta Receber"
...
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"
...
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.
_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 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 = 'numcod_tip_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':UU
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 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':U
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)..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 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 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
_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.- 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 temp-table de Título de Alteração)
tt_params_generic_api.ttv_cod_tabela = 'tt_alter_tit_acr_base_5_5':U
tt_params_generic_api.ttv_cod_campo = 'v_des_url_localiz_json':U
tt_params_generic_api.ttv_cod_campo = 'v_dsl_pix_link':Uvalor = char(100).
E no campo tt_params_generic_api_id.ttv_cod_valor indicar pix link 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 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_desdsl_urlemv_localiz_jsonqrcode':U.
E no campo tt_params_generic_api_id.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 bancoindicar 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 temp-table de Título de Alteração)
tt tt_params_generic_api.ttv_cod_tabela = 'tt_alter_tit_acr_base_5':U
tt
tt_params_generic_api.ttv_cod_campo = 'v_cod_dslcart_emvbcia_qrcodemov':U .E no campo tt_params_generic_api_id
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.
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas