erp4me.shop

Integração Rede de Lojas - IShop x WShop

A integração entre o IShop (matriz/franqueador) e o Shop (WShop) (filiais) conecta as unidades da rede para centralizar cadastros, movimentações e informações estratégicas de operação. Com a configuração correta do Shell, do WSched e das caixas postais, os pacotes .shp circulam com segurança, elevando a produtividade e a confiabilidade dos dados. Consulte o Detalhamento de Campos para entender o objetivo de cada parâmetro antes de iniciar.

Nota: Este guia foi estruturado para apoiar implantações e revisões de ambiente, mantendo foco em valor de negócio, continuidade operacional e qualidade dos dados entre matriz e filiais.

Antes de começar

  • Confirme que as versões do IShop e do WShop são exatamente iguais.
  • Verifique se o PostgreSQL está configurado corretamente no AlterdataConfig.
  • Tenha em mãos o Código Web da matriz e de cada filial.
  • Garanta permissões de leitura e escrita nas pastas de integração, como C:\ALTERDAT\DB\WMAIL\.
  • Valide a conectividade entre as estações envolvidas e a estação que executará o integrador.

Aviso: Nunca prossiga com versões divergentes entre matriz e filial. Essa condição pode gerar falhas de comunicação e comprometer a consistência dos pacotes de integração.

1. Configurações iniciais na matriz (IShop)

Nesta etapa, a matriz recebe sua identificação operacional e os parâmetros que permitirão a comunicação com as unidades da rede.

1.1 Definir dados gerais da matriz

📸 Tela de opções gerais do IShop, onde ficam o número da empresa, o prefixo e os dados da Rede de Lojas.

  1. Acesse Configurações e Manutenção > Opções > Geral.

  2. Defina o número da empresa matriz, normalmente 900, e informe o prefixo correspondente.

  3. Em Rede de Lojas, informe o nome do computador integrador, responsável por executar o Shell.

  4. Informe o Código Web do IShop.

  5. Configure o agendamento automático por intervalo em minutos quando a operação exigir sincronizações recorrentes ao longo do dia.

  6. Quando a rotina precisar ocorrer em dias e janelas específicas, marque Executar em determinados dias, selecione os dias da semana, defina os intervalos de execução e informe quantas vezes a integração será executada por dia.

Sucesso esperado: A matriz fica pronta para identificar as filiais, gerar pacotes de integração e organizar a distribuição de cadastros e movimentações.

📋 Detalhamento de Campos — Configurações da Matriz

Campo

Onde fica no sistema

Objetivo

Número da Empresa

Configurações e Manutenção > Opções > Geral

Identificar a matriz no ecossistema da rede, usando como referência o código 900.

Prefixo

Configurações e Manutenção > Opções > Geral

Organizar a identificação dos dados gerados pela empresa matriz.

Computador Integrador

Rede de Lojas

Definir a estação que processará o Shell e o WSched.

Código Web

Rede de Lojas

Roteiar corretamente os pacotes de integração entre matriz e filiais.

Agendamento Automático

Rede de Lojas

Controlar a frequência de envio e recebimento dos pacotes, equilibrando atualização e performance.

Agendamento por dias

Rede de Lojas > Agendamento automático da Integração

Executar a integração em dias definidos, com intervalos e quantidade de execuções por dia ajustados à operação.

1.2 Cadastrar lojas e caixas postais

A Caixa Postal é o ponto central da troca de arquivos entre matriz e filial. Uma configuração consistente garante que a rede receba cadastros, preços, clientes e movimentações no fluxo correto.

📸 Tela de cadastro da empresa, com abas de Caixa Postal, Exportação e Importação.

  1. Acesse Empresa > Cadastro e selecione a loja desejada.

  2. Crie uma subpasta exclusiva para cada loja dentro da pasta WMAIL, evitando interferência entre pacotes de empresas diferentes.

  3. Configure os diretórios de entrada (IN) e saída (OUT) da loja, por exemplo: C:\ALTERDAT\DB\WMAIL\900_001\IN e C:\ALTERDAT\DB\WMAIL\900_001\OUT.

  4. Vincule o Código Web da loja.

  5. Na aba Exportação, selecione as tabelas que a matriz enviará para a filial.

  6. Na aba Importação, selecione as tabelas que a matriz receberá da filial.

Nota: O sistema utiliza os cadastros já existentes no ERP. Para que a filial receba preços, clientes e produtos atualizados, marque essas informações nas tabelas de exportação conforme a estratégia da rede.

