# Sales orders

Section: Sales. Part of the [API reference](https://developer.yoprint.com/reference.md). Web page: https://developer.yoprint.com/reference/sales-orders/

This page and all 14 operation pages, in 7 files: https://developer.yoprint.com/llms/sales-orders.txt (operations 1 to 2), https://developer.yoprint.com/llms/sales-orders-2.txt (operation 3), https://developer.yoprint.com/llms/sales-orders-3.txt (operation 4), https://developer.yoprint.com/llms/sales-orders-4.txt (operation 5), https://developer.yoprint.com/llms/sales-orders-5.txt (operation 6), https://developer.yoprint.com/llms/sales-orders-6.txt (operations 7 to 8), https://developer.yoprint.com/llms/sales-orders-7.txt (operations 9 to 14)

Sales orders and quotes: create a draft, add jobs and lines, publish it, then run actions on it. A quote is a sales order with `object_type` quote, and most operations here serve both.

## Operations (12)

- [Create a sales order or quote](https://developer.yoprint.com/reference/sales-orders/v2-order-create.md): `POST /v2/api/store/{team_slug}/v2/sales_order/new`. Creates a new draft sales order or quote.
- [List the history of a sales order or quote](https://developer.yoprint.com/reference/sales-orders/v2-order-history.md): `GET /v2/api/store/{team_slug}/v2/sales_order/{order_unique_key}/history`. Returns the order's activity history: who changed what and when.
- [List sales orders](https://developer.yoprint.com/reference/sales-orders/v2-sales-order-filter.md): `POST /v2/api/store/{team_slug}/v2/sales_order/filter`. Lists sales orders, a page at a time, with filters and sorting.
- [Get a sales order or quote](https://developer.yoprint.com/reference/sales-orders/v2-order-show.md): `GET /v2/api/store/{team_slug}/v2/sales_order/{order_unique_key}`. Returns one sales order or quote with its line items (`items`), customer and message participants.
- [Update a sales order or quote](https://developer.yoprint.com/reference/sales-orders/v2-order-update.md): `PUT /v2/api/store/{team_slug}/v2/sales_order/{order_unique_key}`. Changes an order's header fields.
- [Run an action on a sales order or quote](https://developer.yoprint.com/reference/sales-orders/v2-order-single-action.md): `PUT /v2/api/store/{team_slug}/v2/sales_order/{order_unique_key}/action/{action_name}`. Runs one named action on an order.
- [Set the Client Note of a sales order or quote](https://developer.yoprint.com/reference/sales-orders/v2-order-customer-note-update.md): `PUT /v2/api/store/{team_slug}/v2/sales_order/{order_unique_key}/customer_note`. Sets the order's Client Note.
- [Set the production note of a sales order or quote](https://developer.yoprint.com/reference/sales-orders/v2-order-production-note-update.md): `PUT /v2/api/store/{team_slug}/v2/sales_order/{order_unique_key}/production_note`. Sets the order's production note, for your shop floor.
- [Publish a draft sales order or quote](https://developer.yoprint.com/reference/sales-orders/v2-order-publish.md): `PATCH /v2/api/store/{team_slug}/v2/sales_order/{order_unique_key}/publish`. Publishes a draft: what the Publish button does in the web app.
- [Delete a sales order or quote](https://developer.yoprint.com/reference/sales-orders/v2-order-destroy.md): `DELETE /v2/api/store/{team_slug}/v2/sales_order/{order_unique_key}`. Deletes a sales order or quote.
- [Restore a deleted sales order or quote](https://developer.yoprint.com/reference/sales-orders/v2-order-restore.md): `PATCH /v2/api/store/{team_slug}/v2/sales_order/{order_unique_key}/restore`. Brings back a deleted sales order or quote with its lines, jobs, invoices, shipments and messages.
- [Export sales orders as CSV](https://developer.yoprint.com/reference/sales-orders/v1-sales-order-export.md): `POST /v1/api/store/{team_slug}/sales_order/export`. Downloads a CSV file of the published sales orders whose issue date is in a range.

## Legacy and internal operations (2)

Prefer the operations above. Legacy ones name their replacement; internal ones are built for YoPrint's own apps.

- [Filter sales orders (retired v1)](https://developer.yoprint.com/reference/sales-orders/v1-sales-order-filter.md): `POST /v1/api/store/{team_slug}/sales_order/filter` (legacy, deprecated). Retired: this v1 operation no longer works.
- [Get an order's history (retired v1)](https://developer.yoprint.com/reference/sales-orders/v1-sales-order-history.md): `GET /v1/api/store/{team_slug}/sales_order/{hash_id}/history` (legacy, deprecated). Retired: this v1 operation no longer works.