Entities

Quote

B2B sales offer with negotiated prices, lifecycle, comments, and validity

A Quote is a B2B sales offer prepared for a buyer. It has negotiated totals, a validity window, comments, an activity history, and a workflow that can result in an order.

Available since v0.26.0 in @laioutr-core/canonical-types

Components

QuoteBase

base

Quote identity, human-readable number, name, and custom fields.

Schema

name

string

Human-readable subject/title of the quote, e.g. "Q3 framework agreement".

number

string

Human/ERP quote number distinct from the internal id, e.g. "QUO-2026-0042".

customFields

Record<string, unknown>

Custom fields are a way for implementations to pass arbitrary data to actions, queries, etc.

QuoteStatus

status

Open-vocabulary quote lifecycle state with display and reason fallbacks.

Schema

status

stringrequired

statusLabel

string

Connector-resolved display label for status — the fallback shown when the status key is not mapped to a localized label (e.g. a B2B Sellers offer-state name).

statusComment

string

Free-text note attached to the current status — distinct from the buyer/seller notes in QuoteComments (Emporix status.comment).

statusReason

{ code, type, label }

Structured reason for the current status, selected from a source-system reason catalog (Emporix status.quoteReason). code is the locale-independent identity (merchant-configurable ⇒ open string) for grouping/analytics; label is the localized display fallback.

Cost

QuoteCost

cost

Firm subtotal, total, shipping, tax, and applied fee amounts.

Schema

subtotal

Money { amount, currency }required

total

Money { amount, currency }required

shipping

Money { amount, currency }

tax

{ total, isIncluded }

Tax summary.

taxes

{ rate, amount, name }[]

Breakdown of tax rates applied across the quote.

fees

{ code, kind, name, 4 more }[]

Whole-quote fees (e.g. handling), as computed charges.

Validity

QuoteValidity

validity

The period during which the offered prices apply.

Schema

validity

Timespanrequired

A timespan between two dates.

Comments

QuoteComments

comments

Buyer and seller notes attached to the quote.

Schema

customerComment

string

Note from the customer/buyer (B2B Sellers customerComment).

sellerComment

string

Note from the seller/sales rep (commercetools sellerComment).

Activity

QuoteActivity

activity

A timeline of quote changes and participants.

Schema

entries

{ action, actionLabel, actorName, 3 more }[]required

Actions

Use the B2B quote actions to request, accept, decline, revise, cancel, or check out a quote.

Edit this pageorReport an issue

Budget

B2B spending allowance with lifecycle, usage, reset period, and validity

Quote Item

A negotiated product or custom line in a B2B quote