Preço unitário e venda a peso: documentação DataFirefly Unit Price

Instalação

Instale o módulo em Módulos > Gestor de módulos > Carregar um módulo com o ficheiro ZIP, ou copie a pasta dfunitprice para o diretório /modules/ da loja e clique em Instalar.

Na instalação, o módulo cria três tabelas (conteúdos, modos de venda, pesagens de encomendas) e regista os seus hooks. Não acrescenta entradas de menu: tudo se configura na página de configuração do módulo, no separador Módulos da página do produto e na página da encomenda.

Definições do módulo

A página de configuração reúne, de cima para baixo, o editor em massa, as definições, a lista de peças a pesar, as ferramentas e o relatório de conformidade.

Preço unitário dos pesos e dos volumes

Escolha a expressão por defeito: por 1 kg ou por 100 g, por 1 litro ou por 100 ml. Os comprimentos são sempre expressos por metro, as superfícies por m², os volumes a granel por m³. Cada produto pode alterar esta escolha.

Países que impõem 1 kg e 1 litro

Códigos ISO separados por vírgulas, DE por defeito. Para um visitante destes países, o preço unitário é sempre expresso por 1 kg, 1 L, 1 m, 1 m² ou 1 m³, como exige a PAngV alemã, mesmo que tenha escolhido 100 g noutros países.

Apresentação e posições

• Mostrar na página do produto e Posição na página do produto: o preço unitário passa pelo hook nativo displayProductPriceBlock. A posição after_price (por baixo do preço) serve o Classic e os temas derivados. Altere-a apenas se o seu tema não chamar essa posição.
• Mostrar nas listas de produtos e Posição nas listas: categorias, pesquisa, marcas, carrosséis. Posição unit_price por defeito.
• Mostrar no carrinho: por baixo do preço de cada linha.
• Formato: «12,90 € / kg» ou entre parênteses.
• Texto antes do preço unitário: opcional e traduzível, por exemplo «Preço por quilo».

Ocultar se igual ao preço de venda

Uma embalagem de 1 kg vendida ao quilo repete o mesmo valor. Alguns países permitem não o mostrar nesse caso: verifique a regra do seu país antes de ativar a opção.

Ocultar o preço unitário nativo do tema

Evita o duplicado na página do produto quando o tema também mostra o campo nativo.

Escrever nos campos nativos do PrestaShop

O módulo atualiza o preço unitário nativo, a sua etiqueta de unidade (por exemplo «/ kg») e o impacto por combinação. Os módulos de feeds do Google Shopping ou de marketplaces que leem estes campos recebem assim o valor correto.

Reembolso mínimo das peças ao peso real

Abaixo desta diferença com IVA numa encomenda, não é criada nota de crédito. Deixe 0 para reembolsar qualquer diferença.

Categorias em que o preço unitário é obrigatório

Usado apenas pelo relatório de conformidade, que lista os produtos ativos destas categorias sem conteúdo.

Introduzir o conteúdo de um produto

Abra a página do produto, separador Módulos, bloco Preço unitário e modo de venda. O bloco guarda-se com o seu próprio botão Guardar o preço unitário, independentemente do formulário do produto.

• Conteúdo líquido e Unidade: 750 g, 1,5 L, 2,5 m, 12 m² ou uma peça. Deixe vazio para não mostrar preço unitário.
• Preço unitário expresso por: para pesos e volumes, substitui a definição do módulo neste produto.

Por baixo dos campos, uma linha verde mostra durante a escrita o preço unitário calculado com o preço atual. Depois de guardar, uma pré-visualização lembra o preço com IVA sem desconto, o conteúdo e o preço unitário obtido.

Combinações

Preencha apenas as combinações cujo conteúdo difere do produto, por exemplo 250 g, 500 g e 1 kg. Uma combinação sem valor usa o do produto. A unidade «Igual ao produto» usa a unidade do produto. As combinações criadas depois de abrir a página aparecem ao recarregá-la.

O cálculo

O preço unitário é o preço mostrado ao cliente dividido pelo conteúdo e convertido para a referência escolhida. Segue a apresentação com ou sem IVA do grupo do cliente, os preços específicos e as promoções. No carrinho, usa o preço da linha.

Venda ao peso escolhido pelo cliente

Escolha o modo O cliente escolhe a quantidade. O conteúdo torna-se o tamanho de um passo e o preço do produto passa a ser o preço de um passo. Exemplo: passo de 100 g a 2,50 €, um cliente que escolhe 700 g adiciona 7 passos ao carrinho por 17,50 €.

• Mínimo e Máximo, na unidade base (g, ml, cm, m², m³): cada valor tem de ser múltiplo do passo. O máximo é opcional.
• Botões de quantidade: valores separados por ponto e vírgula, por exemplo 250; 500; 1000, cada um múltiplo do passo e entre o mínimo e o máximo.
• Permitir uma quantidade livre: mostra o seletor +/- com introdução direta. Sem botões de quantidade, a introdução livre aparece sempre.

Na página do produto, o campo de quantidade do tema é substituído por este seletor, com os limites e o total em direto. O seletor funciona também na vista rápida das listas e mantém o peso escolhido quando o cliente muda de combinação.

O que o módulo trata por si

• A quantidade mínima nativa do produto e das suas combinações é sincronizada em número de passos.
• O máximo é aplicado no servidor: uma quantidade superior adicionada ao carrinho é reduzida ao máximo.
• A linha da encomenda passa a «Café (700 g)» no back office, na fatura e no e-mail de confirmação.

Peça ao peso real

