---
title: "Changes to Purchase Order - Create"
method: POST
path: "/purchase_order/create"
---

# Changes to Purchase Order - Create

`POST /purchase_order/create`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 15 revisions.

- **2026-10-26** `3bf9d805a276`: 1 info
- **2026-03-02** `fa53dd949b8e`: 6 breaking, 27 info
- **2024-04-22** `08cd9cfa14dd`: 1 breaking, 19 warning, 2 info
- **2024-04-19** `46ceda528000`: 2 breaking, 25 info

## Changes

- **2026-10-26** `3bf9d805a276`: 1 info
  - added the new optional request property `items/items/metadata`
- **2026-03-02** `fa53dd949b8e`: 6 breaking, 27 info
  - request property `status` was restricted to a list of enum values
  - the request property `number` became required
  - the `dropship_address` request property type changed from `string` to `object`
  - the `dropshipped` request property type changed from `string` to `boolean`
  - the `number` request property type changed from `number` to `string`, and format from `integer` to no format
  - the `tax_per` request property type changed from `string` to `number`
  - api operation id `post_purchase_order_create` was added
  - added the new optional request property `items/items/cost`
  - added the new optional request property `items/items/description`
  - added the new optional request property `items/items/item_id`
  - added the new optional request property `items/items/kit_id`
  - added the new optional request property `items/items/name`
  - added the new optional request property `items/items/quantity`
  - added the new optional request property `items/items/rate`
  - added the new optional request property `items/items/received`
  - added the new optional request property `items/items/serial_numbers`
  - added the new optional request property `items/items/sku`
  - added the new optional request property `items/items/type`
  - added the new optional request property `items/items/unit`
  - added the new `accepting` enum value to the request property `status`
  - added the new `acknowledged` enum value to the request property `status`
  - added the new `closed` enum value to the request property `status`
  - added the new `created` enum value to the request property `status`
  - added the new `edited` enum value to the request property `status`
  - added the new `receiving` enum value to the request property `status`
  - added the new `sent` enum value to the request property `status`
  - added the new `transit` enum value to the request property `status`
  - added the media type `application/json` for the response with the status `200`
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `429`
  - added the non-success response with the status `500`
- **2024-04-22** `08cd9cfa14dd`: 1 breaking, 19 warning, 2 info
  - added required request body
  - deleted the `query` request parameter `discount`
  - deleted the `query` request parameter `discount_per`
  - deleted the `query` request parameter `distributor_id`
  - deleted the `query` request parameter `dropship_address`
  - deleted the `query` request parameter `dropshipped`
  - deleted the `query` request parameter `due_date`
  - deleted the `query` request parameter `items`
  - deleted the `query` request parameter `memo`
  - deleted the `query` request parameter `method`
  - deleted the `query` request parameter `number`
  - deleted the `query` request parameter `shipping`
  - deleted the `query` request parameter `status`
  - deleted the `query` request parameter `store_id`
  - deleted the `query` request parameter `subtotal`
  - deleted the `query` request parameter `tax`
  - deleted the `query` request parameter `tax_per`
  - deleted the `query` request parameter `terms`
  - deleted the `query` request parameter `total`
  - deleted the `query` request parameter `warehouse_id`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
- **2024-04-19** `46ceda528000`: 2 breaking, 25 info
  - removed the request body
  - removed the media type `application/json` for the response with the status `200`
  - api operation id `post_purchase_order_create` removed and replaced with ``
  - added the new optional `query` request parameter `discount`
  - added the new optional `query` request parameter `discount_per`
  - added the new optional `query` request parameter `distributor_id`
  - added the new optional `query` request parameter `dropship_address`
  - added the new optional `query` request parameter `dropshipped`
  - added the new optional `query` request parameter `due_date`
  - added the new optional `query` request parameter `items`
  - added the new optional `query` request parameter `memo`
  - added the new optional `query` request parameter `method`
  - added the new optional `query` request parameter `number`
  - added the new optional `query` request parameter `shipping`
  - added the new optional `query` request parameter `status`
  - added the new optional `query` request parameter `store_id`
  - added the new optional `query` request parameter `subtotal`
  - added the new optional `query` request parameter `tax`
  - added the new optional `query` request parameter `tax_per`
  - added the new optional `query` request parameter `terms`
  - added the new optional `query` request parameter `total`
  - added the new optional `query` request parameter `warehouse_id`
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `403`
  - removed the non-success response with the status `429`
  - removed the non-success response with the status `500`

---

[Operation](https://skmtc.dev/skulabs/apis/skulabs-api/docs/purchase_order/create/post.md) - [API](https://skmtc.dev/skulabs/apis/skulabs-api.md) - [Page](https://skmtc.dev/skulabs/apis/skulabs-api/changes/purchase_order/create/post)
