# Documentação do módulo de Pré-encomenda PrestaShop (dfpreorder)

> O módulo DataFirefly Pre-Orders (dfpreorder) permite vender produtos antes de chegarem ao armazém no PrestaShop 8 e 9. Esta página cobre a instalação, as definições, as regras, as entradas de…

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

O módulo **DataFirefly Pre-Orders** (dfpreorder) permite vender produtos antes de chegarem ao armazém no PrestaShop 8 e 9. Esta página cobre a instalação, as definições, as regras, as entradas de stock e a resolução de problemas.

## Instalação

1. Transfira o ZIP a partir da sua conta de cliente DataFirefly.
2. No back-office, vá a _Módulos > Gestor de módulos > Carregar um módulo_ e envie o ZIP.
3. Na instalação, o módulo cria as suas tabelas, os três estados de encomenda e dois separadores de menu: _Catálogo > Pré-encomendas_ para as regras e _Encomendas > Pré-encomendas_ para o acompanhamento.
4. Abra a configuração do módulo para rever as definições gerais e copiar o URL do cron.

O módulo funciona de PrestaShop 8.0 a 9.x com o mesmo ZIP, em multiloja e multilingue. Os textos são fornecidos em português, inglês, francês, espanhol, alemão, italiano, neerlandês e polaco.

## Definições gerais

- **Texto do botão por defeito** e **texto do selo**, por idioma. Cada regra pode substituí-los.
- **Carrinhos que misturam pré-encomendas e artigos em stock**: permitir sem mensagem, permitir com um aviso a indicar que a encomenda será enviada de uma só vez, ou proibir a mistura.
- **Caixa de consentimento no checkout**: acrescenta uma caixa obrigatória quando o carrinho contém uma pré-encomenda. O texto aceita o marcador `%date%`, substituído pela data de envio prevista mais tardia do carrinho. A data do consentimento fica guardada em cada linha de pré-encomenda.
- **E-mails** de confirmação e de disponibilidade, ativáveis separadamente.
- **Atribuição automática** do stock recebido e **estado de encomenda** a aplicar quando todas as linhas estiverem atribuídas.
- **Formulário Avisar-me** nos produtos que não podem ser encomendados ou cujas pré-encomendas estão esgotadas.
- **Envio das encomendas mistas**: um único envio quando tudo estiver disponível, envio parcial (primeiro os artigos em stock, uma encomenda e uma fatura) ou divisão em duas encomendas com a mesma referência no checkout. Na divisão, escolhe se o cliente decide no carrinho ou se todos os carrinhos mistos são divididos.
- **E-mail de envio parcial**, com a lista dos artigos enviados e a ligação de seguimento.
- **Dados estruturados PreOrder**, desativados por defeito: ative apenas se o seu tema ou módulo SEO ainda não gerar o JSON-LD do produto.

## Criar uma regra de pré-encomenda

Vá a _Catálogo > Pré-encomendas_ e depois a _Adicionar uma regra_. Uma regra abrange um produto ou uma combinação específica. O modo escolhe-se com três cartões, e uma coluna à direita mostra uma pré-visualização do bloco da loja enquanto escreve, com as pré-encomendas pendentes da regra e o histórico das datas.

### Os três modos

- **Quando esgotado**: a pré-encomenda arranca quando o stock chega a zero e pára quando o stock é reposto. É o modo para ruturas do fornecedor.
- **Forçada**: o produto fica em pré-encomenda enquanto a regra estiver ativa, mesmo com stock. É o modo de um lançamento.
- **Janela de datas**: a pré-encomenda abre e fecha nas datas indicadas. O fecho é aplicado pela tarefa cron e, como reforço, em cada visita à página do produto.

### Os outros campos

