Á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"

&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
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&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':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':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.