Histórico da Página
...
Produto: | Datasul |
Ocorrência: | Documentação de API |
Nome Físico | prgfin/acr/acr779zb |
Objetivo
Atualmente existe a possibilidade de Integração entre Faturamento x ACR onde, ao criar e atualizar uma Nota Fiscal, é possível informar as Duplicatas que serão geradas no ACR. O objetivo da Integração dos Módulos Recebimento x ACR é 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
Na A execução 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áriaspersistente padrão para essa API é a execução persistente.
A sintaxe para executar a chamada da API/BO em modo persistente é:
def var v_hdl_aux as Handle no-undo.
run prgfin/acr/acr779zc.py persistent set v_hdl_aux.
run pi_main_code_api_integracao_recebimento_acr_5 in v_hdl_aux
(input table acr779zb.py (input table tt-tot-tit,
input table input table tt-titulo,
input table input table tt-un-devol,
output output table tt_log_erros_atualiz,
input table tt-impto-retid-fat).
delete procedure v_hdl_aux.
A variável denominada h-handle irá receber o “handle” do programa, permitindo o acesso aos “métodos” internos da API.
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.
Os Parâmetros utilizados pelo programa estão listados abaixo, na ordem que se segue:
- 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 Recebimento x ACR
- tt-un-devol: tabela temporária que contém o rateio de unidade de negócio da devolução
- tt-impto-retid-fat: tabela temporária que contém os impostos retidos no faturamento
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 | Contém as duplicatas a serem devolvidas. | Entrada |
(*) A partir da 5.07A o estabelecimento passa a ter cinco dígitos.
Atributo | Tipo | Formato | Descrição | REC | Obrigatório | Evolução | |
referencia | character | x(10) | Utilizado para Referencia na criação da Nota de Crédito | X |
|
| |
ep-codigo | integer | character | x(3)>>9 | Código da Empresa Externa | X |
|
|
cod-empresa | character | x(3) | Código da Empresa EMS 5 |
|
|
| |
cod-estabel | character | x(3) / x(5)* | Código do Estabelecimento Externo | X |
|
| |
cod-estab-ems5 | character | x(3) / x(5)* | Código do Estabelecimento EMS 5 |
|
|
| |
cod-esp | character | !! | Código da Espécie Externa | X |
|
| |
serie | character | x(5) | Código da Série Externa | X |
|
| |
nr-docto | character | x(16) | Número do Documento Externo | X |
|
| |
cod-emitente | integer | >>>>>9 | Código do Emitente | X |
|
| |
tot-saldo | decimal | >>>>>>>,>>9.99 | Valor do Saldo em Aberto dos Títulos (Somatório dos tt-titulo.vl-saldo) |
|
|
| |
tot-baixa | decimal | >>>>>>>,>>9.99 | Total a ser baixado (que deve ser rateado entre as várias parcelas) | X |
|
| |
mo-codigo | integer | >9 | Código da Moeda Externa da Nota de Crédito que será gerada | X |
|
| |
cotacao-dia | decimal | >>>,>9.99999999 | Cotação do Dia utilizada para Nota de Crédito que será gerada | X |
|
| |
dt-trans | date | 99/99/9999 | Data de Transação utilizada para indicar a Data de Transação e a Data de Emissão da Nota de Crédito que será gerada | X |
|
| |
nr-docto-cr | character | x(16) | Número do Documento Externo da Nota de Crédito que será gerada | X |
|
| |
serie-cr | character | x(5) | Código da Série Externa da Nota de Crédito que será gerada | X |
|
| |
cod-esp-cr | character | !! | Código da Espécie Externa da Nota de Crédito que será gerada | X |
|
| |
tp-codigo | integer | >>9 | Código do Tipo Fluxo Financeiro | X |
|
| |
estorn-comis | logical | Sim/Não | Indica se estorna ou não comissão | X |
|
| |
sequencia | integer |
| Atributo que indica ocorrência única na tabela temporária | X |
|
| |
conta-devol | character | x(17) | Código da Conta de Débito Externa | X |
|
| |
erro | logical | Sim/Não | Indica se ocorreu erro na tradução |
|
|
| |
serie-nota | character | x(5) | Série da Nota de Devolução | X |
|
| |
nr-docto-nota | character | x(16) | Número da Nota de Devolução | X |
|
| |
nat-operacao | character | X(6) | Natureza de Operação | X |
|
| |
cod-plano-ccusto | character | X(8) | Plano Centro de Custo |
|
|
| |
cod-ccusto | character | X(20) | Centro de Custo |
|
|
| |
cod-plano-cta-ctbl | character | X(8) | Plano Conta Contábil |
|
|
|
def temp-table tt-tot-tit
...
field ep-codigo as integer format ">>9"char format 'x(3)'
field cod-empresa as character format "x(3)"
field cod-estabel as character format "x(35)"
field cod-estab-ems5 as character format "x(35)"
field cod-esp as character format "!!"
...
field mo-codigo as integer format ">9"
field field cotacao-dia as decimal format ">>>,>9.99999999"
...
field nr-docto-cr as character format "x(16)"
field field serie-cr as character format "x(5)"
...
field estorn-comis as logical format "Sim/NÆoNão" /*l_sim_nao*/
field sequencia as integer
...
field 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 nat-operacao as character format "x(6)"
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
...
nr-docto
conta-devol.
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 | REC | Obrigatório | Evolução |
sequencia | integer |
| Atributo que indica de qual duplicata é a parcela em questão | X |
|
|
parcela | character | x(02) | Código da Parcela Externa da Duplicata | X |
|
|
vl-saldo | decimal | >>>>>>>,>>9.99 | Valor do Saldo em Aberto da parcela em questão |
|
|
|
vl-baixa | decimal | >>>>>>>,>>9.99 | Valor a ser baixado da parcela em questão |
|
|
|
ind-baixa | logical |
| Indicador para informar se a parcela será baixada ou não |
|
|
|
...
sequencia
ind-baixa.
Tabela Temporária | Descrição | Entrada/Saída |
tt_log_erros_atualiz | Contém os erros existentes no processo. | Saída |
(*) A partir da 5.07A o estabelecimento passa a ter cinco dígitos.
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução |
tta_cod_estab | character | x(3) / x(5)* | Estabelecimento |
|
|
tta_cod_refer | character | x(10) | Referê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 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_relacto as integer format ">>>>,>>9" label "Relacionamento" column-label "Relacionamento".
Tabela Temporária | Descrição | Entrada/Saída |
tt_un_devol |
| Entrada |
Atributo | Tipo | Formato | Descrição | Obrigatório | Evolução | |
sequencia | integer | int | integer | Atributo que indica de qual duplicata é a parcela em questão |
|
|
parcela | character | x(02) | Código da Parcela Externa da Duplicata |
|
| |
cod-un | character | x(03) | Código da unidade de negócio do rateio |
|
| |
vl-aprop-un | decimal | >>>>>>>,>>9.99 | Valor do rateio na unidade de negócio |
|
|
def temp-table tt-un-devol
...
parcela
cod-un.
Tabela Temporária | Descrição | Entrada/Saída |
tt-impto-retid-fat | Contém os impostos retidos no faturamento | Entrada |
(*) A partir da 5.07A o estabelecimento passa a ter cinco dígitos.
Atributo | Tipo | Formato | Descrição | REC | Obrigatório | Evolução |
cod-estabel | character | 'x(3)' | Código do Estabelecimento EMS2 | X |
|
|
cod-estab-ems5 | character | 'x(3)' / 'x(3)' * | Código do Estabelecimento EMS5 |
|
|
|
cod-esp | character | '!!' | Código da Espécie | X |
|
|
serie | character | 'x(5)' | Série | X |
|
|
nr-docto | character | 'x(16)' | Código do Título | X |
|
|
parcela | character | 'x(02)' | Número da Parcela | X |
|
|
cod-emitente | integer | '>>>>>' | Código do Cliente | X |
|
|
idi-tip-impto | integer |
| Tipo de Imposto (1-PIS,2-COFINS,3-CSLL) | X |
|
|
vl-impto | decimal | '>>>>>>>,>>9.99' | Valor Imposto | X |
|
|
def temp-table tt-impto-retid-fat
field cod-estabel as character format 'x(3)'
field cod-estab-ems5 as character format 'x(5)'
field cod-esp as character format '!!'
field serie as character format 'x(5)'
field nr-docto as character format 'x(16)'
field parcela as character format 'x(02)'
field cod-emitente as integer format '>>>>>'
field idi-tip-impto as integer
field vl-impto as decimal format '>>>>>>>,>>9.99'
index documento is primary
cod-estab-ems5
serie
nr-docto
cod-emitente
parcela
cod-esp
idi-tip-impto.
Observações
...
- Os atributos setados com “X” na Coluna “REC” indica quais os atributos que serão enviados pelo REC.
- Devido a regras aplicadas no Recebimento, a organização da temp-table é da seguinte forma: uma duplicata que possui várias parcelas tem uma ocorrência no tt-tot-tit (ou seja, cada duplicata é uma ocorrência no tt-tot-tit) e as suas várias parcelas são indicadas em N ocorrências na tt-titulo (ou seja, cada parcela é uma ocorrência no tt-titulo). A ligação entre tt-tot-tit e tt-titulo é feita através do atributo sequencia.
- Qualquer alteração que ainda se faça necessária nos atributos da tabela-temporária, seja na ordem, inclusão, alteração ou exclusão deverá ser informado a Sra. Elisabete Oliveira (mailto: [email protected]) para que a mesma possa alterar os programas do Recebimento e de Integração com o EMS 2.