Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.                                                             

Informações Gerais

 

Especificação

Produto

Datasul

Módulo

ACR

Segmento Executor

Manufatura

Projeto

MANFIN01

IRM

MANFIN01-433

Requisito

MANFIN01-1054 

Subtarefa

MANFIN01-1089

País

( x ) Brasil  (  ) Argentina  (  ) Mexico  (  ) Chile  (  ) Paraguai  (  ) Equador

(  ) USA  (  ) Colombia   (  ) Outro _____________.

Objetivo

Na integração marketplace - contas a receber, será necessário importar para o ERP as informações referentes aos pagamentos realizados. Estas informações podem vir dos marketplaces em arquivos do tipo  TXT, XLS, XML ou alguma variação destas extenções, como por exemplo XLSX - > XLS; CSV - > TXT.

Além dos diferentes tipos de arquivo, cada marketplace utiliza um layout diferente, de forma que a disposição das informações estão numa ordem especifica daquele marketplace.

Por conta das diferentes formas em que a informação pode chegar, além da rotina de importação, se faz necessária a criação de uma interface de parametrização desta importação, de forma que o usuário poderá definir o layout e o tipo do arquivo que deseja importar. 

Esta rotina de parametrização deverá ser construída da maneira mais genérica possível, permitindo o reuso por outras rotinas de importação. 

Existirá ainda uma outra rotina de relatório, que irá listar os registros que já se encontram na base.

Definição da Regra de Negócio

 

Rotina

Tipo de Operação

Opção de Menu

Manutenção Layout Transação

Nova

Datasul -> Financeiro / Controladoria ->Universal -> Cadastros

API Processo Transação Importação

Nova

 

Importador Movimento da Administradorado Marketplace

Nova

Datasul -> Financeiro / Controladoria -> Cobranças Especiais Contas a Receber -> Tarefas

relatório_admRelatório Movimentos MarketplaceNovaDatasul -> Financeiro / Controladoria -> Cobranças Especiais Contas a Receber -> Relatórios

 

Cadastro de Layout da Transação.

As informações desta rotina serão guardadas em duas novas tabelas: layout_transacao trans e item_layout_transaçãotrans, onde as informações gerais serão guardadas na tabela pai layout_transacao trans e na tabela filha item_layout_transacao trans serão armazenadas as informações dos campos individualmente. Deve ser criado num um terceiro programa, sem interface, onde constarão, fixas no fonte, quais são as transações disponíveis e quais os campos que cada transação utilizará. A opção de XML não será tratada neste projeto, portanto não deve apresentar em tela nenhuma informação referente a este tipo de arquivo.

Tela-pai (Protótipo de tela 1):

Na tela-pai o usuário deve ser capaz de informar um código identificador (campo chave) e uma descrição para o layout. Também deverá permitir indicar se o layout é de importação ou exportação, e qual a transação que será importada. No caso deste projeto, a transação sempre será “Pagto Marketplace”. 

O usuário também deverá indicar qual a extensão do arquivo que irá importar, se .TXT, .XLS ou .XML. Caso a extensão seja .TXT, deverá ser informado a delimitação dos campos: se por posição ou por um separador. Caso seja por um separador, deve gravar qual é. Caso a extensão seja .TXT ou .XLS, existirá um flag que indicará se o arquivo utiliza ou não um cabeçalho, de forma que a primeira linha do arquivo seja desconsiderada.

Tela-filha(Protótipo de tela 2):

Na tela filha, dependendo da transação informada na tela pai, deve carregar a listagem de campos que o usuário pode parametrizar. Esta busca deve ser feita no terceiro programa,onde estarão as definições de campos por transação.

Não será exibido para o usuário o código do campo. No lugar disto, será somente exibido o label definido para aquele campo daquela transação.

