Hulo Global home
For Vendure Vendure edition: for Vendure 3.5+ shops, installed with npm. Also available for WordPress: Quotations for WordPress
For Vendure

Quotations for Vendure

End-to-end quotation engine — build quotes from your catalogue, email a signed accept/decline link, chase automatically, convert wins to draft orders at the exact quoted total.

1,694 npm downloads last month3,792 downloads in 2026Listed in the Vendure plugin directoryVendure >=3.5 <4, verified on 3.8.2MySQL · MariaDB · PostgreSQLAGPL-3.0 + paid licence key

Install on Vendure: add the package with npm, yarn or pnpm, then register QuotationsPlugin in vendure-config.ts. All steps

npm

npm install @huloglobal/vendure-plugin-quotations

yarn

yarn add @huloglobal/vendure-plugin-quotations

pnpm

pnpm add @huloglobal/vendure-plugin-quotations

Register it in vendure-config.ts

// vendure-config.ts
import { QuotationsPlugin } from '@huloglobal/vendure-plugin-quotations';

export const config: VendureConfig = {
  plugins: [
    QuotationsPlugin.init({
      publicBaseUrl: 'https://shop.example.com',
      licenceKey: process.env.HULO_LICENCE_KEY_QUOTATIONS,
    }),
    // ... your other plugins
  ],
};

What it does

Built for production from day one.

Everything a B2B-ish shop needs to quote like a pro. Build quotes in the admin from your live catalogue (or free-text lines) with per-line and quote-level discounts, VAT and a validity date. One click emails the customer a branded quote page where they accept with a typed-name signature — or decline with a reason — and every step lands in a per-quote audit trail. Unopened quotes get one polite chaser, expiring quotes a heads-up, and overdue ones expire themselves. Accepted quotes convert to a Vendure draft order whose total equals the quote to the penny — a pricing surcharge reconciles quoted vs catalogue pricing, so custom deals never fight your price lists.

Quote requests from your storefront

A public endpoint lets customers ask for a quote from a basket, a product page, a calculator or a plain form. It lands in your inbox as a requested quote with catalogue lines pre-priced at list, the customer gets an acknowledgement with the reference, and you price the rest and send. Throttled, honeypot-protected, switchable per channel.

Quote builder with live catalogue search

Type a product name or SKU and the line lands with the current channel price pre-filled. Free-text lines for services, delivery or anything off-catalogue. Per-line quantity, unit price override, and percentage discount with live totals.

Discounts, VAT and validity done properly

Quote-level discount (percent or fixed) applied before VAT; configurable VAT rate per quote (zero-rate for exports); a validity date after which the quote expires itself. All money handled in integer pence.

Branded customer quote page

A signed, unguessable link opens a clean quote page in your colours with your logo: line items, totals, notes, terms — plus print/save-as-PDF. No customer account needed.

Accept with a signature

The customer types their full name to accept — recorded with a timestamp as their signature, alongside an optional comment. Declines capture a reason. You get an email either way.

Viewed / accepted / declined tracking

The first open flips the quote to viewed with a timestamp. Every event — created, sent, viewed, chased, accepted, declined, expired, converted — is in the per-quote activity log.

Automatic follow-ups

One chaser for unopened quotes after N days, an expires-soon reminder before the validity date, and automatic expiry after it — all on the free tier. All per-channel configurable, all logged, none sent twice. With a licence, follow-up sequences add more steps.

Convert to order at the quoted price

With a licence, accepted quotes become Vendure draft orders from the admin: catalogue lines are added as real order lines and a single "Quotation pricing" surcharge reconciles any difference — the draft total equals the quote total exactly.

Get paid on acceptance

With HULO Payments for Vendure (or your own provider), an accepted quote can be paid online: switch on Pay link on acceptance, or create a pay link on the quote, and the quote is marked paid when the order's settled payments cover the quoted total. Acceptance is bound to the version the customer saw: if the quote was edited after they opened it, the acceptance is refused and the page shows the current version.

PDF, staff preview and "My quotes"

A PDF of every quote, a staff preview of the customer page, and a "My quotes" list for signed-in customers.

Revisions & duplicates

Sent quotes are immutable once decided; duplicate any quote as a fresh draft (linked as a revision) when the deal changes shape.

Send as a member of staff

Pick which administrator each quote goes out as: their name fronts the From header, replies land in their inbox, the quote page shows "Prepared by", and acceptance/decline/opened notifications reach them directly.

