Overview
Quotations is an end-to-end quotation engine for Vendure. The full lifecycle lives in your admin: build a quote from the live catalogue (or free-text lines), email the customer a branded page with a signed link, watch it move through sent → viewed → accepted / declined, chase automatically, and convert wins to draft orders at the exact quoted total.
- Statuses: draft → sent → viewed → accepted / declined / expired / cancelled → converted.
- Money: integer minor units throughout; per-line % discount, quote-level % or fixed discount (applied before VAT), configurable VAT rate per quote.
- Audit: every step (including chasers and customer opens) is an event on the quote.
Install & configure
Install and register the plugin:
yarn add @huloglobal/vendure-plugin-quotations import { QuotationsPlugin } from '@huloglobal/vendure-plugin-quotations';
plugins: [
QuotationsPlugin.init({
publicBaseUrl: 'https://shop.example.com', // used for customer quote links
licenceKey: process.env.HULO_LICENCE_KEY_QUOTATIONS, // optional — or activate in the admin
}),
]Add QuotationsPlugin.uiExtensions to your admin-ui compileUiExtensions extensions list and rebuild the admin. Tables are created automatically on boot (MySQL, MariaDB and PostgreSQL).
Emails send via SMTP from SMTP_SERVER / SMTP_PORT / SMTP_USER / SMTP_PASSWORD / SMTP_FROM, or pass smtp in init().
In the admin Quotations → Settings, set your business name, logo URL, accent colour, notification address, numbering prefix, default validity/VAT/terms, and the chaser/expiry-reminder cadence — per channel.
The quoting workflow
- Build: New quote → search existing customers to autofill their details, then search the catalogue by name/SKU (price pre-fills) or add custom lines. Set quantities, unit-price overrides and per-line discounts; add a quote-level discount, VAT rate, validity and notes/terms. Totals preview live.
- Send: "Save & send" emails the customer a branded message with the signed quote link — sent as the member of staff you pick in the editor (their name fronts the From header, replies go to them, and the quote page shows "Prepared by"). Preview the rendered email or test-send it to yourself first. Re-send any time; the link is stable.
- Track: the first open flips the quote to viewed (optionally emailing you at that moment — the best follow-up cue). Add internal notes to the activity trail; extend validity (reviving expired quotes) in one click. The customer accepts by typing their full name (recorded as a signature with a timestamp) or declines with a reason — you're notified by email either way.
- Chase: the hourly worker sends one reminder for unopened quotes after N days, an expires-soon nudge before the validity date, and expires overdue quotes automatically — all free. With a licence, follow-up sequences add more steps.
- Get paid: with HULO Payments for Vendure (or your own provider passed as
payLinks), switch on Pay link on acceptance or use Create pay link on the quote; the quote is marked paid when the order's settled payments cover the quoted total. Acceptance is bound to the version the customer saw: a quote edited after they opened it cannot be accepted until they reload it. - Convert (licensed): on an accepted quote, "Convert to order" creates a Vendure draft order: catalogue lines become real order lines and one "Quotation pricing" surcharge reconciles any difference, so the draft total equals the quote exactly. Complete the draft in Orders as usual.
Sent quotes that have been decided are immutable — use Duplicate to spin a linked revision when the deal changes.
Quote requests from your storefront
Customers can ask for a quote from a basket, a product page, a calculator or a plain form: post JSON to POST /quotations/request with the channel's vendure-token header (name, email, company, phone, message, source and optional lines by variant id or SKU). The request lands under Sales → Quotations as requested with catalogue lines pre-priced at list, the notify address hears about it, and the customer receives an acknowledgement carrying the reference. Price any free-text lines, then Send to customer. Turn requests off per channel in Settings; the endpoint is throttled and honeypot-protected. Requests are free. A request posted with the customer's shop session is linked to their account and shows under "My quotes"; guest requests are never linked by e-mail address.
Free and licensed
Every new installation has every feature on for its first 14 days, with no card and no licence key. After that the plugin keeps running in its free tier for as long as you like; a licence keeps the licensed features on. If a licence lapses, the licensed features stop and nothing is deleted: settings and data are kept, and a key switches them back on.
Free tier
- Quote builder with live catalogue prices and any currency
- Send, test send, mark as sent, the chaser and the expiry reminder
- Staff preview of the customer page, validity counted from sending, and a PDF of every quote
- Acceptance tied to the version the customer saw, and auto-expiry
- A HULO Payments pay link on acceptance
- Quote requests from your storefront, and "My quotes" for signed-in customers
- A 12-month report, KPIs per currency and EventBus events
Licensed (and the first 14 days)
- Converting an accepted quote to a draft order from the admin
- Templates and follow-up sequences
- Discount approval
- Webhooks, Slack and Microsoft Teams included
- Sales reports with CSV
- Deposits and the balance
- The weekly report and set-up checklist
Buy a monthly, annual (two months free) or lifetime licence from the plugin page, or click Subscribe (or Buy lifetime) on the licence banner of the plugin's admin page: checkout opens in a new tab and the key installs itself within a minute, renewals included. Already have a key? Paste it into the same banner (Activate), no redeploy, or set HULO_LICENCE_KEY_QUOTATIONS; the environment key wins when both are present.
HTTP endpoints
| Method | Path | Purpose |
|---|---|---|
| GET | /quotations/quote/:token | Public customer quote page (signed link; marks viewed) |
| POST | /quotations/quote/:token | Public accept (typed signature) / decline |
| GET/POST | /quotations/quotes | Admin: list / create |
| PUT/DELETE | /quotations/quotes/:id | Admin: update draft/open · delete draft |
| POST | /quotations/quotes/:id/send | Admin: email the customer |
| POST | /quotations/quotes/:id/convert | Admin: accepted quote → draft order (licensed) |
| POST | /quotations/quotes/:id/duplicate | Admin: duplicate / revise |
| POST | /quotations/quotes/:id/cancel | Admin: withdraw an open quote |
| GET | /quotations/stats | Admin: win rate, open pipeline per currency, response time |
| GET | /quotations/variants/search | Admin: catalogue search for the editor |
Troubleshooting
- Emails not sending: check the SMTP env vars; the send response surfaces the SMTP error verbatim in the admin notification.
- Customer link 404s: draft quotes have no public page — send the quote first. Withdrawn (cancelled) quotes deliberately stop resolving.
- Convert fails on a line: the referenced variant must still be enabled and in the channel; the error names the offending line. Free-text-only quotes convert as a single surcharge.
- Chasers not going out: they run on the worker process, hourly, and each quote gets at most one chaser.