Histórico da Página
Documento de API
Produto: | Datasul |
Ocorrência: | Documentação de API |
| Nome Físico | prgfin/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:
Tabela Temporária | Descrição | Entrada/Saída | |
tt-tot-tit |
| EntradaConté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"
.