Customer picker + preview + test-send

Search existing Vendure customers to autofill the quote; preview the rendered email or test-send the real thing to yourself before the customer ever sees it.

Opened notifications + extend validity

Optional "email me the moment the quote is first opened" — the perfect follow-up cue — plus one-click validity extension that can revive an expired quote.

Pipeline KPIs

Win rate and sends over 30 days, open pipeline value per currency, and average send-to-decision time — on the dashboard where you quote — plus a 12-month report.

Per-channel everything

Numbering prefix + sequence, default terms/VAT/validity, notification address and email template per sales channel — with full brand chrome on every email and quote page: logo, accent colour, website, phone, address and a company/VAT footer note.

MySQL, MariaDB & PostgreSQL

The plugin follows whatever database your Vendure dbConnectionOptions use — no configuration. Verified against PostgreSQL 17; MySQL/MariaDB installs are unchanged.

Buy & activate from the admin

The 14-day evaluation starts by itself, with no card. Subscribe or buy lifetime from the plugin's admin page — checkout opens in a new tab and the key installs itself within a minute, renewals included. The same card shows your plan, first-charge date and a Manage billing link to the Stripe portal (update card, cancel, switch plan). Already have a key? Paste it into the same banner. No .env edit, no redeploy; environment keys still take precedence for infrastructure-as-code setups.

Weekly report, set-up checklist & dashboard widget

With a licence (or during the first 14 days), every Monday the plugin emails whoever runs the store a short report of what it did that week — real numbers from your own database, week-over-week, with the next set-up step to take — and the plugin page opens with a set-up checklist that hides itself once everything is done. Change the recipient, send a test or switch the report off from the plugin's Settings tab (needs the host's SMTP_* settings). If the licence lapses, the report stops and the checklist is hidden; their settings are kept. The dashboard widget (Dashboard → Add widget) is free and shows the plugin's recent numbers.

One-click in-app updates

When a new version ships, an update banner shows current → latest with a What's-new link to the changelog. "Update now" installs the registry-verified release via your project's own package manager (yarn/npm/pnpm auto-detected) and gracefully restarts under pm2/systemd. Disable with HULO_SELF_UPDATE=off.

Install

Three steps, five minutes.

Add the package

Or run the one-line installer that does steps 1–3 for you:

curl -sSL https://huloglobal.com/vendure-plugins/quotations/install.sh | bash

Prefer to do it by hand?

npm

npm install @huloglobal/vendure-plugin-quotations

yarn

yarn add @huloglobal/vendure-plugin-quotations

pnpm

pnpm add @huloglobal/vendure-plugin-quotations

Register it

In your vendure-config.ts:

// vendure-config.ts import { QuotationsPlugin } from '@huloglobal/vendure-plugin-quotations'; export const config: VendureConfig = { plugins: [ QuotationsPlugin.init({ publicBaseUrl: 'https://shop.example.com', licenceKey: process.env.HULO_LICENCE_KEY_QUOTATIONS, }), // ... your other plugins ], };

Compile the admin UI

Add the extension to your compileUiExtensions call so the plugin's page appears in the admin:

// compile-admin-ui.ts import { compileUiExtensions } from '@vendure/ui-devkit/compiler'; import { QuotationsPlugin } from '@huloglobal/vendure-plugin-quotations'; compileUiExtensions({ outputPath: path.join(__dirname, 'admin-ui'), extensions: [QuotationsPlugin.uiExtensions], });
No migration to run. The plugin creates its tables on first boot and upgrades them in place on later versions.

That's it. Restart Vendure and the plugin's page is in the admin with every feature on for 14 days — no card, no key. To keep it all on afterwards, open the page and click Subscribe (first charge when the 14 days end) — the key installs itself, no .env edit, no redeploy.

Free tier vs licensed

Try the whole thing, keep the core for free.

Every new install has every feature on for its first 14 days, with no card and no key. After that the free tier keeps working indefinitely, and a licence keeps the licensed features on. If a licence lapses, the licensed features stop and nothing is deleted.

Free tier (after the 14 days)

  • 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

First 14 days + licensed

  • 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
Start 14-day free trial →

HTTP endpoints

Every route exposed.

