# DataFirefly Group Catalog: ocultar produtos por grupo de clientes e catálogo em tablet > Instalação Instale o módulo em Módulos > Gestor de módulos > Carregar um módulo, enviando o ficheiro ZIP. Na instalação, o módulo cria as suas tabelas, regista os seus hooks… - Página: - Idioma: pt - Atualizado em: 2026-09-29 - Outros idiomas: [fr](https://www.datafirefly.com/documentation/dfgroupcatalog/index.md), [en](https://www.datafirefly.com/en/documentation/dfgroupcatalog/index.md), [it](https://www.datafirefly.com/it/documentation/dfgroupcatalog/index.md), [es](https://www.datafirefly.com/es/documentation/dfgroupcatalog/index.md), [de](https://www.datafirefly.com/de/documentation/dfgroupcatalog/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfgroupcatalog/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfgroupcatalog/index.md) - Índice: ## Instalação Instale o módulo em **Módulos > Gestor de módulos > Carregar um módulo**, enviando o ficheiro ZIP. Na instalação, o módulo cria as suas tabelas, regista os seus hooks e adiciona o separador **Catálogo > Visibilidade por grupo**. Para atualizar a partir de uma versão anterior, basta carregar o novo ZIP: o script de atualização cria o que falta sem mexer nos seus produtos reservados. ## Primeira definição: o grupo de equipa O módulo distingue dois tipos de grupos de clientes: - **Os grupos de equipa** veem todos os produtos reservados e abrem o catálogo em tablet. É o grupo dos seus vendedores na loja. - **Os outros grupos**, por exemplo revendedores B2B, só veem os produtos reservados que lhes foram atribuídos. Crie primeiro um grupo dedicado em **Clientes > Grupos**, por exemplo "Vendedores", com as mesmas condições de preço do seu grupo Cliente (desconto de grupo, preços com ou sem IVA), para que a equipa veja os preços públicos. Abra depois **Catálogo > Visibilidade por grupo**, separador **Definições**, assinale este grupo em **Grupos de equipa** e guarde. Por fim, crie uma conta de cliente por tablet ou por vendedor e associe-a a este grupo. Não use o grupo Cliente como grupo de equipa: todos os seus clientes veriam os produtos reservados. ## Reservar um produto a partir da sua página Na página do produto, abra o separador **Módulos** (nova página de produto do PrestaShop 8.1 e 9) ou a secção de módulos (página antiga). O painel **Visibilidade por grupo de clientes** propõe duas opções: - **Público**: o produto segue as suas definições de visibilidade nativas. - **Reservado**: o produto fica oculto na loja. Continua visível para os grupos de equipa e para os grupos que assinalar logo abaixo. Clique em **Guardar visibilidade**. A gravação é imediata e independente do botão de gravação da página do produto. ### O que a reserva faz O produto passa para a visibilidade nativa _Em lado nenhum_. Desaparece assim das categorias, da pesquisa, da navegação por facetas e dos módulos de produtos em destaque. O módulo guarda a visibilidade original para a repor na publicação e acrescenta três proteções que a visibilidade nativa não cobre: - o URL direto do produto devolve uma página não encontrada, ou a página de início de sessão para um visitante sem sessão se a opção estiver ativa; - a adição ao carrinho é recusada; - se um produto reservado já estiver num carrinho, é retirado ao finalizar a encomenda e o cliente é informado. Um produto reservado tem de continuar **ativo**. Um produto desativado não é visível para ninguém, nem para a equipa nem para os grupos autorizados. ## Gerir a visibilidade em massa A página **Catálogo > Visibilidade por grupo**, separador **Produtos**, lista todo o catálogo com o respetivo estado. Filtre por nome, referência, EAN ou ID, por categoria (subcategorias incluídas) e por estado Público ou Reservado. Escolha depois o âmbito (**Produtos assinalados** ou **todos os produtos que correspondem ao filtro**) e a ação: - **Reservar para os grupos assinalados**: substitui os grupos atuais. - **Adicionar** ou **Remover os grupos assinalados**: aplica-se apenas a produtos já reservados. - **Tornar público agora**, com a opção de ativar também a encomenda. - **Tornar público numa data**, ou **Cancelar a publicação agendada**. ### Aplicar uma ação a uma lista de referências O bloco **Aplicar uma ação a uma lista de referências** aceita referências, EAN, UPC ou ID de produto, um por linha ou separados por vírgulas. A referência ou o código de barras de uma variante seleciona o respetivo produto. Os códigos não encontrados são listados após a operação, o que permite corrigir um ficheiro de fornecedor. ### Reservar automaticamente os novos produtos Nas definições, a opção **Reservar automaticamente os novos produtos** faz com que cada produto criado comece como Reservado, com os grupos assinalados por defeito. Útil quando prepara uma coleção antes de a colocar online. ## Publicação agendada Um produto reservado pode tornar-se público numa data e hora precisas. Na página do produto, preencha **Tornar público automaticamente em** e assinale, se quiser, **e ativar a encomenda**. Em massa, use a ação **Tornar público numa data**. A coluna Visibilidade da lista mostra a data prevista. Na data definida, o módulo repõe a visibilidade original, ativa a encomenda se tiver sido pedido e relança a indexação da pesquisa. Sem configuração, a publicação é executada na primeira visita à loja após a data. Para uma hora exata, chame a cada 5 ou 15 minutos o endereço cron indicado em **Definições > Manutenção**, protegido por um token próprio da sua loja. ## O catálogo em tablet ### Acesso e instalação O endereço do catálogo está em **Definições > Catálogo da loja para tablets**, no formato `/module/dfgroupcatalog/catalog`. Também aparece uma ligação na área A minha conta dos clientes autorizados. No tablet, inicie sessão uma vez com a conta do grupo de equipa, abra o endereço e adicione-o ao ecrã principal: o catálogo abre então em ecrã inteiro como uma app. Os grupos assinalados em **Outros grupos autorizados no catálogo da loja** também o podem abrir, mas só veem os produtos públicos e os seus próprios produtos reservados. ### Pesquisar e ler códigos - A pesquisa abrange o nome, a referência, o EAN e as referências ou códigos de barras das variantes. - O botão de leitura usa a câmara do tablet. Em Android é usado o detetor nativo do navegador; no iPad entra em ação uma biblioteca de leitura incluída no módulo. A lanterna é proposta quando o dispositivo a tem. - Um leitor de códigos USB ou Bluetooth funciona em qualquer ponto da página, mesmo com uma ficha aberta. - Quando um código corresponde exatamente a um produto ou variante, a ficha abre diretamente na linha certa. O painel **Categorias**, o filtro **Apenas em stock**, a ordenação e, para a equipa, o filtro Público ou Reservado completam a pesquisa. Os últimos produtos consultados aparecem no topo da lista. ### A ficha de produto no tablet Mostra a galeria com zoom em ecrã inteiro, o preço (riscado em caso de desconto, sem e com IVA se a opção estiver ativa), os preços por quantidade do grupo com sessão iniciada, o stock, a data de reposição, as características e a descrição. A tabela de variantes indica para cada uma a referência, o EAN, o preço, o stock e a localização no armazém, se estiver preenchida. Tocar numa variante mostra a sua imagem. Para a equipa, a ficha indica ainda para que grupos um produto reservado está visível. ### Vista cliente e código QR O botão **Vista cliente**, no topo do ecrã, oculta as quantidades em stock, as localizações, as etiquetas Reservado e a linha "Visível para" antes de virar o tablet para o cliente. Num produto público, o botão **Mostrar ao cliente** apresenta um código QR que abre a página do produto no telemóvel dele. ## Definições - **Grupos de equipa**, **Outros grupos autorizados no catálogo da loja** e **Grupos assinalados por defeito**. - **Reservar automaticamente os novos produtos**. - **Visitantes que abrem um produto reservado**: página de início de sessão em vez de uma página não encontrada. - **Produtos reservados nas listagens da loja**: ver a secção B2B. - Para o catálogo em tablet: título, produtos por página, quantidades em stock, preços sem e com IVA, botão Vista cliente. ## Usar o módulo para um grupo B2B Crie um grupo de revendedores e assinale-o nos produtos reservados que lhe são destinados. Estes clientes abrem a página do produto, adicionam ao carrinho e encomendam normalmente, enquanto os clientes B2C não veem nada. Por defeito, um produto reservado não aparece nas categorias nem na pesquisa, mesmo para um grupo autorizado: acede-se pela sua ligação ou pelo catálogo em tablet. A opção **Produtos reservados nas listagens da loja** mostra-os nas categorias e na pesquisa para os grupos autorizados. Aplica-se apenas a esses clientes e apenas nas categorias que contêm produtos reservados para eles, onde veem uma ordenação simples em vez dos filtros por facetas. Os clientes B2C nunca são afetados. ## Manutenção e desinstalação **Verificar produtos reservados** volta a ocultar um produto reservado cuja visibilidade foi alterada fora do módulo, por uma importação ou por um funcionário cujo perfil não tem permissão para ver o módulo. **Tornar todos os produtos públicos** devolve a cada produto reservado a sua visibilidade original. Use-o antes de desinstalar: caso contrário, os produtos reservados continuam ocultos, que é a opção mais segura. ## Resolução de problemas ### A equipa não vê os produtos reservados Verifique se a conta pertence ao grupo assinalado em Grupos de equipa e se o produto está ativo; depois termine e volte a iniciar a sessão no tablet. ### Um produto reservado voltou a ficar visível A visibilidade foi provavelmente alterada por uma importação ou por um funcionário sem permissão no módulo. Execute **Verificar produtos reservados** e dê ao perfil a permissão "Ver" no módulo em **Parâmetros avançados > Equipa > Permissões**. ### O botão de leitura não aparece ou a câmara é recusada A câmara só está disponível numa loja em HTTPS. Permita o acesso à câmara para o site nas definições do navegador do tablet. Em alternativa, um leitor de códigos de barras continua a funcionar. ### Um produto agendado ainda não está público Sem tarefa cron, a publicação aguarda a visita seguinte à loja. Abra qualquer página do site ou configure o endereço cron. Limpe a cache se estiver ativo um módulo de cache de páginas. ### Os preços do catálogo em tablet diferem dos do site O catálogo mostra os preços do grupo da conta com sessão iniciada. Dê ao grupo de equipa os mesmos descontos e a mesma apresentação do IVA que ao grupo Cliente. ## Limites a conhecer - Os feeds de produtos geridos por outros módulos (Google Shopping, marketplaces, comparadores) não são filtrados por grupo: exclua lá os produtos reservados. - Os blocos de acessórios adicionados por módulos de terceiros podem mostrar um produto reservado ligado a um produto público. ## Compatibilidade - PrestaShop 8.0 a 9.x com o mesmo ZIP, página de produto antiga e nova. - Navegação por facetas nativa (ps_facetedsearch). - Arquitetura ModuleAdminController, sem dependência de Composer. - Interface traduzida em francês, inglês, espanhol, alemão, italiano, neerlandês, polaco e português.