Histórico da Página
Documento de API
Produto: | Datasul |
Ocorrência: | Documentação de API |
| Nome Físico | Prgfin/fgl/ |
| fgl900zo |
Objetivo
Atualizar o módulo de Contabilidade com Lotes de outros módulos, tanto através de arquivos ASCII quanto diretamente do módulo.
Funcionamento
Na forma padrão, realiza-se a a API é persistida em memória e posteriormente chamada através de um comando RUN normaluma PI, passando-se as temp-tables carregadas com as informações necessárias.
A sintaxe para a chamada da API é:
define variable v_hdl_api as handle no-undo.
def new shared stream s_1. /*USADO QUANDO EMITE RELATÓRIO É IGUAL A SIM*/
run prgfin/fgl/fgl900zlfgl900zo.py (Input 3,
Input “Aborta Tudo”,
Input yes,
Input 66,
Input “Apropriação”,
Input “Com Erro”,
Input yes,
Input yes,
persistent set v_hdl_api.
run pi_main_api input-output table tt_integr_lote_ctbl_1,
input-output table tt_integr_lancto_ctbl_1,
input-output table tt_integr_item_lancto_ctbl_1,
input-output table tt_integr_aprop_lancto_ctbl_1,
input-output table tt_integr_ctbl_valid_1).
- Os parâmetros de entrada são:
- Parâmetros:
- Número da versão de Integração (atualmente = 3)
- Tratamento do Erro
4.1. Aborta Lotes Errados
4.2. Aborta Tudo
- Emite Relatório
5.1. Indica se deve listar os erros ou apenas gravar na temp-table tt_integr_ctbl_valid
5.2. Quando igual yes, o programa chamador deverá abrir a stream “s_1” (ver definição no item “Como usuar”) onde será emitido o relatório
- Número de Linhas do relatório
6.1. Apenas quando emite relatório, senão deve ser igual a “no”
- Nível de Impressão
7.1. Indica até que nível deve ser impresso o relatório
7.2. Apropriação, Item, Lançamento ou Lote
- Impressão de Lotes
8.1. Indica o que deve ser impresso
8.2. Com Erro, Sem Erro, Todos ou Nenhum
- Lógico de Primeiro Lote Contábil
9.1. Deve ser usado quando estiver sendo integrado vários lotes contábeis ao mesmo tempo. No primeiro lote enviado deve vir igual a “yes” e os demais igual a “no”
- Lógico de Último Lote Contábil.
10.1.Deve ser usado quando estiver sendo integrado vários lotes contábeis ao mesmo tempo. No último lote enviado deve vir igual a “yes” e os demais igual a “no”
...
recebto_2 in v_hdl_api
(input 3,
input "Aborta Tudo",
input yes,
input 66,
input "Apropriação",
input "Com Erro",
input yes,
input yes,
input-output table tt_integr_lote_ctbl_new,
input-output table tt_integr_lancto_ctbl_new,
input-output table tt_integr_item_lancto_ctbl_new,
input-output table tt_integr_aprop_lancto_ctbl_new,
input-output table tt_integr_ctbl_valid_new,
input-output table tt_api_params_generic).
run pi_finalizar_fgl900zo in v_hdl_api.
delete procedure v_hdl_api.
OBS: Caso tenha migrado para base utilizando rowid e esteja utilizado uma versão inferior a 2 da API, deve ser definido a include abaixo:
/*-- Filtro RECID x ROWID Aplicado --*/
{include/i_fncrowid.i}
E todas variáveis do tipo RECID, devem serem definidas conforme o modelo abaixo:
field ttv_rec_integr_lote_ctbl as &IF "{&ROWID_READY}" = "YES" &THEN rowid &ELSE recid format ">>>>>>9" &ENDIF
Os parâmetros de entrada são:
Parâmetros:
- Número da versão de Integração (atualmente = 3)
- Tratamento do Erro
2.1. Aborta Lotes Errados
2.2. Aborta Tudo
- Emite Relatório
3.1. Indica se deve listar os erros ou apenas gravar na temp-table tt_integr_ctbl_valid
3.2. Quando igual yes, o programa chamador deverá abrir a stream “s_1” (ver definição no item “Como usuar”) onde será emitido o relatório
- Número de Linhas do relatório
4.1. Apenas quando emite relatório, senão deve ser igual a “no”
- Nível de Impressão
5.1. Indica até que nível deve ser impresso o relatório
5.2. Apropriação, Item, Lançamento ou Lote
- Impressão de Lotes
6.1. Indica o que deve ser impresso
6.2. Com Erro, Sem Erro, Todos ou Nenhum
- Lógico de Primeiro Lote Contábil
7.1. Deve ser usado quando estiver sendo integrado vários lotes contábeis ao mesmo tempo. No primeiro lote enviado deve vir igual a “yes” e os demais igual a “no”
- Lógico de Último Lote Contábil.
8.1. Deve ser usado quando estiver sendo integrado vários lotes contábeis ao mesmo tempo. No último lote enviado deve vir igual a “yes” e os demais igual a “no”
- Tabela Temporária com os dados do(s) Lote(s) à ser(em) gerado(s);
- Tabela Temporária com os dados do(s) Lançamento(s) à ser(em) gerado(s);
- Tabela Temporária com os dados do(s) Iten(s) à ser(em) gerado(s);
- Tabela Temporária com os dados da(s) Apropriaçõ(es) à ser(em) gerada(s);
- Tabela Temporária que conterá os possíveis erros da integração;
- Tabela Genérica contendo campos de entradas ou saídas que poderão estar relacionadas a qualquer uma das temp-tables acima citadas.
Tabelas Temporárias
Nos atributos das tabelas temporárias de entrada e saída:
1) Temp-table de Lotes Contábeis
Tabela Temporária | Descrição | Entrada/Saída |
tt_integr_lote_ctbl_new | Conterá a capa do lote; Não é obrigatório o número do lote, pois o programa de recebimento atribuirá o número de lote correto. | Entrada e Saída |
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
tta_cod_modul_dtsul | character | x(3) | Módulo |
| |
tta_num_lote_ctbl | Integer | >>>,>>>,>>9 | Lote Contábil | ||
tta_des_lote_ctbl | character | x(40) | Descrição Lote | ||
tta_cod_empresa | character | x(3) | Empresa | ||
tta_dat_lote_ctbl | date | 99/99/9999 | Data Lote Contábil | ||
ttv_ind_erro_valid | character | x(8) | |||
tta_log_integr_ctbl_online | logical | Sim/Não | Integração Online | ||
ttv_row_integr_lote_ctbl | rowid |
def temp-table tt_integr_lote_ctbl_new no-undo
field tta_cod_modul_dtsul as character format "x(3)" label "Módulo" column-label "Módulo"
field tta_num_lote_ctbl as integer format ">>>,>>>,>>9" initial 1 label "Lote Contábil" column-label "Lote Contábil"
field tta_des_lote_ctbl as character format "x(40)" label "Descrição Lote" column-label "Descrição Lote"
field tta_cod_empresa as character format "x(3)" label "Empresa" column-label "Empresa"
field tta_dat_lote_ctbl as date format "99/99/9999" initial today label "Data Lote Contábil" column-label "Data Lote Contábil"
field ttv_ind_erro_valid as character format "X(08)" initial "Não"
field tta_log_integr_ctbl_online as logical format "Sim/Não" initial no label "Integração Online" column-label "Integr Online"
field ttv_row_integr_lote_ctbl as rowid
index tt_rowid
ttv_row_integr_lote_ctbl ascending.
2) Temp-table de Lançamentos Contábeis
...
Tabelas Temporárias
Nos atributos das tabelas temporárias de entrada e saída:
1) Temp-table de Lotes Contábeis
|
Tabela Temporária | Descrição | Entrada/Saída |
tt_integr_ |
lancto_ctbl_ |
Conterá a capa do lote;
Não é obrigatório o número do lote, pois o programa de recebimento atribuirá o número de lote correto.new | Nível que agrupa os itens de lançamento (DB e CR) para um mesmo cenário e data. | Entrada e Saída |
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
tta_cod_ |
cenar_ |
ctbl | character | x( |
8) |
Cenário Contábil |
|
tta_ |
log_ |
lancto_ |
conver |
Integer
>>>,>>>,>>9
Lote Contábil
logical | Sim/Não | Lançamento Conversão |
tta_ |
log_lancto_apurac_restdo | logical | Sim/Não | Lançamento Apuração |
character
x(40)
Descrição Lote
tta_cod_ |
rat_ctbl | character | x( |
8) |
Empresa
Rateio Contábil | ||
tta_ |
num_ |
lancto_ctbl |
date
99/99/9999
Data Lote Contábil
integer | >>,>>>,>>9 | Lançamento Contábil | ||
ttv_ind_erro_valid | character | x(8) |
tta_ |
dat_ |
lancto_ctbl |
date |
Sim/Não
Integração Online
99/99/9999 | Data Lançamento | ||
ttv_row |
_integr_lote_ctbl |
recid
>>>>>>9
rowid | |||||
ttv_row_integr_lancto_ctbl | rowid |
def def temp-table tt_integr_lotelancto_ctbl_1 new no-undo
field tta_cod_modul_dtsul cenar_ctbl as character format "x(38)" label "MóduloCen rio Cont bil" column-label "MóduloCen rio Cont bil"
field tta_numlog_lote_ctbl lancto_conver as integer logical format ">>>,>>>,>>9Sim/N’o" initial 1 no label "Lote ContábilLan?amento Convers’o" column-label "Lote ContábilLan?to Conv"
field tta_log_deslancto_lote_ctbl apurac_restdo as character logical format "x(40)" label "Descrição LoteSim/N’o" initial no label "Lan?amento Apura?’o" column-label "Descrição LoteLancto Apura?’o"
field tta_cod_empresa rat_ctbl as character format "x(38)" label "EmpresaRateio Cont bil" column-label "EmpresaRateio"
field tta_datnum_lotelancto_ctbl as date format "99/99/9999" initial today label "Data Lote Contábil as integer format ">>,>>>,>>9" initial 10 label "Lan?amento Cont bil" column-label "Data Lote ContábilLan?amento Cont bil"
field ttv_ind_erro_valid as as character format "X(08)" initial "NãoN’o"
field tta_logdat_integrlancto_ctbl _online as logical date format "Sim99/99/Não9999" initial no ? label "Integração OnlineData Lan?amento" column-label "Integr OnlineData Lan?to"
field ttv_recrow_integr_lote_ctbl as recid format ">>>>>>9"
index tt_recid
ttv_rec_integr_lote_ctbl ascending
.
2) Temp-table de Lançamentos Contábeis
...
Tabela Temporária
...
Descrição
...
Entrada/Saída
...
as Rowid
field ttv_row_integr_lancto_ctbl
...
Nível que agrupa os itens de lançamento (DB e CR) para um mesmo cenário e data.
...
Entrada e Saída
as Rowid
index tt_id is primary unique
ttv_row_integr_lote_ctbl ascending
tta_num_lancto_ctbl ascending
index tt_rowid
ttv_row_integr_lancto_ctbl ascending
.
3) Temp-table de Itens de Lançamento Contábeis
Tabela Temporária | Descrição | Entrada/Saída |
tt_integr_item_lancto_ctbl_new | Devem conter os débitos e os créditos nas diversas contas contábeis, estabelecimento, centro de custo, unidade de negócio. | Entrada e Saída |
(*) A partir da 5.07A o estabelecimento passa a ter cinco dígitos.
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
tta_num_seq_lancto_ctbl | integer | >>>>9 | Sequência Lançamento | ||
tta_ind_natur_lancto_ctbl | character | x(2) | Natureza | ||
tta_cod_plano_cta_ctbl | character | x(8) | Plano Contas | ||
tta_cod_cta_ctbl | character | x(20) | Conta Contábil | ||
tta_cod_plano_ccusto | character | x(8) | Plano Centros Custo | ||
tta_cod_estab | character | x(3) / x(5)* | Estabelecimento | ||
tta_cod_unid_negoc | character | x(3) | Unidade Negócio | ||
tta_cod_histor_padr | character | x(8) | Histórico Padrão | ||
tta_des_histor_lancto_ctbl | character | x(2000) | Histórico Contábil | ||
tta_cod_espec_docto | character | x(3) | Espécie Documento | ||
tta_dat_docto | date | 99/99/9999 | Data Documento | ||
tta_des_docto | character | x(25) | Número Documento | ||
tta_cod_imagem | character | x(30) | Imagem | ||
tta_cod_indic_econ | character | x(8) | Moeda | ||
tta_dat_lancto_ctbl | date | 99/99/9999 | Data Lançamento | ||
tta_qtd_unid_lancto_ctbl | decimal | >>,>>>,>>9.99 | Quantidade | ||
tta_val_lancto_ctbl | decimal | >>>>>,>>>,>>9.99 | Valor Lançamento | ||
tta_num_seq_lancto_ctbl_cpart | integer | >>>9 | Sequência Contra-Partida | ||
ttv_ind_erro_valid | character | X(8) | |||
tta_cod_ccusto | character | x(11) | Centro Custo | ||
tta_cod_proj_financ | character | x(20) | Projeto | ||
ttv_row_integr_lancto_ctbl | rowid | ||||
ttv_row_integr_item_lancto_ctbl | rowid |
def temp-table tt_integr_item_lancto_ctbl_new no-undo
field
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
tta_cod_cenar_ctbl | character | x(8) | Cenário Contábil |
|
|
tta_log_lancto_conver | logical | Sim/Não | Lançamento Conversão |
|
|
tta_log_lancto_apurac_restdo | logical | Sim/Não | Lançamento Apuração |
|
|
tta_cod_rat_ctbl | character | x(8) | Rateio Contábil |
|
|
ttv_rec_integr_lote_ctbl | recid | >>>>>>9 |
|
|
|
tta_num_lancto_ctbl | integer | >>,>>>,>>9 | Lançamento Contábil |
|
|
ttv_ind_erro_valid | character | x(8) |
|
|
|
tta_dat_lancto_ctbl | date | 99/99/9999 | Data Lançamento |
|
|
ttv_rec_integr_lancto_ctbl | recid | >>>>>>9 |
|
|
|
def temp-table tt_integr_lancto_ctbl_1 no-undo
field tta_cod_cenar_ctbl as character format "x(8)" label "Cenário Contábil" column-label "Cenário Contábil"
field tta_log_lancto_conver as logical format "Sim/Não" initial no label "Lançamento Conversão" column-label "Lançto Conv"
field tta_log_lancto_apurac_restdo as logical format "Sim/Não" initial no label "Lançamento Apuração" column-label "Lancto Apuração"
field tta_cod_rat_ctbl as character format "x(8)" label "Rateio Contábil" column-label "Rateio"
field ttv_rec_integr_lote_ctbl as recid format ">>>>>>9"
field tta_num_lancto_ctbl as integer format ">>,>>>,>>9" initial 10 label "Lançamento Contábil" column-label "Lançamento Contábil"
field ttv_ind_erro_valid as character format "X(08)" initial "Não"
field tta_dat_lancto_ctbl as date format "99/99/9999" initial ? label "Data Lançamento" column-label "Data Lançto"
field ttv_rec_integr_lancto_ctbl as recid format ">>>>>>9"
index tt_id is primary unique
ttv_rec_integr_lote_ctbl ascending
tta_num_lancto_ctbl ascending
index tt_recid
ttv_rec_integr_lancto_ctbl ascending
.
3) Temp-table de Itens de Lançamento Contábeis
Tabela Temporária | Descrição | Entrada/Saída |
tt_integr_item_lancto_ctbl_1 | Devem conter os débitos e os créditos nas diversas contas contábeis, estabelecimento, centro de custo, unidade de negócio. | Entrada e Saída |
...
Atributo
...
Tipo
...
Formato
...
Descrição
...
Obrigatório
...
Evolução
...
ttv_rec_integr_lancto_ctbl
...
recid
...
>>>>>>9
...
...
...
tta_num_seq_lancto_ctbl
...
integer
...
>>>>9
...
Sequência Lançto
...
...
as integer format ">>>>9" initial 0 label "Sequ?ncia Lan?to" column-label "Sequ?ncia Lan?to"
field tta_ind_natur_lancto_ctbl
...
character
...
x(2)
...
Natureza
...
...
as character format "X(02)" initial "DB" label "Natureza" column-label "Natureza"
field tta_cod_plano_cta_ctbl
...
character
as character format "x(8)
...
" label "Plano Contas" column-label "Plano Contas"
...
...
field tta_cod_cta_ctbl
...
character
...
x(20)
...
Conta Contábil
...
...
as character format "x(20)" label "Conta Cont bil" column-label "Conta Cont bil"
field tta_cod_plano_ccusto
...
character
as character format "x(8)
...
" label "Plano Centros Custo" column-label "Plano Centros Custo"
...
...
field tta_cod_estab
...
character
as character format "x(
...
5)
...
" label "Estabelecimento" column-label "Estab"
...
...
field tta_cod_unid_
...
character
...
negoc as character format "x(3)
...
" label "Unid Neg½cio" column-label "Un Neg"
...
...
field tta_cod_histor_padr
...
character
as character format "x(8)
...
Histórico Padrão
...
...
" label "Hist½rico Padr’o" column-label "Hist½rico Padr’o"
field tta_des_histor_lancto_ctbl
...
character
...
x(2000)
...
Histórico Contábil
...
...
as character format "x(2000)" label "Hist½rico Cont bil" column-label "Hist½rico Cont bil"
field tta_cod_espec_docto
...
character
...
as character format "x(3)
...
" label "Esp?cie Documento" column-label "Esp?cie"
...
...
field tta_dat_docto
...
date
as date format "99/99/
...
9999" initial ? label "Data Documento" column-label "Data Documento"
...
...
field tta_des_docto
...
character
...
as character format "x(25)
...
" label "Nœmero Documento" column-label "Nœmero Documento"
...
...
field tta_cod_imagem
...
character
...
as character format "x(30)
...
" label "Imagem" column-label "Imagem"
...
...
field tta_cod_indic_econ
...
character
...
as character format "x(8)
...
" label "Moeda" column-label "Moeda"
...
...
field tta_dat_lancto_ctbl
...
date
as date format "99/99/9999
...
Data Lançamento
...
...
" initial ? label "Data Lan?amento" column-label "Data Lan?to"
field tta_qtd_unid_lancto_ctbl
...
decimal
as decimal format ">>,>>>,>>9
...
Quantidade
...
...
.99" decimals 2 initial 0 label "Quantidade" column-label "Quantidade"
field tta_val_lancto_ctbl
...
decimal
...
as decimal format ">>>,>>>,>>>,>>9.99
...
Valor Lançamento
...
...
" decimals 2 initial 0 label "Valor Lan?amento" column-label "Valor Lan?amento"
field tta_num_seq_lancto_ctbl_cpart
...
as integer
...
>>>9
...
Sequência CPartida
...
...
format ">>>9" initial 0 label "Sequ?ncia CPartida" column-label "Sequ?ncia CP"
field ttv_ind_erro_valid
...
character
as character format "X(
...
08)" initial "N’o"
...
...
field tta_cod_ccusto
...
character
as Character format "x(
...
20)" label "Centro Custo" column-label "Centro Custo"
...
...
field tta_cod_proj_financ
...
character
...
as character format "x(20)
...
" label "Projeto" column-label "Projeto"
...
...
field ttv_
...
row_integr
...
_lancto_ctbl
...
recid
...
...
>>>>>>9
as Rowid
...
def temp-table tt field ttv_row_integr_item_lancto_ctbl _1 no-undo
field ttv_rec_integr_lancto_ctbl as recid format ">>>>>>9"
field tta_num_seq_lancto_ctbl as Rowid
index tt_id as integer format ">>>>9" initial 0 label "Sequência Lançto" column-label "Sequência Lançto" field tta_ind_natur is primary unique
ttv_row_integr_lancto_ctbl as character format "X(02)" initial "DB" label "Natureza" column-label "Natureza" field tta_cod_plano_cta ascending
tta_num_seq_lancto_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_plano_ccusto as character format "x(8)" label "Plano Centros Custo" column-label "Plano Centros Custo"
field tta_cod_estab as character format "x(3)" label "Estabelecimento" column-label "Estab"
...
ascending
index tt_rowid
ttv_row_integr_item_lancto_ctbl ascending
.
4) Temp-table de Apropriações Contábeis
Tabela Temporária | Descrição | Entrada/Saída |
tt_integr_aprop_lancto_new | Devem conter as aberturas dos créditos ou débitos por finalidades econômicas. | Entrada e Saída |
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
tta_cod_finalid_econ | character | x(10) | Finalidade | ||
tta_cod_unid_negoc |
...
character | x(3) |
...
Unidade Negócio |
tta_cod_ |
...
plano_ccusto | character | x(8) | Plano Centros Custo | ||
tta_qtd_unid_lancto_ctbl | decimal | >>,>>>,>>9.99 | Quantidade | ||
tta_val_lancto_ctbl | decimal | >>>>>,>>>,>>9.99 | Valor Lançamento | ||
tta_num_id_aprop_lancto_ctbl | integer | 9999999999 | Apropriação Lançamento | ||
tta_dat_cotac_indic_econ | date | 99/99/9999 | Data Cotação | ||
tta_val_cotac_indic_econ | decimal | >>>>,>>9.9999999999 | Cotação | ||
ttv_ind_erro_valid | character | X(8) | |||
tta_ind_orig_val_lancto_ctbl | character | X(10) | Origem Valor | ||
tta_cod_ccusto | character | X(11) | Centro Custo | ||
ttv_row_integr_item_lancto_ctbl | rowid | ||||
ttv_row_integr_aprop_lancto_ctbl | rowid |
def temp-table tt_integr_aprop_lancto_new no-undo
field tta_cod_finalid_econ
field tta_des_histor_lancto_ctbl as character format "x(2000)" label "Histórico Contábil" column-label "Histórico Contábil"
field tta_cod_espec_docto as character format "x(3)" label "Espécie Documento" column-label "Espécie"
field tta_dat_docto as date format "99/99/9999" initial ? label "Data Documento" column-label "Data Documento"
field tta_des_docto as character format "x(25)" label "Número Documento" column-label "Número Documento"
field tta_cod_imagem as character format "x(30)" label "Imagem" column-label "Imagem"
field tta_cod_indic_econ as character format "x(8)" label "Moeda" column-label "Moeda"
field tta_dat_lancto_ctbl as date format "99/99/9999" initial ? label "Data Lançamento" column-label "Data Lançto"
field tta_qtd_unid_lancto_ctbl as decimal format ">>,>>>,>>9.99" decimals 2 initial 0 label "Quantidade" column-label "Quantidade"
field tta_val_lancto_ctbl as decimal character format ">>>>>,>>>,>>9.99" decimals 2 initial 0 label "Valor Lançamentox(10)" label "Finalidade" column-label "Valor LançamentoFinalidade"
field tta_numcod_seq_lancto_ctbl_cpart as integer format ">>>9" initial 0 label "Sequência CPartidaunid_negoc as character format "x(3)" label "Unid Neg½cio" column-label "Sequência CPUn Neg"
field ttvtta_indcod_erro_valid plano_ccusto as character format "Xx(088)" initial "Não" field tta_cod_ccusto label "Plano Centros Custo" column-label "Plano Centros Custo"
field tta_qtd_unid_lancto_ctbl as Character decimal format "x(11)" label "Centro Custo>>,>>>,>>9.99" decimals 2 initial 0 label "Quantidade" column-label "Centro CustoQuantidade"
field tta_cod_proj_financ val_lancto_ctbl as character decimal format "x(20)" label "Projeto>>>,>>>,>>>,>>9.99" decimals 2 initial 0 label "Valor Lan?amento" column-label "ProjetoValor Lan?amento"
field ttvtta_recnum_integrid_itemaprop_lancto_ctbl as recid format ">>>>>>9"
index tt_id is primary unique
ttv_rec_integr_lancto_ctbl ascending
tta_num_seq_lancto_ctbl ascending
index tt_recid
ttv_rec_integr_item_lancto_ctbl ascending
.
4) Temp-table de Apropriações Contábeis
Tabela Temporária | Descrição | Entrada/Saída |
tt_integr_aprop_lancto_ctbl_1 | Devem conter as aberturas dos créditos ou débitos por finalidades econômicas. | Entrada e Saída |
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
tta_cod_finalid_econ | character | x(10) | Finalidade |
|
|
tta_cod_unid_negoc | character | x(3) | Unid Negócio |
|
|
tta_cod_plano_ccusto | character | x(8) | Plano Centros Custo |
|
|
tta_qtd_unid_lancto_ctbl | decimal | >>,>>>,>>9.99 | Quantidade |
|
|
tta_val_lancto_ctbl | decimal | >>>>>,>>>,>>9.99 | Valor Lançamento |
|
|
tta_num_id_aprop_lancto_ctbl | integer | 9999999999 | Apropriacao Lançto |
|
|
ttv_rec_integr_item_lancto_ctbl | recid | >>>>>>9 |
|
|
|
tta_dat_cotac_indic_econ | date | 99/99/9999 | Data Cotação |
|
|
tta_val_cotac_indic_econ | decimal | >>>>,>>9.9999999999 | Cotação |
|
|
ttv_ind_erro_valid | character | X(8) |
|
|
|
tta_ind_orig_val_lancto_ctbl | character | X(10) | Origem Valor |
|
|
tta_cod_ccusto | character | X(11) | Centro Custo |
|
|
ttv_rec_integr_aprop_lancto_ctbl | recid | >>>>>>9 |
|
|
|
def temp-table tt_integr_aprop_lancto_ctbl_1 no-undo
field tta_cod_finalid_econ as character format "x(10)" label "Finalidade" column-label "Finalidade"
field tta_cod_unid_negoc as character format "x(3)" label "Unid Negócio" column-label "Un Neg"
field tta_cod_plano_ccusto as character format "x(8)" label "Plano Centros Custo" column-label "Plano Centros Custo"
field tta_qtd_unid_lancto_ctbl as decimal format ">>,>>>,>>9.99" decimals 2 initial 0 label "Quantidade" column-label "Quantidade"
field tta_val_lancto_ctbl as decimal format ">>>>>,>>>,>>9.99" decimals 2 initial 0 label "Valor Lançamento" column-label "Valor Lançamento"
field tta_num_id_aprop_lancto_ctbl as integer format "9999999999" initial 0 label "Apropriacao Lançto" column-label "Apropriacao Lançto"
field ttv_rec_integr_item_lancto_ctbl as recid format ">>>>>>9"
field tta_dat_cotac_indic_econ as date format "99/99/9999" initial ? label "Data Cotação" column-label "Data Cotação"
field tta_val_cotac_indic_econ as decimal format ">>>>,>>9.9999999999" decimals 10 initial 0 label "Cotação" column-label "Cotação"
as integer format "999999999" initial 0 label "Apropriacao Lan?to" column-label "Apropriacao Lan?to"
field tta_dat_cotac_indic_econ as date format "99/99/9999" initial ? label "Data Cota?’o" column-label "Data Cota?’o"
field tta_val_cotac_indic_econ as decimal format ">>>>,>>9.9999999999" decimals 10 initial 0 label "Cota?’o" column-label "Cota?’o"
field ttv_ind_erro_valid as character format "X(08)" initial "N’o"
field tta_ind_orig_val_lancto_ctbl as character format "X(10)" initial "Informado" label "Origem Valor" column-label "Origem Valor"
field tta_cod_ccusto as Character format "x(20)" label "Centro Custo" column-label "Centro Custo"
field ttv_row_integr_item_lancto_ctbl as Rowid
field ttv_row_integr_aprop_lancto_ctbl as Rowid
index tt_id is primary unique
ttv_row_integr_item_lancto_ctbl ascending
tta_cod_finalid_econ ascending
tta_cod_unid_negoc ascending
tta_cod_plano_ccusto ascending
tta_cod_ccusto ascending
index tt_rowid
ttv_row_integr_aprop_lancto_ctbl ascending
.
5) Temp-table com os Erros da Integração
Tabela Temporária | Descrição | Entrada/Saída |
tt_integr_ctbl_valid_new | Tabela com erros | Entrada e Saída |
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
ttv_num_mensagem | integer | >>>>,>>9 | Número Mensagem | ||
ttv_ind_pos_erro | character | X(8) | Posição | ||
ttv_row_integr_ctbl | rowid |
def temp-table tt_integr_ctbl_valid_new no-undo
field ttv_num_mensagem as integer format ">>>>,>>9" label "Nœmero" column-label "Nœmero Mensagem"
field ttv_ind_pos_erro as character format "X(08)" label "Posi?’o"
field ttv_row_integr_ctbl as Rowid
index tt_id is primary unique
ttv_row_integr_ctbl ascending
ttv_num_mensagem ascending
.
6) Temp-table genérica para passagem de campos relacionadas a qualquer uma das temp-tables acima, utilizada para evitar que a API em questão tenha novas evoluções caso campos novos sejam necessários.
Tabela Temporária | Descrição | Entrada/Saída |
tt_api_params_generic | Tabela genérica de campos | Entrada e Saída |
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
ttv_row_id | character | x(80) | RowId de outro registro de temp-table que está relacionada | ||
ttv_cod_tabela | character | x(28) | Nome da tabela relacionada | ||
ttv_cod_campo | character | x(35) | Nome do campo a ser passado | ||
ttv_cod_valor | character | x(8) | Valor do campo, sempre deverá ser convertido para Character. |
def temp-table tt_api_params_generic no-undo
field ttv_cod_row_id field ttv_ind_erro_valid as character format "Xx(0880)" initial "Não"
field tta_ind_orig_val_lancto_ctbl field ttv_cod_tabela as as character format "Xx(1028)" initial "Informado" label "Origem ValorTabela" column-label "Origem ValorTabela"
field ttattv_cod_ccusto campo as Character character format "x(1135)" label "Centro CustoCampo" column-label "Centro Custo"
field ttv_rec_integr_aprop_lancto_ctbl as recid format ">>>>>>9"
index tt_id Campo"
field ttv_cod_valor as character format "x(8)" label "Valor" column-label "Valor"
index tt_idx_param_generic is is primary unique
ttv_rec_integr_item_lancto_ctbl ascending
tta_cod_finalid_econ ttv_cod_tabela ascending tta_cod_unid_negoc ascending
ascending tta ttv_cod_planorow_ccusto id ascending ttaascending
ttv_cod_ccusto campo ascending
ascending
index tt_recid
ttv_rec_integr_aprop_lancto_ctbl ascending
.
5) Temp-table com os Erros da Integração
Tabela Temporária | Descrição | Entrada/Saída |
tt_integr_ctbl_valid_1 | Tabela com erros | Entrada e Saída |
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
ttv_rec_integr_ctbl | recid | >>>>>>9 |
|
|
|
ttv_num_mensagem | integer | >>>>,>>9 | Número Mensagem |
|
|
ttv_ind_pos_erro | character | X(8) | Posição |
|
|
def new shared temp-table tt_integr_ctbl_valid_1 no-undo
field ttv_rec_integr_ctbl as recid format ">>>>>>9"
field ttv_num_mensagem as integer format ">>>>,>>9" label "Número" column-label "Número Mensagem"
field ttv_ind_pos_erro as character format "X(08)" label "Posição"
index tt_id is primary unique
ttv_rec_integr_ctbl ascending
ttv_num_mensagem ascending
.
.
Lista de Campo(s) que a API fgl900zo processa e que podem ser passados como parâmetro através da tamp-table tt_params_generic_api:
Código do Participante: Relacionado a tabela Item Lançamento Contábil (tt_integr_item_lancto_ctbl_1). Na criação de cada registro da tabela tt_integr_item_lancto_ctbl_1, será adicionado um campo correspondente na tt_params_generic_api, somente caso seja necessário passar esta informação.
Exemplo:
create tt_api_params_generic .
assign tt_api_params_generic.ttv_row_id = tt_integr_item_lancto_ctbl_new.ttv_row_integr_item_lancto_ctbl
tt_api_params_generic.ttv_cod_tabela = 'tt_integr_item_lancto_ctbl':U
tt_api_params_generic.ttv_cod_campo = 'Participante':U
tt_api_params_generic.ttv_cod_valor = [Valor do Código do Participante em formato caracter].
Relacionamento entre as tabelas temporárias:
- TT_INTEGR_LOTE_CTBL_1 NEW
1 Armazenar no atributo ttv_recrow_integr_lote_ctbl o recidrowid(TT_INTEGR_LOTE_CTBL_1NEW)
- TT_INTEGR_LANCTO_CTBL_1 NEW
1 Armazenar no atributo ttv_recrow_integr_lote_ctbl o recidrowid(TT_INTEGR_LOTE_CTBL_1NEW)
2 Armazenar no atributo ttv_recrow_integr_lancto_ctbl o recidrowid(TT_INTEGR_LANCTO_CTBL_1NEW)
- TT_INTEGR_ITEM_LANCTO_CTBL_1 NEW
1 Armazenar no atributo ttv_recrow_integr_lancto_ctbl o recidrowid(TT_INTEGR_LANCTO_CTBL_1NEW)
2 Armazenar no atributo ttv_recrow_integr_item_lancto_ctbl o recidrowid(TT_INTEGR_ITEM_LANCTO_CTBL_1NEW)
- TT_INTEGR_APROP_LANCTO_CTBL_1 NEW
1 Armazenar no atributo ttv_recrow_integr_item_lancto_ctbl o recidrowid(TT_INTEGR_ITEM_LANCTO_CTBL_1NEW)
2 Armazenar no atributo ttv_recrow_integr_aprop_lancto_ctbl o recidrowid(TT_INTEGR_APROP_LANCTO_CTBL_1NEW)
Observações:
- Se o atributo tt_integr_lote_ctbl.ttv_ind_erro_valid = “Não”, o lote está na contabilidade do EMS 5.0;
- Senão o lote apresentou inconsistência, que podem ser vistas no relatório (se impresso) ou nos registros da tabela temporária tt_integr_ctbl_valid_1new;
- Para que se tenha o rastreamento das apropriações geradas, a temp-table de apropriação retorna o atributo tta_num_id_aprop_lancto_ctbl com o valor do “token” da apropriação gerada na contabilidade; .