Histórico da Página

...

Produto:	Datasul
Ocorrência:	Documentação de API
Nome Físico	prgfin/cfl/cfl724zb

Objetivo

Importar movimentos de outros módulos referentes a Fluxo de Caixa para o módulo Fluxo de Caixa.

Funcionamento

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

...

input-output table tt_import_movto_valid_cfl).

Parâmetros

Parâmetro	Descrição
p_num_vers_integr_api	Será utilizado para determinar se o programa que está chamando está íntegro com as definições correntes da API;
tt_import_movto_fluxo_cx	Esta temp-table conterá todos os movimentos que devam ser importados para o Fluxo de Caixa.
tt_import_movto_valid_cfl	Esta temp-table conterá os possíveis erros que poderão ocorrer na integração.

Retorno

A API retornará na tabela temporária tt_import_movto_valid_cfl todos os erros encontrados ou mensagens de alerta gerados durante o processo de validação dos movimentos.

...

Observações: Quando a API for executado 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.

...

O programa que irá executar a api_movto_fluxo_cx_recebto (cfl724zb.py) deverá conter e criar as seguintes tabelas temporárias:

Tabela Temporária	Descrição	Entrada/Saída
tt_import_movto_fluxo_cx	Conterá as informações dos movimentos a serem importados.	Entrada e Saída

(*) A partir da 5.07A o estabelecimento passa a ter cinco dígitos.

Atributo	Tipo	Formato	Descrição	Obrig.	Evolução
tta_num_fluxo_cx	integer	>>>>>,>>9	Código da Conta Correnteconta corrente.	Sim
tta_dat_movto_fluxo_cx	date	99/99/9999	Data Movimentodo movimento.	Sim
tta_cod_estab	character	x(3) / x(5)*	Seqüência em que o movimento será gerado.	Sim
tta_cod_unid_negoc	character	x(3)	Código da Unidade unidade de Negócionegócio.	Sim
tta_cod_tip_fluxo_financ	character	x(12)	Código do Tipo de Fluxo Financeirotipo de fluxo financeiro.	Sim
tta_ind_fluxo_movto_cx	character	x(3)	Indicador do Fluxo fluxo do Movimentomovimento Valores permitidos: ENT ent e SAIsai. Onde: ENT ent = Entradaentrada SAI sai = Saídasaída.	Sim
tta_ind_tip_movto_fluxo_cx	character	x(2)	Indicador do Tipo tipo de Movimentomovimento. Valores permitidos: RE re e NRpr. Onde: RE re = Realizadorealizado NR pr = Não Realizadoprevisto.	Sim
tta_cod_modul_dtsul	character	x(3)	Código do Módulomódulo. Normalmente utilizado “CMG” “CFL” para movimentos do Caixa e Bancosfluxo de caixa.	Sim
tta_val_movto_fluxo_cx	decimal	>>,>>>,>>>,>>9.99	Valor do Movimentomovimento.	Sim
ttv_ind_erro_valid	character	x(8)	Caso ocorra algum erro, este campo terá o valor “Sim” “sim” e as respectivas mensagens de erro estarão na tt_import_movto_valid_cfl, onde a leitura deverá ser feita pelo atributo ttv_rec_movto_fluxo_cx. Exemplo: For for each tt_import_movto_fluxo_cx no-lock Where where tt_import_movto_fluxo_cx.ttv_ind_erro_valid = “Sim”“sim”: For for each tt_import_movto_valid_cfl no-lock Where where tt_import_movto_valid_cfl.ttv_rec_movto_fluxo_cx = tt_import_movto_fluxo_cx. ttvTtv_rec_movto_fluxo_cx: Disp disp tt_import_movto_valid_cfl. Endend. Endend.	Sim
tta_cod_histor_padr	character	x(8)	Código do Histórico Padrãohistórico padrão.	Não
tta_des_histor_movto_fluxo_cx	character	x(2000)	Descrição do Histórico Padrãohistórico padrão.	Não
ttv_rec_movto_fluxo_cx	recid	>>>>>>9	Deverá conter o número do recid da temp-table tt_import_movto_fluxo_cx. Exemplo: assign ttTt_import_movto_fluxo_cx.ttv_rec_movto_fluxo_cx = recid(tt_import_movto_fluxo_cx).	Sim

...

field tta_cod_estab as character format "x(35)" label "Estabelecimento" column-label "Estab"

...

Observação: Os atributos “tta_cod_histor_padr e tta_des_histor_movto_fluxo_cx” estão informados como não obrigatório, pois um ou outro pode ser informado, é obrigatório que pelo menos um seja informado, podendo se necessário informar os dois.

Tabela Temporária	Descrição	Entrada/Saída
tt_import_movto_valid_cfl	Conterá as informações dos movimentos que não foram importados com a respectiva mensagem de erro.	Entrada e Saída

Atributo	Tipo	Formato	Descrição	Obrig.	Evolução
ttv_rec_movto_fluxo_cx	recid	>>>>>>9	O recid do movimento da tt_import_movto_fluxo_cx que apresentou o erro.	Sim
ttv_num_mensagem	integer	>>>>,>>9	Número da mensagem de erro.	Sim
ttv_des_mensagem	character	x(50)	Descrição da mensagem do erro.	Sim
ttv_des_ajuda	character	x(50)	Descrição da ajuda do erro.	Sim

...

field ttv_rec_movto_fluxo_cx as recid format ">>>>>>9" initial ?

field ttv_num_mensagem as mensagem as integer format ">>>>,>>9" label "Número" column-label "Número Mensagem"

field ttv_des_mensagem as mensagem as character format "x(50)" label "Mensagem" column-label "Mensagem"

field ttv_des_ajuda as character format "x(50)" label "Ajuda" column-label "Ajuda"

.

Execução

Na execução da API ocorrem as seguintes validações:

...

7. Tipo do Movimento

Valida so se o Tipo do Movimento informado é RE(Realizado) ou PR(Previsto);

...

9. Valor do Movimento

Valida se há alguma algum valor informado;

10. Histórico Padrão

Se informado será verificado se o Histórico Padrão é válido para o módulo CFL, caso não esteja informado é obrigatório a existe^ncia existência da descrição do histórico;

...

Será verificado se a descrição do histórico não está em branco, salvo se o código do histórico padrão estiver informado, caso a descrição do histórico não estiver informada será pego a descrição do histórico padrão.

Criação dos Registros

Exemplo de criação de movimentos de fluxo de caixa:

...

tt_import_movto_fluxo_cx.tta_cod_unid_negoc = "xxx"

tt tt_import_movto_fluxo_cx.tta_cod_tip_fluxo_financ = "11111"

...

tt_import_movto_fluxo_cx.tta_cod_estab estab = "xxx"

tt_import_movto_fluxo_cx.tta_cod_unid_negoc = "xxx"

...

Árvore de páginas

Versões comparadas

Versão antiga 1

Nova versão Atual

Chave