Integração

Consinco

Configurações e definições sobre

Integração VIPCommerce x Consinco
Fluxo - Integração
● Definir padrão de árvore mercadológica para WEB
01 Definição Árvore Mercadológica ● 2 Níveis (Departamento e Seção)
● Máximo 14 departamentos
Liberações de acesso ao banco e ● Banco de dados (IP externo, porta, ID do DB, user, password)
02 parametrizações ERP
● Permissões de Insert, Update, Delete em algumas tabelas
* Execução de procedure oficial de integração

Liberação de conexão do servidor de ● Liberar o IP Fixo fornecido pela VipCommerce para integração
03 integração ● * Pode haver a necessidade da liberação em FIREWALL

● Classificar os produtos que compõe o Mix no ERP com

04 Update dos Produtos Departamento, seção e descrição WEB
● Marcar parâmetro “Flag” envia para o e-commerce

● Conceito
05 Estoque de Segurança ● Cálculo

● Envio de cargas iniciais Ex.(Produtos, Estoque-Preço, Pedidos,

Ofertas, etc)
06 Teste/Finalização
● O ERP realizará todo o tratamento das informações para a
perfeita utilização da Plataforma VIPCommerce

● Ativar e Desativar Produtos

07 Informações Importantes ● Tempo de atualização
01 - Classificação Mercadológica do E-commerce
Para implantação do processo de vendas pelo e-commerce é necessário a criação de uma nova classificação mercadológica
específica para o e-commerce. Essa classificação, também chamada de árvore mercadológica deve ser criada dentro do ERP do
varejista. Ela não terá nenhuma ligação com a classificação utilizada pela loja física, assim não afetando nenhum processo.

A classificação obrigatoriamente precisa ser em dois níveis: departamento e seção.

Recomendamos que não se ultrapasse um número maior que 14 na criação dos departamentos para haver melhor
aproveitamento do layout do e-commerce. Recomendamos que não se ultrapasse um número maior que 30 na criação das
seções para também haver melhor aproveitamento do layout do e-commerce.

Departamento
X DEPARTAMENTO

Grupo

Subgrupo Familia SEÇÃO

01 - Classificação Mercadológica
Departamento Seção Departamento Seção

Animais Alimento para cães Animais Alim. para cães

Bazar e utilidades Artigo para festa Bazar e util Art p/ festa
Bebidas Cerveja Bebidas Cerveja
Biscoitos e chocolates Barra de chocolate Bisc.e chocolates Barra de choc
Carnes Carne bovina Carnes Carne bovina
Cereais e farináceos Farinha e creme de milho Cereais e farin. Farinha e creme de milho
Congelados Sobremesa congelada Congelados Sobremesa Cong
Frios e laticínios Queijo Frios e Lat. Queijo
Hortifruti Detergente líquido Hort-ifruti Deterg. líquido
Matinais e sobremesas Leite em pó Matinais e sobre Leite pó

✔ ❌
01 - Classificação Mercadológica

- Nível Hirárquico

Dentro da Consinco é possível criar vários níveis de hierarquia,

mas dentro da VIPCOMMERCE só trabalhamos com 2 níveis .

Portanto caso forem criar do zero é bom se atentar em fazer

a criação em 2 níveis ( NIVEL 1 = DEPARTAMENTO,
NIVEL 2 = SEÇÃO ) e caso já estiver criado e formos
reaproveitar, precisaremos de quais serão os níveis para
Departamento e Seção.
01 - Classificação Mercadológica

Max Cadastro > Produto > Categoria

