Documento de API
Produto: | Datasul |
Ocorrência: | Documentação de API |
Nome Físico | cdp/cdapi056.p |
Objetivo
Esta API será executada pela franquia de finanças. Seu objetivo é realizar a carga inicial referente a movimentação de Materiais (movto-estoq) e Item Requisição (it-requisição), gravando uma temp-table que será utilizado pelo programa de finanças para realizar a carga inicial no módulo de Execução Orçamentária, recebendo os seguintes parâmetros:
RUN cdp/cdapi056 (INPUT ep-codigo,
INPUT dat-movto-ini,
INPUT dat-movto-fim,
INPUT p_log_req_devol_mater,
INPUT p_log_atend_req_mater,
INPUT p_log_req_mater).
Funcionamento
Essa API será executa pelo programa de finanças.
A API irá alimentar informações na tabela tt_movto_empenh_mat_mi, sendo a mesma definida como “shared”.
Exemplo de definição de temp-table shared:
def shared temp-table tt_movto_empenh_mat_mi no-undo
Definição dos Parâmetros:
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
ep-codigo | Char | >>9 | Código Empresa | Não | 001 |
dat-movto-ini | Date | Default | Data Inicial do Movimento | Não | 001 |
dat-movto-fim | Date | Default | Data Final do Movimento | Não | 001 |
p_log_req_devol_mater | Log | Default | Carregar Req/Devol Material | Não | 001 |
p_log_atend_req_mater | Log | Default | Carregar Requisição Atendida | Não | 001 |
p_log_req_mater | Log | Default | Carregar Requisição | Não | 001 |
Tabelas Temporárias
Atributos das tabelas temporárias:
Tabela Temporária | Descrição | Entrada/Saída |
tt_movto_empenh_mat_mi | Conterá as informações referentes aos movimentos de materiais (movto-estoq) e item requisição (it-requis). |
|
Definição Atributos da Tabela Temporária Rowerrors:
Atributo | Tipo | Formato | Descrição |
ttv_num_trans_estoq | Int | ->>>,>>>,>>9 | Numero Transação Estoque |
ttv_rec_orig_movto_empenh | Recid | >>>>>>9 | Recid da Origem de movimento do Empenho |
ttv_rec_id_movto | Recid | >>>>>>9 | Recid do movimento |
tta_num_orig_movto_empenh | Int | >9 | Numero da origem do movimento |
ttv_cod_pedido | Char | x(12) | Código do pedido |
ttv_num_ordem | Int | >>>,>>>,>>9 | Numero da ordem |
ttv_cod_espec_docto | Char | x(3) | Espécie Documento |
ttv_cod_natur_operac_2 | char | x(6) | Código da natureza de operação |
ttv_cod_serie | char | x(5) | Código de serie |
ttv_cod_docto_ems2 | char | x(16) | Código do documento |
tta_cod_estab | char | x(3) | Estabelecimento |
ttv_num_empres_ems2 | Int | >>>>,>>9 | Numero da empresa do ems2 |
ttv_num_seq | Int | >>>,>>9 | Numero seqüencial |
ttv_num_seq_item | Int | >>>9 | Seqüência do item |
ttv_num_req | Int | >>>,>>9 | Numero seqüencial |
ttv_cod_tip_req | Char | x(30) | Tipo da requisição |
ttv_nom_abrev | Char | x(15) | Nome Abreviado |
ttv_cod_item_dw | Char | x(16) | Item |
ttv_num_ord_req | Int | zzzzz9,99 | Numero ordem |
ttv_qtd_reqtdo | Dec | >>>,>>>,>>9.99 | Quantidade requerida |
tta_val_movto_empenh | Dec | ->>,>>>,>>>,>>9.99 | Movimento Empenhado |
ttv_cod_ccusto | Char | x(11) | Centro Custo |
ttv_cod_unid_negoc | Char | x(3) | Unidade de Negócio |
ttv_cod_finalid_econ | Char | x(10) | Finalidade Econômica |
ttv_dat_movto | Date | 99/99/9999 | Data Movimento |
ttv_qtd_movto | Dec | ->>>>,>>9.9999 | Quantidade do movimento |
ttv_val_movto | Dec | ->,>>>,>>>,>>9.99 | Valor do movimento |
tta_cod_cta_ctbl | Char | x(20) | Conta Contábil |
ttv_nr_ord_produ | Int | >>>,>>>,>>9 | Ordem Manutenção |
ttv_cd_equipto | Char | x(16) | Equipamento |
ttv_id_movto | Int | ->>>,>>>,>>9 | ID Movimento |
Considerações Gerais:
- Devem ser passadas os parâmetros conforme listado acima.
Exemplo:
RUN cdp/cdapi056 (INPUT ep-codigo,
INPUT dat-movto-ini,
INPUT dat-movto-fim,
INPUT p_log_req_devol_mater,
INPUT p_log_atend_req_mater,
INPUT p_log_req_mater).
- A API funciona da seguinte forma: Recebe os parâmetros, faz as criticas das mesmas, caso não tenha ocorrido nenhum problema realiza a carga da temp-table tt_movto_empenh_mat_mi. O primeiro parâmetro passa o código da empresa para que seja feita a leitura dentro desta API e gravada a temp-table. O segundo e o terceiro campos é data inicial e final do movimento para que se possa filtra os movimentos por faixa de data. O quarto indica que será gerada uma carga das requisições e devoluções de materiais (movto-estoq). O quinto indica que será gerado uma carga das requisições atendidas, E o Sexto indica que será gerado uma carga de requisição de materiais (it-requis).
- Essa API será executa pelo programa de finanças.