Data conventions

Money

Amounts are integers in minor units of the currency, in fields ending in Minor: amountMinor: 238000 in EUR is €2,380.00. Currencies are ISO 4217 codes (^[A-Z]{3}$). There are no floating-point amounts in the order engine contracts.

Payment and refund amounts are always positive; the kind (payment or refund) gives the direction. Allocation legs of a refund are negative.

One exception: on the quote store, external_price.amount (a supplier price on a quote line) is in major units.

Identifiers

Resource	Format	Example
Trip	Tenant prefix, a hyphen, 12 hexadecimal characters	TRP-B2BD5A9771E4
Purchase order	PO- and 12 hexadecimal characters	PO-5BEE8AAD2A57
Order line	L- and 12 hexadecimal characters	L-A610167BDD4D
Quotation	QT- and 12 hexadecimal characters	QT-E419E9088B0D
Intent	INT- and 12 hexadecimal characters, or your own value	INT-E7814BE45E5F
Quote	Tenant prefix and 8 characters without ambiguous letters	Q-7KD2M9QX
Payment, refund	pay_ and a UUID	pay_c61ba173-…
Group	grp_ and the agreement reference, or a UUID	grp_GA-2026-582C6A
Group agreement	ga_ and a UUID; reference GA- year and 6 characters	GA-2026-582C6A
Disruption, mass change	dis_, mc_ and a UUID	mc_f40b7d54-…
Change	chg_ and 20 hexadecimal characters	chg_1884420249cffc7a9544

Treat identifiers as opaque strings of up to 200 characters. Your own references (customerRef, agencyRef, externalRef, actorRef) are stored as given.

Timestamps and dates

Timestamps are ISO 8601 with an offset (2026-11-02T09:05:37.000Z); the service writes UTC. Calendar dates without a time (deposit due dates, departure dates on group agreements) are YYYY-MM-DD.

Codes from configuration

Channels, purchase moments, markets, connected systems, processes and payment scenarios are codes defined in the tenant's orchestration configuration (^[a-z][a-z0-9_-]*$). The examples in this documentation use the channels web, app, contact_centre, agency and onboard and the moments booking, pre_trip and onboard; your tenant's codes may differ. Read them with GET /order-orchestration/config.

Actors

Writes record who made them:

Surface	Field	Shape
Order orchestration	actorRef, createdBy	A reference string; createdBy adds kind (customer, agent, agency).
Order operations, groups	actor	{ id, name?, role, channel? }
Configuration	actor	{ id, name?, role?, channel } with channel api, form, change_desk, system or seed.
Quote store, repricing	—	Taken from the token.