# Formulário de Entrega de Objetos Pesados: guia de instalação e configuração

> O módulo Formulário de Entrega de Objetos Pesados e Volumosos mostra, na etapa de transportadora do checkout, um questionário sobre as condições de acesso (andar, elevador, escadas, passagens estreitas, obstáculos)…

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

O módulo **Formulário de Entrega de Objetos Pesados e Volumosos** mostra, na etapa de transportadora do checkout, um questionário sobre as condições de acesso (andar, elevador, escadas, passagens estreitas, obstáculos) para os produtos pesados ou volumosos: móveis, eletrodomésticos, televisores de grande formato, mobiliário profissional ou médico. Os campos são inteiramente configuráveis no back-office, sem escrever uma linha de código.

Este módulo foi desenvolvido para PrestaShop 8.0 a 9.x, compatível com multiloja e multilingue. Não usa nenhuma dependência externa: JavaScript vanilla, sem jQuery nem Composer.

Os 17 campos pré-instalados e os modelos de e-mail de notificação são fornecidos em francês e inglês. Numa loja em português, traduza as designações e textos de ajuda de cada campo no construtor (campos por idioma) e preencha o título e a introdução do formulário em português; o e-mail de notificação ao seu serviço logístico parte no idioma de recurso (inglês) salvo se adicionar uma pasta `mails/pt/`.

## Instalação

1. A partir do back-office, abra **Módulos > Gestor de módulos** e clique em **Instalar um módulo**.
2. Selecione o ficheiro `dfdeliveryform.zip` e lance a instalação.
3. No fim da instalação, clique em **Configurar** para aceder às definições.

Na instalação, o módulo cria automaticamente as suas tabelas, regista os seus hooks e pré-instala um conjunto de **17 campos prontos a usar** (horários de presença, acesso de camião pesado, distância de estacionamento, andar, elevador, escadas, passagens estreitas, obstáculos, confirmação de exatidão). Pode mantê-los, modificá-los ou partir do zero.

## Definições gerais

A página de configuração divide-se em duas zonas: as **definições** (em cima) e o **construtor de campos** (em baixo).

- **Ativar o módulo**: mostra ou oculta o formulário do lado da loja.
- **Bloquear o checkout enquanto não estiver completo**: se ativado, o cliente não pode confirmar a etapa de entrega antes de ter submetido o formulário. Se desativado, o formulário fica facultativo.
- **Modo de ativação**: determina quando o formulário aparece (ver a secção seguinte).
- **E-mail de notificação**: endereço que recebe o formulário preenchido na validação da encomenda. Deixe vazio para usar o e-mail da loja.
- **Título do formulário** e **Texto de introdução**: personalizáveis por idioma.

## Modos de ativação

O formulário só deve aparecer para as encomendas em causa. Estão disponíveis quatro modos:

- **Todas as encomendas**: o formulário aparece sistematicamente.
- **Limiar de peso do produto**: o formulário aparece assim que um produto do carrinho atinge o peso definido (30 kg por defeito). Ideal para eletrodomésticos e mobiliário. O peso usado é o peso unitário do produto preenchido na sua ficha.
- **Produtos específicos**: introduza uma lista de IDs de produtos separados por vírgulas (ex. `12,45,102`).
- **Categorias específicas**: introduza uma lista de IDs de categorias separados por vírgulas. Qualquer produto que pertença a uma dessas categorias ativa o formulário.

O formulário mostra ao cliente a lista dos produtos em causa do seu carrinho, para que compreenda porque lhe são feitas estas perguntas.

## Construtor de campos

O construtor, situado sob as definições, lista todos os campos do formulário. Para cada campo, pode reordená-lo (setas cima/baixo), ativá-lo/desativá-lo, modificá-lo ou eliminá-lo.

### Adicionar ou modificar um campo

Clique em **Adicionar um campo** ou no ícone de lápis de um campo existente. O editor propõe:

- **Tipo**: 7 tipos disponíveis: título de secção, texto, número, texto longo, interruptor, Sim/Não, lista pendente.
- **Designação** e **texto de ajuda**: introduzidos por idioma. A designação no idioma por defeito é obrigatória; os idiomas deixados vazios retomam essa designação.
- **Opções** (apenas tipo lista pendente): uma opção por linha, independentemente para cada idioma.
- **Mostrar apenas se**: condição de apresentação (ver abaixo).
- **Obrigatório** e **Ativo**.

O código técnico de um campo é gerado automaticamente a partir da designação na criação e mantém-se estável depois, mesmo que renomeie a designação.

### Tipos de campos

- **Título de secção**: separador visual, sem introdução.
- **Texto**: campo de introdução numa linha.
- **Número**: introdução numérica (distância, largura, número de degraus…).
- **Texto longo**: zona de texto multilinha para as descrições.
- **Interruptor**: comutador sim/não estilizado, ideal para uma confirmação.
- **Sim / Não**: duas pastilhas exclusivas, serve muitas vezes de pai a um campo condicional.
- **Lista pendente**: escolha entre opções definidas por idioma.

## Campos condicionais

Um campo pode aparecer apenas segundo a resposta a um campo pai do tipo **Sim/Não** ou **interruptor**.

1. No editor do campo filho, abra a lista **Mostrar apenas se** e escolha o campo pai.
2. Selecione o valor esperado: **= Sim / marcado** ou **= Não / desmarcado**.

Exemplo: o campo « Largura da porta do elevador » só aparece se a pergunta « Elevador / monta-cargas » estiver ativada; o campo « Número de degraus » só aparece se « Escadas » estiver ativado. Um campo ocultado pela sua condição nunca é exigido, mesmo que esteja marcado como obrigatório.

## Do lado do cliente

Na etapa de transportadora, o cliente vê um cartão que indica o estado do formulário (_A preencher_ / _Preenchido_) e um botão para o abrir. O formulário abre numa janela moderna: cartões de escolha, interruptores, pastilhas Sim/Não, validação em direto dos campos obrigatórios.

- As respostas são registadas por carrinho: um cliente que volte encontra as suas respostas pré-preenchidas.
- Em modo bloqueante, o botão de confirmação da etapa de entrega reabre automaticamente o formulário enquanto não estiver preenchido.

## Acompanhamento das respostas

As respostas do cliente são exploráveis em três locais:

- **E-mail de notificação**: na validação da encomenda, é enviado um e-mail HTML que resume todas as respostas para o endereço configurado (serviço logístico, transportadora ou preparador). Os modelos FR e EN estão incluídos.
- **Ficha de encomenda**: um painel dedicado mostra o resumo pergunta/resposta na encomenda, no back-office.
- **Base de dados**: as respostas são guardadas, associadas ao carrinho e depois à encomenda validada.

## Desinstalação

A desinstalação a partir do Gestor de módulos elimina de forma limpa as tabelas do módulo (campos, respostas) e a sua configuração.

## Perguntas frequentes

### O formulário não aparece

Verifique que o módulo está ativado, que o modo de ativação corresponde ao carrinho de teste (por exemplo, que um produto atinge o limiar de peso) e que pelo menos um campo está ativo.

### Posso traduzir os títulos?

Sim. Cada designação, texto de ajuda e opção de lista introduz-se por idioma diretamente no construtor de campos. O título e a introdução do formulário são igualmente multilingues.

### O módulo é compatível com o PrestaShop 9 e com multiloja?

Sim, o módulo visa PrestaShop 8.0 a 9.x e funciona em contexto multiloja.
