Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Documento de API

Produto:

Datasul

Ocorrência:

Documentação de API

Nome Físicoprgfin/acr/acr904zaacr904zb

 

Objetivo

Gerar movimentos de comissões para o módulo Contas a Receber

 

Funcionamento

1. No programa que irá chamar está API, deve ser definida a temp-table(tt_movto_comis_repres_geracaogeracao2) como local e a temp-table(tt_movto_comis_erro) também como local.

2. Executar o programa API(utilizar o nome externo), da seguinte forma:

 

def var v_hdl_programa as Handle no-undo.

 

run prgfin/acr/acr904za.py (1,acr904zb.py persistent set v_hdl_programa.

 

run pi_main_code_api_movto_comis_repres_geracao_c in v_hdl_programa

                                            (input  1,

                                             Input  table                         input table tt_movto_comis_repres_geracaogeracao2,

                                                                     output table tt_movto_comis_erro).

Delete procedure v_hdl_programa.

 

3. Após a execução do programa, deve ser testada a temp-table de erro (tt_movto_comis_erro), afim de verificar se houve ou não erros durante o processo de importação.

 

Parâmetro Entrada API Gera movimentos Comissões

num_vers_integr_api: será utilizado para determinar se o programa que está chamando está íntegro com as definições correntes da API;

 

Tabelas Temporárias

 

Tabela Temporária

Descrição

Entrada/Saída

tt_movto_comis_repres_geracaogeracao2

Conterá as informações dos movimentos a serem integradas com o ACR

Entrada

 

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

Atributo

Tipo

Formato

Descrição

Obrig.

Evol.

tta_cod_empresa

character

x(3)

Empresa

 Sim

 

tta_cdn_repres

Integer

>>>,>>9

Representante

 Sim

 

tta_cod_estab

character

x(3) / x(5)*

Estabelecimento

 Sim

 

tta_cod_espec_docto

character

x(3)

Espécie Documento

 Sim

 

tta_cod_ser_docto

character

x(3)

Série Documento

 Sim

 

tta_cod_tit_acr

character

x(10)

Título

 Sim

 

tta_cod_parcela

character

x(02)

Parcela

 Sim

 

tta_cod_refer

character

x(10)

Referência

 Sim

 

tta_cod_usuario

character

x(12)

Usuário

 Sim

 

tta_dat_transacao

date

99/99/9999

Data Transação

 Sim

 

tta_ind_trans_acr

character

X(29)

Transação

 Sim

 

tta_ind_sit_movto_comis

character

X(18)

Situação

 Sim

 

tta_ind_tip_movto

character

X(20)

Tipo Movimento

 Sim

 

tta_ind_natur_lancto_ctbl

character

X(02)

Natureza

 Sim

 

tta_val_base_calc_comis

decimal

>>>,>>>,>>9.99

Base Calc Comis

 Sim

 

tta_val_movto_comis

decimal

->>,>>>,>>>,>>9.99

Valor Movimento

 Sim

 

tta_num_id_tit_acr

integer

9999999999

Token Cta Receber

 Não

 

tta_des_histor_movto_comis

character

x(40)

Histórico

 Não

 

tta_num_id_movto_tit_acr

integer

9999999999

Token Movto Tit ACR

 Sim

 

tta_ind_trans_comis

character

X(30)

Transação Comissão

 Sim

 

tta_cod_unid_negoc

character

x(3)

Unid Negócio

Não

 

ttv_log_consid_movto_pagto

logical

"Sim/Não"

Considera Pagto

Sim

 

tta_dat_emis_docto

date

99/99/9999

Data  Emissão

Sim

 

tta_cdn_motiv_movto_comis

Integer

>>>9

Código Motiv Movto

 

 

 

def temp-table tt_movto_comis_repres_geracao geracao2 no-undo

    field tta_cod_empresa                  as character format "x(3)" label "Empresa" column-label "Empresa"

    field tta_cdn_repres                   as repres                   as Integer format ">>>,>>9" initial 0 label "Representante" column-label "Representante"

...

    field tta_cod_espec_docto              as character format "x(3)" label "Espécie Documento" column-label "Espécie"

    field     field tta_cod_ser_docto                as character format "x(3)" label "Série Documento" column-label "Série"

    field tta_cod_tit_acr                  as character format "x(10)" label "Título" column-label "Título"

    field tta_cod_parcela                  as parcela                  as character format "x(02)" label "Parcela" column-label "Parc"

...

    field tta_dat_transacao                as date format "99/99/9999" initial today label "Data Transação" column-label "Dat Transac"

    field     field tta_ind_trans_acr                as character format "X(29)" initial "Implantação" label "Transação" column-label "Transação"

...

    field tta_ind_trans_comis              as character format "X(3035)" label "Transação Comissão" column-label "Transação Comissão"

    field tta_cod_unid_negoc               as character format "x(3)" label "Unid Negócio" column-label "Un Neg"

    field ttv_log_consid_movto_pagto       as logical format "Sim/Não" initial yes

    field tta_dat_emis_docto               as date format "99/99/9999" initial today label "Data  Emissão" column-label "Dt Emissão"

    field tta_cdn_motiv_movto_comis        as Integer format ">>>9" initial 0 label "Código Motiv Movto" column-label "Código Motiv"

    index tt_id_movto_comis              

          tta_cod_empresa                  ascending

          tta_cdn_repres                   ascendingrepres                   ascending.

 

OBSERVAÇÕES:

  1. 1.  Caso a natureza do lançamento seja um débito a data Emissão do documento será igual a data de transação, caso contrario a data de emissão será gravada com o valor informado no campo tta_dat_emis_docto.

 

Tabela Temporária

Descrição

Entrada/Saída

tt_movto_comis_repres_geracaoerro

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

Entrada

Atributo

Tipo

Formato

Descrição

Obrig.

Evol.

tta_cod_empresa

character

x(3)

Empresa

 

 

tta_cdn_repres

Integer

>>>,>>9

Representante

 

 

ttv_num_seq_movto_comis_erro

integer

>>>>,>>9

Num Sequência

 

 

ttv_des_mensagem

character

x(50)

Mensagem

 

 

ttv_des_ajuda

character

x(50)

Ajuda

 

 

...

          tta_cod_empresa                  ascending

          tta_cdn_repres                   ascendingrepres                   ascending

          ttv_num_seq_movto_comis_erro     ascending.