Layout_Suvinil_3 0_basico

Prévia do material em texto

IMPLANTA DESENVOLVIMENTO E INTEGRAÇÃO LTDA.
Suvinil - Cockpit
MANUAL DE INTEGRAÇÃO DE DADOS DE ERP
MODELO RESUMIDO
Histórico de Revisões
Data Versão Descrição
21/10/2015 2.0 Inclusão do campo cind_pro na view SUVINIL_STOCKANDVOLUME. Me-
lhoria na descrição de qtde_pro e qtve_pro. Melhoria na descrição de vali-
dações para pbru_ivn, pliq_ivn, qtde_ivn na view SUVINIL_SALES_ISALES.
Inclusão do anexo com exemplos de relatórios para validação da View SUVI-
NIL_STOCKANDVOLUME
26/10/2015 2.1 Melhoria na descrição do campo qtde_pro.
06/06/2016 3.0 Melhoria na especificação das restrições dos campos das views e das descri-
ções dos relatórios no anexo de exemplos.
Implanta Desenvolvimento e Integração Ltda
Av. Jamel Cecílio, 2496, Jardim Goiás
Edifício New Business Style, Salas A61 e A62
CEP: 74810-100 - Goiânia - GO
+55 (62) 3281-8582
http://www.implantait.com.br
Sumário
Histórico de Revisões ii
1 Introdução e Contextualização da Integração 1
1.1 Introdução . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.2 Pré-requisitos para a Integração . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.3 Alternativas de Integração . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.3.1 Tipo 1 – Views criadas pela software house . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.3.2 Tipo 2 – Views criadas pela Implanta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.4 Dados que Serão Extraídos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.5 Qual a Periodicidade do Envio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.6 Qual o Modelo de Infraestrutura Utilizada . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.7 Casos Omissos e Dúvidas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2 Estrutura das Views 4
2.1 View de Matriz/Filiais do Canal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2.2 View de Estoque e Volume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
A Processo de Validação 7
A.1 Validação de Estoque . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
A.1.1 View de Estoque . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
A.1.2 Relatório de Estoque do ERP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
A.1.3 Relatório de Movimentações de Estoque . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Implanta Desenvolvimento e Integração Ltda
Av. Jamel Cecílio, 2496, Jardim Goiás
Edifício New Business Style, Salas A61 e A62
CEP: 74810-100 - Goiânia - GO
+55 (62) 3281-8582
http://www.implantait.com.br
Capítulo 1
Introdução e Contextualização da Integração
1.1 Introdução
Este documento aborda os detalhes técnicos da implementação da integração de sistemas ERPs e o sistema Cockpit
da BASF-SUVINIL.
O objetivo do projeto é integrar os dados de Sell Out extraídos diretamente do sistema do canal, permitindo a
BASF-SUVINIL apoia-lo de forma proativa, antecipar tendências e gerar ações de marketing mais efetivas.
O sistema possibilitará o acompanhamento mais assertivo das ações de marketing direcionadas, com resultados
e pontuações dos programas da BASF-SUVINIL.
Existem duas alternativas para a implementação desta integração, cada uma com vantagens e desvantagens para
o canal e para a empresa desenvolvedora do software ERP, conforme será abordado nas seções a seguir.
1.2 Pré-requisitos para a Integração
Para que a integração seja realizada, é necessário que alguns requisitos sejam atendidos para que a instalação do
Extrator Implanta e extração diária sejam executados:
• Conexão com a internet banda larga estável;
• Servidor Windows para que o Extrator seja instalado e que este possua acesso ao banco de dados;
• Manter o servidor ligado durante o período de extração;
• Possuir dados históricos de no mínimo a partir de janeiro de 2015.
1.3 Alternativas de Integração
1.3.1 Tipo 1 – Views criadas pela software house
Criação de Visões no banco de dados (views) com a regra de negócio do ERP e uso do extrator padrão Implanta
• A empresa detentora do ERP, apenas ocupa o tempo de um desenvolvedor/DBA para criar as views no formato
apropriado para o extrator padrão;
• O tempo de implementação dos protocolos de segurança e autenticação dos dados necessários é aproveitado
com o uso do extrator padrão Implanta;
• A auditoria e conferência dos dados é feita por técnicos treinados da Implanta, que conhecem completamente a
demanda da BASF-SUVINIL. Estes técnicos comparam os dados extraídos com relatórios do sistema ERP para
garantir a exatidão dos dados;
Implanta Desenvolvimento e Integração Ltda
Av. Jamel Cecílio, 2496, Jardim Goiás
Edifício New Business Style, Salas A61 e A62
CEP: 74810-100 - Goiânia - GO
+55 (62) 3281-8582
http://www.implantait.com.br
SUVINIL - COCKPIT 2
• A evolução do software extrator, para atender demandas da BASF-SUVINIL ou para se ajustar a mudanças
no software ERP também é feita de forma compartilhada: o extrator é atualizado pela Implanta e demandas
de atualização das views são feitas para a empresa detentora do ERP mediante notificação ou solicitação de
mudança;
1.3.2 Tipo 2 – Views criadas pela Implanta
O trabalho de desenvolvimento das views é efetuado pela Implanta IT Solutions, com auxílio da empresa desenvol-
vedora do software ERP para entender a estrutura do banco de dados e realizar a implantação destas no banco de
dados. O Extrator é instalado e mantido pela Implanta.
• Todo o esforço de desenvolvimento é executado pela Implanta;
• A auditoria e conferência dos dados é feita por técnicos treinados da Implanta, que conhecem completamente a
demanda da BASF-SUVINIL. Estes técnicos comparam os dados extraídos com relatórios do sistema ERP para
garantir a exatidão dos dados;
• A evolução do software extrator, para atender demandas da BASF-SUVINIL ou para se ajustar a mudanças no
software ERP também é feita pela Implanta, mediante notificação ou solicitação de mudança;
O Extrator Implanta utiliza um usuário somente leitura para se conectar ao banco de dados do ERP, para garantir
que as informações originais do ERP não serão de forma alguma modificadas pelo extrator.
1.4 Dados que Serão Extraídos
O modelo de integração inclui o envio de informações da revenda, estoque e operações fiscais. Este modelo é definido
durante a fase de negociação entre a BASF-SUVINIL e o canal, e fica estabelecido no contrato entre as partes.
Os dados a serem extraídos para o modelo são:
• Dados da Loja/Filial: CNPJ, Razão Social, Nome Fantasia, CEP, Código do Município IBGE, Logradouro, Nú-
mero do Logradouro, Complemento e Bairro;
• Produto: Código, Descrição, Unidade de Medida, Código de Barras;
• Estoque e Volume Vendido: Quantidade vendida, Quantidade atual em estoque (em unidades) e por período;
Os dados devem ser enviados conforme estão cadastrados no ERP. Não é necessário transformá-los para o padrão
utilizado pela BASF-SUVINIL. Códigos e descrições dos produtos, operações fiscais e outros serão analisados após
o envio. Configurações de padronização (’De-Para’) serão feitas na própria ferramenta de auditoria e configuração,
chamada Cockpit BASF-SUVINIL, pela equipe responsável na Implanta.
1.5 Qual a Periodicidade do Envio
O Extrator deve ser executado diariamente, inclusive finais de semana, após o final do expediente do canal, ou em
horário combinado durante o processo de implantação do extrator.
Casualmente, pode-se executá-lo em datas retroativas, por motivos como falha na exportação ou quando houver
algum ajuste nos dados, por exemplo, em casos de fechamento contábil/fiscal.
Caso o canal desligue os computadoresno final do expediente, é preferível executar a extração nas primeiras
horas da manhã do dia seguinte, enviando o movimento do dia anterior.
O extrator não deve enviar movimentação parcial do dia, ou seja, enquanto o expediente ainda não estiver encer-
rado.
Implanta Desenvolvimento e Integração Ltda
Av. Jamel Cecílio, 2496, Jardim Goiás
Edifício New Business Style, Salas A61 e A62
CEP: 74810-100 - Goiânia - GO
+55 (62) 3281-8582
http://www.implantait.com.br
SUVINIL - COCKPIT 3
1.6 Qual o Modelo de Infraestrutura Utilizada
O extrator deve ser instalado em uma máquina com sistema operacional Windows. Caso o servidor de Banco de Da-
dos seja outro sistema operacional (Linux, por exemplo), esta máquina Windows deverá enxergar e acessar o servidor
de Banco de Dados, através da rede interna por meio de views (visões), de banco de dados, criadas exclusivamente
para este fim.
Importante! É um requisito da integração o acesso a um
banco de dados do sistema (de produção ou réplica atualizada
automaticamente e online). Integrações com formato interme-
diário (CSV, TXT) não estão previstas nesta fase do projeto.
1.7 Casos Omissos e Dúvidas
Caso exista alguma dúvida sobre algum assunto que não foi abordado neste manual, por favor, entre em contato com
a Implanta, em um dos seguintes canais:
Email: suporte@implantait.com.br
Telefone: 62 3281-8582
Implanta Desenvolvimento e Integração Ltda
Av. Jamel Cecílio, 2496, Jardim Goiás
Edifício New Business Style, Salas A61 e A62
CEP: 74810-100 - Goiânia - GO
+55 (62) 3281-8582
http://www.implantait.com.br
Capítulo 2
Estrutura das Views
Para este projeto, views devem ser disponibilizadas para que o Extrator da Implanta importe os dados e os envie
para o servidor da Suvinil.
View é uma consulta armazenada no banco de dados, ou seja, a view é uma tabela virtual que possibilita apenas
a visualização das informações restritas a essa consulta. Ela permite somente a pesquisa otimizada dos dados, sem
alteração do conteúdo. Com o uso de views, os dados da empresa estão protegidos da gravação acidental e de acessos
não autorizados a outras informações do banco de dados.
Os campos necessários para executar o Extrator da Implanta estão descritos nos quadros deste capítulo.
Importante! Todos os campos listados para as views deste
layout devem estar presentes nas views. A indicação da co-
luna "Validações"se refere ao preenchimento do campo e ou-
tras validações vinculadas ao campo.
Para a criação das views, todos os nomes, tanto das views quanto dos seus campos deverão ser obedecidos. Estas
devem ser criadas no banco de produção para que os dados estejam sempre disponíveis na extração diária sem que
haja interferência humana no processo.
Dica: Os tipos de dados utilizados para o layout a seguir são
para o banco PostgreSQL. O tipo do campo deve ser ajustado
de acordo com o banco de dados utilizado no canal.
Para a inclusão das informações é importante também:
• Não incluir "zeros não significativos"para campos numéricos;
• Não incluir "espaços"no início ou no final de campos numéricos e alfanuméricos;
• Não incluir caracteres de formatação;
• Registros inativos também devem ser enviados.
Implanta Desenvolvimento e Integração Ltda
Av. Jamel Cecílio, 2496, Jardim Goiás
Edifício New Business Style, Salas A61 e A62
CEP: 74810-100 - Goiânia - GO
+55 (62) 3281-8582
http://www.implantait.com.br
SUVINIL - COCKPIT 5
2.1 View de Matriz/Filiais do Canal
Nesta view estão contidas as informações referentes à Matriz da revenda e suas respectivas filiais.
O nome da view deverá ser SUVINIL_FILIAIS.
CAMPO TIPO VALIDAÇÕES DESCRIÇÃO
codi_cli text Obrigatório Informar o código da filial.
raza_cli varchar(60) Obrigatório Razão Social da filial.
cnpj_cli varchar(14) Obrigatório CNPJ da filial, somente números.
fant_cli varchar(60) Obrigatório Nome fantasia da filial.
muni_cli varchar(7) Obrigatório Código do IBGE da filial.
fone_cli varchar(15) Telefone da filial com DDD. Somente números.
mail_cli varchar(70) E-mail da filial.
lati_cli double precision Latitude do endereço da filial.
long_cli double precision Longitude do endereço da filial.
ende_cli varchar(60) Endereço da filial.
nume_cli varchar(60) Número do endereço da filial.
comp_cli varchar(60) Complemento do endereço da filial.
bair_cli varchar(60) Bairro/Distrito do endereço da filial.
Implanta Desenvolvimento e Integração Ltda
Av. Jamel Cecílio, 2496, Jardim Goiás
Edifício New Business Style, Salas A61 e A62
CEP: 74810-100 - Goiânia - GO
+55 (62) 3281-8582
http://www.implantait.com.br
SUVINIL - COCKPIT 6
2.2 View de Estoque e Volume
Nesta view estão contidas informações sobre o estoque e volume dos produtos da revenda. A posição de estoque
deve ser enviada, independente de sua movimentação.
O nome desta view deverá ser SUVINIL_STOCKANDVOLUME.
Importante! A view deverá trazer as informações de estoque
(qtde_pro) dos produtos mesmo que a quantidade vendida
(qtve_pro) seja zero e vice-versa.
CAMPO TIPO VALIDAÇÕES DESCRIÇÃO
codi_cli text Obrigatório Código da filial.
codi_fab varchar(20) Obrigatório Código que identifica a SUVINIL no ERP do canal (não é o
código que identifica os produtos da SUVINIL no ERP do
canal).
codi_pro varchar(20) Obrigatório Código que identifica o produto SUVINIL no canal. No
caso de chave composta, sugere-se concatenar com sepa-
rador "."
desc_pro varchar(60) Obrigatório Descrição completa do produto.
unid_pro varchar(10) Obrigatório Unidade de venda do produto; CX, LT, KG, etc.
barr_pro varchar(14) Obrigatório Código de barra oficial do produto na SUVINIL. Ex.:
7891260224571
cind_pro varchar(20) Código oficial do produto na SUVINIL. Ex.: 55119986
date_pro date Obrigatório Data do estoque.
qtde_pro numeric(18,3) Obrigatório, >=0 Quantidade em estoque físico. Deve ser enviado diaria-
mente se houver estoque. Independente da movimentação
do produto. Neste campo deve conter a posição do esto-
que do produto na data, ou seja, o estoque do produto na
data a partir da data de início da extração.
qtve_pro numeric(18,3) Obrigatório Saldo da quantidade que saiu do estoque na data. Obtido
a partir da diferença (Saídas - Entradas) do estoque.
* O preenchimento será obrigatório se estes dados forem controlados pela revenda.
Implanta Desenvolvimento e Integração Ltda
Av. Jamel Cecílio, 2496, Jardim Goiás
Edifício New Business Style, Salas A61 e A62
CEP: 74810-100 - Goiânia - GO
+55 (62) 3281-8582
http://www.implantait.com.br
Apêndice A
Processo de Validação
Para verificar os dados fornecidos, a Implanta solicita alguns relatórios do ERP do cliente para assim confirmar se os
dados fornecidos nas views foram disponibilizados corretamente.
A.1 Validação de Estoque
A.1.1 View de Estoque
Segue um exemplo do resultado de uma consulta na view SUVINIL_STOCKANDVOLUME:
codi_cli codi_fab codi_pro desc_pro unid_pro barr_pro cind_pro date_pro qtde_pro qtve_pro
1 102 2032 RESINA SINT.
LUX BCO 3,6L
LT 7891260286678 56016908 2015-09-29 35 5
1 102 2032 RESINA SINT.
LUX BCO 3,6L
LT 7891260286678 56016908 2015-09-30 30 5
1 102 5035 ACELER. SECAGEM
SINT 0,25L
LT 7891260229064 56552788 2015-09-29 5 0
1 102 5035 ACELER. SECAGEM
SINT 0,25L
LT 7891260229064 56552788 2015-09-30 0 5
1 102 2111 RESINA SINT
BRANCA 4KG
KG 7891260221853 54502907 2015-09-29 10 -5
1 102 2111 RESINA SINT
BRANCA 4KG
KG 7891260221853 54502907 2015-09-30 10 0
A.1.2 Relatório de Estoque do ERP
Para conferir as informações contidas na view SUVINIL_STOCKANDVOLUME (qtde_pro) o cliente deverá fornecer
um relatório de estoque com a posição de estoque na data solicitada, somente de produtos SUVINIL.
Dica: O relatório exibido nessa seção é apenas exemplificativo.
Devendo ser utilizado um relatório existente no ERP
Este relatório deve conter as seguintes informações:
Implanta Desenvolvimento e Integração Ltda
Av. Jamel Cecílio, 2496, Jardim Goiás
Edifício New Business Style, Salas A61 e A62
CEP: 74810-100 - Goiânia - GO
+55 (62) 3281-8582
http://www.implantait.com.br
SUVINIL - COCKPIT 8• Código da Empresa
• Data de Referência
• Código do Produto
• Descrição do Produto
• Unidade do produto
• Posição do estoque na data
• Código Oficial do Produto na Suvinil (se houver)
A validação será feita comparando os dados do estoque presente na view e as informações dos relatórios. Por isso
é importante que os dados nas views do banco de dados estejam semelhantes aos dados dos relatórios.
Para o exemplo, será utilizada a data do dia 29/09/2015.
Relatório de Posição de Estoque - 29/09/2015
Empresa Data Código do Pro-
duto na Indústria
Código Produto Nome do Produto Unidade Quantidade em
Estoque
1 2015-09-29 56016908 2032 RESINA SINT. LUX BCO 3,6L LT 35
1 2015-09-29 56552788 5035 ACELER. SECAGEM SINT 0,25L LT 5
1 2015-09-29 54502907 2111 RESINA SINT BRANCA 4KG KG 10
A.1.3 Relatório de Movimentações de Estoque
Para conferir as informações de quantidade de produtos que saíram/entraram do estoque e que está contida na view
SUVINIL_STOCKANDVOLUME (qtve_pro) o cliente deverá fornecer um relatório que contenha a quantidade que
saiu do estoque na data (Saídas - Entradas).
Dica: O relatório exibido nessa seção é apenas exemplificativo.
Devendo ser utilizado um relatório existente no ERP
Este relatório deve conter as seguintes informações:
• Código da Empresa
• Data de Referência
• Código do Produto
• Descrição do Produto
• Unidade do produto
• Saldo de Estoque na Data (Saídas - Entradas)
• Código Oficial do Produto na Suvinil (se houver)
Para o exemplo, será utilizada a data do dia 29/09/2015.
Relatório de Movimentação de Estoque - 29/09/2015
Empresa Data Código do Pro-
duto na Indústria
Código Produto Nome do Produto Unidade Saídas do Esto-
que
1 2015-09-29 56016908 2032 RESINA SINT. LUX BCO 3,6L LT 5
1 2015-09-29 54502907 2111 RESINA SINT BRANCA 4KG KG -5
Implanta Desenvolvimento e Integração Ltda
Av. Jamel Cecílio, 2496, Jardim Goiás
Edifício New Business Style, Salas A61 e A62
CEP: 74810-100 - Goiânia - GO
+55 (62) 3281-8582
http://www.implantait.com.br
SUVINIL - COCKPIT 9
Veja que não é preciso conter registros com valores zerados no relatório.
É importante que as informações da view estejam semelhantes às informações contidas nos relatórios do software
de gestão (ERP), pois a validação consiste na comparação entre esses dados. As informações dos relatórios devem
estar de acordo com os valores do próprio sistema, não devendo ser adaptados ou ajustados para corresponder aos
valores nas views.
Durante o processo de validação podem ocorrer divergências entre os dados dos relatórios e os dados das views.
Se for constatado que as informações dos relatórios fornecidos, estão incorretas, o implantador solicitará um novo
relatório para conferência das informações.
Implanta Desenvolvimento e Integração Ltda
Av. Jamel Cecílio, 2496, Jardim Goiás
Edifício New Business Style, Salas A61 e A62
CEP: 74810-100 - Goiânia - GO
+55 (62) 3281-8582
http://www.implantait.com.br
	Histórico de Revisões
	Introdução e Contextualização da Integração
	Introdução
	Pré-requisitos para a Integração
	Alternativas de Integração
	Tipo 1 – Views criadas pela software house
	Tipo 2 – Views criadas pela Implanta
	Dados que Serão Extraídos
	Qual a Periodicidade do Envio
	Qual o Modelo de Infraestrutura Utilizada
	Casos Omissos e Dúvidas
	Estrutura das Views
	View de Matriz/Filiais do Canal
	View de Estoque e Volume
	Processo de Validação
	Validação de Estoque
	View de Estoque
	Relatório de Estoque do ERP
	Relatório de Movimentações de Estoque