02 - Liberação de acesso e parametrização
DESCRIÇÃO DETALHES
IP Externo Liberar acesso externo para o IP específico possibilitando conexão com o banco de dados.
Porta de conexão
Porta
Pode ser necessário liberação de acesso e no firewall de seu servidor/rede.
Nome do Banco de Dados (SID ou Service Name)
Usuário Nome do usuário (user) do banco de dados para conexão.
Senha Senha (password) do banco de dados para conexão.
CONSINCO.MAP_CATEGORIA ; CONSINCO.MAP_FAMDIVCATEGECOMMERCE ;
CONSINCO.MAP_MARCA ; CONSINCO.MAP_FAMEMBALAGEM ;
CONSINCO.MAP_PRODCODIGO ; CONSINCO.MAP_PRODUTO ;
CONSINCO.MAP_PRODCODIGO ; CONSINCO.MRL_PRODUTOEMPRESA ;
Tabelas para Liberação de Leitura CONSINCO.MRL_PRODEMPSEG ; CONSINCO.MAP_FAMILIA ;
CONSINCO.EDI_PEDVENDACLIENTE ; CONSINCO.EDI_PEDVENDA ;
CONSINCO.GE_CIDADE ; CONSINCO.MRL_PROMOCAO ;
CONSINCO.MRL_PROMOCAOITEM ; CONSINCO.MAP_FAMDIVCATEG
CONSINCO.MFL_DOCTOFISCAL
CONSINCO.EDI_PEDVENDACLIENTE ; CONSINCO.EDI_PEDVENDA
Tabelas para Liberação de
CONSINCO.EDI_PEDVENDAITEM ; CONSINCO.EDI_PEDVENDAFORMAPAGTO
Leitura/Escrita/Delete :
CONSINCO.EDI_PEDVENDANSU

Procedure para Liberação Execução : CONSINCO.SP_IMP_EDIPEDVENDA

CONSINCO.S_EDI_PEDVENDACLIENTE ; CONSINCO.S_EDI_PEDVENDA
Sequence’s para Liberação de Execução:
CONSINCO.S_EDI_PEDVENDAFORMAPAGTO ; CONSINCO.S_SEQNSUPEDVENDA
02 - Liberação de acesso e parametrização
DESCRIÇÃO DETALHE

Número empresa que será
utilizado
Número segmento que será
utilizado
Código do Representante
Código Geral Operação ( CGO )
As Empresas, enquanto Estruturas de Negócio, consistem na representação de cada uma das
unidades de negócio onde as operações são praticadas.
Consistem em subdivisões das Divisões de Negócio.
Cadastrar o representante comercial para o processo de venda.
Criar um para o Ecommerce,se tiver mais de um CD será necessário 1( um ) para cada CD
devidamente atribuído a filial no cadastro do representante.
O código Geral de Operação define o funcionamento de uma operação no sistema

Tabela de Venda
Nível hierárquico
Tabela Mercadologica Utilizada
Tabela com De-Para de formas
de pagamentos
Número da tabelas de venda que será usada no processo de venda
Definição do nível departamento e seção
Tipo de classificação categoria (Mix - de Loja ou Consumidor)
Exemplo: Dinheiro – Codigo 1 ,
Master Debito – Codigo 25, etc.

Documentação concinco: https://tdn.engpro.totvs.com.br/pages/releaseview.action?pageId=567747544

02 - Liberação de acesso e parametrização

Preencha os dados do banco no documento “Acessos”.

