HU - Como Fazer - CIGAM HUB

De CIGAM WIKI
Revisão de 17h22min de 3 de setembro de 2025 por Lucas.giacomelli (discussão | contribs) (Como Fazer - CIGAM HUB)


Palavras-Chave

Canal de Venda. E-Commerce. HUB. Marketplace. Orçamentos. Pedidos.

Como Fazer - CIGAM HUB

A solução CIGAM HUB tem o intuito de agir como intermediário entre o ERP CIGAM e diversas plataformas de e-commerce/marketplaces, como por exemplo, VTEX, Nuvemshop, Moovin, Magazord, entre outras. Tendo acesso a informações fundamentais como pedidos realizados, produtos, variantes, marcas, categorias, coleções, canais de vendas e lojas.

Os Canais de Vendas poderão ser utilizados, mas as opções serão definidas por cada plataforma.

Voltar ao início

Quais são os pré-requisitos para utilizar o CIGAM HUB?

Para utilização da Solução CIGAM HUB será necessário licença comercial do HUB Integrador. Em caso de dúvidas sobre a questão de licenciamento acionar equipe comercial da CIGAM.

Existem alguns requisitos de ambientes que devem ser verificados, como IIS habilitado e versões do Dotnet. Sobre a implementação pode ser consultada a documentação abaixo disponibilizada na Wiki:

🔗 GE - Como Fazer - Ferramenta de implantação de sites e aplicações web

Observação: Em caso de dúvidas, acionar equipe de consultoria infra CIGAM para esclarecimentos.

Voltar ao início

Quais são os nomes lógicos que devem ser revisados para utilizar o CIGAM HUB?

  • HUB_INSTAL = %CIGAM_INSTAL%Cab\HUB\

Indicar o caminho da pasta que será disponibilizado os componentes do HUB.

  • CIGAMHUB_COMPANY = Avaliar chave com comercial/implementação
  • LOJA_HUB = 1

Criar os nomes lógicos listados abaixo e verificar se existe as tabelas criadas no banco de dados, caso não exista criar pelo CGAtualizacao.ecf.

  • GEHUBPLATAFORMA = GEHPLAT
  • GEHUBLOJA = GEHLOJA
  • GEHUBPLATALOJA = GEHPLALO
  • GEHUBPARCABECA = GEHPARCA
  • GEHUBPARDETALHE = GEHPADET
  • GEHUBPARDEPARA = GEHPADPA
  • GEHUBDEPARAPEDIDO = GEHDPAPE
  • GEHUBSTATUS = GEHDSTAT

Voltar ao início

Quais são os itens de menu que devem ser criados para utilizar o CIGAM HUB?

📸 Criar os itens de Menu conforme programas abaixo:

🔗 Para mais detalhes, consulte: GE - Como Fazer - Apontamento de Menu

Voltar ao início

Quais são as configurações envolvidas para utilizar o CIGAM HUB?

Existe a opção de criação de Pedidos ou Orçamentos para os pedidos importados das plataformas. A definição de como será a criação deverá ser avaliada na configuração 'GE - GE - 3008 - Finalização do Pedido/Orçamento na Web e Hub'. Esta configuração irá definir a criação de Pedidos ou Orçamentos pelos Portais CIGAM, HUB e Integrador. As opções disponíveis são:

  • Pedido: Será feito a criação de um pedido no módulo Faturamento/Pedidos.
  • Orçamento Integrado: Será feito a criação de um orçamento no módulo Gestão de Lojas.

Existe a opção de utilizar Múltiplas Formas de Pagamento para os pedidos importados do HUB. Para que isso seja possível é necessário a revisão das parametrizações do Módulo de Lojas e a revisão das configurações 'FA - GE - 1475 - Informar múltiplas condições de pagamento e troco' (Opção Marcada) e 'FA - GE - 3170 - Versão das múltiplas formas de pagamento no Mód. Faturamento' (opção "1 Conforme Orçamento/Lojas")

Para clientes que não desejam utilizar Múltiplas Formas de Pagamento, revisar manual GF - Como Fazer - Painel de Recebimentos Antecipados (Adiantamentos de Pedidos ou integração com CIGAM HUB).

Para a opção de Orçamentos existe a funcionalidade de Controle de Cargas. Para implementação da mesma revisar o manual CL - Como Fazer - Controle de Cargas. As configurações e parametrizações exclusivas do HUB estarão no tópico Como sempre gerar cargas ao criar orçamentos pelo HUB e Integrador?

Voltar ao início

Como cadastrar dados de parametrização do CIGAM HUB?

No cadastro de Parametrização do CIGAM HUB vamos implementar as informações de “Lojas”, “Plataformas” e demais informações que serão utilizadas para criação dos Pedidos.