POST/quotations/requestPublic: a customer asks for a quote (lands as requested)
GET/quotations/quote/:tokenPublic: the customer quote page (signed link)
POST/quotations/quote/:tokenPublic: accept (typed signature) or decline
GET/quotations/quotesAdmin: list + filter + search
POST/quotations/quotesAdmin: create a quote
PUT/quotations/quotes/:idAdmin: update a draft/open quote
POST/quotations/quotes/:id/sendAdmin: email the customer
POST/quotations/quotes/:id/convertAdmin: accepted quote → draft order (licensed)
POST/quotations/quotes/:id/duplicateAdmin: duplicate / revise
GET/quotations/statsAdmin: win rate + pipeline KPIs
GET/quotations/variants/searchAdmin: catalogue search for the editor
GET/quotations/licence/statusAdmin: licence + evaluation + update status
POST/quotations/licence/activateAdmin: activate a licence key from the admin UI
POST/quotations/update/runAdmin: one-click in-app update + graceful restart
GET/quotations/digest/settingsAdmin: weekly report recipient, last/next send
POST/quotations/digest/send-testAdmin: email this week's report to you now
GET/quotations/setupAdmin: set-up checklist (what is still to do)
GET/quotations/widgetAdmin: headline figures for the dashboard widget

FAQ

Common questions.

How do I get a licence key?

Buy one on the web with Stripe Checkout: monthly licence for Quotations, annual licence for Quotations (two months free) or lifetime licence for Quotations. You'll receive the JWT key by email. Paste it into the plugin's admin settings (Activate) — no redeploy — or set it as HULO_LICENCE_KEY_QUOTATIONS in your .env if you prefer config-as-code; the env key wins when both are present.

Does it work without a key?

Yes. Every install runs with all premium features on for its first 14 days — no card, no licence key, nothing to configure — so you can judge it on your real traffic. After that it keeps working in the free tier. To keep them, click Subscribe on the plugin's admin page: the first charge is taken when the 14 days end (or 49 hours after checkout, if that is later), you can cancel any time before then, and the licence installs itself.

Which databases are supported?

MySQL, MariaDB and PostgreSQL (verified against PostgreSQL 17). The plugin follows your Vendure dbConnectionOptions automatically — there is nothing to configure.

How do updates work?

The plugin checks the npm registry daily. When a newer version exists, the admin dashboard shows an update banner with a What's-new link to the changelog and an "Update now" button that installs the registry-verified release via your own package manager and gracefully restarts under your process supervisor. Prefer manual control? Copy the install command instead, or set HULO_SELF_UPDATE=off.

Where is data stored?

In your Vendure database: the plugin keeps its data in its own tables there, created on boot. Hulo Global never receives your customer data: the plugin sends our licence server only the licence check-ins and usage counts described under “Do the plugins call home?”.

Will it survive a Vendure upgrade?

It supports Vendure >=3.5.0 <4.0.0 (its peer dependency), and current releases are built and tested against Vendure 3.8.2 before they are published. A boot-time compatibility check emits a non-fatal warning if @vendure/core is outside that range, so upgrades to a future 3.x are safe to try. The 4.0 line will be tested and re-declared once its changelog lands.

Changelog

What's new.

Latest release: v0.10.0, 16 November 2026. Full changelog for Quotations for Vendure

Show changes

v0.10.0NewLatest

Changed

  • Every e-mail restyled to one shared design: a 600px white card on a light grey background, the store's logo (or its name) over a 3px accent bar, a clear heading, the quote's reference, validity and total in a summary box, a button, a "Kind regards" sign-off with the store's reply-to address, and a footer strip with the store's address, phone, website and footer note. Inline styles and tables only, every value escaped, and every message now has a plain-text part. It uses the existing Accent colour, Logo URL and footer settings, so nothing needs setting up. Restyled: the quote e-mail, test sends (now with a "Test send" warning box), the chaser, the expiry reminder (its heading names the date), follow-up steps, the pay-link e-mails for the whole amount, a deposit or the balance (the pay button plus a secondary "View your quotation" button, and the amount due now), and the request acknowledgement (which had no HTML part). Store notifications (new request, first view, accepted, declined) and discount-approval requests and outcomes use the same design, more compact; they were plain text. The weekly report uses the shared design from the licence SDK 0.15.7 with the store's logo and accent colour.
  • Your own e-mail templates are used as they are: the summary box and button go where the template has the quote link on a line of its own (else before its sign-off), and no second sign-off is added when the template has one.
  • Default texts: British English, "Kind regards", "e-mail"; the request acknowledgement no longer promises a reply "usually within one working day" (nothing in the plugin ensures that). Stored templates are not changed.
  • Licence SDK ^0.15.7; dev dependencies refreshed to the latest minor versions (TypeScript 5.9, Vitest 2.1, @types/nodemailer 6.4). Held back: TypeScript 7, Vitest 5 (the monorepo harness pins Vitest 2) and @types/nodemailer 8 (the types for nodemailer 8+, while the peer range starts at 6).