- IP Externo (Para consultar o IP acesse o site https://www.meuip.com.br do servidor do banco)

- Porta
- Nome do Banco (SID ou Service Name)
- Usuário
- Senha

000.000.000.00
000.000.000.00

Observação: IP externo nunca começa com

192.168...
02 - Liberação de acesso e parametrização
Caso a aba ecommerce dos produtos não esteja habilitada, é necessário ativar o parâmetro geral de “Utiliza
integração com E-commerce” conforme imagem a seguir:
03 - Liberação de conexão do servidor de
implantação

A Vipcommerce irá disponibilizar uma maquina que ficará exclusiva para hospedar o serviço de integração. Iremos repassar
o IP desse servidor para o T.I, para que possa liberar acesso desse IP a porta do banco de dados, no Firewall dele.

Caso esse servidor seja criado pelo supermercado, o implantador irá abordar os tópicos com o T.I e vai criar uma tarefa que
ficará sob a responsabilidade do supermercado.
03 - Liberação de conexão do servidor de
implantação
A integração VipCommerce com o ambiente do cliente adota diversos protocolos de segurança que tornam esta
comunicação altamente complexa de ser reproduzida por pessoa não autorizada.

A começar pelo servidor dedicado ao serviço que é de uso restrito ao time de integração, encontra-se em um conjunto de
máquinas exclusivas da VipCommerce e é monitorado por pessoal especializado.

O acesso ao servidor requer chave criptografada AES-256-bit que é um padrão considerado altamente seguro. Este
segundo fator se sobressai em muitas vezes o uso de senha de acesso e é hoje o padrão recomendado por especialistas.

Um terceiro fator significativo é o fato do servidor em questão possui um IP exclusivo e fixo. Dessa forma é possível
configurar o servidor de borda do cliente para somente receber requisições em uma porta específica de um IP previamente
definido. Todas as demais requisições podem ser destinadas a rota de “blackhole” ou simplesmente rejeitado.

Por fim, pede-se que seja criado um usuário com acesso restrito e limitado às funções mapeadas pelo e-commerce o que,
garante que o SGBD (Software de Gerenciamento de Banco de Dados) deverá impedir qualquer ação que não tenha sido
explicitamente definido pelo DBA.
04 - Update de Produtos

Após as liberações de acesso e criação da árvore mercadológica é hora de começar a tratar todos os produtos que
estarão no e-commerce. Para isso, três alterações serão a base dessa etapa que deve ser feita dentro da aba
E-commerce, são eles os campos: integra produto com E-commerce”, categorias E-commerce e descrição
E-commerce.

O campo “integra produto com E-commerce” deve estar marcado para o produto estar ativo.

Categorias devem ser escolhidas, isso é, o produto deve ser classificado com departamento e seção pela árvore que
foi criada especialmente para o e-commerce.

O campo “descrição E-commerce” deve conter a descrição tratada (com acentos e sem abreviações). Esse descrição
ficará no site sendo visível ao cliente.

Essa atualização deve ser feita para todo o mix de produtos que deseja ir para o e-commerce, devendo utilizar as
planilhas que foram passadas pelo consultor da Vipcommerce. Essa atualização pode ser feita manual ou em massa
(recomendado) via banco de dados e é de responsabilidade do varejista.
04 - Update de Produtos
05 - Estoque de segurança
O Estoque segurança é um campo na Vipcommerce utilizado para limitação do mínimo para venda , ou seja é um dos
parâmetros que faz o item ficar indisponível no E-commerce.

Uma de suas funções é fazer com que as rupturas de falta de estoque ( Oriundas de vendas realizadas ao mesmo tempo na
loja e no e-commerce) não sejam sentidas tão comumente na operação já que vai ser reservado uma parte para loja física.

Nos casos em que os sistema possui um giro dia de fácil consulta e exatibilidade , o mesmo é utilizado para geração do
estoque segurança , virando tempo de reposição do estoque daquele produto (Ex: Se o produto tem media de venda de 5
produtos e ele demora cerca de 5 dias para ser reposto no estoque o seu estoque sugerido é o produto dessas 2
informações, sendo assim 25 dias de estoque segurança).

Quando não temos essa informação do giro dia , normalmente é utilizado uma porcentagem do estoque atual no momento da
criação do produto e o controle deste campo fica dentro da VIP a gosto do cliente sendo a nível de produto .

Outra função deste parâmetro é definir a base de cálculo para o desbloqueio automático , sendo assim ele é de suma
importância para que o processo do desbloqueio automático funcione .

(Ex: Se o produto possui 25 de estoque segurança e o parâmetro para desbloqueio automático está definido como 5 vezes , o
desbloqueio só ocorrerá quando o item atingir o estoque loja de 125 unidades )
05 - Estoque de segurança
A probabilidade de vender todo o estoque de um produto na loja física e no site ao mesmo é pequena mas precisa ser tratada,
assim como é necessário tratar estoques virtuais, isso é, produtos que constam como disponível no ERP mas não constam no
estoque real. Como tratativa a Vipcommerce possui o recurso “estoque de segurança”, que significa definir um valor de reserva de
estoque para os produtos. Essa reserva não será vendida no site pois quando o estoque cair para essa reserva o produto ficará
como indisponível no site, evitando assim uma ruptura de estoque.

O valor definido como estoque de segurança fica na aba de estoque do backoffice do varejista.

Exemplo: No sistema consta 100 unidades de Coca-Cola 2 litros no estoque. Esse produto possui estoque de segurança de 20
unidades. Se for vendido na loja 85 unidades deste produto o estoque será 15. Por ter estoque abaixo do estoque de segurança, o
produto não será exibido no e-commerce (estoque: 15, segurança: 20, Total: -5).

A regra do sistema é de exibir como “indisponível” produto com estoque menor que 1.

O cálculo do sistema é: (estoque ERP - estoque de segurança = estoque site)

05 - Estoque de segurança
Tabela a ser utilizada para definição do estoque de
segurança.

Na coluna “Departamento e-commerce” o varejista deve

preencher com sua própria classificação escolhida para o
e-commerce.

Na coluna “Dias de estoque” o varejista deve preencher

com o dias que aquele departamento deve ter de estoque
de segurança.

O varejista deve pensar de forma estrategica sobre “Dias

de Estoque” definindo-os proporcionalmente ao giro de
cada departamento,

Observação: estas informações serão utilizadas

juntamente com o campo “giro medio” extraido do ERP.

Exemplo: bebidas alcoólicas possui maior chance de alto

giro, logo os dias de segurança será maior do que o
departamento “bazar” que provavelmente possui giro
menor.
05 - Estoque de segurança
Para criação do estoque de segurança o campo “giro médio” do ERP será utilizado. A integração da Vipcommerce irá
ler de forma automática este campo e criar o cálculo com base na planilha anterior.
O calculo é: estoque de segurança = giro médio x dias de segurança
 05 - Estoque de segurança
Quando a integração estiver ativa, o estoque de segurança poderá ser visualizado em:

Produtos > produtos > listagem > *escolha um produto* > editar > aba 2 “estoque” > campo “Segurança”.

Observação: caso deseje

alterar o estoque de
segurança, é necessário abrir
um chamado para integração
solicitando a alteração e
anexando a tabela com os
novos dias de segurança.
Esse campo não deve ser
alterado no backoffice.
 06 - Teste/ Finalização
Após a etapa de classificação, o responsável do projeto na Vipcommerce irá abrir um chamado interno para
que o time técnico responsável pela integração finalize o processo e envie todos os produtos do ERP para o
backoffice da Vipcommerce. Uma vez feito isso, a integração está pronta e a comunicação entre os dois
sistemas está ativa.

No backoffice os produtos
estarão em:

Produtos > Produtos > Listagem

07 - Informações Importantes

- Ativar e Desativar produto

O campo “integra produto com e-commerce” da
Consinco funciona para ativar e desativar o produto.
Quando marcado este campo, o produto fica como
ativo no e-commerce. O mesmo processo segue para
quando é necessário desativar um produto, bastando
desmarcar (e- integra produto com e-commerce =
falso).

Observação: como se trata de uma ação dentro da

aba “e-commerce” essa função é apenas para o site.
O produto continuará como ativo para venda na loja
caso esse campo esteja desmarcado.
07 - Informações Importantes

- Tempos para atualização

A partir do momento que a integração está ativa, essa integração começa a rodar rotinas de atualização dos dados no site
pegando alterações do ERP. Existem tipos de atualizações e cada uma possui sua frequência:

1. Atualização de produto: preço, estoque e disponibilidade (ativo e desativado) - instantaneo

2. Atualização de produto: departamento, seção, descrição - 10 min no backoffice e D+1 no site

*Observe que o tempo de atualização do site pode ser diferente do tempo de atualização no backoffice.

* Dependendo da complexidade (muitos produtos alterados de uma vez só) da atualização esse tempo pode ser maior.

- Desativando um produto na loja e no e-commerce

Um recurso que pode ser utilizado para desativar um produto na loja e no site é utilizar o campo “status venda”.
07 - Informações Importantes

- Status Venda
Flag “Status Venda” desativa o produto por CD (loja).