# Pedido de Orçamento B2B (Orçamento Express): guia completo
> Apresentação O módulo Orçamento Express Multiproduto B2B (dfexpressquote) acrescenta um botão «Pedir um orçamento» no rodapé da página do carrinho. Num clique, o seu cliente profissional transforma o seu carrinho…
- Página:
- Idioma: pt
- Atualizado em: 2026-09-02
- Outros idiomas: [fr](https://www.datafirefly.com/documentation/dfexpressquote/index.md), [en](https://www.datafirefly.com/en/documentation/dfexpressquote/index.md), [es](https://www.datafirefly.com/es/documentation/dfexpressquote/index.md), [de](https://www.datafirefly.com/de/documentation/dfexpressquote/index.md), [it](https://www.datafirefly.com/it/documentation/dfexpressquote/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfexpressquote/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfexpressquote/index.md)
- Índice:
## Apresentação
O módulo **Orçamento Express Multiproduto B2B** (`dfexpressquote`) acrescenta um botão **«Pedir um orçamento»** no rodapé da página do carrinho. Num clique, o seu cliente profissional transforma o seu carrinho num **orçamento PDF** limpo, recebido por e-mail, sem ter de criar conta. É enviada uma cópia à sua loja e cada orçamento é acompanhado no back-office com os seus estados.
O PDF é gerado com o TCPDF, já incluído no PrestaShop: nenhuma biblioteca externa nem dependência Composer. O documento nunca é guardado no servidor, é regenerado a pedido a partir de um instantâneo do carrinho registado na base de dados.
**Adaptação para Portugal:** o módulo é entregue em 5 idiomas (FR, EN, ES, DE, IT) e os modelos de e-mail apenas em francês e inglês; traduza as cadeias em **Internacional → Traduções** e crie a pasta `mails/pt/`. O orçamento PDF é um documento comercial sem valor fiscal: não substitui a fatura ou fatura-recibo emitida por software certificado pela AT. No campo «Menções legais de IVA», indique por exemplo a taxa aplicável e a menção «IVA à taxa legal em vigor» ou a isenção invocada.
## Compatibilidade
- PrestaShop 8.0 a 9.x
- PHP 7.4 a 8.3
- Loja única e multiloja
- 5 idiomas: FR, EN, ES, DE, IT
- Tema Classic e temas personalizados (modal em JavaScript nativo, independente do tema)
- Nenhuma dependência (nem Composer nem framework)
## Instalação
1. No back-office, abra **Módulos > Gestor de módulos**.
2. Clique em **Instalar um módulo** e selecione o ficheiro `dfexpressquote.zip`.
3. Uma vez instalado, clique em **Configurar**.
Na instalação, o módulo cria a sua tabela de orçamentos, regista os seus hooks (`actionFrontControllerSetMedia`, `displayShoppingCartFooter`, `displayExpressCheckout`), adiciona um separador **Orçamento Express** no menu Encomendas e inicializa as suas definições por defeito.
## Configuração
### Apresentação e botão
- **Etiqueta do botão**: texto apresentado no rodapé do carrinho, personalizável.
- **Pedir os dados de contacto**: ativa o modo formulário de contacto. Desativado, o módulo passa ao modo 1 clique instantâneo (o orçamento PDF é gerado sem nenhum formulário).
### Orçamento
- **Prefixo de referência**: prefixo dos números de orçamento (por defeito `DEV`), seguido da data e de um contador.
- **Duração de validade**: número de dias de validade do orçamento, usado para calcular a data de vencimento.
- **Mostrar o IVA**: mostra as colunas e os totais de IVA no PDF.
- **Mostrar a morada**: acrescenta o bloco de morada do destinatário no PDF.
- **Menções legais de IVA** e **Condições**: textos livres acrescentados no rodapé do orçamento.
### E-mails
- **E-mail ao cliente**: envia automaticamente o orçamento PDF em anexo ao cliente.
- **E-mail à loja**: envia uma notificação à sua equipa.
- **Endereço de e-mail de notificação**: destinatário interno (por defeito o e-mail da loja).
## Funcionamento
### Dois modos de pedido
Em **modo formulário**, um clique abre uma modal leve onde o cliente preenche a sua empresa, o seu nome, o seu e-mail e, opcionalmente, o seu telefone, o seu número de IVA intracomunitário e uma mensagem. Em **modo 1 clique instantâneo**, o orçamento PDF é produzido imediatamente, sem formulário. Nos dois casos não é exigida nenhuma criação de conta.
### O orçamento PDF
O PDF retoma a identidade da sua loja: logótipo, contactos, referência única, data de emissão e data de validade, bloco do destinatário, tabela dos produtos (referência, designação, quantidade, preço unitário sem IVA, IVA, total sem IVA) e totais sem IVA, IVA e com IVA, seguidos das suas menções e condições. Nunca é guardado em disco: é regenerado a pedido a partir do instantâneo do carrinho registado na base de dados, o que evita a acumulação de ficheiros e garante um documento sempre coerente.
### E-mails automáticos
Consoante a sua configuração, o cliente recebe o seu orçamento em anexo e a sua loja é notificada no endereço à sua escolha. Os modelos de e-mail são fornecidos em francês e em inglês.
### Acompanhamento no back-office
O separador **Orçamento Express** lista todos os orçamentos com a sua referência, o destinatário, o montante com IVA, o estado e a data. Abre um orçamento para ver o seu detalhe, faz evoluir o seu estado (novo, enviado, aceite, recusado, convertido) e regenera ou transfere o PDF a qualquer momento.
### Segurança
A transferência do PDF é protegida por um token determinista derivado da chave da sua loja. Cada pedido é protegido por um honeypot anti-robô e um token ligado ao carrinho em curso, e só atua sobre o carrinho da sessão atual.
## FAQ e resolução de problemas
### O cliente tem de criar uma conta?
Não. O pedido de orçamento funciona em modo convidado. O modo 1 clique instantâneo gera mesmo o PDF sem nenhum formulário.
### É preciso instalar uma biblioteca PDF?
Não. O orçamento é gerado com o TCPDF, já incluído no PrestaShop 8 e 9. Nenhuma dependência Composer.
### O botão não aparece na página do carrinho
Esvazie a cache do PrestaShop (Parâmetros avançados > Desempenho) e, durante os seus testes, desative a combinação/compressão (CCC). O botão só aparece quando o carrinho contém pelo menos um artigo. Se o seu tema não acionar o hook `displayShoppingCartFooter`, o botão é inserido através do carregamento dos recursos no front-office.
### Os ficheiros PDF acumulam-se no servidor?
Não. O orçamento não é guardado em disco: é regenerado a pedido a partir do instantâneo do carrinho na base de dados.
### É compatível com PrestaShop 9?
Sim. O módulo é compatível com PrestaShop 8 e 9, em multiloja e multilingue.