> 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/track-receipts.md).

# Track receipts

Track full and partial receipts automatically from external ERP/MES/IMS systems, notify followers, and reference the receipt status definitions

Silkline connects with your other systems (e.g., an ERP, MES, or IMS) to automatically track receipt status and quantities.

When a receiving event occurs in another system, that event calls Silkline's API and updates the quantities received and status of each line item in the event.

## Follower notifications

When items on an order are received, all followers of the order automatically receive a notification indicating which line items were received. Receiving events are typically immediate, but email notifications are sent every 15 minutes.

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-cae87c6ea0fd03aaf2b7228adb54de94139a7fdb%2FScreenshot%202025-02-22%20at%203.54.28%E2%80%AFPM.png?alt=media" alt="" width="563"><figcaption><p>Example of receipt notification</p></figcaption></figure>

## Receipt status

In the Orders table, hover over the **Receipt Status** or **Billed Status** column header to see each status and its definition.

When a line item is partially or fully received, the workflow step for that line item is updated to the "Received" step. The step's label reflects the line's receipt status wherever it appears, including the order page, the Line Items view, and supplier check-ins: a partially received line shows "Partial receipt", an over-received line shows "Over-received", and a fully received line shows "Received". The quantity received updates as further receiving events happen.

When you edit an order, each line shows its **Qty Received** and **Qty Billed** next to Extended Cost. These fields are read-only in this view: they typically come from connected systems that manage receiving and billings.

## Partial receipts

Silkline supports tracking of partial receipts. A partial receipt is defined as when the quantity received is greater than 0 but less than the quantity ordered. Buyers can view, search, and filter this data from the Line Items view.

## Closing individual lines

A line item can be closed independently of the rest of its order — for example, to stop tracking a line whose invoices were misapplied, while the order's other lines stay open.

Closing a line preserves its ordered, received, and billed quantities exactly as they are; nothing is zeroed out. A closed line keeps a permanent record of what was originally ordered, and can be reopened at any time to resume tracking it normally.

Closing a line sets its receipt status to COMPLETE — the same status closing the entire order already gives every one of its lines. Closing means no further receipts are expected, whether that's decided line-by-line or for the whole order at once. The quantity tooltip and Status column still show a distinct label depending on how much was actually received before closing:

| If the line, when closed, was... | It shows...                                             |
| -------------------------------- | ------------------------------------------------------- |
| Not received at all              | Closed                                                  |
| Partially received               | Closed short                                            |
| Fully (or over-) received        | Complete or Over-received, the same as an unclosed line |

{% hint style="info" %}
A closed line's remaining quantity reads 0, regardless of how much was actually received. It no longer counts toward reports of outstanding quantity, such as a supplier's open orders report or check-in requests.
{% endhint %}

To close or reopen a line, open its quantity received/billed tooltip on the order page and use the close (or reopen) action next to the edit icon. This requires permission to edit the order. The line's Status column shows a disabled "Closed" badge in place of its workflow step while it's closed.

Closing or canceling an entire order automatically closes all of its lines; reopening the order reopens all of its lines, including any that were closed individually.

## Receipt status reference

### Line item receipt status

Each line item on an order has a receipt status that reflects how much of the ordered quantity has been received. There are six possible statuses:

| Status   | Definition               | When it applies                                                        |
| -------- | ------------------------ | ---------------------------------------------------------------------- |
| DRAFT    | Not yet sent to supplier | Order is in DRAFT, REVIEW, or APPROVED state                           |
| OPEN     | Awaiting receipt         | Order is OPEN, no units received yet                                   |
| PARTIAL  | Partially received       | Some units received, but fewer than the quantity ordered               |
| COMPLETE | Fully received           | All ordered units received, the line is closed, or its order is CLOSED |
| CANCELED | Order was canceled       | Order is in CANCELED state                                             |
| NONE     | Not receivable           | Item has no material or has a NonReceivable material type              |

**Key points:**

* DRAFT, CANCELED, and NONE are driven by the **order state** and **material type**, not by receiving activity.
* OPEN, PARTIAL, and COMPLETE are driven by **units received vs. units ordered**.
* When an order is CLOSED, or a line is [closed individually](#closing-individual-lines), it becomes COMPLETE regardless of how many units were received — except when over-received, which still shows as such.
* NONE items are not receivable but still participate in ETA and Need Date calculations.

### Order-level receipt status

Each order also has an overall receipt status that summarizes the statuses of its line items:

| Status   | Definition                        | When it applies                                            |
| -------- | --------------------------------- | ---------------------------------------------------------- |
| DRAFT    | All receivable items are DRAFT    | Order has not been sent to the supplier                    |
| OPEN     | All receivable items are OPEN     | Order sent, nothing received yet                           |
| PARTIAL  | Mixed statuses among items        | Some items received and others not, or any item is PARTIAL |
| COMPLETE | All items are COMPLETE or NONE    | All receivable items have been fully received              |
| CANCELED | All receivable items are CANCELED | Order was canceled                                         |

**Key points:**

* NONE items are excluded when determining whether all items share the same status — they do not block an order from reaching COMPLETE.
* If any single item is PARTIAL, the entire order is PARTIAL.
* Mixed statuses among receivable items (e.g., some OPEN and some COMPLETE) result in the order being PARTIAL.
* Orders with no line items derive their receipt status from the order state.
* If every line on an order is closed individually, the order's own receipt status reads COMPLETE too, even though the order itself hasn't been moved to the CLOSED state.
