# Manage suppliers and purchase orders
URL: https://support.starshipit.com/articles/14700000000007-manage-suppliers-and-purchase-orders
Canonical: https://support.starshipit.com/articles/14700000000007-manage-suppliers-and-purchase-orders
Markdown: https://support.starshipit.com/articles/14700000000007-manage-suppliers-and-purchase-orders.md
Updated: 2026-11-08

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Create, import, and manage suppliers and purchase orders in Starshipit WMS to track incoming stock and drive your receiving workflow.

Before stock can be received into your warehouse, you need two things in Starshipit WMS: a **supplier** record for each vendor you buy from, and a **purchase order (PO)** for each incoming delivery. Add a supplier email when you want to send a created PO directly from WMS.

Suppliers and POs give you:

* A structured record of what you ordered, from whom, and in what quantity.
* Visibility of **Incoming** stock on the inventory dashboard before it physically arrives.
* A receiving workflow that compares what you expected against what actually arrived.

## Before you begin

- Have the products you want to order available in WMS.
- Create or choose a supplier before adding a PO.
- Add the supplier's email address if you will email the PO from WMS.

## Suppliers

Suppliers represent the vendors or manufacturers you purchase stock from. Setting them up first makes it easier to create purchase orders and report on inbound stock by supplier.

### Creating a supplier

1. Go to the **Suppliers** section in WMS.
2. Click **Create supplier**.
3. Enter the supplier name.
4. Enter an email address if you want to send purchase orders to this supplier from WMS.
5. Click **Save**.

You can edit supplier details at any time. Each purchase order is linked to a supplier record, giving you a clear history of who supplied each delivery.

## Purchase orders

A **purchase order (PO)** records the products and quantities ordered from a supplier. It drives receiving and updates **Incoming** stock on the inventory dashboard.

### Creating a purchase order