Escolha o modo Peça ao peso real para os produtos cujo peso exato só se conhece na preparação: carne, queijo ao corte, peixe.

• Peso médio de uma peça: é o conteúdo, por exemplo 1,2 kg. O preço do produto é o de uma peça com esse peso.
• Peça mais leve e Peça mais pesada: opcionais, mostradas ao cliente como intervalo. O intervalo tem de incluir o peso médio.

Na página do produto, uma caixa «Vendido ao peso real» explica a regra ao cliente: uma peça mais leve é reembolsada da diferença, uma peça mais pesada não custa nada a mais. A linha da encomenda passa a «Costeleta (cerca de 1,2 kg)» ou «(2 × cerca de 1,2 kg)».

Pesar uma encomenda

Na página da encomenda, o painel Pesos reais lista cada linha em causa com o peso estimado e o valor pago.

1. Introduza o peso real total de cada linha, todas as peças incluídas, em kg (em L para um volume, em m para um comprimento).
2. O reembolso de cada linha e o total são calculados durante a escrita. Um peso que se afasta mais de 50 % da estimativa mostra um alerta, muitas vezes um erro de unidade (1200 em vez de 1,2).
3. Escolha se o cliente recebe o e-mail e o vale, clique em Validar os pesos e confirme.

O reembolso de uma linha mais leve é proporcional: valor pago × (1 − peso real / peso estimado). Uma linha mais pesada não gera reembolso e nunca é cobrada a mais.

O que é criado

• Uma nota de crédito PrestaShop pelo total das diferenças, visível nos documentos da encomenda. O seu PDF lista as linhas e uma tabela «Regularização ao peso real».
• Um vale do mesmo valor se a caixa estiver assinalada, reservado ao cliente e válido durante um ano.
• Um e-mail ao cliente no seu idioma com os pesos estimados, os pesos reais e o valor reembolsado.

A fatura da encomenda inclui uma menção que explica a venda com peso estimado e a regularização por nota de crédito. O cliente vê também os pesos reais no detalhe da encomenda, na sua conta.

Encomendas a pesar

A página de configuração lista as encomendas que ainda contêm peças a pesar, das mais antigas para as mais recentes, com uma ligação direta para cada encomenda. As encomendas canceladas, com erro ou reembolsadas não aparecem.

Editor em massa

No topo da página de configuração, o editor em massa mostra os produtos em páginas de 50, filtráveis por categoria, por nome, referência ou ID, e limitados por defeito aos que ainda não têm conteúdo.

• Os conteúdos escritos no nome ou na referência são detetados e pré-preenchidos, com a menção «Detetado». As embalagens são multiplicadas («6 x 33 cl» dá 198 cl) e as dimensões como «40×60 cm» ignoradas.
• Alterar um valor assinala a linha. O preço unitário é calculado em direto.
• Selecionar os tamanhos detetados assinala de uma vez todas as linhas pré-preenchidas da página.
• Preencher também as combinações cujo nome contém um tamanho: uma combinação «Peso – 500 g» recebe 500 g, sem substituir um valor já introduzido.

Esvaziar o conteúdo de uma linha assinalada remove o conteúdo do produto. Os produtos vendidos a peso ou ao peso real são só de leitura na tabela: edite-os na sua página.

Importação e exportação CSV

O bloco Exportar CSV produz uma linha por produto e por combinação, para todo o catálogo ou uma categoria. Colunas: id_product, id_product_attribute, reference, name, net_quantity, unit, reference_unit.

A importação aceita o separador ; ou ,. As colunas net_quantity e unit são obrigatórias, juntamente com id_product ou reference (referência do produto ou da combinação). Unidades: g, kg, ml, cl, l, mm, cm, m, m2, m3, unit. reference_unit aceita 1kg, 100g, 1l ou 100ml. Um net_quantity vazio remove a linha. Os erros são listados com o número da linha sem bloquear as restantes.

Ferramentas e relatório de conformidade

Ressincronizar agora recalcula os campos nativos e as quantidades mínimas de todos os produtos configurados. Use-o depois de uma importação de preços em massa, ou quando funcionários sem acesso ao módulo editam produtos: o PrestaShop não executa os hooks de um módulo para um perfil sem permissão para o ver.

O relatório de conformidade indica o número de produtos configurados e lista até 300 produtos ativos sem conteúdo nas categorias obrigatórias, com uma ligação para a sua página.

Resolução de problemas

O preço unitário não aparece na página do produto

Verifique se o produto tem conteúdo e se a apresentação na página do produto está ativa. Se o tema não chamar a posição after_price, escolha price ou weight nas definições.

O preço unitário aparece duas vezes

Ative Ocultar o preço unitário nativo do tema. Se o duplicado continuar, o seu tema usa outra classe CSS para esse bloco: contacte-nos com o nome do tema.

O campo de quantidade continua visível num produto vendido a peso

O tema usa uma marcação de quantidade não standard. O peso escolhido é na mesma respeitado no servidor (mínimo e máximo). Contacte-nos com o nome do tema para uma adaptação.

O preço nativo não está atualizado depois de uma importação de preços

Clique em Ressincronizar agora.

Compatibilidade

• PrestaShop 8.0 a 9.x, o mesmo ZIP cobre os dois ramos.
• Apresentação através do hook nativo displayProductPriceBlock, testada com o tema Classic.
• Arquitetura ModuleAdminController, sem dependência do Composer, PHP 7.2 ou superior.
• Interface e e-mails em português, francês, inglês, espanhol, alemão, italiano, neerlandês e polaco.