Uma vez carregado todos os campos, o usuário poderá informar, para cada campo:

  • A ordem em que o campo irá aparecer na linha do registro;
  • Um valor padrão;
  • Um campo que indicará se o usuário deseja importar: 
    • Todos os registros; 
    • Somente os registros que atendam uma regra; 
    • Todos os registros, exceto aqueles que atendam uma regra;
  • A regra/descrição que deve ser aplicada, caso informe uma das duas ultimas opções no item anterior;

No caso especifico da extensão .TXT delimitada por posição, o usuário deve informar, além da posição inicial do campo, o seu tamanho, para que a importação seja possível. Nos outros casos, o campo tamanho será mostrado, mas desabilitado, e exibindo o valor de tamanho máximo cadastrado para a transação

Quando for informado um valor padrão, o conteúdo daquele campo será desconsiderado, e sempre irá importar o valor padrão. 

Validações:

Caso o layout já tenha um processo (será descrito mais abaixo neste documento), não poderá ser modificado ou excluído, assim fica garantido que a importação realizada sempre terá um layout cadastrado válido.

Uma vez criado o layout, não será mais possível alterar o tipo de transação.

Com todas as informações do layout devidamente cadastradas nas tabelas layout_transacao trans e item_layout_transacaotrans, poderá avançar para a rotina de importação.

Importador

Movimento da Administradora.

Movimentos do Marketplace

Para cada transação, deve existir uma tela de importação. Porém o processo de importação em si será encapsulado em uma API que deverá ser criada. 

API

Esta API deve receber como parâmetro o layout que será usado, o nome do arquivo, o diretório onde o arquivo está, o diretório para onde o arquivo será enviado em caso de sucesso, o diretório para onde o arquivo será enviado em caso de erro e a situação do processo, que por default será ' '.  A API deverá retornar uma temp-table com os dados que irá ler dos arquivos e o código do processo que foi criado nesta importação.

O objetivo da API é ler todo o arquivo, de acordo com a parametrização do layout, gravar estas informações numa temp-table, criar um processo de importação e retornar os dados para que o programa de importação possa gravar no banco. A API só irá criar o processo, nada mais.

A estrutura da API segue os seguintes passos:

  • Validar parâmetros de entrada;
  • Criar processo transação;
  • Importar os dados de acordo com o tipo de arquivo cadastrado no layout;
  • Se não houver nenhum erro até este momento, tenta mover o arquivo para a pasta destino;
  • se falhar, ou se houver algum outro erro, move o arquivo para a pasta de erro.
  • Devolver a temp-table com os dados, a de erros e o código do processo criado.

Caso o extrato de versão esteja ativo, a API deverá exportar as temp-tables e o registro do processo num diretório especificado.

Tabela de processos

A tabela de processos de importação das transações é uma tabela filha da tabela de parametrização (layout_transacaotrans) e será pai de todas as tabelas de transação , (no caso deste projeto movto_admdramktplace). Esta tabela tem como objetivo guardar informações da importação do arquivo, sendo necessário guardar:

  • O código do layout;
  • Um identificador numérico sequencial;
  • O nome do arquivo importado;
  • O caminho completo do arquivo;
  • A data e hora da criação;
  • A data e hora da última modificação;
  • A data e hora da importação do arquivo;
  • Um indicador da situação do processo;
  • O usuário que realizou a importação.

Com esta tabela, é possível filtrar os registros criados pelo mesmo arquivo, sem precisar replicar diversos campos em todos os registros.

Tela Importação(Protótipo de tela 3):

Este programa será responsável por criar os movimentos das administradoras selecionadasdos marketplaces selecionados, utilizando os dados de acordo com o que for retornado da API, que será chamada conforme a parametrização da administradorado marketplace.

 A tela conterá uma seleção de administradoras e bandeirasmarketplaces, que irá carregar num browse todos os registros correspondentes a busca, onde o usuário poderá marcar de quais administradoras marketplaces deseja importar. Neste browse será apresentado a identificação da administradorado marketplace, o código do layout que utiliza, e o local de origem dos arquivos que serão importados.

