# Data e horário de entrega para PrestaShop: documentação do módulo > Este módulo acrescenta ao checkout do PrestaShop 8 e 9 uma escolha obrigatória de data e horário de entrega, limitada pela capacidade real da sua oficina, com zonas servidas por… - Página: - Idioma: pt - Atualizado em: 2026-09-24 - Outros idiomas: [fr](https://www.datafirefly.com/documentation/dfflorist/index.md), [en](https://www.datafirefly.com/en/documentation/dfflorist/index.md), [es](https://www.datafirefly.com/es/documentation/dfflorist/index.md), [de](https://www.datafirefly.com/de/documentation/dfflorist/index.md), [it](https://www.datafirefly.com/it/documentation/dfflorist/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfflorist/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfflorist/index.md) - Índice: Este módulo acrescenta ao checkout do PrestaShop 8 e 9 uma escolha obrigatória de data e horário de entrega, limitada pela capacidade real da sua oficina, com zonas servidas por dia da semana, cartão de mensagem, levantamento na loja e suplementos de entrega. Nome técnico: `dfflorist`. ## Instalação 1. Em **Módulos > Gestor de módulos**, clique em **Carregar um módulo** e largue o ficheiro ZIP. 2. Na instalação, o módulo cria as suas tabelas, dois horários de exemplo (Manhã 09:00-12:00 e Tarde 14:00-18:00), quatro modelos de cartão ilustrados e um produto oculto **Suplemento de entrega** (referência `DFFLO-SURCHARGE`). 3. Aparece um novo separador **Encomendas > Entregas florista**. A barra de navegação do módulo dá acesso ao planeamento, zonas, horários, encerramentos, cartões, carga da oficina e definições. Não elimine o produto Suplemento de entrega do catálogo: é ele que transporta os suplementos no carrinho. Pode alterar o nome, a imagem e a regra de imposto. ## Definições gerais ### Âmbito - **Produtos abrangidos**: todos os produtos ou só os das categorias assinaladas (flores frescas, plantas, produtos frescos). - **Transportadoras abrangidas**: deixe tudo desmarcado para aplicar o planeamento a todas. Com uma seleção, as outras transportadoras (flores secas por encomenda postal, por exemplo) não pedem data. - **Transportadoras de levantamento na loja**: ver mais abaixo. - **Entregar apenas dentro das zonas**: assim que uma zona está ativa, um código postal fora de todas as zonas não pode encomendar com uma transportadora abrangida. - **Selo na página de produto** e **cor de destaque** do bloco do checkout. ### Data de entrega e prazos - **Data obrigatória** e **hora obrigatória** (só quando existem horários para o dia escolhido). - **Entrega no próprio dia** e a respetiva **hora limite** (HH:MM, fuso horário da loja). - **Hora limite diária de encomenda** (opcional): uma encomenda feita depois desta hora conta a partir do dia seguinte. Exemplo: 16:00 com um prazo mínimo de um dia, uma encomenda de segunda-feira às 17:00 não pode ser entregue na terça. - **Prazo mínimo** em dias, **tempo de preparação antes de um horário** para encomendas do próprio dia, **janela de reserva** em dias. ### Capacidade da oficina - **Dias de entrega** da oficina e **capacidade por dia da semana** em unidades (0 = sem limite diário). - **Carga predefinida por produto**: unidades consumidas por artigo. Defina uma carga diferente por produto em **Carga da oficina**. - **Reserva durante o checkout** (20 minutos por defeito): os carrinhos que escolheram um horário retêm-no durante esse tempo. - **Aviso de últimos lugares** e **estados de encomenda que libertam capacidade** (cancelada, erro de pagamento, reembolsada por defeito). ### Cartão de mensagem e destinatário Ative o cartão, torne a mensagem obrigatória se necessário, fixe o comprimento máximo e proponha a assinatura e a opção de cartão sem assinatura. O telefone do destinatário pode estar oculto, ser opcional ou obrigatório. ## Zonas de entrega Uma zona agrupa códigos postais e os dias em que é servida. Padrões aceites, um por linha ou separados por vírgulas: - código exato: `1100-001` - prefixo: `11*` - intervalo: `1000-001..1999-999` O país é opcional. O **prazo adicional** soma-se ao prazo mínimo nas zonas afastadas e desativa aí a entrega no próprio dia. Quando várias zonas coincidem, vale a primeira zona ativa da lista. ## Horários de entrega Cada horário tem uma etiqueta traduzível, uma hora de início e de fim, dias da semana, uma capacidade em unidades (0 = só se aplica a capacidade do dia), um **suplemento com IVA** opcional e, se necessário, uma limitação a certas zonas. Sem horários ativos, o cliente escolhe apenas uma data. ## Encerramentos e dias de pico - **Fechado**: a data fica bloqueada (férias, inventário). - **Dia de pico ou abertura excecional**: a capacidade do dia é substituída pela sua (0 = ilimitada) e o dia abre mesmo que normalmente esteja fechado. Se não houver horários para esse dia da semana, são propostos todos os horários ativos. ## Cartões de mensagem Cada modelo tem um nome, um texto sugerido que preenche a mensagem quando o cliente escolhe o cartão e uma imagem JPG, PNG ou WebP até 2 MB, proporção 3:2 recomendada. Os quatro modelos incluídos (Aniversário, Amor, Obrigado, Condolências) são editáveis. ## Carga da oficina por produto Para cada produto, indique as **unidades por artigo** (0 para uma jarra ou chocolates sem preparação) e uma **preparação adicional** em dias para artigos por encomenda. Quando um desses produtos está no carrinho, o prazo aumenta e a entrega no próprio dia fica desativada. ## O que o cliente vê no checkout No passo Envio, o bloco aparece por baixo da lista de transportadoras, acima do botão Continuar. O cliente escolhe um dia no calendário (o indicador mostra a carga, um «+» assinala um suplemento) e depois um horário que mostra os últimos lugares e o suplemento. Em seguida escolhe um modelo de cartão, escreve a mensagem e a assinatura e vê a pré-visualização atualizar-se. A escolha é guardada automaticamente. O botão Continuar fica bloqueado enquanto faltar informação obrigatória, e o servidor volta a verificar tudo ao validar o passo. ## Levantamento na loja Assinale as suas transportadoras Click & collect em **Transportadoras de levantamento na loja**. Para elas, o bloco passa a **Data de levantamento**: sem zona, sem telefone do destinatário e sem suplemento. Os horários limitados a zonas não são propostos. Quando o cliente muda de transportadora, o bloco recarrega e o suplemento é adicionado ou retirado do carrinho. ## Suplementos de entrega Somam-se três fontes, todas com IVA na moeda predefinida: - o suplemento do **horário** escolhido (expresso, hora fixa); - o suplemento do **dia da semana** (o domingo, por exemplo); - o suplemento do **próprio dia**. O total é adicionado ao carrinho numa linha **Suplemento de entrega**, com a regra de imposto do produto oculto. Aparece no resumo, na encomenda e na fatura. É retirado automaticamente se o cliente passar ao levantamento na loja ou se o carrinho deixar de conter produtos abrangidos. ## Planeamento e impressão A página **Planeamento** mostra uma faixa de 14 dias com a sua ocupação, a carga do dia selecionado por horário, as unidades retidas por carrinhos em curso e a lista de entregas (hora, zona ou menção Levantamento na loja, destinatário, morada, artigos, cartão). Três ações: - **Imprimir cartões**: cartões A6, quatro por folha A4 com linhas de corte, marcados depois como Impresso; - **Folha de entregas**: volta por horário, levantamentos na loja numa secção à parte; - **Exportar CSV**: separador ponto e vírgula, compatível com Excel. ## Encomendas, emails e PDF - A lista de encomendas do back-office ganha uma coluna **Data de entrega** ordenável e filtrável por intervalo de datas. - A ficha da encomenda mostra um painel com a data, o horário, a zona, o suplemento e o cartão, e permite alterá-los (sem controlo de capacidade). - Nos emails nativos, a data é adicionada após o nome da transportadora, no idioma da encomenda. Variáveis disponíveis para os seus modelos: `{dfflo_delivery_date}`, `{dfflo_delivery_slot}`, `{dfflo_card_message}`. - A fatura em PDF mostra a data e o telefone do destinatário, a guia de remessa acrescenta a mensagem. ## Atualização a partir da 1.0.0 Carregue o ZIP 1.1.0 por cima da versão existente no gestor de módulos. O script de atualização acrescenta as novas colunas e definições, cria o produto Suplemento de entrega e associa as imagens aos cartões de exemplo. As suas zonas, horários e encomendas são mantidos. ## Perguntas frequentes ### O bloco não aparece no checkout Verifique se o módulo está ativado nas definições, se o carrinho contém um produto abrangido e se a transportadora escolhida está abrangida ou declarada como levantamento na loja. ### Não é proposta nenhuma data Verifique os dias de entrega da oficina, os dias servidos na zona do cliente, o prazo mínimo e a janela de reserva. Um produto com preparação adicional também adia a primeira data. ### O que acontece na desinstalação? As zonas, horários, cartões e datas guardadas nas encomendas são eliminados, bem como o produto Suplemento de entrega. As linhas de suplemento já faturadas permanecem nas encomendas.