Histórico da Página
...
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 Cadastro de Marketplace.
2. Executar o programa API(utilizar o nome externo), da seguinte forma:
...
run prgfin/acr/acr563za.py persistent set v_hdl_programa.
run pirun pi_main_api_concil_mktplace_arq_imp in v_hdl_programa 3 (input vp_cdn_mktplace, input-output output table tt_movto_mktplace_imp, output output table tt_log_erros, input v_log_import_valid).
delete procedure v_hdl_programa.
...
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. Cadastro de Marketplace.
v_log_import_valid: Determinará que irá realizar a validação da conciliação no momento que importa.
Tabelas Temporárias
Tabela Temporária | Descrição | Entrada/Saída |
tt_movto_mktplace_imp | Conterá as informações dos movimentos marketplaces que serão gerados para o Marketplace informado | Entrada/Saída |
Atributo | Descrição | Formato | Descrição | Obrigatório | Observação |
tta_cod_id_trans | character | x(30) | ID Transação | Não | |
tta_cod_ped_vda | character | x( |
15) | Pedido Venda | Sim | Será o campo usado para encontrar o título a receber no processamento da conciliação | ||
tta_des_ped_movto_mktplace | character | x(40) | Pedido Movto Market | Não | |
tta_cod_nota_fisc | character | x(16) | Nota Fiscal | Não | |
tta_nom_cliente | character | x(40) | Nome Cliente | Não | |
tta_dat_compra | date | 99/99/9999 | Data Compra | Não | |
tta_dat_pagto | date | 99/99/9999 | Data Pagamento | Sim | Será a data usada para liquidar os títulos a receber |
tta_des_parc_pagto | character | x(40) | Parcela Pagto |
Não | ||||
tta_ind_movto_concil | character | X(15) | Movimento Conciliação | Sim |
Não informar, será preenchido com o tipo de transação da transação do Cadastro de Marketplace com base no campo tta_cod_trans_mktplace. | |||||
tta_val_movto | decimal | ->>,>>>,>>>,>>9.99 | Valor Movimento | Não | Somente informar se tta_ |
cod_ |
trans_ |
mktplace NÃO for do tipo Liquidação no Cadastro de Marketplace. Pode receber valores negativos. | ||
tta_val_perc_comis | decimal | >>9. |
9999 | Percentual Comissão | Sim | Somente informar se tta_ |
cod_ |
trans_ |
mktplace for do tipo Liquidação no Cadastro de Marketplace | |||||
tta_val_comis | decimal | >>>,>>>,>>9.9999 | Valor Comissão | Não | Somente informar se tta_ |
cod_ |
trans_ |
mktplace for do tipo Liquidação no Cadastro de Marketplace | |||||
tta_val_repas_brut | decimal | ->>,>>>,>>>,>>9.99 | Vl Repasse Bruto | Não | Somente informar se tta_ |
cod_ |
trans_ |
mktplace for do tipo Liquidação no Cadastro de Marketplace | |||||
tta_val_repas_liq | decimal | ->>,>>>,>>>,>>9.99 | Vl Repasse Líquido | Não | Somente informar se tta_ |
cod_ |
trans_ |
mktplace for do tipo Liquidação no Cadastro de Marketplace | |||||
tta_num_lin_importa | integer | >>>>,>>9 | Linha Importação | Não | Não informar |
tta_num_id_concil_mktplace | integer | 999999999 | ID Concil Mktplace | Não | Retornará o número da conciliação criada |
tta_num_movto_mktplace | integer | 999999999 | Movto Marketplace | Não | Retornará o número do movimento criado |
tta_des_lin_import | character | x(2000) | Linha Importada | Não | Não informar |
tta_cod_estab | character | x(5) | Estabelecimento | Não | |
tta_cod_espec_docto | character | x(3) | Espécie Documento | Não | |
tta_cod_ser_docto | character | x(5) | Série Documento | Não | |
tta_cod_tit_acr | character | x(16) | Título | Não | |
tta_cod_parcela | character | x(02) | Parcela | Não | |
tta_cod_trans_mktplace | character | x(20) | Cod Transação | Não | Transação do marketplace cadastrada no Cadastro de Marketplace |
ttv_val_frete | decimal | ->>,>>>,>>>,>>9.99 | Valor Frete | Não | |
tta_num_id_tit_acr | integer | 999999999 | ID Token Título a Receber | Não | Não deve ser informado. Para vincular o movimento marketplace a um título a receber específico use os campos tta_cod_estab, tta_cod_espec_docto, tta_cod_ser_docto, tta_cod_tit_acr e tta_cod_parcela |
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(
...
15)" 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)"
...
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.
...
9999" decimals
...
4 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 "Linha Importada"
field tta_cod_estab as character format "x(5)" label "Estabelecimento" column-label "Estab"
field tta_cod_espec_docto as character format "x(3)" label "Esp‚cie Documento" column-label "Esp‚cie"
field tta_cod_ser_docto as character format "x(5)" label "S‚rie Documento" column-label "S‚rie"
field tta_cod_tit_acr as character format "x(16)" label "T¡tulo" column-label "T¡tulo"
field tta_cod_parcela as character format "x(02)" label "Parcela" column-label "Parcela"
field tta_cod_trans_mktplace as character format "x(20)" label "Cod Transa‡Æo" column-label "Cod Transa‡Æo"
field ttv_val_frete as decimal format "->>,>>>,>>>,>>9.99" decimals 2 label "Valor Frete" column-label "Valor Frete"
field tta_num_id_tit_acr as integer format "999999999" initial 0 label "Token Cta Receber" column-label "Token Cta Receber"
.
Tabela Temporária | Descrição | Entrada/Saída |
tt_log_erros | Conterá as informações de erros na integração dos movimentos | Saída |
...
field ttv_num_seq as integer format ">>>,>>9" label "Seqüência" column-label "Seq"
field ttv_num_cod_erro as integer format ">>>>,>>9" label "Número" column-label "Número"
field ttv_des_erro as character format "x(50)" label "Inconsistência" column-label "Inconsistência"
field ttv_des_ajuda as character format "x(50)" label "Ajuda" column-label "Ajuda"
index tt_id
ttv_num_seq ascending
ttv_num_cod_erro ascending
.
Para maiores informações consulta Tutoriais - Conciliação Marketplace