Á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/apb/apb773za

 

Objetivo

Atualmente existe a possibilidade de Integração entre Recebimento x APB onde, ao criar e atualizar um Documento, é possível informar as Duplicatas que serão geradas no APB. O objetivo da Integração dos Módulos Faturamento x APB é justamente movimentar esses títulos que foram gerados quando ocorrer uma Devolução de Mercadoria, através de um Acerto de Valor a Crédito, uma alteração da Situação do Título para Devolvido ou a geração de uma Antecipação. A API tem como objetivo receber os títulos (duplicatas) que serão movimentados a partir da(s) Nota(s) de Crédito(s) gerada(s).

 

Funcionamento

A API/BO...

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

A sintaxe para a chamada da API/BO é:

run prgfin/apb/apb773zb.py persistent set v_hdl_api_integr_faturam_apb (Input 1).

 

run pi_main_code_api_integracao_faturamento_apb_2 in v_hdl_api_integr_faturam_apb

                                              (Input apb773za.py (input  table tt-tot-tit,         

                            input                                                       Input table tt-titulo,        

                            output                                                      Output table tt_log_erros_atualiz).

 

Parâmetros API Integração Faturamento x APB:

 

tt-tot-tit: tabela temporária que contém as duplicatas a serem devolvidas.

tt-titulo: tabela temporária que contém as várias parcelas envolvidas da(s) duplicata(s).

tt-log-erros-atualiz: retorna os erros que aconteceram ao integrar Faturamento x APB.

 

Tabelas Temporárias

Nos atributos das tabelas temporárias de entrada e saída:

 

Entrada

Tabela Temporária

Descrição

Entrada/Saída

tt-tot-tit

 

Contém as duplicatas a serem devolvidas.

Entrada

 

(*) No EMS 2.06B a empresa é inteira no Datasul 11 a empresa é caracter.

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

Atributo

Tipo

Formato

Descrição

Obrig.

Evol.

referencia

character

x(10)

referenciaReferência.

 

 

ep-codigo

integer/ character*

>>9/x(3)*

Empresa Externa.ep-codigo

 

 

cod-empresa

character

x(3)

cod-empresaEmpresa.

 

 

cod-estabel

character

x(3) / x(5)**

Estabelecimento Externo.cod-estabel

 

 

cod-estab-ems5

character

x(3) / x(5)**

Estabelecimento.cod-estab-ems5

 

 

cod-fornec

integer

>>>>>9cod

-fornecFornecedor.

 

 

cod-esp

character

!!

cod-espEspécie.

 

 

serie

character

x(5)

serieSérie.

 

 

nr-docto

character

x(16)

nr-doctoTítulo.

 

 

tot-saldo

decimal

>>>>>>>,>>9.99

tot-saldoValor Total de Saldo.

 

 

tot-baixa

decimal

>>>>>>>,>>9.99

tot-baixaValor Total da Baixa.

 

 

mo-codigo

integer

>9mo

-codigoMoeda.

 

 

cotacao-dia

decimal

>>>,>9.99999999

cotacao-diaCotação.

 

 

dt-trans

date

99/99/9999

dt-transData de Transação.

 

 

nr-docto-cr

character

x(16)

nr-docto-crDocumento CR.

 

 

serie-cr

character

x(5)

serie-crSérie CR.

 

 

cod-esp-cr

character

!!cod

-esp-crEspécie CR.

 

 

tp-codigo

integer

>>9

tp-codigo

 

 

conta-debito

character

x(17)

conta-debitoConta de Débito.

 

 

sequencia

integer

 sequencia

Sequência.

 

 

erro

logical

Sim/Nãoerro

Gerou Erro.

 

 

serie-nota

character

x(5)

Série da Nota.

 

 

nr-docto-nota

character

x(16)

Número do Documento da Nota.

 

 

cod-plano-ccusto

character

x(8)

Plano de Centro de Custo.

 

 

cod-ccusto        

character

x(20)

Centro de Custo.

 

 

cod-plano-cta-ctbl

character

x(8)

Plano de Conta Contábil.

 

 

 

def temp-table tt-tot-tit no-undo

    field referencia     referencia         as character format "x(10)"

    &IF '{&emsfin_version}' < '5.07A' &THEN

    field ep-codigo      codigo          as integer   format ">>9"

    &ELSE

    field ep-codigo          as char   format "x(3)"

    &ENDIF

    field cod-empresa    empresa        as character format "x(3)"

    field cod-estabel    estabel        as character format "x(3)"

    field cod-estab-ems5 ems5     as character format "x(3)"

    field cod-fornec     fornec         as integer   format ">>>>>9"

    field cod-esp        esp            as character format "!!"

    field serie          serie              as character format "x(5)"

    field nr-docto       docto           as character format "x(16)"

    field tot-saldo      saldo          as decimal   format ">>>>>>>,>>9.99"

    field tot-baixa      baixa          as decimal   format ">>>>>>>,>>9.99"

    field mo-codigo      codigo          as integer   format ">9"

    field cotacao-dia    dia        as decimal   format ">>>,>9.99999999"

    field dt-trans       trans           as date      format "99/99/9999"

    field nr-docto-cr    cr        as character format "x(16)"

    field serie-cr       cr           as character format "x(5)"

    field cod-esp-cr     as cr         as character format "!!"

    field tp-codigo      codigo          as integer   format ">>9"

    field conta-debito   debito       as character format "x(17)"

    field sequencia      sequencia          as   integer

    field erro           erro               as logical   format "Sim/NÆoNão" /*l_sim_nao*/

    field serie-nota         as character format "x(5)"

    field nr-docto-nota      as character format "x(16)"

    field cod-plano-ccusto   as character format 'x(8)'

    field cod-ccusto         as character format 'x(20)'

    field cod-plano-cta-ctbl as character format 'x(8)'

    index seq            is primary unique

...

          serie

          nr-docto.

 

Tabela Temporária

Descrição

Entrada/Saída

tt-titulo 

Contém as várias parcelas envolvidas da(s) duplicata(s).

Entrada

Atributo

Tipo

Formato

Descrição

Obrig.

Evol.

sequencia

integer

  

Sequência.

 

 

parcela

character

x(02)

 Parcela.

 

 

vl-saldo

decimal

>>>>>>>,>>9.99

 Valor de Saldo.

 

 

vl-baixa

decimal

>>>>>>>,>>9.99

 Valor da Baixa.

 

 

ind-baixa

logical

 

 

 

 

 

def temp-table tt-titulo

...

    field parcela       as character format "x(02)"

    field vl-saldo      as saldo      as decimal   format ">>>>>>>,>>9.99"

    field vl-baixa      as decimal   format ">>>>>>>,>>9.99"

    field ind-baixa     as baixa     as logical

    index titulo        is primary

          sequencia

          ind-baixa.

 

 

Tabela Temporária

Descrição

Entrada/Saída

tt_log_erros_atualiz

Retorna os erros que aconteceram ao integrar Faturamento x APB.

Saída

 

...

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

Atributo

Tipo

Formato

Descrição

Obrig.

Evol.

tta_cod_estab

character

x(3) / x(5)*

Estabelecimento

 

 

tta_cod_refer

character

x(10)

ReferˆnciaReferência

 

 

tta_num_seq_refer

integer

>>>9

Sequência

 

 

ttv_num_mensagem

integer

>>>>,>>9

Número

 

 

ttv_des_msg_erro

character

x(60)

Mensagem Erro

 

 

ttv_des_msg_ajuda

character

x(40)

Mensagem Ajuda

 

 

ttv_ind_tip_relacto

character

X(15)

Tipo Relacionamento

 

 

ttv_num_relacto

integer

>>>>,>>9

Relacionamento

 

 

...

def new shared temp-table tt_log_erros_atualiz no-undo

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

...

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

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

...

    field ttv_num_relacto                  as integer format ">>>>,>>9" label "Relacionamento" column-label "Relacionamento"

    .