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

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.