> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vinmake.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quotation

> Generate a client quotation from approved true cost

# Quotation

⚪ **Planned (Phase 3)** — markup version
🔵 **Future (Phase 5)** — pricing intelligence

The quotation workflow turns an approved true cost into a client-facing quotation.
It ships in two levels: a simple markup version first, then a pricing intelligence
layer once the data exists to drive it.

## Level 1 — Simple markup quotation

The first version is the simplest possible. The merchandiser selects or types a
markup, and Brain calculates the selling price.

User input:

```text theme={null}
Generate quotation with 15% markup
```

Brain calculates:

```text theme={null}
Selling Price = True Cost × (1 + Markup %)
```

Examples:

| True Cost | Markup | Quotation Price |
| --------: | -----: | --------------: |
|   \$10.00 |    10% |         \$11.00 |
|   \$10.00 |    15% |         \$11.50 |
|   \$10.00 |    20% |         \$12.00 |

This is a Tier 1 skill — small, deterministic, easy to debug. See [Tiers](/brain/staging/architecture/tiers).

## Level 2 — Pricing intelligence

Once we have enough historical data, Brain helps recommend a price using multiple
sources of signal. This is **Phase 5** — we don't build it until the data
substrate exists.

### External comparable styles

Brain searches for similar retail products and estimates wholesale feasibility:

```text theme={null}
Retail price: $89
Estimated wholesale FOB target: 20–30% of retail
Suggested FOB range: $17.80–$26.70
```

### User-provided comparable styles

The user may paste:

* A product link
* Competitor price
* Target retail price
* Buyer price expectation
* A similar past quote

Brain folds those into the recommendation.

### Historical VinMake data

Brain analyzes:

* Past quotations to the same client
* Accepted margin by client
* Rejected quote history
* Negotiation patterns
* Final confirmed price vs. originally submitted price
* Margin erosion after negotiation
* Style-category margin range

### Client-specific margin profile

Different clients have different pricing behavior. Brain derives this from history
(it does not invent it):

| Client | Typical Submitted Margin | Typical Final Margin | Notes                 |
| ------ | -----------------------: | -------------------: | --------------------- |
| Jaspal |                   18–22% |               14–18% | Negotiates moderately |
| Lulus  |                   15–20% |               12–16% | Price sensitive       |
| ASOS   |                   20–25% |               15–20% | Volume dependent      |

The intelligence layer recommends a quote range with rationale that links to the
underlying data. The merchandiser picks the actual number.

## Approval gate

The merchandiser reviews the recommended quote, edits if needed, and approves.
Approval generates the quotation PDF and triggers the quotation email draft.

## Output

* Quotation PDF generated from the approved price and quote terms
* Quotation record written to the Brain database with reference to the style and
  client
* Trigger for [Quotation Email](/brain/staging/workflows/quotation-email)

## Related

* [True Cost](/brain/staging/workflows/true-cost) — upstream
* [Quotation Email](/brain/staging/workflows/quotation-email) — downstream
* [Oversight Agent](/brain/staging/workflows/oversight) — tracks what happens after
  the quote goes out