Histórico da Página
Documento de API
Produto: | Datasul |
Ocorrência: | Documentação de API |
Nome Físico | prgfin/acr/acr563za |
Objetivo
Gerar movimentos dos Marketplaces para conciliação dos repasses realizados pelos mesmos
Funcionamento
1. No programa que irá chamar está API, devem ser definidas as temp-table (tt_movto_mktplace_imp) e temp-table (tt_log_erros). Além disso, deverá ser informado o código do Marketplace que deverá estar cadastrado no programa acr067aa.
2. Executar o programa API(utilizar o nome externo), da seguinte forma:
def var v_hdl_programa as handle no-undo.
run prgfin/acr/acr563za.py persistent set v_hdl_programa.
run pi_main_api_concil_mktplace_arq_imp in v_hdl_programa (input v_cdn_mktplace, input
...
-output table tt_movto_mktplace_imp, output table tt_log_erros).
delete procedure v_hdl_programa.
3. Após a execução do programa, deve ser testada a temp-table de erro (tt_log_erros), para verificar se houveram ou não erros durante o processo de importação.
Parâmetro
...
entrada
v_cdn_mktplace: Determinará para qual Marketplace será gerada a conciliação e seus movimentos. O código informado deverá estar cadastrado no programa acr067aa.
Tabelas Temporárias
Tabela Temporária | Descrição | Entrada/Saída |
tt_movto_ |
mktplace_ |
imp | Conterá as informações dos movimentos |
Entrada
(*) A partir da 5.07A o estabelecimento passa a ter cinco dígitos.
marketplaces que serão gerados para o Marketplace informado | Entrada/Saída |
Atributo | Descrição | Atributo | TipoFormato | Descrição | Obrig.Obrigatório | Evol.Observação | |||||||||||||||||
tta_cod_ | empresacharacter | x(3) | Empresa | Sim | tta_cdn_repres | Integer | >>>,>>9 | Representante | Sim | tta_cod_estabid_trans | character | x( | 3) / x(5)*30) | ID Transação | Não | Estabelecimento | Sim|||||||
tta_cod_ | especped_ | doctovda | character | x( | 312) | Espécie DocumentoPedido Venda | Sim | Será o campo usado para encontrar o título a receber no processamento da conciliação | |||||||||||||||
tta_ | coddes_ped_ | sermovto_ | doctomktplace | character | x( | 340) | Série Documento | SimPedido Movto Market | Não | ||||||||||||||
tta_cod_ | titnota_ | acrfisc | character | x( | 1016) | TítuloNota Fiscal | SimNão | ||||||||||||||||
tta_ | codnom_ | parcelacliente | character | x( | 0240) | ParcelaNome Cliente | SimNão | ||||||||||||||||
tta_ | coddat_ | refercompra | character | x(10) | Referência | Sim | tta_cod_usuario | character | x(12) | Usuário | Sim | date | 99/99/9999 | Data Compra | Não | ||||||||
tta_dat_ | transacaopagto | date | 99/99/9999 | Data | TransaçãoPagamento | Sim | Será a data usada para liquidar os títulos a receber | ||||||||||||||||
tta_ | inddes_ | transparc_ | acrpagto | character | Xx( | 2940) | TransaçãoParcela Pagto | SimNão | |||||||||||||||
tta_ | inddes_ | sit_movto_ | comismktplace | character | Xx( | 1880) | SituaçãoMovimento Marketplac | SimNão | |||||||||||||||
tta_ind_ | tipmovto_ | movtoconcil | character | X( | 2015) | TipoMovimento Conciliação | Sim | Deve ser Liquidação ou Não tratado | |||||||||||||||
tta_val_movto | decimal | ->>,>>>,>>>,>>9.99 | Valor Movimento | Não | Somente informar se tta_ind | _natur_lancto_ctblcharacter | X(02) | Natureza | Sim | _movto_concil não for liquidação. Pode receber valores negativos. | |||||||||||||
tta_val_perc_comis | decimal | >>9.99 | Percentual Comissão | Sim | Somente informar se tta_ind_movto_concil for liquidação | ||||||||||||||||||
tta_val | tta_val_base_calc_comis | decimal | >>>,>>>,>>9. | 99Base Calc Comis | Sim9999 | Valor Comissão | Não | Somente informar se tta_ind_movto_concil for liquidação | |||||||||||||||
tta_val_ | movtorepas_ | comisbrut | decimal | ->>,>>>,>>>,>>9.99 | Valor Movimento | Sim | Vl Repasse Bruto | Não | Somente informar se tta_ind_movto_concil for liquidação | ||||||||||||||
tta_val_repas_liq | decimal | ->>,>>>,>>>,>>9.99 | Vl Repasse Líquido | Não | Somente informar se tta_ind_movto_concil for liquidação | ||||||||||||||||||
tta_num_lin_importa | integer | >>>>,>>9 | Linha Importação | Não | Não informar | 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_ | movtoconcil_ | tit_acrmktplace | integer | 9999999999 | Token Movto Tit ACR | Sim999999999 | ID Concil Mktplace | Não | Retornará o número da conciliação criada | ||||||||||||||
tta_ | indnum_ | transmovto_ | comismktplace | integer | character | X(30) | Transação Comissão | Sim999999999 | Movto Marketplace | Não | Retornará o número do movimento criado | ||||||||||||
tta_ | coddes_ | unidlin_ | negocimport | character | x( | 32000) | Unid NegócioLinha Importada | Não | ttv_log_consid_movto_pagtological | "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 | Não informar |
def temp-table tt_movto_
...
mktplace_
...
imp no-undo
...
field tta_cod_
...
id_trans as character format "x(
...
30)" label "
...
ID Transação" column-label "
...
ID Transação"
...
field tta_
...
cod_ped_vda as character format "x(
...
12)" label "
...
Pedido Venda" column-label "
...
Pedido Venda"
...
field tta_
...
des_ped_
...
movto_
...
mktplace as character format "x(
...
40)" label "
...
Pedido Movto Market" column-label "
...
Pedido Movto Market"
...
field tta_cod_
...
nota_
...
fisc as character format "x(
...
16)" label "
...
Nota Fiscal" column-label "
...
Nota Fiscal"
...
field tta_
...
nom_
...
cliente as character format "x(
...
40)" label "
...
Nome Cliente" column-label "
...
Nome Cliente"
...
field tta_
...
dat_
...
compra as
...
date format "
...
99/99/9999" initial ? label "Data Compra" column-label "
...
Dt Compra"
...
field tta_
...
dat_
...
pagto as
...
date format "
...
99/99/9999" initial today label "Data Pagamento" column-label "
...
Data Pagto"
...
field tta_des_
...
parc_
...
pagto as character format "x(
...
40)" label "
...
Desc Parcela Pagto" column-label "
...
Desc Cal Pagto"
...
field tta_des_
...
movto_
...
mktplace as
...
character format "
...
x(80)" label "Movimento Marketplac" column-label "
...
Movimento Marketplac"
...
field tta_ind_
...
movto_
...
concil as character format "X(
...
15)" initial "
...
Liquidação" label "
...
Movimento Concil" column-label "
...
Movimento Concil"
...
field tta_
...
val_
...
movto
...
as
...
decimal format "
...
->>,>>>,>>>,>>9.99" decimals 2 initial 0 label "Valor Movimento" column-label "
...
Vl Movto"
...
field tta_
...
val_
...
perc_
...
comis as
...
decimal format "
...
>>9.99" decimals 2 initial 0 label "Percentual Comissão" column-label "
...
Perc Comis"
...
field tta_
...
val_comis as decimal format ">>>,>>>,>>9.9999" decimals 4 initial 0 label "Valor Comissão" column-label "
...
Valor Comissão"
...
field tta_val_
...
repas_
...
brut as decimal format "->>,>>>,>>>,>>9.99" decimals 2 initial 0 label "
...
Vl Repasse Bruto" column-label "
...
Vl Rep Brut"
...
field tta_val_
...
repas_
...
liq as decimal format "->>,>>>,>>>,>>9.99" decimals 2 initial 0 label "
...
Vl Repasse Líquido" column-label "
...
Vl Rep Liq"
...
field tta_num_
...
lin_
...
importa as integer format "
...
>>>>,>>9" initial 0 label "
...
Linha Importação" column-label "
...
Linha Importação"
...
field tta_
...
num_
...
id_
...
concil_
...
mktplace as
...
integer format "
...
999999999" initial 0 label "
...
ID Concil Mktplace" column-label "
...
ID Concil Mktplace"
...
field tta_num_
...
movto_
...
mktplace as integer format "
...
999999999" initial 0 label "
...
Movto
...
Marketplace" column-label "
...
Movto
...
Marketplace"
...
field tta_
...
des_
...
lin_import as character format "x(
...
2000)" label "
...
Linha Importada" column-label "
...
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
...
Linha Importada"
.
OBSERVAÇÕES:
- 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_erro | 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 |
def temp-table tt_movto_comis_erro no-undo
field tta_cod_empresa as character format "x(3)" label "Empresa" column-label "Empresa"
field tta_cdn_repres as Integer format ">>>,>>9" initial 0 label "Representante" column-label "Representante"
field ttv_num_seq_movto_comis_erro as integer format ">>>>,>>9" label "Num Sequência" column-label "Num Sequência"
field ttv_des_mensagem as character format "x(50)" label "Mensagem" column-label "Mensagem"
field ttv_des_ajuda as character format "x(50)" label "Ajuda" column-label "Ajuda"
index tt_id_movto
tta_cod_empresa ascending
tta_cdn_repres ascending
ttv_num_seq_movto_comis_erro ascending.