Fixed

  • The plain-text part of the pay-link e-mails had no link (it said "with the button below"); it now carries the pay link and the quote link.
  • The public quote page and the accept/decline form are rate limited per client address (120 page views and 20 responses a minute; 429 after that), as the PDF download already was.
  • Store notification subjects are kept to one line whatever the requester typed.
v0.9.0New

Parity with HULO Quotations for WordPress (free 0.1.4 and Pro).

Changed (tiers)

  • Free now: sending a quote, test sends, the unopened-quote chaser and the expiry reminder (they ran premium-only before). Auto-expiry was already free and is now listed as such.
  • Premium now: the weekly e-mail report and the set-up checklist. Without a licence or the evaluation the report is not sent (the weekly clock is left as it was, so it resumes on the next Monday once a licence is active), Send me a test and Preview answer 402, and the checklist reports nothing to do. Settings and data are kept.
  • Still premium: converting an accepted quote to a draft order from the admin, plus the new templates, follow-up sequences, discount approval, webhooks, sales reports and deposits below.
  • PREMIUM_FEATURES lists what is actually gated (storefront requests were listed but never gated).

Fixed

  • B5: KPIs and the weekly report no longer add amounts in different currencies together. GET /quotations/stats reports valueByCurrency per status, pipelineByCurrency and last30.valueWonByCurrency (minor units per currency; value and last30.valueWonPence are gone). The weekly report, the admin banner and the dashboard widget show value won per currency ("£1,234.56 + €500.00"). The anonymous heartbeat figure valueWonPence counts the store's main currency only.
  • Expiry is recorded per quote (trail entry "Validity ended" and an event) instead of one silent bulk update.
  • Chasers and expiry reminders are claimed before they are sent and released when the e-mail fails, so an overlapping or late run never sends one twice; the chaser only goes to quotes never opened.

Added (free)

  • EventBus events: QuotationEvent (exported) for created, requested, updated, sent, viewed, accepted, declined, expired, cancelled, converted, paid, payment, approval, follow-up and deleted, with a quote summary (no token, no internal notes).
  • Mark as sent (POST /quotations/quotes/:id/mark-sent): the store shared the quote itself; a draft or request opens for the customer without an e-mail.
  • Validity counted from the send: a quote keeps its validity period (validityDays) and its date starts when it is first sent (or marked as sent). A resend keeps the date; a quote whose date has passed must be extended first.
  • Staff preview of the customer page (GET /quotations/quotes/:id/page): not counted as an opening, the accept form is switched off.
  • Server-side PDF (built in, no dependency): GET /quotations/quote/:token/pdf from the customer link (rate-limited, not an opening, never cached), GET /quotations/quotes/:id/pdf for staff, a Download PDF button on the customer page and an optional attachment on the quote e-mail (Settings → Attach the quote as a PDF).
  • "My quotes" for signed-in customers: GET /quotations/my (shop session, channel from vendure-token) lists the customer's own quotes (by account, never by e-mail; drafts hidden; requests as "awaiting price") with quote, PDF and pay links. A request posted while signed in is linked to the account; guest requests are no longer linked to an account by e-mail address.
  • 12-month report (GET /quotations/reports/monthly, Reports tab): created, sent, accepted, win rate and value won per currency per month.
  • Per-e-mail request throttle kept in the database (10 an hour per address, across processes and restarts), on top of the per-client limit.
  • HULO Payments pay link on acceptance: with Pay link on acceptance on (Settings, per channel) the accepted quote becomes a draft order at the quoted total, moves to ArrangingPayment (a free shipping method is picked when the channel has one) and the customer is e-mailed a pay link; staff can also create and e-mail it from the quote. HULO Payments for Vendure is detected at runtime (no dependency); a host can pass its own payLinks provider to init(). The quote is marked paid when the order's settled payments cover the total. The converted draft order now carries the quote's customer.