No Cadastro de Plataformas, vamos informar a plataforma escolhida pelo cliente para integrações. Para o cadastro desta informação clicar no botão ‘Plataforma’, conforme exemplo:

Plataforma hub.png

Devemos também realizar o cadastro das lojas que vamos utilizar no HUB. Para o cadastro desta informação clicar no botão ‘Loja’, conforme exemplo:

Loja hub.png

Após o cadastro da Plataforma e das Lojas, deve ser realizado o vínculo das mesmas através do Botão ‘Vínculo Plataforma/Loja’:

Vinculo hub.png

Guia Atributos: Será utilizada para definirmos informações padrão para criação do pedido. Quando não informados dados de Tipo de Operação o sistema fará as buscas de Tipo de Operação das regras fiscais. Exemplo de Cadastro:

Atributos hub.png

Guia Canal de Venda: Será utilizada para definirmos o “de para” entre canal de venda x unidade de negócio. Também informaremos a conta gerencial, centro de armazenagem e tabela de preço.

Importante: O canal de venda deverá estar cadastrado na plataforma escolhida.

Canal hub.png

Guia Controle: Será utilizada para definirmos o “de para” entre os controles(etapas) que o pedido possui no ERP vinculando com as etapas existentes na plataforma. Nesta guia informaremos os controles até o momento de importar o pedido.

Controle hub.png

Guia Condição de Pagamento: Será utilizada para definirmos o “de para” entre condições de pagamento que o pedido possui no ERP vinculando com as condições de pagamento existentes na plataforma.

CondPag hub.png

Guia Transportadora: Será utilizada para definirmos o “de para” entre as transportadoras que o pedido possui no ERP vinculando com as transportadoras existentes na plataforma.

Transportadora hub.png

Guia Controle Exportação: Informar os controles que atualizam status do sistema para a plataforma. Esta tela segue a mesma lógica da tela de Controle.

ControleExp hub.png

Voltar ao início

Quais são os dados de produtos que devem ser cadastrados?

As informações contidas no Cadastro de Material serão importadas para o cadastro de variantes dos produtos. Exemplo de Cadastro de Variante com as informações do cadastro de produtos:

CadVariante hub.png

Voltar ao início

Como realizar a integração dos produtos para o CIGAM HUB?

Através da rotina de Integração de produtos poderá ser enviado ao HUB os itens que estarão disponíveis para venda. O requisito para que os itens sejam considerados para importação para o HUB é que estes tenham estoque, que estejam com o preço de venda cadastrado na tabela de preços informada na tela e que os produtos estejam cadastrados na TG informada em tela.

Esta rotina também poderá ser utiliza no Gerenciador de Processos para rodar de forma automática.

Integracao hub.png

TG: Caso cliente possua variações de produto pode ser criada uma TG para o devido registro do EAN de cada variação.

Guia Opções:

IntegracaoOpc hub.png

Marca:

  • Nenhum – Não exporta a informação de marca (comportamento atual). Demais opções da tela ficarão desabilitadas.
  • Especificação – Somente poderá selecionar esta opção se houver pelo menos uma especificação do tipo cadastro na base, seja no grupo ou nas configurações.
  • Característica – Somente poderá selecionar esta opção se configuração ‘CP - GE - 339 - Utilizar configurador de produto’ estiver marcada;

Especificação: Habilitado e editável apenas se a opção ‘Marca’ estiver igual à "Especificação", deve abrir um combo para selecionar qual das especificações da base é utilizada para marca.

Característica: Habilitado e editável apenas se a opção Marca estiver igual à "Característica".

⚠️ Importante: A característica informada neste campo será levada para todos os produtos.

Voltar ao início

Como podemos realizas a importação de pedidos?

Poderemos realizar a importação de Pedidos através da rotina de Integra Pedido. Nela poderemos informar o número do Pedido Externo para realizar a importação:

IntegraPedido hub.png

Poderemos fazer a integração em Lote dos Pedidos através da rotina Integração Ecommerce Pedidos:

IntegraPedidoLote hub.png

Podemos também realizar a importação de Pedidos através do Gerenciador de Processos. Exemplo:

ImpPedGP hub.png

Exemplo de Pedido Importado:

ExPedImp hub.png

Voltar ao início

Como poderemos acessar e utilizar o portal do CIGAM HUB?

Após acessar o endereço do portal http://144.22.227.3:92/ e realizar o login, o usuário será redirecionado para uma nova página, que varia de acordo com o tipo de usuário logado e suas permissões.

1. 💼 Menu – Administrador:

Se o seu usuário possuir o perfil administrador, você terá acesso ao seguinte menu:

MenuAdm hub.png
1.1 🏢 Empresas:

