Linha Datasul

Árvore de páginas

Documento de API

Produto:

Datasul

Ocorrência:

Documentação de API

Nome FísicoPrgfin/apl/apl007zr

 

Objetivo

Efetuar a correção de aplicações financeiras no Sistema de Aplicações e Empréstimos.

 

Funcionamento

Na forma padrão, realiza-se a chamada através de um comando RUN normal, passando-se as informações necessárias.

A sintaxe para a chamada da API é:

 

run prgfin/apl/apl007zr.py        (1,

                                 input p_num_id_operac_financ,

                                  input p_cod_banco,

                                  input p_cod_produt_financ,

                                  input p_cod_operac_financ,

                                  input p_dat_fim_correc,

                                  output table tt_log_erro).

 

Parâmetros

Parâmetro

Descrição

Num_vers_integr_api

Será utilizado para determinar se o programa que está chamando está íntegro com as definições correntes da API.

[ p_num_id_operac_financ ]

É o identificador da operação financeira. Caso sejam informados os campos: p_cod_banco, p_cod_produt_financ e p_cod_operac_financ, o mesmo poderá ser passado como zero.

[ p_cod_banco ]

É o código do banco. Não será necessário informá-lo caso tenha sido informado o p_num_id_operac_financ.

[ p_cod_produt_financ ]

É o código do produto financeiro. Não será necessário informá-lo caso tenha sido informado o p_num_id_operac_financ.

[ p_cod_operac_financ ]

É o código da operação financeira. Não será necessário informá-lo caso tenha sido informado o p_num_id_operac_financ.

p_dat_fim_correc

É data até a qual deverá ser efetuada a correção da aplicação financeira.

tt_log_erro

Os retornos de erros encontrados durante o processo de criação serão gravados nesta tabela.

 

Retorno

A API retornará na tabela temporária tt_log_erro contendo todos os erros encontrados ou mensagens de alerta gerados durante o processo de correção da aplicação financeira no Aplicações e Empréstimos.

Observações: Quando a API for executada por um programa externo, logo após a chamada da API, deverá ser criado um tratamento para impressão dos erros. E para a correta visualização dos erros, todos os campos desta tabela devem ser impressos.

 

Atributos

Nos atributos das tabelas temporárias de entrada e saída, o nome de um atributo opcional aparece cercado por colchetes, como, por exemplo, [Atributo-op].

 

Tabela Temporária

Descrição

Entrada/Saída

tt_log_erro

Conterá as informações de erros na integração, é a temp-table que retorna os possíveis problemas na integração dos registros.

Saída

 

Atributo

Tipo

Formato

Descrição

Obrig.

Evolução

Ttv_num_cod_erro

integer

>>>>,>>9

Número da Mensagem

 

 

Ttv_des_msg_ajuda

character

x(40)

Descrição da Mensagem de Ajuda

 

 

Ttv_des_msg_erro

character

x(60)

Descrição da Mensagem de Erro.

 

 

 

Definição:

def temp-table tt_log_erro no-undo

field ttv_num_cod_erro                 as integer format ">>>>,>>9" label "Número" column-label "Número"

field ttv_des_msg_ajuda                as character format "x(40)" label "Mensagem Ajuda" column-label "Mensagem Ajuda"

field ttv_des_msg_erro                 as character format "x(60)" label "Mensagem Erro" column-label "Inconsistência"    .