Added (premium)

  • Quote templates: save a quote's lines, discounts, VAT, notes, terms, validity and currency (never the customer or internal notes) and start new drafts from them (Templates tab).
  • Follow-up sequences: up to three extra e-mails N days after sending while the quote is open and unpaid; each step claimed once, in order, at most one a day per quote, never within a day of the chaser or reminder.
  • Discount approval: limits on discount % off list, discount amount and total (per currency). A quote over a limit cannot be sent or marked as sent until an approver approves exactly that version (a hash of lines, discounts, VAT, currency and totals); an edit invalidates the approval. Test sends are never held; without premium the gate is off. Approvers: listed admin e-mails, else any SuperAdmin; the preparer cannot approve their own quote unless they are the only approver and that is allowed.
  • Webhooks (up to five): JSON signed with X-Hulo-Signature: sha256=HMAC(secret, "<timestamp>.<body>"), Slack and Microsoft Teams presets; public http(s) addresses on standard ports only, checked on save and on every delivery with the connection pinned to the checked address; no redirects; retries with back-off (six attempts); 30-day delivery log with retry and test.
  • Sales reports by member of staff and by source, per currency, with a formula-safe CSV export.
  • Deposits: a percentage (optionally only above a per-currency threshold, or per quote) taken first, then the balance, as two pay links on the same order. Deposit + balance = the quoted total exactly in minor units (zero-decimal currencies in whole units); every link is claimed before it is created; the quote is paid only when the balance settles. A deposit already taken is completed whatever the licence state.

Compatibility

  • New tables quotation_template, quotation_followup, quotation_approval, quotation_webhook_log, quotation_deposit and new nullable / defaulted columns, created on start-up on MySQL, MariaDB and PostgreSQL. Tested with Vendure 3.8.2; @vendure/core >=3.5.0 <4.0.0.
  • Pay links need HULO Payments for Vendure exposing createPayLink(ctx, { orderCode, amount?, currency, description, customerEmail?, returnUrl?, expiresInHours?, reference?, metadata? }) → { url, ref } on an exported service (PayLinkService or PaymentsService), or a payLinks provider in init().
v0.8.6NewSecurity

Fixed

  • A converted quote keeps its quoted price through checkout on Vendure 3.8+. Vendure 3.8 recalculates every order, draft orders included, when it moves to ArrangingPayment. A draft order converted from a quote then picked up catalogue price or promotion changes made after the conversion: in the e2e test a price rise from 100.00 to 125.00 moved the accepted 168.00 quote to 198.00 at checkout. The plugin now adds an order process that re-balances the quote surcharge right after that recalculation, in the same transaction, so the order total (before shipping) and its VAT split match the quote again; the quote's history records a repriced event. Orders whose lines an admin has changed since the conversion follow the catalogue as before. Shipping is not part of a quote and is not touched. No change on Vendure 3.5 to 3.7, where the transition does not recalculate.
  • Security Admin REST routes refuse a Shop-API session on Vendure 3.8+. Vendure 3.8 binds every session to the API it was created on and refuses Shop-API sessions on the Admin API (GHSA-5fpx-9m35-w745), but it does not check REST routes added by plugins: an administrator's storefront session still carried their admin permissions into the Quotations admin REST routes. Those routes now also require a session created on the Admin API (isAdminApiSession from the licence SDK 0.15.6, the same rule as Vendure's own AuthGuard). The admin UI is unaffected; administrators logged in before the 3.8 upgrade log in again once, as Vendure already requires. No change on Vendure 3.5 to 3.7.

Compatibility

  • Tested with Vendure 3.8.2 (NestJS 12, @nestjs/graphql 14, Apollo Server 5), as well as 3.5 to 3.7. The peer range stays @vendure/core >=3.5.0 <4.0.0; nothing here needs 3.8.
  • Requires @huloglobal/vendure-licence-sdk ^0.15.6.
v0.8.5New

Package metadata

  • The license field is now AGPL-3.0-only, matching LICENSE, which grants the GNU Affero General Public License version 3 (it said SEE LICENSE IN LICENSE). Published npm builds remain under the separate commercial licence described in LICENSE. No code changes.
v0.8.4NewSecurity