Para cada administradora terá uma parametrização em uma tabela à parteA parametrização dos marketplaces estarão na tabela param_mktplace (ER_MANFIN01-435_CIASHOP-ACR-Lote_Marketplace), onde, entre outras coisas, constará qual o layout que a administradora utiliza, o local onde os arquivos estão, para onde devem ir e um local em casos de erros.

Com estes parâmetros já é possível utilizar a API, portanto, para cada documento de cada administradoramarketplace, deve fazer a chamada correspondente a API. Quando esta terminar seu processamento, o programa de importação deverá criar registros na tabela movto_admdra mktplace de acordo com a temp-table retornada. Além disso, deve gerar um relatório, onde constarão o total de arquivos encontrados e importados de cada administradoramarketplace, quantos registros foram importados em cada arquivo e o local de origem e atual do arquivo. Também deverá ser apresentado os possíveis erros neste relatório.

ACRxxx - relatório_adm.

Relatório Movimentos Marketplace

O objetivo deste programa é a consulta dos movimentos de administradora já importados por meio de um relatório. 

A interface deste programa deve seguir o layout padrão dos outros programas de relatório, com todas as funcionalidades padrões já existentes. Na faixa de seleção, deve ser possivel filtrar por:

  • administradora de créditopor marketplace;
  • por layout utilizado;
  • por data de importação;

Este relatório servirá para simples conferencia de tudo o que já foi importado até o momento.



Protótipo de Tela

 

 

Protótipo 01

 

 

 

Protótipo 02

 

 

 


 Protótipo 3:

Image Removed


Image Added 

 

Fluxo do Processo

 <não se aplica>. 

Dicionário de Dados

 

TabelaDescriçãoBancoMódulo
movto_
admdra

Movimento da administradora

movfin
mktplaceMovimentos do MarketplaceemsfinACR
CampoTipoTamanhoValor InicialMandatórioTítuloAbrevPictureHelp de Campo

num_movto_admdra

int

11

0

Sim

Nr Movto Admdra

Número Mov

>>>,>>>,>>>,>>9

Número Movimento da Administradora

cod_admdra_cartao_cr

char

5

 

Sim

Administradora

Administrad

x(5)

Código Administradora Cartão Crédito

cod_band

char

10

 

Sim

Bandeira

Band

x(10)

Código da Bandeira

ind_tip_trans_movto_admdra

char

15

"Liquidação"

Sim

Transação

Trans

x(15)

cod_empresacharacter3 simEmpresa             Emp         x(3)Código Empresa
cdn_mktplaceInteger40simMarketplace         Marketplace >>>9Marketplace
cdn_proces_transInteger60simCódigo              Código      >>>,>>9Código Processo Transação
num_lin_importainteger70simLinha Importação    Linha Import>>>>,>>9Linha Importação
num_pasta_importainteger70nãoPasta Importação    Pasta Import>>>>,>>9Pasta Importação
num_movto_mktplaceinteger90simMovto Marketplace   Movto Market999999999Número Movimento Marketplace
ind_sit_movto_mktplacecharacter15PendentesimSituação Movto      Sit Movto   X(15)Situação Movto Marketplace
ind_trans_movto_mktplacecharacter15LiquidaçãosimTransação           Transação   X(15)Indicador Transação Movimento Marketplace
Tipo Transação Movimento Administradora
cod_ped_vda
char
character12 
Não
nãoPedido
Venda
Venda        Ped
Vda
Vda     x(12)Código Pedido Venda
des_sit_movto_
admdra
mktplace
char
character40 
Não
nãoSituação Movto Marke
Situação
Situação    
X
x(40)Descrição Situação
Movimento Administradora
Movto Marketplace
dat_sit_movto_
admdra
mktplacedate
10
8
 
?
Não
não
Dt
Situação Movto MarkeDt
Situação
Situação 99/99/9999Data Situação
Movimento Administradora
Movto Marketplace
dat_compradate
10
8
 
