---
title: "savePurchaseOrders"
method: POST
path: "/purchaseorder/v1/savePurchaseOrders"
tags: ["Purchase Order Service"]
---

# savePurchaseOrders

`POST /purchaseorder/v1/savePurchaseOrders`

Save purchase orders.

## Headers

- `authenticationtoken` string, required
- `password` string, required
- `sitename` string, required
- `userid` string, required
- `X-B3-TraceId` string

## Request body

- PurchaseOrderRowsList — PurchaseOrderRowsList description
  - `locationCode` string, required — The Code for the Location associated with the transaction.
  - `purchaseOrderSaveRows` PurchaseOrderSaveRows[]
    - `purchaseOrderDetailRows` PurchaseOrderDetailRow[]
      - `orderQuantity` number, required — The Order Quantity for the product line item.
      - `vendorProductNumber` string, required — The Vendor's Product Number for the product line item.
      - `vendorUnit` string, required — The Vendor's Package Type/Unit for the product line item.
    - `purchaseOrderHeaderRow` PurchaseOrderHeaderRow — PurchaseOrderHeaderRow description
      - `doNotTransmit` 'Y' | 'y', required — Indicates whether a “Submitted” order should be transmitted to the vendor. Enter 'Y' or 'y' for Yes; leave blank for No.
      - `expectedDeliveryDate` string, required — The Expected Delivery Date if the Order Type is 'VO' or the Return Date if the Order Type is 'VR'.
      - `locationCode` string, required — The Code for the Location associated with the transaction.
      - `message` string — Message for the transaction document.
      - `misc1GlDescription` string — The GL account associated with the Misc. 1 charge for a Vendor Return.
      - `misc1GlValue` number — The amount of the Misc. 1 charge for a Vendor Return.
      - `misc2GlDescription` string — The GL account associated with the Misc. 2 charge a Vendor Return.
      - `misc2GlValue` number — The amount of the Misc. 2 charge for a Vendor Return.
      - `orderStatus` 'NEW' | 'New' | 'SUBMITTED' | 'Submitted' | 'new' | 'submitted', required — Must be ‘New’ or ‘Submitted’ (not case sensitive).
      - `orderType` 'VO' | 'VR' | 'Vo' | 'Vr' | 'vo' | 'vr', required — Must be ‘VO’ for Vendor Order or ‘VR’ for Vendor Return (not case sensitive).
      - `referenceNumber` string — The Reference Number for the transaction.
      - `shippingGlDescription` string — The GL account associated with the Freight/Shipping charge for a Vendor Return.
      - `shippingValue` number — The amount of the Freight/Shipping charge for a Vendor Return.
      - `taxGlDescription` string — The GL account associated with the Tax charged on a Vendor Return.
      - `taxValue` number — The amount of the Tax charged on a Vendor Return.
      - `vendorCode` string, required — The Code for the vendor associated with the transaction.

## Response `200`

Success(Auto generated customer order number is returned)

- PurchaseOrderAutoGeneratePONumbers[]
  - `orderNumber` string — The Purchase Order Number for the transaction.

## Other responses

- `400` — Validation Error
- `401` — Authorization
- `429` — Too Many Requests
- `500` — Unexpected Error
- `503` — System under maintenance
- `504` — Timeout

---

[API](https://skmtc.net/crunchtime/apis/inventory-labor.md) · [All operations](https://skmtc.net/crunchtime/apis/inventory-labor/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crunchtime/inventory-labor/versions/0af8e380ff2c/schema)