Dica: Para localizar o Código Web da loja, consulte o cadastro do cliente no CRM e acesse Endereço > Referência do endereço. Use essa informação para garantir o roteamento correto dos pacotes.

📋 Detalhamento de Campos — Caixa Postal

Campo

Onde fica no sistema

Objetivo

Diretório IN

Empresa > Cadastro > Caixa Postal

Receber os arquivos que serão lidos pela empresa configurada.

Diretório OUT

Empresa > Cadastro > Caixa Postal

Armazenar os arquivos gerados para envio às demais empresas da rede.

Subpastas de Integração

C:\ALTERDAT\DB\WMAIL\900_001\IN / OUT

Separar os pacotes por loja para evitar interferência entre empresas integradas à mesma matriz.

Código Web da Loja

Empresa > Cadastro

Identificar a filial no roteamento dos pacotes de integração; pode ser consultado no CRM em Endereço > Referência do endereço.

Tabelas de Exportação

Caixa Postal > Aba Exportação

Definir quais dados a matriz enviará para a filial, como produtos, preços e clientes.

Tabelas de Importação

Caixa Postal > Aba Importação

Definir quais dados a matriz receberá da filial, como vendas e movimentações.

2. Implantação na filial (WShop)

Com a matriz preparada, a filial deve receber a base inicial e os parâmetros de comunicação para operar integrada à rede.

2.1 Gerar a base da nova empresa

📸 Tela de geração de base no IShop, usada para criar o backup que será restaurado no ambiente da filial.

  1. No IShop, acesse Empresa > Geração de base de dados para nova empresa.

  2. Selecione a empresa de origem, normalmente 900, e a filial de destino.

  3. Gere o backup que será utilizado na implantação da loja.

2.2 Restaurar e parametrizar o WShop

📸 Installer Alterdata na opção Servidor e tela de Rede de Lojas no WShop.

  1. Na filial, utilize o Installer Alterdata na opção Servidor para restaurar o backup gerado.

  2. No WShop da loja, acesse Configurações e Manutenção > Opções > Rede de Lojas.

  3. Informe o Código Web da unidade, mantendo o mesmo código vinculado à caixa postal dessa empresa no IShop.

  4. Configure o agendamento automático da filial pelo mesmo padrão da matriz, definindo intervalos em minutos ou a execução em dias e horários específicos conforme a operação.

  5. Acesse Empresa > Cadastro > Caixa Postal no WShop e configure a caixa postal da filial apontando o Código Web da MATRIZ como identificação do terminal remoto.

  6. Valide se a filial está apontando para os diretórios de integração corretos.

Falha crítica: Se as versões do IShop e do WShop estiverem divergentes, a integração poderá falhar e os pacotes poderão ser rejeitados. Corrija as versões antes de liberar a operação.

📋 Detalhamento de Campos — Implantação da Filial

Campo

Onde fica no sistema

Objetivo

Empresa de Origem

Empresa > Geração de base de dados para nova empresa

Determinar a matriz que servirá como referência para a base inicial da filial.

Filial de Destino

Empresa > Geração de base de dados para nova empresa

Indicar qual loja receberá a base preparada para implantação.

Opção Servidor

Installer Alterdata

Restaurar o backup e preparar a estrutura local do WShop.

Código Web da Unidade

WShop > Configurações e Manutenção > Opções > Rede de Lojas

Permitir que a filial envie e receba pacotes com identificação correta.

Código Web da Matriz

WShop > Empresa > Cadastro > Caixa Postal

Apontar a caixa postal da filial para a matriz, garantindo o destino correto dos pacotes.

Agendamento Automático da Filial

WShop > Opções > Rede de Lojas

Executar a integração da filial por intervalos ou dias específicos, seguindo a mesma governança definida para a matriz.

3. Gestão de estoque e performance

Em redes com grande volume de dados, o equilíbrio entre atualização e desempenho é essencial para manter as lojas produtivas e a matriz bem informada.

3.1 Otimizar o alinhamento de estoque

📸 Tela de alinhamento de produtos e configuração do Agendador de Tarefas do Windows.

  1. Evite intervalos muito curtos em bases grandes para não sobrecarregar o processamento.

  2. Utilize o Agendador de Tarefas do Windows para executar o ExecuteDll.exe.

  3. Configure a função AnalizarEstoqueEmpresa para execução a cada 1 ou 2 horas, conforme o volume da operação.

  4. Desmarque a opção Executar alinhamento de produtos na próxima exportação no IShop para agilizar as trocas rotineiras.

Aviso: Intervalos agressivos em ambientes com muitas lojas podem gerar lentidão. Ajuste a frequência conforme o volume de vendas, quantidade de produtos e infraestrutura disponível.