?
Não
nãoData
compra
Compra         Dt
compra
Compra   99/99/9999Data Compra
.
dat_pagtodate
10
8
 
today
Não
nãoData
Pagamento
Pagamento      Data
Pagto
Pagto  99/99/9999Data
do
Pagamento
dat_estorn_movtodate
10
8
 
?
Não
nãoDt Estorno
Movto
Movto    Dt
Estorno
Estorno  99/99/9999Data
do
Estorno
do
Movimento
dat_liber_peddate
10
8
 
?
Não
nãoDt
Liberação
Liberação        Dt Liberação99/99/9999Data
da
Liberação Pedido
dat_prev_pagtodate
10
8
 
today
Não
nãoData Prevista
Pgto
Pgto  Prev
Pagto
Pagto  99/99/9999Data Prevista Pagamento
dat_envio_mercaddate
10
8
 
?
Não
não
Data
Dt Envio
Mercadoria
Mercadoria Dt
Envio
Envio    99/99/9999Data Envio Mercadoria
dat_notif_enviodate
10
8
 
?
Não
não
Data
Dt Notificação EnvioDt
Notific
Notific  99/99/9999Data de Notificação de Envio
des_produt
char
character100 
Não
nãoDescrição
Produto
Produto   
Produto
Produto     
X
x(100)Descrição do Produto
des_tip_pagto
char
character20 
Não
nãoTipo
Pagamento
Pagamento      Tp
Pagto
Pagto    
X
x(20)Descrição Tipo Pagamento
val_ped_vda
dec
decimal
11
13
 
0
Não
nãoValor
pedido
Pedido        Vl
Pedido
Pedido   ->>,>>>,>>>,>>9.99Valor do Pedido
des_parc_pagto
char
character40 
Não
nãoDesc Parcela
Pagto
Pagto  Desc
Parc
Cta Pgo
X
x(40)Descrição Parcela Pagamento
val_produt
dec
decimal
11
13
 
0
Não
nãoValor
produto
Produto       Vl
Produto
Produto  ->>,>>>,>>>,>>9.99Valor do Produto
valor
val_frete
dec
decimal
11
13
 
0
Não
nãoValor
frete
Frete         
Frete
Frete       ->>,>>>,>>>,>>9.99Valor do Frete
val_repas_brut
dec
decimal
11
13
 
0
Não
não
Valor
Vl Repasse
Bruto
Bruto    Vl Rep
Brut
Brut ->>,>>>,>>>,>>9.99Valor Repasse Bruto
val_perc_comis
dec
decimal
4
5
 
0
Não
nãoPercentual
Comissão
Comissão Perc
Comis
Comis  
>9
>>9.99Percentual Comissão
val_comis
dec
decimal
11
13
 
0
Não
nãoValor
Comissão
Comissão      Val Comissão>>>,>>>,>>9.
99
9999Valor Comissão
val_repas_liq
dec
decimal
11
13
 
0
Não
não
Valor
Vl Repasse
Líquido
Líquido  Vl Rep
Liq
Liq  ->>,>>>,>>>,>>9.99Valor Repasse Líquido
ind
des_
sit
orig_movto_
admdra
mktplace
char
character
15
50
Pendente
 
Sim
não
Situação
Origem Movto Market 
Sit Movto
Origem      
X
x(
15
50)

Situação Movimento Administradora

Origem Movimento Marketplace
des_ped_movto_mktplacecharacter40 nãoPedido Movto Market Pedido      x(40)Pedido Movimento Marketplace
ÍndiceTipoChave
mvtmktpl_dat_comp  cod_empresa cdn_mktplace dat_compra

Índice

Tipo

Chave

mvtdmdr_id

Primário/único

num_movto_admdra

mvtdmdr_ped_vda

 

cod_ped_vda

