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: user manual

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

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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

MethodPathPurpose
GET/quotations/quote/:tokenPublic customer quote page (signed link; marks viewed)
POST/quotations/quote/:tokenPublic accept (typed signature) / decline
GET/POST/quotations/quotesAdmin: list / create
PUT/DELETE/quotations/quotes/:idAdmin: update draft/open · delete draft
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
POST/quotations/quotes/:id/cancelAdmin: withdraw an open quote
GET/quotations/statsAdmin: win rate, open pipeline per currency, response time
GET/quotations/variants/searchAdmin: 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.