Pedido de Orçamento B2B (Orçamento Express): guia completo
Instalar, configurar e explorar o pedido de orçamento B2B (carrinho convertido em orçamento PDF num clique, sem criação de conta) para PrestaShop 8 e 9.
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
- No back-office, abra Módulos > Gestor de módulos.
- Clique em Instalar um módulo e selecione o ficheiro
dfexpressquote.zip. - 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.