> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kordless.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Quote receipt and derivation
> Why a Quote result can be replayed exactly, what pins it carries, and how the derivation is recorded.
Every quote carries a complete replay record — the exact book version, structured inputs, line-item derivation, conditions, and review trail that produced the offer. This record exists so the business can explain, years later, exactly what it offered and why. The same request always produces the same result.
## What a quote pins
A priced quote records four book pins that together identify the exact artifact that evaluated the request:
| Pin | What it identifies |
| ------------- | ------------------------------------------- |
| Book ID | The book the quote was evaluated against |
| Version | The immutable published version number |
| Version ID | The internal version identifier |
| Artifact hash | The compiled artifact hash for exact replay |
When all four pins are present, the quote is **replayable**. When a pin is missing, the receipt shows a **Not replayable** chip — the stored result and derivation remain visible, but the offer cannot be exactly reproduced against its original version.
Book pinning was enforced from the start of the revamped product. Quotes created before pinning was enforced may be missing pins. New quotes always carry the full set.
## Structured inputs
Each quote stores the normalized inputs that were evaluated — the service selections, factor choices, and context the customer or staff member provided. These inputs are structured, not free-form text. They are what the Book's evaluator consumed to produce the result.
The same inputs evaluated against the same book version always produce the same result. This is true across HQ, hosted quote paths, embeds, and the public API — they all use the same immutable published artifact and evaluator.
## Line-item derivation
The derivation table on the quote receipt shows every line item the Book evaluated, in order:
| Column | What it shows |
| ------ | ------------------------------------------------------------ |
| Rule | The label and source key of the pricing rule |
| Kind | The item kind — for example, base price, modifier, or add-on |
| State | Whether the item was selected and its selection state |
| Amount | The line item's low and high amounts |
Each line item carries its own provenance — the rule that produced it, the factor selections that triggered it, and the amount it contributed. The sum of selected line items is the offered amount.
## Commercial policy
The policy frozen with the price when the quote was produced:
| Field | What it records |
| ----------------- | --------------------------------------------------------- |
| Deposit | The deposit amount required at commitment, or none |
| Valid until | When the offer expires if the customer does not accept |
| Requires approval | Whether the policy required owner approval before sending |
The policy is frozen at evaluation time. If you change the book's deposit or validity settings later, existing offers keep the policy they were produced with.
## Review and override record
When a quote is held for owner review, the review record captures the complete decision trail:
| Field | What it records |
| ----------------- | --------------------------------------------------------------------------------------- |
| Review required | Whether the quote was held |
| Hold reasons | Why the quote was held — a review rule, the autonomy rung, or an inspection requirement |
| Approved by | Who approved the quote |
| Adjusted from | The original range before an owner correction |
| Adjustment reason | Why the owner corrected the range |
| Note | Any note the owner left |
This trail is the correction history. It shows what the Book produced, what the owner changed, and why. An adjustment classified as an existing rule problem or a missing rule also drafts a learning proposal against the pinned book version — the reason becomes the owner evidence for that proposal.
## Why the result can be replayed
A quote is replayable when:
1. The book version ID and artifact hash are present.
2. The structured inputs are stored.
3. The evaluator is deterministic.
Given the same book version and the same inputs, the evaluator always produces the same result. This is a structural guarantee, not a promise — the evaluator does not use randomness, external lookups, or model inference at evaluation time. The LLM never sets the number.
Publishing a new book version does not change existing offers. Quotes already sent or in progress remain pinned to the version that produced them. New quotes use the newly published version.
## What this means for owners and developers
For owners, the receipt is the audit trail. When a customer asks why a price was what it was, the receipt shows the exact rules, line items, and conditions. When a correction is needed, the adjustment and its reason are recorded permanently.
For developers, the receipt is the replay contract. The same request submitted through the API produces the same result as the same request submitted through HQ or a hosted path. The book version pin means a quote can be replayed against its original version even after the Live book has moved to a new version.
## Related
How book versions work and why quotes can be replayed.
How source, evidence, and suggestion are tracked and verified.