3.2 Habilitar estoque por empresa

📸 Tela de Rede de Lojas com a opção para visualizar estoque de todas as empresas e consulta de Estoque por Empresa.

  1. Nas caixas postais da matriz, habilite Estoque das empresas em Exportação e Empresas em Importação.

  2. No IShop, em Rede de Lojas, marque Permitir visualizar estoque de todas as empresas.

  3. Na filial, acesse WShop > Opções > Agendador de Integração > Alinhamento e marque Alinhar estoque entre loja e matriz.

  4. Realize a integração entre matriz e filiais para atualizar as informações de estoque.

  5. Realize a consulta em Estoque > Consulta de Estoque > Estoque por Empresa.

Ganho de negócio: A consulta de estoque por empresa reduz perda de vendas, pois permite localizar rapidamente produtos disponíveis em outras unidades da rede.

📋 Detalhamento de Campos — Estoque e Performance

Campo

Onde fica no sistema

Objetivo

ExecuteDll.exe

Agendador de Tarefas do Windows

Automatizar rotinas de processamento sem depender de intervenção manual.

AnalizarEstoqueEmpresa

Agendador de Tarefas do Windows > Ação

Executar o alinhamento de estoque por empresa na frequência definida.

Executar alinhamento de produtos na próxima exportação

IShop > Rede de Lojas

Controlar se a próxima exportação realizará alinhamento completo de produtos.

Estoque das empresas

Caixa Postal > Exportação

Enviar dados de estoque das unidades para apoiar consultas em rede.

Permitir visualizar estoque de todas as empresas

IShop > Rede de Lojas

Autorizar a visualização da disponibilidade de produtos nas demais lojas.

Alinhar estoque entre loja e matriz

WShop > Opções > Agendador de Integração > Alinhamento

Sincronizar o estoque entre filial e matriz para manter a consulta por empresa atualizada.

4. Ferramentas de integração e transferência

O ecossistema Shop oferece recursos para ajustes finos, reprocessamentos controlados e logística entre lojas, apoiando uma operação mais ágil e integrada.

4.1 Utilizar ferramentas de integração

📸 Tela de ferramentas de integração, com opções de alinhamento, preço por empresa e transferência.

  • Alinhar Matriz/Filial: força a reexportação de documentos e movimentações de um período específico.

  • Preço por Empresa: permite praticar valores diferenciados por região, perfil de loja ou estratégia comercial.

  • Solicitação de Transferência: permite que a loja solicite mercadorias à matriz ou a outras filiais.

4.2 Preparar a solicitação de transferência

📸 Cadastro das lojas como clientes e parametrização das operações de entrada e saída.

  1. Cadastre as lojas como Clientes.

  2. Ative a opção de transferência para as lojas envolvidas.

  3. Configure as operações de entrada e saída que serão usadas na movimentação.

  4. Valide o fluxo com uma solicitação controlada antes de liberar para a operação diária.

Dica: Use a solicitação de transferência para transformar disponibilidade de estoque em venda atendida, mantendo rastreabilidade entre lojas e matriz.

📋 Detalhamento de Campos — Ferramentas e Transferência

Campo

Onde fica no sistema

Objetivo

Alinhar Matriz/Filial

Ferramentas de Integração

Reexportar documentos e movimentações quando for necessário recompor um período.

Preço por Empresa

Ferramentas de Integração

Permitir políticas comerciais distintas por loja ou região.

Solicitação de Transferência

Ferramentas de Integração

Formalizar pedidos de mercadorias entre matriz e filiais.

Lojas como Clientes

Cadastro de Clientes

Habilitar a loja como participante do fluxo de transferência.

Operações de Entrada/Saída

Configurações fiscais e operacionais

Garantir registro correto das movimentações geradas pelas transferências.

⌨️ Atalhos úteis

Ação

Atalho

Valor para a operação

Gravar configurações

F9

Agiliza a confirmação dos parâmetros ajustados.

Consultar estoque

F4 na tela de vendas

Apoia o atendimento ao cliente com informação rápida de disponibilidade.

Executar rotina agendada

Agendador de Tarefas do Windows

Mantém o alinhamento de estoque recorrente sem ação manual.


🌐 Aviso de Ecossistema

Aviso: A integração Rede de Lojas impacta diretamente a qualidade dos dados que circulam entre IShop, WShop e módulos relacionados, coma parte Contábil/Fiscal. Mantenha versões, caixas postais, códigos web e rotinas agendadas sob governança para preservar vendas, estoque, fiscal e indicadores da rede.