ind_sit_movto_
admdra
mktplace
mvtdmdr
mvtmktpl_dat_
comp
estorn  cod_empresa cdn_mktplace dat_estorn_
compra
movto ind_sit_movto_
admdra
mktplace
mvtdmdr
mvtmktpl_dt_
dat
prev_
estor
pag  cod_empresa cdn_mktplace dat_
eston
prev_
movto
pagto ind_sit_movto_
admdramvtdmdr_dat_prv_pag
mktplace
mvtmktpl_empres 

dat_prev_pagto

 cod_empresa ind_sit_movto_
admdra
mktplace
mvtdmdr
mvtmktpl_
admdra
id
 

cod_admdra_cartao_cr

cod_band

Primário/Único num_movto_mktplace
mvtmktpl_ped_vda  cod_empresa cod_ped_vda ind_sit_movto_
admdra
mktplace
mvtmktpl_proc_trans  cdn_proces_trans

 

 

TabelaDescriçãoBancoMódulo
proces_transProcesso TransaçãoemsuniUTB
CampoTipoTamanhoValor InicialMandatórioTítuloAbrevPictureHelp de Campo
cod_layout_transcharacter8 simCódigo Layout TransCod Layoutx(8)Código do Layout Transação
cdn_proces_transinteger760simCódigoCódigo->,>>>,>>9Código Processo Transação
cod_nom_arqcharacter40 simNome ArquivoNome Arquivox(40)Nome Arquivo
des_caminho_completcharacter150 simCaminho CompletoCaminho Compx(150)Caminho Completo do Arquivo
dat_criac_arqdate10?nãoDt Criação ArquivoDt Criação99/99/9999Data Criação Arquivo
hra_criac_arqcharacter8 nãoHr Criação ArquivoHr Criação99:99:99Hora Criação Arquivo
dat_ult_mod_arqdate10?nãoDt Último ModificDt Ult Mod99/99/9999Data Último Modificação Arquivo
hra_ult_mod_arqcharacter8 nãoDt Hr Último ModificDt Hr Ult Mod99:99:99Hora Último Modificação Arquivo
dat_import_arqdate10?simDt ImportaçãoDt ImportaçãoImport99/99/9999Data Importação Arquivo
hra_import_arqcharacter8 simHr ImportaçãoHr ImportaçãoImport99:99:99Hora Importação Arquivo
ind_sit_proces_transcharacter15AtivonãoSituação ProcessoSit Processox(15)Situação Processo Transação
cod_usuar_importcharacter12 nãoUsuário ImportaçãoUsuáriox(12)Código Usuário Importação
ÍndiceTipoChave
prcstrns_idPrimario/únicocod_layout_trans
cdn_proces_trans 

 

 

 

TabelaDescriçãoBancoMódulo
layout_transLayout TransaçãoemsuniUTB
CampoTipoTamanhoValor InicialMandatórioTítuloAbrevPictureHelp de Campo
cod_layout_transcharacter8 simCódigo Layout TransCod Layoutx(8)Código do Layout Transação
des_layout_transcharacter40 nãoDescrição LayoutDescriçãox(40)Descrição do Layout Transação
ind_operac_layoutcharacter15ImportaçãosimOperação LayoutOperaçãox(15)Operação do Layout
ind_tip_arq_layoutcharacter5TXTsimTipo ArquivoTipo Arqx(5)Tipo do Arquivo
ind_tip_delimitaccharacter15(nenhum)nãoTipo DelimitaçãoDelimitaçãox(15)Indicador Tipo Delimitação
cod_delimitcharacter3 nãoDelimitadorDelimitadorx(3)Delimitador
ind_trans_layoutcharacter30Pagto MarketplacesimTransaçãoTransaçãox(30)Transação do Layout
log_usa_cabeclogical nonãoUsa CabecalhoCabecalhoyes/noUsa Cabeçalho ?
ÍndiceTipoChave
lyttrns_idPrimario/únicocod_layout_trans

 

 

 

