# 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…

- Página: <https://www.datafirefly.com/pt/documentation/dfunitprice/>
- Idioma: pt
- Atualizado em: 2026-09-23
- Outros idiomas: [fr](https://www.datafirefly.com/documentation/dfunitprice/index.md), [en](https://www.datafirefly.com/en/documentation/dfunitprice/index.md), [es](https://www.datafirefly.com/es/documentation/dfunitprice/index.md), [de](https://www.datafirefly.com/de/documentation/dfunitprice/index.md), [it](https://www.datafirefly.com/it/documentation/dfunitprice/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfunitprice/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfunitprice/index.md)
- Índice: <https://www.datafirefly.com/pt/documentation/llms.txt>

## 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.

O stock continua a ser contado em passos, porque o PrestaShop não admite quantidades decimais. Com um passo de 100 g, introduza 50 para 5 kg em stock. O bloco da página do produto lembra esta conversã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.

A nota de crédito regista o reembolso, mas não devolve o dinheiro. Salvo se der um vale, devolva o valor através do seu prestador de pagamento. Uma pesagem validada é definitiva. A nota de crédito mantém a quantidade da linha para que o PDF nativo mostre o valor correto: o PrestaShop considera por isso estas peças como já reembolsadas, e um reembolso posterior destas linhas faz-se por valor através do seu prestador de pagamento.

### 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 «40x60 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.
