> For the complete documentation index, see [llms.txt](https://docs.silkline.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.silkline.ai/orders/shipments.md).

# Shipments

Record what a supplier shipped against your orders — carrier, tracking, dates, shipped quantities per line, and shipping documents such as packing slips and certificates

A shipment records what a supplier sent: the supplier's shipment number, carrier, tracking number, ship and expected delivery dates, the quantity shipped on each order line, and the documents that came with it. One shipment can cover lines from several orders, as long as they are all from the same supplier.

Shipments are available to every organization.

## Viewing shipments

Open **Orders** > **Shipments** in the navigation bar to see every shipment in your organization. Search by shipment number, tracking number, carrier, supplier, or PO number, and filter, group, or export the table like other tables in Silkline.

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-5e7332c7c28a871c874298b83e131b9c420a3449%2Fshipments-table.png?alt=media" alt="Shipments table with shipment number, supplier, orders, carrier, tracking number, dates, lines, and documents columns"><figcaption><p>The Shipments page</p></figcaption></figure>

Click a shipment to open its page, which lists its details, its documents, and a **Lines** table. The table groups the shipped lines under their order and shows each line's item, documents, and shipped and ordered quantities. **Documents** shows each document type the line's quality clauses require, checked when one of its files has that type and flagged when none does, followed by a count of the line's other files. Hover over it to see each file. Search the lines by item, filter them by order, document type, or missing documents, and export them. To list the lines without the order headings, open **Grouping** and click **Reset**; the order then appears in its own column.

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-3a9e007e9a634f7c5cf49d731c38ffc58cf74f93%2Fshipment-page.png?alt=media" alt="Shipment page showing details, shipment documents, and a lines table grouped by order"><figcaption><p>A shipment's page</p></figcaption></figure>

### Shipment lines

The **Shipment Lines** tab on the Shipments page lists every shipped line across all shipments, with its shipment number, supplier, order, item, documents, and quantities. Use it to find the lines that still need documents:

1. Open **Orders** > **Shipments** and click **Shipment Lines**.
2. Open **Filters** > **Missing Documents** and pick **Has missing documents**. Pick **No missing documents** to see the lines that have every required document, including lines with no requirements.
3. Click a line to open its shipment, then edit the shipment to attach the documents.

Search the tab by item, shipment number, supplier, or PO number. Filter by supplier, order, or document type, group by shipment, supplier, or order, and export the lines.

Shipments also appear on:

* **Orders:** the **Shipments** card lists every shipment carrying the order's lines. It sits at the top of open and closed orders. On orders in other states, it appears below the line items once the order has a shipment.
* **Orders and Line Items tables:** the **Shipments** column shows each order's or line's shipments, and the **Shipments** filter narrows the table to rows that have or don't have shipments.

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-527afd1edee86c4307001c97eda199d68454252b%2Forder-shipments-card.png?alt=media" alt="Shipments card on an order, listing a shipment&#x27;s lines, shipped quantities, and documents" width="563"><figcaption><p>The Shipments card on an order</p></figcaption></figure>

## Adding a shipment

1. Click **New Shipment** on the Shipments page, or **Add Shipment** on an order's Shipments card. From an order, the supplier is already set.
2. Enter the **Supplier shipment number** (the supplier's packing slip or advance ship notice number), **Carrier**, **Tracking number**, **Ship date**, and **Expected delivery**. All are optional.
3. Under **Orders**, add each order the shipment carries with **Add an order…**. From an order, that order is already added. On each order, pick the lines shipped with **Add a line from…**, then enter the quantity in **This shipment**. **Already shipped** shows the quantity on the line's other shipments.
4. Upload documents under **Documents**, and attach them to lines with **Add document**. Documents not attached to a line apply to the whole shipment, such as a packing slip.
5. Click **Add shipment**.

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-d184a371f48f41bf7438a5e99d47be863b4d01ac%2Fshipment-edit-sidebar.png?alt=media" alt="Edit Shipment sidebar with shipment details, an order&#x27;s lines with shipped quantities, and documents attached to each line" width="563"><figcaption><p>Adding lines and documents to a shipment</p></figcaption></figure>

To change a shipment, click **Edit** on its page or the pencil icon on an order's Shipments card. Delete it from the same places.

Adding, editing, and deleting shipments each need their own permission. Admins and Buyers have all three.

## Required shipping documents

A [quality clause](https://docs.silkline.ai/profile-and-settings/organization-settings/quality-clauses.md) can list **Required shipping documents**, such as a Certificate of Conformance. Each shipped line whose order line carries that clause then shows a slot for each required document type.

* Fill a slot by uploading a file or picking one already on the shipment. Picking a file with no document type sets it to the slot's type.
* When the same document covers other lines on the shipment, **Also fill** attaches it to those lines too.
* The shipment shows how many required documents are attached, such as `2 of 3 required documents`. Hover over a missing document to see which clause requires it.
* The **Documents** column on a shipment's **Lines** table and on the **Shipment Lines** tab flags the document types each line still needs.

Missing required documents don't prevent saving a shipment.

## What suppliers see

When a supplier opens a PO you shared with them, its page shows the shipments carrying its lines, read-only. If the PO was shared with them directly, they also see the documents attached to those lines. Documents that apply only to the whole shipment are not shown.
