# Horários de Entrega PrestaShop: instalação e configuração

> Apresentação O módulo acrescenta ao checkout do PrestaShop 8 e 9 a escolha de um dia e de uma janela horária de entrega ou de levantamento. Cada janela tem uma…

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

## Apresentação

O módulo acrescenta ao checkout do PrestaShop 8 e 9 a escolha de um dia e de uma janela horária de entrega ou de levantamento. Cada janela tem uma capacidade em número de encomendas, cada zona os seus códigos postais, transportadoras, hora limite e dias de encerramento. A janela escolhida acompanha a encomenda até ao planeamento, aos emails, à fatura e à guia de remessa.

## Instalação

1. Em **Módulos > Gestor de módulos**, clique em **Carregar um módulo** e envie o ficheiro `dfdeliveryslots-1.1.0.zip`.
2. O módulo cria o menu **Encomendas > Janelas de entrega**. O botão Configurar do módulo também leva até lá.
3. A partir da versão 1.0.0, basta enviar o novo ZIP: o script de atualização acrescenta as novas colunas, tabelas e hooks.

## Criar uma zona

Abra o separador **Zonas e janelas** e depois **Adicionar uma zona**. É usada a primeira zona ativa da lista que corresponde à transportadora, ao país e ao código postal da morada.

### Tipo de zona

**Entrega ao domicílio** ou **Levantamento na loja**. O tipo altera os textos mostrados ao cliente ("Escolha o dia e a hora de levantamento"), os emails e a fatura. Para levantamento, associe a sua transportadora "levantamento na loja" e deixe os códigos postais vazios.

### Transportadoras

Assinale as transportadoras sob as quais o seletor aparece. Só são listadas as transportadoras nativas: as fornecidas por um módulo (pontos de recolha, serviços de encomendas) não são suportadas.

### Países e códigos postais

Deixe os países vazios para todos os países. Os códigos postais separam-se por vírgulas ou quebras de linha:

- valor exato: `06000`
- intervalo: `06000-06300`
- prefixo: `06*`
- códigos com hífen: `1000-001`, intervalo `1000-001-1999-999`

O campo **Testar um código postal** indica em direto se um código está abrangido pela zona.

### Prazo e hora limite

- **Prazo mínimo (dias)**: 0 permite a entrega no próprio dia, 1 começa no dia seguinte.
- **Hora limite de encomenda**: depois desta hora, é acrescentado um dia ao prazo.
- **Tempo de preparação (minutos)**: uma janela que começa em menos deste tempo deixa de ser proposta.
- **Período de reserva (dias)**: número de dias propostos a partir do primeiro dia possível.
- **Máximo de entregas por dia**: limite para todas as janelas do dia, 0 para nenhum.

## Janelas semanais

O **gerador rápido** cria as janelas de uma só vez: dias assinalados, hora de início e de fim, duração, capacidade e suplemento. Cada janela continua editável:

- **Capacidade**: número máximo de encomendas por janela e por data, 0 para ilimitada.
- **Suplemento**: valor com imposto incluído acrescentado à encomenda para esta janela (expresso, noite, domingo), 0 para nenhum.
- **Oferecida**: desmarcada, a janela fica guardada mas deixa de ser proposta.

Eliminar uma janela não afeta as encomendas já feitas nela.

## Dias de encerramento

O separador **Dias de encerramento** encerra uma data ou um período (até 366 dias), para uma zona ou para todas. Assinale **Repetir todos os anos na mesma data** para os feriados fixos como 25 de dezembro.

## Prazos por produto

O separador **Prazos por produto** acrescenta dias aos produtos preparados por encomenda. A regra aplica-se a um produto (ID ou referência) ou a uma categoria. O prazo adicional mais longo do carrinho soma-se ao da zona e o cliente vê uma mensagem com o primeiro dia disponível.

## Planeamento

O separador **Planeamento de entregas** mostra os próximos 14 dias com o número de encomendas e, para o dia escolhido, a ocupação de cada janela e as encomendas agrupadas por janela horária.

- **Ajustar este dia**: altera a capacidade de uma janela só para esta data. Vazio = capacidade habitual, 0 = janela encerrada nesse dia.
- **Imprimir a folha de entregas**: moradas, telefones e instruções por janela.
- **Exportar CSV**: ficheiro separado por ponto e vírgula, que abre no Excel.

## Definições

- **Janela obrigatória** para as transportadoras associadas a uma zona.
- **Ocultar estas transportadoras** quando a morada está fora de todas as zonas.
- **Janela nos emails de confirmação**, junto ao nome da transportadora.
- **Reserva da janela durante o checkout**: 30 minutos por defeito, 0 para contar só as encomendas concluídas.
- **Limiar dos lugares restantes**: mostra "Só restam 2" abaixo deste número de lugares.
- **Cor de destaque** do dia e da janela selecionados.
- **Imposto aplicado aos suplementos**.

### Linha de suplemento

O PrestaShop não permite acrescentar um valor aos portes de uma transportadora nativa sem override. O suplemento é por isso transportado por um produto oculto criado pelo módulo, acrescentado ao carrinho numa linha própria com um preço específico do carrinho. Mantenha este produto ativo e exclua-o dos seus feeds de produtos se necessário. O seu ID aparece nas definições.

## Email de lembrete

Ative **Enviar um lembrete ao cliente**, escolha os dias de antecedência (1 = na véspera, 0 = na manhã do próprio dia) e a hora a partir da qual o envio é permitido. Chame o URL de cron indicado nas definições uma vez por hora, por exemplo:

```
0 * * * * curl -s "https://sua-loja.pt/pt/module/dfdeliveryslots/cron?token=..."
```

O botão **Enviar agora os lembretes pendentes** lança o envio manualmente. Cada encomenda recebe um só lembrete, reenviado se alterar a data no back office. Os modelos `dfds_reminder` e `dfds_reminder_pickup` estão na pasta `mails/` do módulo, em 8 idiomas.

## Nas encomendas

- **Ficha da encomenda**: janela, zona, suplemento e formulário para mudar a data ou a janela. A capacidade não é verificada nas alterações feitas no back office.
- **Lista de encomendas**: coluna Janela de entrega, ordenável e filtrável por intervalo de datas.
- **Fatura e guia de remessa em PDF**: janela impressa no idioma da encomenda.
- **Encomenda cancelada**: a janela é libertada automaticamente.

## Limitações conhecidas

- As transportadoras fornecidas por um módulo (pontos de recolha) não são suportadas.
- O módulo foi pensado para o checkout nativo. Os módulos de checkout numa só página não foram testados.
- Um cupão em percentagem também se aplica à linha de suplemento, e o suplemento conta para o limiar de portes grátis.
- Com a loja em manutenção, o cron tem de ser chamado a partir de um IP autorizado.