1. Go to the **Purchase Orders** section.
2. Click **Create purchase order**.
3. Select a **Supplier**.
4. Enter a **PO number** (your internal reference or the supplier's order number).
5. Add each product (SKU) you are ordering.
6. Enter its ordered quantity.
7. Check each line's **Unit Cost**. It starts from the product's default unit cost and can be changed for this PO.
8. Save as **DRAFT** if you are still editing, or set to **CREATED** when confirmed.
9. Reopen the PO and check its supplier, products, quantities and costs.

### Email a purchase order

You can email a purchase order in **CREATED**, **ORDERED**, **IN_TRANSIT** or **ARRIVED** status when its supplier has an email address. Draft, partially received and received POs cannot be emailed.

1. Go to **Purchase Orders** and open the created purchase order.
2. Check the supplier, line items, quantities, pricing and delivery details.
3. Confirm the **Supplier Email** is correct. If it is missing, open the supplier record and add it.
4. Click **Email Supplier**.

Confirm that WMS shows the email as queued and displays the intended recipient address.

Use the purchase order list to compare suppliers, statuses, expected dates, line counts and received quantities before opening a PO.

![The WMS purchase order list showing an in-transit order with its transit stage and partially received orders](/uploads/articles/starshipit-wms/web/inbound/purchase-orders.jpg)

The PO detail page shows the supplier, expected date, line items, unit costs and totals that should be checked before receiving. Use **Inbound progress** to review the inbound status, optional transit stage and change history.

![A purchase order showing In Transit status and the Ocean transit stage](/uploads/articles/starshipit-wms/web/inbound/purchase-order-details.jpg)

### Update the expected arrival date

Users with purchase-order management permission can edit or clear **Expected Arrival Date** while the PO is **DRAFT** or **CREATED**. The date is read-only in other statuses.

1. Open the purchase order and change **Expected Arrival Date**.
2. Select **Save as Draft** for a draft, or **Save changes** for a created PO.
3. Reopen the PO and confirm the date.

Date changes to a **CREATED** PO appear under **Inbound progress > Change history** with the previous date, new date, user and time.

### Update line costs before receiving

Users with purchase-order management permission can change line unit costs while the PO is a draft or awaiting receipt, provided no quantity has been received on any line.

1. Open the purchase order and check its line items.
2. Enter each agreed **Unit Cost**, using zero or a positive value.
3. Select **Save changes** for a PO awaiting receipt, or **Save as Draft** for a draft.
4. Reopen the PO and confirm the costs and totals before receiving stock.

These costs apply to this PO without changing the product's default unit cost. Receiving uses the PO line cost. Line costs are locked once receiving begins.

### Duplicate a purchase order

1. Open the original purchase order's actions menu and select **Duplicate**.
2. Review the copied supplier, expected arrival date, products, quantities and prices.
3. Edit the new draft as needed before changing its status to **CREATED**.

WMS creates a new draft and adds the next available numeric suffix to the original PO number, such as `PO-100-1`.

### Import purchase orders

If you need to create many POs at once — for example, when migrating from another system — you can import them via CSV upload. Your CSV must follow the required column structure for PO number, supplier, and line items.

For a connected Unleashed or MYOB Acumatica account:

1. Open the purchase-order actions menu.
2. Select **Import from Unleashed** or **Import from MYOB Acumatica**.
3. Preview the available purchase orders and select the ones you need.
4. Choose whether WMS should create them as **Draft** or **Created**.
5. Check the imported POs before receiving.

For MYOB Acumatica prerequisites, product matching and verification, see [Set up MYOB Acumatica with Starshipit WMS](/articles/14700000000056-set-up-myob-acumatica-with-starshipit-wms).

### PO statuses

Purchase orders move through the following statuses:

| Status | What it means |
|---|---|
| **DRAFT** | PO is being prepared and has not yet been issued. |
| **CREATED** | PO has been issued and is awaiting receipt. |
| **ORDERED** | Order has been placed with the supplier. |
| **IN_TRANSIT** | Goods are on their way to the warehouse. |
| **ARRIVED** | Goods have arrived and await receiving; stock has not been added yet. |
| **PARTIALLY_RECEIVED** | Some lines or quantities have arrived; more are still expected. |
| **RECEIVED** | Receiving is complete, or the PO has been deliberately closed within the receiving tolerance. |

Before receiving starts, users with purchase-order management permission can update the inbound status:

1. Open the PO and choose **Inbound progress > Inbound status**.
2. Select **Created**, **Ordered**, **In Transit** or **Arrived**.
3. Wait for the success message.
4. Check **Change history** for the change, user and time.

:::note
Changing inbound status does not add stock. Receiving sets **PARTIALLY_RECEIVED** or **RECEIVED** automatically; these POs cannot be manually returned to an inbound status.
:::

### Track optional transit stages

Transit stages track extra steps, such as customs clearance, without changing PO status or adding stock. You need purchase-order management permission, a PO in **CREATED**, **ORDERED**, **IN_TRANSIT** or **ARRIVED**, and no received quantities.

1. Open **Inbound progress > Transit stage**.
2. Select or clear a stage.
3. Check **Change history** to confirm the saved change.

After receiving starts, the saved value appears as **Last transit stage** and cannot be changed. Use the separate **Status** and **Transit stage** filters on the PO list to find outstanding work.

An **Admin** with account-wide settings access can configure the available stages:

1. Go to **System > Settings > Receiving > Purchase order transit stages**.
2. Select **Manage stages**, then add, rename, reorder or archive stages.
3. Select **Save**, then reopen the settings to confirm the list.

Renaming or archiving a stage preserves the names already saved on POs and in their history.

### Handling incomplete or short deliveries

If a supplier ships less than expected, the PO stays in **PARTIALLY_RECEIVED** until the remaining quantity arrives.

If you decide you will not receive the outstanding quantity, you can:

* **Mark individual lines as missing** — records that the expected stock did not arrive.
* **Mark the PO as fully received** — closes the PO and removes it from your outstanding view, even if not all lines have been received. Use this when you have decided not to follow up on the remaining quantity.

WMS checks **Under-Receiving Tolerance** before closing a short PO. A line below the configured minimum remains open. Review the [receiving tolerances](/articles/14700000000008-receive-stock-against-a-purchase-order#review-receiving-tolerances) before closing the outstanding quantity.

### Monitoring outstanding POs

Regularly review POs with status **CREATED**, **ORDERED**, **IN_TRANSIT**, **ARRIVED** or **PARTIALLY_RECEIVED** to follow up on short deliveries or delayed shipments. The PO list supports filtering by status so you can focus on what is still outstanding.

## Next steps

* [Receiving stock](/articles/14700000000008-receive-stock-against-a-purchase-order) — how to receive a delivery against a PO.
* [Putaway](/articles/14700000000009-put-away-received-stock) — how to move received stock from staging to final storage locations.