- **Data de envio prevista**: apresentada na página do produto, no carrinho, na conta do cliente, na fatura e nos e-mails.
- **Quantidade máxima** e **máximo por cliente**: 0 significa ilimitado. Os limites são verificados no servidor em cada gravação do carrinho.
- **Desconto de pré-encomenda** em percentagem ou montante: disponível nos modos forçada e janela de datas, em que o período é conhecido à partida. Cria um preço específico removido no fim da regra.
- **Texto do botão** e **mensagem** por idioma, próprios da regra.
- **Contagem decrescente** (até ao fecho ou até ao lançamento) e **barra de unidades reservadas**, que exige uma quantidade máxima.

### Criar muitas regras de uma vez

O botão _Atribuição em massa e importação CSV_ abre dois formulários. O primeiro abrange todos os produtos de uma categoria, marca ou fornecedor (os critérios somam-se). Para os produtos que já têm regras, escolha _Atualizar apenas a data de envio prevista_ (por defeito), _Substituir todas as definições_ ou _Não alterar_, e se os produtos sem regra recebem uma.

O segundo importa um CSV com as colunas `product` (ID ou referência), `combination` (opcional), `mode`, `release_date`, `max_qty`, `max_per_customer`, `date_start`, `date_end`. Nas regras existentes só são alteradas as colunas presentes e preenchidas.

### Alterar a data de reposição de um fornecedor

Na atribuição em massa, escolha o fornecedor, introduza a nova data de envio prevista, mantenha _Atualizar apenas a data de envio prevista_ e _Avisar os clientes se a data mudar_ e aplique. Todas as regras dos produtos do fornecedor são alteradas, incluindo as das combinações; modos, limites e janelas ficam intactos. As pré-encomendas pendentes recebem a nova data, os clientes recebem o e-mail de atraso com uma ligação de cancelamento e a alteração fica registada no histórico de cada regra. Um CSV só com `product` e `release_date` faz o mesmo produto a produto.

## O que o cliente vê

Num produto em pré-encomenda, o botão de adicionar ao carrinho assume o texto escolhido, aparece um selo nas imagens das listagens e da página do produto, e uma caixa mostra a data prevista, a sua mensagem, a contagem decrescente e a barra de unidades reservadas. O bloco atualiza-se ao mudar de combinação.

No carrinho, cada linha abrangida é assinalada com a data prevista. No checkout, a caixa de consentimento recorda a data. Após a encomenda, o cliente acompanha as suas pré-encomendas em _A minha conta > As minhas pré-encomendas_ e pode pedir o cancelamento das linhas ainda pendentes.

## Envio das encomendas mistas

A definição _Envio das encomendas mistas_ decide o que acontece quando uma encomenda contém artigos em stock e artigos em pré-encomenda.

- **Um único envio** (por defeito): toda a encomenda aguarda em _Pré-encomenda: a aguardar stock_ e segue quando tudo estiver disponível.
- **Envio parcial**: a página da encomenda mostra os artigos em stock com um campo para o número de seguimento e o botão _Marcar como parcialmente enviada_. A encomenda passa a _Pré-encomenda: parcialmente enviada_, que permite a guia de remessa, e o cliente recebe a lista dos artigos enviados, a ligação de seguimento da transportadora e os artigos restantes com as datas. O painel lista todas as encomendas cuja parte em stock pode seguir já. Uma encomenda, uma fatura; o segundo volume usa o número de seguimento nativo do PrestaShop.
- **Divisão em duas encomendas**: o PrestaShop cria no checkout uma encomenda para os artigos em stock e outra para as pré-encomendas, com a mesma referência, através do seu mecanismo nativo de volumes (sem override). Uma linha parcialmente em stock é dividida em duas. Os portes aplicam-se a cada volume. Com a opção de escolha do cliente, uma caixa no carrinho permite-lhe pedir a divisão; caso contrário, todos os carrinhos mistos são divididos.

Teste a divisão com os seus módulos de pagamento numa loja de testes antes de a ativar. Um produto em modo forçado que ainda tem stock é considerado em stock pelo PrestaShop e não é separado.

### Coluna Pré-encomenda na lista de encomendas

