Editar Produtos em Massa no PrestaShop 8 e 9: documentação

Apresentação

O módulo mostra o seu catálogo numa grelha editável tipo folha de cálculo, no back-office do PrestaShop 8 ou 9. Edita produtos ou combinações com o teclado, aplica ações em lote a centenas de produtos, exporta e reimporta um ficheiro CSV, e cada alteração gravada pode ser anulada a partir do histórico.

Instalação

1. Em Módulos > Gestor de módulos, clique em Carregar um módulo e selecione dfbulkeditor-1.0.0.zip.
2. A instalação cria o separador Catálogo > Editor em massa e as duas tabelas do histórico.
3. O botão Configurar do módulo abre as definições e uma ligação direta para o editor.

Definições

• Linhas por página (predefinição): 50, 100, 250 ou 500. Cada funcionário pode alterá-lo na grelha.
• Itens por pedido de lote: de 10 a 500, 50 por predefinição. As ações em lote são enviadas em vários pedidos deste tamanho. Reduza o valor se o servidor interromper pedidos longos.
• Manter o histórico durante (dias): 180 por predefinição. Os conjuntos de alterações mais antigos são apagados automaticamente uma vez por dia e já não podem ser anulados.

Permissões

As permissões definem-se em Parâmetros avançados > Equipa > Permissões, no separador Editor em massa. A permissão Ver permite consultar a grelha e o histórico e exportar em CSV. A permissão Editar é necessária para gravar, lançar uma ação em lote, importar um ficheiro ou anular um conjunto de alterações. Sem ela, a grelha fica só de leitura.

A grelha

Vistas Produtos e Combinações

O seletor no canto superior esquerdo alterna entre produtos e combinações. A vista Combinações mostra cada combinação com o seu produto, os atributos, o impacto no preço e o preço final sem e com IVA. As combinações de um mesmo produto ficam agrupadas e o nome do produto só é repetido a cinzento.

Idioma, pesquisa e filtros

A lista de idiomas escolhe o idioma dos campos de texto mostrados e editados (nome, meta título, meta descrição, URL amigável, textos de disponibilidade). A pesquisa abrange nome, referência, EAN e ID. O botão Filtros abre os critérios: categoria com ou sem subcategorias, marca, estado, intervalo de stock, intervalo de preço sem IVA, dados em falta (EAN, referência, preço de compra, meta título, meta descrição, imagem) e produtos com ou sem combinações.

Colunas

O botão Colunas mostra ou oculta cada coluna. Arraste a margem direita de um cabeçalho para mudar a largura e faça duplo clique para voltar à largura predefinida. Estas escolhas ficam guardadas no seu navegador, separadamente para cada vista. Um clique num cabeçalho ordenável ordena a grelha.

Editar células

Com teclado e rato

• Setas, Tab, Enter: mover entre células.
• Escrever, F2 ou duplo clique: editar a célula ativa. Enter confirma e desce, Tab confirma e passa para a direita, Esc cancela.
• Shift + clique ou Shift + setas: selecionar um intervalo.
• Ctrl + C / Ctrl + V: copiar e colar, também de e para o Excel ou o Google Sheets. Um único valor colado num intervalo preenche todo o intervalo.
• Ctrl + D: preencher para baixo com o primeiro valor do intervalo.
• Delete: esvaziar as células de texto selecionadas.
• Espaço: alternar uma caixa sim/não (estado, disponível para encomenda, etc.).
• Ctrl + Z: anular a última edição não gravada.
• Ctrl + S: gravar.

O nome, o meta título e a meta descrição editam-se numa caixa mais larga com contador de caracteres: 60 recomendados para o meta título e 160 para a meta descrição.

Casos particulares

• Preço com IVA: o valor introduzido é convertido em preço sem IVA segundo a regra de impostos do produto.
• Categorias e categoria principal: estas células abrem um seletor em árvore com pesquisa. Se a categoria principal for retirada, a primeira categoria restante substitui-a.
• Stock de um produto com combinações: bloqueado na vista Produtos, edita-se na vista Combinações.
• EAN-13: 13 dígitos no máximo, um aviso assinala um dígito de controlo incorreto.

Gravar

As células alteradas ficam destacadas a amarelo e o botão Guardar indica quantas são. A gravação faz-se por partes. Um valor recusado pelo PrestaShop fica a vermelho: passe o rato sobre a célula para ler o motivo. Se mudar de vista, de página ou de filtro com alterações pendentes, o módulo propõe gravá-las primeiro, descartá-las ou cancelar.

Ações em lote

Alcance e pré-visualização

O botão Ações em lote aplica-se às linhas marcadas ou a todos os resultados filtrados, até 100 000 itens. Para selecionar todos os resultados, marque a caixa do cabeçalho e clique em «Selecionar os N resultados». O botão Pré-visualizar mostra o antes e o depois dos 20 primeiros itens, bem como os itens ignorados e o motivo. A ação é depois executada por partes com uma barra de progresso.

Preços