Apresenta uma lista de cards com informações básicas das empresas cadastradas no HUB. Sendo possível realizar pesquisas através do CNPJ, nome da empresa, e mostrar as que se encontram ativas ou inativas.

  • Id: Código único atribuído a cada empresa cadastrada dentro do HUB;
  • CNPJ: Número exclusivo designado pela Receita Federal na identificação de empresas;
  • ERP: Sigla referente ao parceiro responsável pelo cliente;
  • Parceiro: Define o parceiro responsável pelo cliente;
  • Data/Hora: Informação de data e horário que a empresa foi cadastrada no HUB;


Empresas hub.png

Também é possível realizar o cadastro de novas empresas através do botão ‘Nova Empresa’, localizado acima dos filtros:

NovaEmpresa hub.png
Opções – Empresas

Além disso, ao clicar no ícone com três pontos, localizado ao lado do nome da empresa, no canto superior direito dos cards, temos novas opções de acesso, são elas:

👁️ Acessar Hub;

✏️ Editar;

📋 Inconsistências;

OpcoesEmpresa hub.png
👁️ Acessar Hub
Acessar hub.png

Página principal do HUB, onde temos acesso a diversas opções relacionadas a loja através do menu lateral esquerdo, conforme imagem abaixo:

Marketplace hub.png
📊 Menu Dashboard

Página com indicadores de vendas realizadas em um determinado período, sendo os últimos 30 dias o filtro padrão.

Dashboard hub.png

Para alterar o período das informações, o usuário deve clicar no ícone de calendário localizado no canto direito do título e selecionar período de tempo desejado.

PeriodoDashboard hub.png
📋 Menu Gerenciador de Pedidos

Neste menu teremos acesso a consulta e edição dos pedidos importados da plataforma de e-commerce para o HUB. Sendo possível filtrar os resultados pelo código, nome do cliente, período da venda, além de visualizar pedidos integrados ou não ao ERP.

GerPedidos hub.png

Nos cards de cada pedido individual, existem ícones com as funcionalidades de ‘Editar’ e ‘ Extrato’:

✏️ Editar Pedidos

Possibilita a edição de algumas informações referentes ao endereço e endereço de entrega do cliente/pedido selecionado. Importante: As mudanças aqui feitas não alterarão os dados do pedido existentes na plataforma.

EditarPedidos hub.png
📄 Extrato do Pedido

Gera um extrato de crédito do pedido com as principais informações do mesmo, conforme imagem abaixo:

ExtratoPedido hub.png
🛒 Menu Cadastro de Produtos

Página com informações dos produtos cadastrados. Nela é possível realizar pesquisas pelo nome e referência , além de filtrar por produtos ativos/inativos.

CadProduto hub.png
✏️ Edição de Produtos

Poderemos realizar a edição ou exclusão dos produtos através dos ícones abaixo:

EdicaoProduto hub.png

Na página de edição encontraremos dois ícones que serão responsáveis pela atualização (forma manual) do produto e ainda o ícone para salvar as informações alteradas.

EdicaoProduto1 hub.png

Alguns campos na página de edição de produtos são obrigatórios, como por exemplo Marcas e Categorias. Caso qualquer um dos dois esteja em branco, não será possível salvar as alterações realizadas.

🏷️ Menu Marcas

Página com informações das marcas cadastradas. Nela é possível realizar pesquisas pelo nome da marca e período de atualização, além de filtrar por marcas ativas/inativas.

MenuMarcas hub.png

Também é possível realizar a edição de informações de marcas já cadastradas, basta clicar no ícone de lápis encontrado no canto superior direito do card. Além disso, podemos realizar o cadastro de novas marcas através do botão “Nova Marca”, localizado acima dos filtros:

MenuMarcas1 hub.png
🔠 Menu Cadastro de Categoria
MenuCategoria hub.png

Página com informações das categorias e subcategorias cadastradas. Sendo possível criá-las de duas maneiras, são elas:

🆕 Através do botão “Nova Categoria”, localizado no canto superior direito, ao lado do título da página;

➕ Ou selecionando uma categoria ou subcategoria e clicando no botão “+” que aparecerá ao lado direito;

NovaCategoria hub.png

Com isso, para criar uma subcategoria, seguimos os passos acima, adicionando no campo “ID Categoria Global” o ID referente a categoria principal. Para editar uma categoria ou subcategoria já cadastrada, selecione-a e clique no botão com o ícone de um lápis para abrir uma nova tela com os campos editáveis.

SubCategoria hub.png
👥 Menu Cadastro de Usuários

Página com informações dos usuários da loja selecionada, sendo possível realizar a pesquisa através do nome e filtrar usuários ativos ou inativos.

CadUsuario hub.png

Também é possível realizar a edição de informações de usuários já cadastrados, basta clicar no ícone de lápis encontrado no canto superior direito do card. Além disso, podemos realizar o cadastro de novos usuários através do botão “Novo Usuário”, localizado acima dos filtros:

NovoUsuario hub.png
🛍️ Menu Canal de Vendas