Fixed

  • PostgreSQL: quotes can be created, accepted and converted. With licence SDK 0.15.3 or older, every conditional UPDATE on Postgres reported 2 affected rows, so the plugin's "exactly one row changed" checks always failed. Creating a quote stopped with "Could not allocate a quote number", and the same check broke logging a customer's first view, recording an acceptance and converting a quote to a draft order. The plugin now requires licence SDK ^0.15.4, which reports the real count. Verified against PostgreSQL 17. The first weekly report is no longer skipped either (it used to start a week late). MySQL and MariaDB were not affected.
  • Security The customer quote page (GET and POST /quotations/quote/:token, whose address carries the quote's secret token) and the admin previews (GET /quotations/quotes/:id/preview, GET /quotations/digest/preview) now send Cache-Control: private, no-store, on their refusals and not-found pages too, so no browser, proxy or CDN keeps a copy. The other HULO plugins already send it on their report previews.

Package metadata

  • The npm package no longer includes the plugin's compiled unit tests.
v0.8.3New

Documentation

  • The README now shows the plugin logo, hosted on huloglobal.com so it displays on npm and GitHub alike, linking to the product page. No code changes.
v0.8.2NewSecurity
  • Security Request acknowledgements no longer relay requester-written text. POST /quotations/request is public, so anyone could make the store e-mail any address with their own wording (the typed name and free-text line descriptions went into {{customerName}} and {{summary}}). The acknowledgement now greets with "there", lists only catalogue lines by their catalogue name plus a count of items still to price, and goes at most once per address per day (checked in memory and against the event log, so restarts and other processes count) with a cap of 30 per hour per process. Catalogue-matched request lines are always described by the catalogue name. The merchant notification is unchanged.
  • Security Acceptance is bound to the version the customer saw. The quote page's form carries a fingerprint of the lines, money, VAT, notes and terms (v); an acceptance whose fingerprint no longer matches (the quote was edited after it was opened) is refused with "This quotation has changed since you opened it" and the page shows the current version. The conditional update also re-checks the total. An accept POST without v is refused, so a page opened before the upgrade needs a reload; declines need no fingerprint.
  • Security Conversion requires CreateOrder on the quote's channel. Converting now also checks the admin's CreateOrder permission on the channel the order is created in (previously UpdateSettings on the open channel was enough).

Fixed

  • Converting an accepted quote created the draft order in whichever channel the admin had open, at that channel's prices and currency. The order is now created in the quote's channel and currency; a quote whose currency the channel does not sell is refused (and stays accepted) instead of being converted at the same number in another currency.
  • The converted order matched the quoted gross total but booked the whole pricing difference as tax-free, so its net and VAT differed from the quote (an all-free-text quote showed no VAT at all). The reconciling surcharge now carries the VAT difference, so the order's net total, VAT and gross total all equal the quote's.
v0.8.1New

Changed

  • Every install now gets a 14-day evaluation with all features on and no card (granted by the HULO licence server). The licence banner's buttons read Subscribe: during the evaluation the first charge falls on the day it ends, so there is no second free trial.
v0.8.0

Added

  • Weekly report: every Monday at 08:00 server time the plugin emails quotes created, sent and accepted, value won, storefront requests and win rate for the week against the week before, with up to three next steps. Settings → Weekly report: on/off, recipient (defaults to the channel notify or reply-to address, then the licence email, then the trial-reminder address), Send me a test, Preview. Uses the plugin's SMTP settings; worker-only, once per install across workers. Endpoints GET|POST /quotations/digest/settings, POST /quotations/digest/send-test, GET /quotations/digest/preview.
  • Set-up checklist at the top of the Quotes tab with real checks (SMTP reachable, reply-to/notify address, business name or logo, storefront requests arriving or dismissed, first quote sent); GET /quotations/setup, POST /quotations/setup/dismiss.
  • Dashboard widget (Dashboard → Add widget → Quotations): quotes sent, accepted and value won for the last 7 days, the licence notice when one applies, and a link to the page; GET /quotations/widget.
  • Help drawer in the page header: New quote → Send → Convert.
  • Value won · 30d KPI next to the win rate (quotes accepted in the last 30 days).
  • Licence banners show the lifecycle notice (trial ending, key expiring, evaluation ended) in an amber strip, the premium feature list on trial and free installs, and the 30-day figures ("So far: …"). meta / licence/status gain notice, premiumFeatures, recentStats and buyUrl.

Changed

  • Usage stats sent with the evaluation reminders and the daily heartbeat now cover the last 30 days under the keys quotesCreated, quotesSent, quotesAccepted, valueWonPence, requestsReceived, winRatePct (counts and totals only). Licensed installs keep reporting via the heartbeat.
  • 402 responses carry the buy URL https://elite.charity/licence/buy/vendure-plugin-quotations; the admin UI renders any licence-required error as one sentence pointing at the banner.
  • The address given for the evaluation reminder is remembered (plugin pref eval.leadEmail) as the report's last-resort recipient.
  • Requires @huloglobal/vendure-licence-sdk ^0.15.0. New shared table hulo_plugin_prefs (created on boot; shared by all HULO plugins).
v0.7.3

Fixed

  • The hourly cron had no deadline: one stalled pass (seen on ELITE: stuck from noon, every later hour logged "previous run still in progress") blocked expiry and chasers until a restart. A pass now has a 15-minute deadline; on timeout it is logged with the step it was in and the single-flight guard is released. Chaser sends are conditional updates, so a late completion cannot double-send.
v0.7.2

Changed

  • The quote builder's catalogue search reads Vendure's search index (search_index_item) when the channel has been indexed: translated names, SKU and channel price live in one table, so no translation joins. It searches in the admin's language, falls back to English index rows, and to the live product-variant tables when the index is empty or absent (Elasticsearch hosts, before the first reindex). Results and their shape are unchanged; the decision is re-checked every minute.

Fixed

  • PostgreSQL: every camelCase column the plugin reads from Vendure's own tables (customers, administrators, addresses, variants, translations, prices) is now quoted, so catalogue search, request pricing, the customer and staff pickers and customer linking work on Postgres, where unquoted identifiers fold to lowercase. The config-row upsert no longer fails with an ambiguous column reference.
  • A PostgreSQL corpus test (tests/pg-corpus.test.ts, runs when HULO_PG_URL is set) extracts every SQL statement in src/, translates it with the SDK's dialect adapter and prepares it against a scratch database with quoted stand-ins for the Vendure tables, so a quoting or dialect regression fails the unit suite.
v0.7.1

Fixed

  • Editing a sent quote no longer silently pushes its expiry to 30 days from now; validity only changes when the editor sets it.
  • Two concurrent creates can no longer receive the same reference: numbers are claimed with a compare-and-set and (channelId, reference) is unique.
  • Viewing, accepting/declining and converting are now single-shot: parallel first views produce one "opened" event and one notification, a double-submitted accept cannot notify twice, and a double "Convert" cannot create two draft orders (the quote is claimed before the draft is created and released if it fails).
  • A revision now supersedes the original (which is cancelled) instead of leaving both acceptable.
  • Catalogue search and request pricing work on Postgres (enabled IS TRUE instead of = 1) and in non-English shops (the admin's language, falling back to English).
  • requested quotes are no longer served on the public quote URL before they are priced.

Changed

  • One pooled SMTP transport with 10 s connect / 30 s send deadlines instead of a new connection per email with nodemailer's 2 min / 10 min defaults. Merchant notifications and request acknowledgements are sent off the request path, so a slow mail server never stalls the customer's page or the hourly cron.
  • The public request throttle keys on the real client address (no longer trusts a spoofable header), adds a per-email bucket, and evicts idle entries instead of wiping everyone's counters.
  • Quote lines are written in one statement; long text fields are capped; config reads no longer swallow database errors and fall back to defaults.
  • Chaser and expiry-reminder sweeps read each quote once; a skipped hourly tick is logged; the licence-server lead call has a timeout.
  • Line and VAT rounding use integer arithmetic; emails and the quote page format the validity date the same way; expiry is judged by the database clock everywhere.
  • Admin editor: search results that arrive out of order are ignored; timers are cleared on destroy.
v0.7.0

Added

  • Quote requests from your storefront. A public, unauthenticated POST /quotations/request lets any site — a basket, a product page, a calculator or a plain form — ask for a quote. Each request lands in the admin as a requested quote with catalogue lines (by variant id or SKU) pre-priced at the channel's list price, free-text lines left for you to price, the customer's message and where it came from. The channel's notify address gets the details, and the customer receives an acknowledgement carrying the quote reference (editable template in Settings). Existing customers are linked by email.
  • Requests inbox. A new Requests tile on the Quotes page shows how many are waiting for a price (click it to filter); the detail panel shows the customer's message; requested quotes are editable, deletable and sent with the same Send to customer button, which moves them to sent.
  • Per-channel switch. Accept quote requests in Settings (on by default) turns the endpoint off for a channel.

Notes

  • Requests are throttled per client address (10 an hour), a hidden website field acts as a honeypot, and the endpoint never needs a licence — sending the finished quote does, as before.
  • Schema: quotation.requestMessage / requestSource / requestedAt, quotation_config.acceptRequests / requestAckBody (added automatically on boot).
v0.6.1

Changed

  • Branding. The bundled hulo-global-logo.svg is now the HG wordmark on the HULO black rounded square (the same mark as the huloglobal.com header), with explicit -light and -dark variants alongside the auto-switching default.
v0.6.0

Added

  • Licence & billing card in the admin. Always visible: the current state (free tier, free trial with first-charge date, monthly/annual subscription, lifetime, or master licence) with the actions that apply — start the 14-day free trial or subscribe, buy lifetime, Manage billing (Stripe customer portal: update card, cancel, switch plan) and Upgrade to lifetime (the old subscription stops billing at the end of its paid period). Requires licence SDK ^0.14.0.
v0.5.1

Changed

  • The 14-day free trial is now card-backed. Unlicensed installs run in the free tier; start the trial from the admin banner (monthly or annual → Start 14-day free trial) — Stripe collects a card, nothing is charged until day 15, cancel any time before then, one trial per customer — and the licence installs itself within a minute. The automatic no-card evaluation window is retired (licence SDK ^0.13.0).
v0.5.0

Added

  • Buy licence from the admin. The evaluation / free-tier banner now has a plan picker and a Buy licence button: checkout opens in a new tab and, once payment completes, the licence installs itself — no email round-trip, no .env edit, no restart. Renewed subscription keys are picked up automatically too. New admin endpoints licence/purchase-link and licence/claim-status.

Changed

  • Requires @huloglobal/vendure-licence-sdk ^0.12.0.
  • The 7-day card trial at checkout has been retired: every install already gets the 14-day no-card evaluation, and paid plans now bill from day one.
v0.4.0

Added

  • Channel-branded emails, properly. New per-channel branding fields — website, phone, business address and a footer note (company/VAT number) — rendered as a professional footer on both the quote email and the customer quote page, alongside the existing logo, accent colour and business name. Every channel sends fully in its own brand.
  • Dropdowns everywhere sensible. VAT rate (UK standard/reduced/ zero + custom), validity (7/14/30/60/90 days + custom) and currency are now dropdowns in the editor; settings gained preset dropdowns for default VAT/validity, chaser and expiry-reminder cadence, a currency select, accent-colour swatches, and an "Insert variable…" picker for the email template.
v0.3.0

Changed

  • Step-by-step quote wizard. The editor is now four guided steps — Customer → Items → Pricing → Review & send — with a progress bar, per-step validation hints ("a name and a valid email unlock the next step"), clickable completed steps, and a final review that mirrors what the customer will see with one big "Send quote" button. Sensible channel defaults mean most quotes never need the Pricing step touched.
  • The admin nav entry now lives only under Sales.
v0.2.0

Added

  • Send as a member of staff. Pick any administrator in the editor (defaults to you): their name fronts the email's From header, replies go straight to their inbox, the customer page shows "Prepared by", the {{staffName}} variable signs the email body, and accept/decline/ opened notifications reach them directly.
  • Customer picker. Search existing Vendure customers in the editor — name, email, company and phone autofill (and the quote links to the customer record).
  • Preview & test-send. Open the rendered customer email in a tab, or send the real thing to yourself (subject-tagged [TEST]) before it goes to the customer.
  • Extend validity. Push the expiry date out on open quotes — and revive expired ones — in one click, with the audit trail updated.
  • Opened notifications. Optional per-channel "email me when the quote is first opened" — the best moment to pick up the phone.
  • Internal notes. Comment on the activity trail; never shown to the customer.
  • Admin navigation. The plugin now registers a "Quotations" entry in the admin nav (Sales section) — no more typing the URL.
  • Plugin logo.
v0.1.0

Added

  • Initial release. Quote builder (catalogue search with live prices, free-text lines, per-line + quote-level discounts, VAT, validity, notes/terms), per-channel branding + numbering, branded customer email with signed accept/decline link, typed-name signature capture, viewed/accepted/declined tracking with a full per-quote audit trail, auto-expiry, unopened-quote chaser + expires-soon reminder, conversion of accepted quotes to draft orders at the exact quoted total, KPI dashboard (win rate, open pipeline, response time), MySQL/MariaDB + PostgreSQL support, in-admin licence activation and one-click in-app updates. 14-day full-featured evaluation; free tier is draft + preview.

Ready to ship?

Install in five minutes, run the trial on real traffic, keep it if it earns its place.