Histórico da Página
...
Documento de API
Produto: | Datasul |
Ocorrência: | Documentação de API |
Nome Físico | prgfin/fas/fas795za |
...
Observação: A partir da release 12.1.2503.
Objetivo
Excluir os movimentos de baixas gerados gerados tanto pelo módulo do Ativo Fixo quanto pelas notas fiscais de venda de ativos/imobilizados.
Quando houver integração entre o Faturamento e o Ativo, os movimentos de baixa serão gerados após Após a atualização da nota fiscal de venda de ativos, onde os bens patrimoniais que estão relacionadas a nota fiscal sofreram uma a baixa por venda, o . Esse relacionamento entre nota fiscal e bem patrimonial são armazenados será armazenado na tabela bem_docto_faturam, caso ocorra a desatualização da nota fiscal, a baixa de venda deverá ser excluída também no modulo de ativo fixo.
Funcionamento
Na forma padrão, realiza-se a chamada através de um comando RUN normal, armazenando o programa em uma variável através do comando PERSISTENT e em seguida executando uma PROCEDURE deste programa, passando-se os parâmetros com as informações necessárias.
...
DEF VAR v_hdl_program AS HANDLE NO-UNDO.
RUN prgfin\fas\fas795za.py PERSISTENT SET v_hdl_program.
RUN pi_main_code_exc_movto_pat IN v_hdl_program (INPUT TABLE tt_exc_movto_pat,
INPUT TABLE tt_nota_fisc_vda,
OUTPUT TABLE tt_log_erros).
DELETE PROCEDURE v_hdl_program.
Parâmetros
Parâmetro | Descrição |
tt_exc_movto_pat | Esta temp-table conterá os registros com as informações dos bens patrimoniais do módulo de ativo fixo, os quais foram gerados pelas vendas de ativos/imobilizados efetuada pelo módulo da faturamento. Deverá ser definida conforme os atributos mencionados a seguir, na seção Tabelas Temporárias. |
tt_nota_fisc_vda | Esta temp-table conterá os registros com as informações dos itens da nota fiscal de venda de ativos/imobilizados efetuada pelo módulo da faturamento. Deverá ser definida conforme os atributos mencionados a seguir, na seção Tabelas Temporárias. |
tt_log_erros | Esta temp-table conterá os erros ocorridos durante as validações feitas pela API no momento da exclusão dos movimentos de baixas gerados pelas notas fiscais de venda de ativos/imobilizados. Deverá ser definida conforme os atributos mencionados a seguir, na seção Tabelas Temporárias. Não deverá ser alimentada ao chamar a API. |
...
- Deve ser gerada a temp-table no programa que chamará a API. Esta temp-table conterá as informações sobre os documentos de entrada e os itens do documento que serão implantados no Ativo Fixo.
Retorno
A API retornará na tabela temporária tt_log_erros que conterá todos os erros encontrados ou mensagens de alerta gerados durante o processo de validação dos documentos.
...
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.
Tabelas Temporárias
Nos atributos das tabelas temporárias de entrada e saída, o programa o programa que irá executar a api_docto_entr deverá conter a pi_main_code_exc_movto_pat deverá conter e criar as seguintes tabelas temporárias:
1) Criação de Documentos de entrada e itens do documento de entradaTabela de informações dos bens patrimoniais do módulo de ativo fixo - Módulo FAS
Tabela Temporária | Descrição | Entrada/Saída |
tt_bemexc_investmovto_mgapat | Conterá as informações dos documentos de entrada e seus itensbens patrimoniais do módulo de ativo fixo, os quais foram gerados pelas vendas de ativos/imobilizados efetuada pelo módulo da faturamento. | Entrada |
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
tta_cod_empresa | character | x(3) | Código da empresa externa a ser traduzida pela matriz de tradução de unidade organizacional. | Sim |
tta_cod_ |
cta_ |
pat |
integer
>>>>>>>>9
character | x(18) | Código da conta patrimonial na qual o bem patrimonial está associado, conforme cadastro no FAS011AA/FAS214AA/FAS329AA - Conta Patrimonial. | Sim |
tta_num_ |
bem_ |
pat |
character
x(20)
integer | >>>>>>>>9 | Número/código de identificação do bem patrimonial, conforme cadastro no FAS701AA/FAS211AA - Aquisição de Bens Patrimoniais. | Sim |
tta_num_ |
seq_ |
bem_ |
pat |
character
x(5)
integer | >>>>9 | Número de sequência de identificação do bem patrimonial. | Sim |
ttv_cod_natur_operac
character
x(6)
Sim
tta_num_seq_movto_bem_pat | integer | >>>>>>,>>9 | Número de sequência do movimento de baixa do bem patrimonial. | Sim | |
tta_dat_movto |
ttv_cod_estab
character
x(3)
Sim
_bem_pat | date |
99/99/9999 | Data da movimentação de |
baixa do |
bem patrimonial. | Sim |
tta_ind_ |
orig_ |
movto | character | x( |
8) |
ttv_cdn_aux
integer
>>>,>>9
ttv_cod_origem
character
x(8)
ttv_des_aux_5
character
x(40)
ttv_val_aquis_bem_pat
decimal
->>,>>>,>>>,>>9.99
ttv_val_aquis_fasb_bem_pat
decimal
>>,>>>,>>>,>>9.99
ttv_val_aquis_cmi_bem_pa
decimal
>>,>>>,>>>,>>9.99
ttv_cdn_unid_bem
integer
>>>,>>9
Sim
ttv_cdn_org_bem
integer
>>>,>>9
ttv_cdn_ord_manut
integer
>>>,>>9
ttv_des_bem_pat
character
x(40)
Sim
ttv_cod_unid_negoc
character
x(3)
tta_num_id_ri_bem_pat
integer
>>>,>>>,>>9
ttv_gera_bem_quant
logical
yes/no
ttv_sequencia
integer
>>9
ttv_cod_moed_fasb
character
x(8)
ttv_dat_fasb
date
99/99/9999
Indicador de origem de movimento. As opções disponíveis são:
| Sim |
2) Tabela de itens da nota fiscal de venda de ativos/imobilizados - Módulo FT
Tabela Temporária | Descrição | Entrada/Saída |
tt_exc_movto_pat | Conterá as informações dos itens da nota fiscal de venda de ativos/imobilizados efetuada pelo módulo da faturamento. | Entrada |
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
tta_cod_estab_nf | character | x(5) | Código do estabelecimento da nota fiscal do módulo de Faturamento, conforme cadastro no UTB071AA/UFN206AA/UTB317AA - Estabelecimento. | Sim | |
tta_cod_ser_nf | character | x(5) | Série da nota fiscal do módulo de Faturamento. | Sim | |
tta_cod_nota_fisc | character | x(10) | Número da nota fiscal do módulo de Faturamento. | Sim | |
tta_num_seq_item | integer | >>>>9 | Número de sequência do item da nota fiscal do módulo de Faturamento. | Sim | |
tta_cod_item_nf | character | x(16) | Código do item da nota fiscal do módulo de Faturamento. | Sim |
34) Tabela de erros
Tabela Temporária | Descrição | Entrada/Saída |
tt_log_erros | Conterá as informações das mensagem de erro ocorridas na criação do documento de entrada. | Saída |
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
ttv_num_seq | integer | >>>,>>9 | Número sequencial. | ||
ttv_num_cod_erro | integer | >>>>,>>9 | Número do erro. | ||
ttv_des_erro | character | x(50) | Mensagem de erro. | ||
ttv_des_ajuda | character | x(50) | Mensagem de ajuda referente ao erro. |
Execução
Leitura e Criação dos Registros
...