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

<p>O módulo <strong>DataFirefly Pre-Orders</strong> (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.</p>

<h2>Instalação</h2>
<ol>
<li>Transfira o ZIP a partir da sua conta de cliente DataFirefly.</li>
<li>No back-office, vá a <em>Módulos > Gestor de módulos > Carregar um módulo</em> e envie o ZIP.</li>
<li>Na instalação, o módulo cria as suas tabelas, os dois estados de encomenda e dois separadores de menu: <em>Catálogo > Pré-encomendas</em> para as regras e <em>Encomendas > Pré-encomendas</em> para o acompanhamento.</li>
<li>Abra a configuração do módulo para rever as definições gerais e copiar o URL do cron.</li>
</ol>
<p>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.</p>

<h2>Definições gerais</h2>
<ul>
<li><strong>Texto do botão por defeito</strong> e <strong>texto do selo</strong>, por idioma. Cada regra pode substituí-los.</li>
<li><strong>Carrinhos que misturam pré-encomendas e artigos em stock</strong>: permitir sem mensagem, permitir com um aviso a indicar que a encomenda será enviada de uma só vez, ou proibir a mistura.</li>
<li><strong>Caixa de consentimento no checkout</strong>: acrescenta uma caixa obrigatória quando o carrinho contém uma pré-encomenda. O texto aceita o marcador <code>%date%</code>, substituído pela data de envio prevista mais tardia do carrinho. A data do consentimento fica guardada em cada linha de pré-encomenda.</li>
<li><strong>E-mails</strong> de confirmação e de disponibilidade, ativáveis separadamente.</li>
<li><strong>Atribuição automática</strong> do stock recebido e <strong>estado de encomenda</strong> a aplicar quando todas as linhas estiverem atribuídas.</li>
<li><strong>Formulário Avisar-me</strong> nos produtos que não podem ser encomendados.</li>
<li><strong>Dados estruturados PreOrder</strong>, desativados por defeito: ative apenas se o seu tema ou módulo SEO ainda não gerar o JSON-LD do produto.</li>
</ul>

<h2>Criar uma regra de pré-encomenda</h2>
<p>Vá a <em>Catálogo > Pré-encomendas</em> e depois a <em>Adicionar uma regra</em>. Uma regra abrange um produto ou uma combinação específica.</p>

<h3>Os três modos</h3>
<ul>
<li><strong>Quando esgotado</strong>: a pré-encomenda arranca quando o stock chega a zero e pára quando o stock é reposto. É o modo para ruturas do fornecedor.</li>
<li><strong>Forçada</strong>: o produto fica em pré-encomenda enquanto a regra estiver ativa, mesmo com stock. É o modo de um lançamento.</li>
<li><strong>Janela de datas</strong>: 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.</li>
</ul>

<h3>Os outros campos</h3>
<ul>
<li><strong>Data de envio prevista</strong>: apresentada na página do produto, no carrinho, na conta do cliente, na fatura e nos e-mails.</li>
<li><strong>Quantidade máxima</strong> e <strong>máximo por cliente</strong>: 0 significa ilimitado. Os limites são verificados no servidor em cada gravação do carrinho.</li>
<li><strong>Desconto de pré-encomenda</strong> 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.</li>
<li><strong>Texto do botão</strong> e <strong>mensagem</strong> por idioma, próprios da regra.</li>
<li><strong>Contagem decrescente</strong> (até ao fecho ou até ao lançamento) e <strong>barra de unidades reservadas</strong>, que exige uma quantidade máxima.</li>
</ul>

<h3>Criar muitas regras de uma vez</h3>
<p>O botão <em>Atribuição em massa e importação CSV</em> abre dois formulários. O primeiro cria uma regra por produto que corresponda a uma categoria, marca ou fornecedor, somando os critérios. O segundo importa um CSV com as colunas <code>product</code> (ID ou referência), <code>combination</code> (opcional), <code>mode</code>, <code>release_date</code>, <code>max_qty</code>, <code>max_per_customer</code>, <code>date_start</code>, <code>date_end</code>. As regras existentes são atualizadas.</p>

<h2>O que o cliente vê</h2>
<p>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.</p>
<p>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 <em>A minha conta > As minhas pré-encomendas</em> e pode pedir o cancelamento das linhas ainda pendentes.</p>

<h2>Acompanhamento e atribuição de stock</h2>
<p><em>Encomendas > Pré-encomendas</em> reúne o acompanhamento.</p>
<h3>Painel</h3>
<p>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.</p>
<h3>Atribuir uma entrega</h3>
<p>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 <em>Atribuir (mais antigas primeiro)</em> serve as encomendas por data, ou <em>Escolher encomendas</em> abre o ecrã de atribuição com as linhas propostas assinaladas e editáveis.</p>
<p>Quando todas as linhas em pré-encomenda de uma encomenda estão atribuídas, a encomenda passa ao estado configurado (por defeito <em>Pré-encomenda: pronta a enviar</em>) e o cliente recebe um e-mail. Depois prepara a encomenda normalmente.</p>
<div class=”df-callout note”><p>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.</p></div>

<h2>Gerir um atraso</h2>
<p>Abra a regra, altere a data de envio prevista e deixe ativa a opção <em>Avisar os clientes se a data mudar</em>. 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.</p>
<p>Os pedidos de cancelamento chegam ao painel. <em>Confirmar o cancelamento</em> liberta as unidades reservadas; o reembolso continua a ser feito na página da encomenda com o seu método de pagamento. <em>Manter a pré-encomenda</em> devolve as linhas ao estado pendente.</p>

<h2>Tarefa cron</h2>
<p>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.</p>

<h2>Perguntas frequentes</h2>
<h3>O cliente paga a totalidade?</h3>
<p>Sim, na versão 1.0. O sinal com pagamento do restante à disponibilidade está previsto para a versão 1.1.</p>
<h3>Porque é que uma encomenda passa a Pré-encomenda: a aguardar stock?</h3>
<p>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.</p>
<h3>Uma regra sobre uma combinação afeta as outras?</h3>
<p>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.</p>
<h3>A contagem decrescente não aparece</h3>
<p>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.</p>
<h3>O botão mantém o texto original</h3>
<p>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.</p>