A lista nativa _Encomendas_ ganha uma coluna _Pré-encomenda_ com filtro: qualquer pré-encomenda, a aguardar stock, pronta a enviar, cancelamento pedido. Isola num clique as encomendas que aguardam stock.

## Acompanhamento e atribuição de stock

_Encomendas > Pré-encomendas_ reúne o acompanhamento.

### Painel

Os indicadores mostram as unidades pendentes, o número de encomendas envolvidas, a faturação reservada com IVA, as unidades já atribuídas e os pedidos de cancelamento. A tabela por produto indica, para cada produto ou combinação, as unidades pendentes, o stock do PrestaShop, as unidades atribuíveis de imediato e a quantidade a encomendar ao fornecedor. O botão de exportação CSV usa as mesmas colunas.

### Atribuir uma entrega

Uma pré-encomenda baixa o stock no momento da encomenda, deixando-o negativo. As unidades fisicamente disponíveis para as pré-encomendas são, portanto: unidades pendentes + stock atual. Depois de uma reposição, o botão _Atribuir (mais antigas primeiro)_ serve as encomendas por data, ou _Escolher encomendas_ abre o ecrã de atribuição com as linhas propostas assinaladas e editáveis. O total da seleção atualiza-se em tempo real, com um alerta se ultrapassar as unidades fisicamente disponíveis.

Quando todas as linhas em pré-encomenda de uma encomenda estão atribuídas, a encomenda passa ao estado configurado (por defeito _Pré-encomenda: pronta a enviar_) e o cliente recebe um e-mail. Depois prepara a encomenda normalmente.

A atribuição automática serve as pré-encomendas sem validação manual, mas nunca antes da data anunciada numa regra forçada ou com janela de datas.

## Gerir um atraso

Abra a regra, altere a data de envio prevista e deixe ativa a opção _Avisar os clientes se a data mudar_. As pré-encomendas pendentes são atualizadas e cada cliente afetado recebe um e-mail com a nova data e uma ligação para pedir o cancelamento. O número de clientes avisados aparece depois de guardar, e o histórico das datas anunciadas surge por baixo do formulário.

Os pedidos de cancelamento chegam ao painel. _Confirmar o cancelamento_ liberta as unidades reservadas; o reembolso continua a ser feito na página da encomenda com o seu método de pagamento. _Manter a pré-encomenda_ devolve as linhas ao estado pendente.

## Tarefa cron

A configuração do módulo mostra um URL com token. Agende-o a cada 15 minutos no seu alojamento. Abre e fecha as janelas de datas à hora prevista e, se a atribuição automática estiver ativa, serve as pré-encomendas cujo stock chegou.

## Perguntas frequentes

### O cliente paga a totalidade?

Sim. O cliente paga a totalidade na encomenda com os seus meios de pagamento habituais.

### Os artigos em stock podem seguir antes das pré-encomendas?

Sim, com o envio parcial ou a divisão descritos em Envio das encomendas mistas. No modo de envio único, a encomenda aguarda até tudo estar disponível.

### Porque é que uma encomenda passa a Pré-encomenda: a aguardar stock?

O módulo coloca a encomenda nesse estado assim que ela é paga e contém pelo menos uma linha em pré-encomenda. O estado está pago e não é enviável, o que evita que uma encomenda incompleta siga para preparação.

### Uma regra sobre uma combinação afeta as outras?

O PrestaShop só gere a definição que permite encomendas sem stock ao nível do produto. O módulo aplica-a no produto e depois bloqueia, na loja e no carrinho, as combinações esgotadas sem regra, para manter o comportamento original da loja.

### A contagem decrescente não aparece

Só aparece se a data de fecho (modo janela) ou a data de envio prevista estiver no futuro, e se a opção estiver ativa na regra.

### O botão mantém o texto original

O módulo substitui o texto do botão de adicionar ao carrinho nos temas padrão. Num tema muito personalizado, contacte o suporte com o URL da página do produto: o seletor do botão pode ser adaptado.
