# Quotes

Quote management operations.
Quotes are pricing requests/responses that can be converted to shipments.


## Filter quotes

 - [POST /quotes/filter](https://docs.mvmnt.io/apis/openapi/quotes/filterquotes.md): Search for quotes using filter criteria.

## Common Filters

- Active quotes: { "filter": { "status": { "in": ["DRAFT", "REQUESTED", "QUOTED"] } } }
- Won quotes: { "filter": { "status": { "equalTo": "WON" } } }
- By customer: { "filter": { "customerId": { "equalTo": "uuid" } } }
- Expiring soon: { "filter": { "expiresAt": { "lessThanOrEqualTo": "2025-01-20T00:00:00Z" } } }

## Create a quote

 - [POST /quotes](https://docs.mvmnt.io/apis/openapi/quotes/createquote.md): Create a new quote with order details.

## How it works

Creating a quote also creates an associated Order containing the route and freight details.
The Order is embedded in the Quote and cannot be managed separately.

## Required fields

- customer: Reference to the customer (shipper profile)
- order: Order details including stops and mode

## Example workflow

1. Create quote with customer and order details
2. Add pricing (amount) via PATCH
3. Send to customer (status changes to QUOTED)
4. Convert to shipment when accepted (POST /quotes/{id}/convert-to-shipment)

## Get a quote

 - [GET /quotes/{id}](https://docs.mvmnt.io/apis/openapi/quotes/getquote.md): Retrieve a quote by ID or key.

The response includes embedded order details (route, freight, equipment).

## Update a quote

 - [PATCH /quotes/{id}](https://docs.mvmnt.io/apis/openapi/quotes/updatequote.md): Update quote fields including status changes.

## Status changes

Status changes use this endpoint (not separate action endpoints):
- Set to QUOTED: { "status": "QUOTED", "amount": 2500 }
- Set to WON: { "status": "WON" }
- Set to LOST: { "status": "LOST", "lostReason": "TOO_HIGH" }

## Validation rules

- When setting status to LOST, lostReason is required
- When lostReason is OTHER, lostReasonText is required

## Note

To convert a won quote to a shipment, use POST /quotes/{id}/convert-to-shipment

## Delete a quote

 - [DELETE /quotes/{id}](https://docs.mvmnt.io/apis/openapi/quotes/deletequote.md): Soft delete a quote.

The quote record is marked as deleted but not permanently removed.
Associated orders are also soft deleted.

## Convert quote to shipment

 - [POST /quotes/{id}/convert-to-shipment](https://docs.mvmnt.io/apis/openapi/quotes/convertquotetoshipment.md): Convert an accepted quote into a shipment.

## What happens

1. Quote status is set to WON (if not already)
2. A new Shipment is created
3. The Order from the quote is linked to the shipment
4. Optionally, additional orders can be added

## Prerequisites

- Quote must be in QUOTED or WON status
- Quote cannot already have a shipment

## Response

Returns the IDs of both the quote and the newly created shipment.