Preço a alterar: preço com IVA, preço sem IVA ou preço de compra nos produtos; preço final com IVA, preço final sem IVA, impacto sem IVA ou preço de compra nas combinações. Operações: aumentar ou diminuir em %, aumentar ou diminuir um montante, definir um valor ou preço de compra multiplicado por um coeficiente. Arredondamentos: 2 casas decimais, ao 0,05 ou ao 0,10 mais próximo, número inteiro, terminado em ,99, ,95 ou ,90. Num produto com combinações muda o preço base e os impactos mantêm-se.

Stock, estado, marca e impostos

O stock pode ser definido, aumentado ou diminuído (os produtos com combinações são ignorados na vista Produtos). O estado ativa ou desativa. A marca atribui-se ou retira-se. A mudança de regra de impostos pode manter os preços com IVA, recalculando o preço sem IVA.

Categorias

Adicionar a categorias, remover de categorias, substituir todas as categorias (marcando a categoria principal no seletor) ou alterar a categoria principal.

Nomes e textos SEO

Campos: meta título, meta descrição, nome ou URL amigável. Operações: preencher a partir de um modelo, acrescentar no início, acrescentar no fim, localizar e substituir. As variáveis inserem-se com um clique: {name}, {reference}, {ean13}, {manufacturer}, {category}, {price}, {shop}, {id}. Exemplo: {name} | {shop} com a opção «Apenas se o campo estiver vazio». A ação aplica-se ao idioma escolhido na grelha ou a todos os idiomas. Os URL amigáveis são limpos e os textos demasiado longos são cortados.

Alterar outro campo

Visibilidade, estado do produto, disponível para encomenda, mostrar preço, apenas online, etiqueta «em promoção», quantidade mínima, alerta de stock baixo, custos de envio adicionais, peso, largura, altura, profundidade e textos de disponibilidade. Na vista Combinações: quantidade mínima, alerta de stock baixo e impacto no peso.

Descontos

Adicionar um desconto cria um preço específico de catálogo: percentagem ou montante (com IVA por predefinição, ou marque «Montante sem IVA»), datas de início e de fim opcionais, grupo de clientes e quantidade mínima. Um desconto com exatamente as mesmas condições não é criado duas vezes. Remover todos os descontos apaga os preços específicos de catálogo dos itens, sem mexer nas regras de carrinho nem nas regras de preços de catálogo. Na vista Combinações, o desconto aplica-se a cada combinação. A coluna «Descontos» mostra o número de descontos em curso ou agendados.

Exportação e importação CSV

Exportar

O botão de transferência exporta as linhas selecionadas ou todos os resultados filtrados, com todos os campos editáveis da vista. Dois formatos: ponto e vírgula e vírgula decimal para o Excel em português e na maioria das línguas europeias, ou vírgula e ponto decimal para o Excel em inglês e o Google Sheets. Os cabeçalhos são códigos de campo (key, price, quantity…). As categorias são listadas como ID separados por |.

Reimportar

1. Mantenha-se na mesma vista da exportação (Produtos ou Combinações) e escolha o idioma dos campos de texto.
2. Clique no botão de importação e largue o ficheiro. O separador é detetado automaticamente.
3. Escolha como encontrar os itens: chave (coluna key da exportação), ID, referência ou EAN-13. Uma referência partilhada por vários produtos é assinalada e ignorada.
4. Clique em Pré-visualizar para ver as alterações das 20 primeiras linhas e depois em Importar.

As células vazias são ignoradas e só são gravados os valores diferentes dos atuais. Nos preços, uma alteração do preço sem IVA tem prioridade sobre o preço com IVA. As caixas sim/não aceitam 1/0, sim/não e os equivalentes nos idiomas do módulo. Cada importação aparece no histórico e pode ser anulada como uma ação em lote.

Histórico e anulação

O separador Histórico lista cada gravação da grelha, ação em lote, importação e anulação, com a data, o funcionário e o número de produtos e valores. Detalhes mostra cada valor antes e depois. Anular repõe os valores anteriores do conjunto. Por predefinição, um valor alterado de novo depois do conjunto é mantido e assinalado. Marque «Substituir alterações posteriores» na confirmação para o repor mesmo assim. Uma anulação também pode ser anulada.

Multiloja

A grelha mostra e edita apenas a loja selecionada. A partir do contexto «Todas as lojas» ou de um grupo, um aviso indica que loja é mostrada. Selecione outra loja no menu multiloja para a editar.

Resolução de problemas

• Uma ação em lote para a meio: reduza «Itens por pedido de lote» na configuração. Os itens já processados ficam no histórico e podem ser anulados.
• Uma célula continua a vermelho depois de gravar: o PrestaShop recusou o valor. Passe o rato sobre a célula para ler o motivo, corrija e grave de novo.
• O ficheiro importado mostra caracteres estranhos: guarde-o como «CSV UTF-8» no Excel.
• Um produto com novo nome não aparece na pesquisa da loja: o módulo reindexa os produtos ativos visíveis na pesquisa. Verifique a visibilidade do produto.