Página com informações dos canais de vendas cadastrados, sendo possível realizar a pesquisa através do nome.

CanalVendas hub.png
🎞️ Menu Coleções

Página com informações das coleções da loja selecionada, sendo possível realizar a pesquisa através do nome.

MenuColecoes hub.png

Nos cards das coleções temos dois ícones distintos, o “Editar” permite ao usuário acessar, modificar e salvar as alterações realizadas. Já o “Ver produtos” abre uma nova tela sendo possível visualizar todos os produtos que fazem parte da coleção selecionada.

Além disso, podemos realizar o cadastro de novas coleções através do botão “Nova Coleção”, localizado acima dos filtros:

NovaColecao hub.png

⚠️ Observação: Atualmente não é possível adicionar, remover ou editar produtos de coleções através do Hub.

⚙️ Menu Cadastro de Especificações
MenuEspecif hub.png

✏️ Editar: Acessa a página de cadastro de empresa, permitindo alterar todos os dados já cadastrados da mesma.

🏪 Lojas: Permite o cadastro de novas lojas, através do botão “NOVA LOJA”, localizado abaixo dos dados da empresa selecionada.

Lojas hub.png

🆔 Credenciais: Ao clicar no ícone com três pontos, localizado ao lado do nome da loja, no canto superior direito do card, entramos na página de credenciais de lojas. Sendo possível, possível cadastrar novas credenciais, ao clicar no botão “NOVAS CREDENCIAIS”:

Credenciais hub.png

Nas opções do card referente as credenciais já cadastrados temos cinco novos recursos, são eles:

⬇️ Importar Categorias;

⬇️ Importar Canal de Vendas;

⬇️ Importar Coleções;

✏️ Editar;

🗑️ Excluir;

CardCredenciais hub.png

As três primeiras opções são referentes a importações de informações já registradas na plataforma referente ao card, como por exemplo, VTEX, NuvemShop, etc, para a solução HUB.

📋 Inconsistências
Inconsistencias hub.png

Página onde concentram-se todas as inconsistências referente a integração Plataformas > HUB. Sendo possível verificar de forma intuitiva erros e mensagens de avisos. Facilitando o trabalho de implementação e também do suporte.

Inconsistencias1 hub.png
🤝 Parceiros

Apresenta uma lista de cards com informações básicas dos parceiros cadastrados. Sendo possível realizar pesquisas através do nome e mostrar parceiros ativos ou inativos.

🆔 ID: Código único atribuído a cada parceiro cadastrado dentro do HUB;

📅/⌚ Data/Hora: Informação de data e horário que o parceiro foi cadastrado no HUB;

Parceiro hub.png

Também é possível realizar a edição de informações dos parceiros, basta clicar no ícone de lápis encontrado no canto superior direito do card. Além disso, podemos realizar o cadastro de novos parceiros através do botão “Novo Parceiro”, localizado acima dos filtros:

NovoParceiro hub.png
👤 Usuários

Apresenta uma lista de cards com informações dos usuários cadastrados. Sendo possível realizar pesquisas através do nome do usuário e mostrar os que se encontram ativos ou inativos.

🆔 ID: Código único atribuído a cada usuário cadastrado dentro do HUB;

👤 Perfil: Tipo de perfil do usuário;

🤝 Parceiro: Define de qual parceiro o usuário é colaborador;

📅/⌚ Data/Hora: Informação de data e horário que o parceiro foi cadastrado no HUB;

Usuario hub.png

Também é possível realizar a edição de informações dos usuários, basta clicar no ícone de lápis encontrado no canto superior direito do card. Além disso, podemos realizar o cadastro de novos usuários através do botão “Novo Usuário”, localizado acima dos filtros, o mesmo receberá a senha por e-mail.

NovoUsuario1 hub.png
👤 Perfis de Usuários

São quatro perfis distintos:

👨‍💼 Administrador

   • Acesso completo a todas as lojas;
   • Permite manutenção completa de todas as “companhias” (CRUD);

💼 Comercial

   • Precisa ter código “Parceiro Cigam”;
   • Permite manutenção completa de “companhias” (CRUD) vinculadas ao seu código de “Parceiro Cigam”;
   • Não acessa a visão das lojas;

👩‍💼 Supervisor

   • Precisa ter código “Parceiro Cigam”;
   • Acesso Pesquisa às lojas vinculadas ao seu código de “Parceiro Cigam”;
   • Não permite manutenção de “Companhias” (somente visualiza);
   • Permite alterar produtos;
   • Permite alterar pedidos;

🏪 Loja

   • Acesso total a sua loja, ou seja, permite alterar produtos e pedidos da loja vinculada ao usuário; 

⚠️ Vale lembrar que usuários com o perfil “Loja” são criados diretamente no Cadastro de Usuários dentro da loja específica.

Voltar ao início