Documento de API
Produto: | Datasul |
Ocorrência: | Documentação de API |
Nome Físico | Prgfin/fgl/fgl902zb |
Objetivo
Atualizar os valores de saldo realizado e saldo empenhado na tabela sdo_ctbl, utilizada a partir da release 5.05.
Funcionamento
Na forma padrão, realiza-se a chamada através de um comando RUN normal, passando-se as temp-tables carregadas com as informações necessárias.
A sintaxe para a chamada da API é:
run prgfin/fgl/fgl902zb.py (Input 1,
Input table tt_xml_input_1,
output table tt_log_erros).
Parâmetros API de Atualização de Saldos:
Os Parâmetros utilizados pelo programa estão listados abaixo, na ordem que se segue:
- num_vers_integr_api..: versão de Integração da API;
- tt_xml_input_1...........: tabela temporária que contém todos os dados necessários para que seja realizada a atualização na tabela de saldos;
- tt_log_erros................: Retorna para o usuário, as informações de erros ocorridos durante o processo de atualização de saldo.
Tabelas Temporárias
Nos atributos das tabelas temporárias de entrada e saída:
1) Conterá as faixas de dados:
Tabela Temporária | Descrição | Entrada/Saída |
tt_xml_input_1 | Conterá as faixas de dados. | Entrada |
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
ttv_cod_label | character | x(8) | Label |
|
|
ttv_des_conteudo | character | x(40) | Texto |
|
|
ttv_num_seq_1 | integer | >>>,>>9 |
|
|
|
ttv_num_seq_2 | integer | >>>>,>>9 |
|
|
|
def temp-table tt_xml_input_1 no-undo
field ttv_cod_label as character format "x(8)" label "Label" column-label "Label"
field ttv_des_conteudo as character format "x(40)" label "Texto" column-label "Texto"
field ttv_num_seq_1 as integer format ">>>,>>9"
field ttv_num_seq_2 as integer format ">>>>,>>9"
.
2) Temp-table de erros:
Tabela Temporária | Descrição | Entrada/Saída |
tt_log_erros | Conterá a lista de erros encontrados durante a leitura de saldos. | Saída |
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
ttv_num_seq | integer | >>>,>>9 | Seqüência |
|
|
ttv_num_cod_erro | integer | >>>>,>>9 | Número |
|
|
ttv_des_erro | character | x(50) | Inconsistência |
|
|
ttv_des_ajuda | character | x(50) | Ajuda |
|
|
def temp-table tt_log_erros no-undo
field ttv_num_seq as integer format ">>>,>>9" label "Seqüência" column-label "Seq"
field ttv_num_cod_erro as integer format ">>>>,>>9" label "Número" column-label "Número"
field ttv_des_erro as character format "x(50)" label "Inconsistência" column-label "Inconsistência"
field ttv_des_ajuda as character format "x(50)" label "Ajuda" column-label "Ajuda"
.
Observações
tt_xml_input_1: Nesta temp-table, será necessário que se passe os dados que serão utilizadas para realizar a atualização da tabela de saldos.:
- Função – (SOMA, DIMINUI);
- Código empresa;
- Plano de Contas;
- Código conta contábil;
- Plano centro de custo;
- Código centro de custo;
- Código estabelecimento;
- Código unidade de negócio;
- Data da movimentação;
- Código finalidade econômica;
- Código projeto;
- Valor da movimentação;
- Quantidade do movimento.