TabelaDescriçãoBancoMódulo
item_layout_transItem Layout TransaçãoemsuniUTB
CampoTipoTamanhoValor InicialMandatórioTítuloAbrevPictureHelp de Campo
cod_layout_transcharacter8 simCódigo Layout TransCod Layoutx(8)Código do Layout Transação
cod_campocharacter40 simCampoCampox(40)Código Campo
des_label_campocharacter50 simLabelLabelx(50)Label do Campo
ind_tip_campocharacter10CharactersimTipo CampoTipox(10)Tipo do Campo
num_tam_campointeger50simTamanho CampoTamanho>,>>9Tamanho do Campo
num_pos_campointeger70simPosição CampoPosição>>>,>>9Posição do Campo
des_val_padr_campocharacter40 nãoValor Padrão CampoValor Padrãox(40)Descrição Valor Padrão Campo
ind_regra_exceccharacter20TodosnãoImportarImportarx(20)Regra para Importação da Linha
des_lista_regra_exceccharacter200 nãoListaListax(200)Lista de Regras ou Exceções
des_tag_xmlcharacter40 nãoTAG XMLTAGx(40)TAG do XML
ÍndiceTipoChave
itmlyttr_idPrimario/único

cod_layout_trans

cod_campo

Grupo de Perguntas

<não se aplica>.

Consulta Padrão

<não se aplica>.

Estrutura de Menu

 

Procedimentos

 

Procedimento

 

 

 

Descrição

(Max 40 posições)

(Max 40 posições)

(Max 40 posições)

Módulo

 

 

 

Programa base

 

 

 

Nome Menu

(Max 32 posições)

(Max 32 posições)

(Max 32 posições)

Interface

GUI/WEB/ChUI/Flex

GUI/WEB/ChUI/Flex

GUI/WEB/ChUI/Flex

Registro padrão

Sim

Sim

Sim

Visualiza Menu

Sim/Não

Sim/Não

Sim/Não

Release de Liberação

 

 

 

 

 

 

Programas

 

Programa

 

 

 

Descrição

(Max 40 posições)

(Max 40 posições)

(Max 40 posições)

Nome Externo

 

 

 

Nome Menu/Programa

(Max 32 posições)

(Max 32 posições)

(Max 32 posições)

Nome Verbalizado[1]

(Max 254 posições)

(Max 254 posições)

(Max 254 posições)

Procedimento

 

 

 

Template

(Verificar lista de opções no man01211)

(Verificar lista de opções no man01211)

(Verificar lista de opções no man01211)

Tipo[2]

Consulta/Manutenção/ Relatório/Tarefas

Consulta/Manutenção/ Relatório/Tarefas

Consulta/Manutenção/ Relatório/Tarefas

Interface

GUI/WEB/ChUI/Flex

GUI/WEB/ChUI/Flex

GUI/WEB/ChUI/Flex

Categoria[3]

 

 

 

Executa via RPC

Sim/Não

Sim/Não

Sim/Não

Registro padrão

Sim

Sim

Sim

Outro Produto

Não

Não

Não

Visualiza Menu

Sim/Não

Sim/Não

Sim/Não

Query on-line

Sim/Não

Sim/Não

Sim/Não

Log Exec.

Sim/Não

Sim/Não

Sim/Não

Rotina (EMS)

 

 

 

Sub-Rotina (EMS)

 

 

 

Localização dentro da Sub Rotina (EMS)

 

 

 

Compact[4]

Sim/Não

Sim/Não

Sim/Não

Home[5]

Sim/Não

Sim/Não

Sim/Não

Posição do Portlet[6]

0 – Top Left

1 – Top Right

2 – Bottom Left

3 – Bottom Right

0 – Top Left

1 – Top Right

2 – Bottom Left

3 – Bottom Right

0 – Top Left

1 – Top Right

2 – Bottom Left

3 – Bottom Right

Informar os papeis com os quais o programa deve ser vinculado

 

 

 

 

Cadastro de Papéis

<não se aplica>..

 


 

 Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico.