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

# Issues

Track quality issues and non-conformances against the PO line they belong to, record them in Silkline or sync them from external systems, send them to suppliers, and feed supplier issue-rate scorecard

The **Issues** page in Silkline provides a centralized view of quality issues tracked against order line items. An *issue* represents a defect, non-conformance, or quality discrepancy found on items received from a supplier — recorded against a specific order line so that problem context (which PO, which part, who supplied it) is preserved alongside the issue itself.

Issues come from one of two places:

* **Recorded in Silkline.** Once a Silkline admin turns on **Issue creation** under **Organization Settings > Issues**, users with the **Create Issue** permission log issues directly from the Issues page, and users with the **Edit Issue** permission update or delete them from the issue detail page. See [Creating and editing issues](#creating-and-editing-issues).
* **Synced from an external system.** Some integrations (currently First Resonance ION and Manufacturo) ingest issues into Silkline. Issue creation is off by default, so synced issues stay managed in the external system. See [Integrations](https://docs.silkline.ai/integrations.md) for the full list of integrations and which capabilities each one supports.

{% hint style="info" %}
Issues must be enabled for your organization before the Issues page appears in the sidebar. An admin can enable this feature under **Organization Settings > Issues**. See [Issues Settings](https://docs.silkline.ai/profile-and-settings/organization-settings/issues.md) for details.
{% endhint %}

## Why issues matter: supplier scorecards

Issues are not just a record-keeping tool — they directly drive the **Issue Rate** metric on the [Supplier Scorecard](https://docs.silkline.ai/suppliers.md#supplier-scorecard). Each issue in Silkline is attributed to the supplier behind the PO line it's logged against, and that data is rolled up into trailing 3-month, 12-month, and all-time error rates per supplier.

This means:

* An issue counts toward its supplier's quality score when its **Responsibility** is Supplier or not yet classified. Set it to Internal or Other when the supplier did not cause the problem, and the issue no longer counts against them.
* The Issue Rate on the supplier list and the supplier detail page share the same calculation.
* Scorecards refresh hourly, so new issues and responsibility changes appear in the supplier's metrics within an hour.

When triaging an issue, the supplier's recent error rate gives you immediate context: is this a one-off, or part of a pattern with this supplier?

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-bc454ef1ac5fa3ece5ccb1607afcc18a249b9c31%2Fissues-table.png?alt=media" alt="Issues page table view"><figcaption><p>Issues table with search, filters, and the Export button in the footer</p></figcaption></figure>

## Issues table

The Issues page shows a searchable, sortable table of all issues for your organization. Key columns include title, status, responsibility, order, supplier, item, defective quantity, reporter, and assigned to. Use the search bar to find issues by title, and the column filters to narrow by status, responsibility, supplier, or assignee.

### Exporting issues

Use the **Export** button below the issues table to download a CSV. The export reflects the table as configured on screen:

* Any active filters and search terms are applied, and every matching row is included — not just the rows on the current page.
* The CSV contains the columns currently visible in the table, with headers matching the column names shown on screen. The **Item** column is split into Material Number, Material Name, Material Description, Revision, and Item Description.

## Creating and editing issues

Click **Create Issue** on the Issues page (or run **Create Issue** from the command palette) to open the issue form. The form asks for:

| Field                                                           | Description                                                                                                                                                                                  |
| --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Order Line**                                                  | The purchase order line the defect was found on. Search by order number, supplier, part number, part name, or line description. The order line cannot be changed after the issue is created. |
| **Title**                                                       | Short summary of the defect. Required.                                                                                                                                                       |
| **Status**                                                      | New, In Progress, or Closed. Defaults to New. An issue synced with a different status keeps it until you pick one of the three.                                                              |
| **Defective Quantity**                                          | How many units are defective. Required.                                                                                                                                                      |
| **Reporter**                                                    | Who found the defect. Defaults to you and is set once, when the issue is created.                                                                                                            |
| **Assigned To**                                                 | Who is responsible for resolving the issue.                                                                                                                                                  |
| **Problem Description**, **Cause Description**, **Disposition** | Rich-text descriptions of what is wrong, why it happened, and the action taken.                                                                                                              |

Saving opens the new issue's detail page. On the detail page, the pencil icon next to the title opens the same form to edit the issue, and the trash icon deletes it after confirmation. Deleting an issue also removes its activity feed and cannot be undone. Issues synced from an integration cannot be deleted in Silkline; remove them in the source system instead.

{% hint style="info" %}
Creating an issue requires the **Create Issue** permission; editing or deleting one requires the **Edit Issue** permission. Both are granted to the Admin, Supplier Quality, and Buyer roles by default. The Create, Edit, and Delete controls appear only after **Issue creation** is turned on in [Issues settings](https://docs.silkline.ai/profile-and-settings/organization-settings/issues.md).
{% endhint %}

## Issue detail page

Click an issue from the table — or the issue icon on an order line — to open its detail page.

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-a6b93267da5a330412b12507a881616c04ec86e3%2Fissues-detail-page.png?alt=media" alt="Issue detail page"><figcaption><p>Issue summary, status, people, and descriptions</p></figcaption></figure>

The detail page is organized into three sections:

### Page header

The header shows the issue title alongside a **link to the supplier** behind the affected PO line, including the supplier's logo. Click the supplier to jump directly to their profile and full scorecard.

### Summary card

Captures the structured facts about the issue:

| Field                  | Description                                                                                |
| ---------------------- | ------------------------------------------------------------------------------------------ |
| **Order Line**         | The PO and line number this issue was logged against. Click to open the purchase order.    |
| **Supplier**           | The supplier on the linked PO. Click to open their detail page, including their scorecard. |
| **Part**               | The part number and revision on the affected line item. Click to open the part.            |
| **Defective Quantity** | How many units are flagged as defective on this issue.                                     |

### Status card

Shows where the issue stands:

| Field                     | Description                                                                               |
| ------------------------- | ----------------------------------------------------------------------------------------- |
| **Status**                | New, In Progress, or Closed. Users who can edit issues can change it here.                |
| **Responsibility**        | Supplier, Internal, Other, or Unclassified. Users who can edit issues can change it here. |
| **Created** / **Updated** | Issue lifecycle timestamps.                                                               |

### People card

Shows who is responsible for the issue:

* **Reporter** — the person who originally reported the issue.
* **Created By** — the person (or system) that created the record in Silkline.
* **Assigned To** — the person currently responsible for resolving it.

### Descriptions card

Free-form rich-text fields:

* **Problem Description** — what is wrong.
* **Cause Description** — why it happened, once known.
* **Disposition** — the action taken (rework, scrap, return, accept-as-is, etc.).

### Integration sync

If you have integrations with writeback enabled, sync buttons appear in the action bar at the top of the page. These let you push the issue's state to (or pull from) the configured integration on demand.

## Collaborating with suppliers

You can loop a supplier in on an issue directly from its detail page. The action bar at the top of the page provides everything you need:

* **Send** / **Resend** — email the issue to the supplier, with an optional PDF attachment and a secure link to view the issue online. See [Sending an issue to a supplier](#sending-an-issue-to-a-supplier).
* **Download PDF** — preview and download the issue as a PDF. See [Downloading an issue as a PDF](#downloading-an-issue-as-a-pdf).
* **Share** — opens the Share sidebar, where **Copy** creates a shareable link to the issue and copies it to your clipboard, so you can paste it into a chat or your own email.
* **Activity** — opens the issue's activity feed (see below).

{% hint style="info" %}
Sending and sharing an issue requires the **Send Issue** permission, which is granted to the Buyer, Supplier Quality, and Admin roles by default.
{% endhint %}

### Sending an issue to a supplier

Click **Send** (or **Resend**, once the issue has been sent at least once) to open the **Send Issue to Supplier** compose sidebar:

* **TO** — pre-filled with the supplier's default contacts. Add or remove supplier contacts, or type a new email address. New supplier email addresses are saved as contacts on the supplier (this requires the **Create Supplier Contact** permission).
* **CC** / **BCC** — add supplier contacts or members of your own organization. BCC is pre-filled with your own email address so you get a copy.
* **Subject** and **Message** — pre-filled from your organization's **Send Issue** email template, with the issue title and supplier name already substituted. Edit them freely before sending; the message supports rich text. Admins can customize the template under [Email Settings](https://docs.silkline.ai/profile-and-settings/organization-settings/email-settings.md).
* **Attach Issue PDF** — when toggled on, a PDF of the issue is generated and attached to the email. The toggle is off by default, and your choice is remembered for the next send. FedRAMP-enabled organizations don't have this option.

The email the supplier receives includes your message and a **View Issue** button that links to a secure, read-only view of the issue — no Silkline login required. The link expires after 30 days; resend the issue to generate a fresh one.

The supplier's view shows the issue title and status, the defective quantity, the reported date, and the problem, cause, and disposition descriptions. Internal details such as your order, people assignments, and supplier scorecard metrics are not exposed. The supplier responds by replying to the email, and their reply is captured automatically in the issue's [activity feed](#activity-feed).

### Downloading an issue as a PDF

Click the **Download PDF** button in the action bar to open a preview of the rendered PDF. From the preview you can zoom in and out and move between pages using the controls at the bottom of the document, then click the download icon to save the file. The PDF includes your organization's logo, the issue details (order line, supplier, part, status, and defective quantity), and the problem, cause, and disposition descriptions — the same document that's attached when you send an issue with **Attach Issue PDF** enabled.

If you'd rather skip the preview, check **Download without preview** — future clicks of the button will download the PDF immediately.

### Activity feed

The **Activity** button opens a running timeline of everything that has happened on the issue:

* when the issue was created,
* each time it was **sent to the supplier**, including who sent it, the recipients, and any attachments,
* every **email reply received** from the supplier (replies to the issue email are captured automatically and shown inline), and
* any **notes** your team adds.

Click an email entry to read the full message. Supplier replies thread into the same feed, so the whole conversation about an issue lives in one place.

## Issues on orders

When a line item has related issues, an issue icon appears on the line. Hover to see a summary of each issue, and click through to the full detail page.

<figure><img src="https://2684497859-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwPsevXC0g5kNMF7GTyPN%2Fuploads%2Fgit-blob-62f5010f1fd3ca19a53131188316b4059b738fc0%2Fissues-indicator-on-order-line.png?alt=media" alt="Issue icon on order line item with tooltip"><figcaption><p>Issue icon on a line item; hover shows issue summary</p></figcaption></figure>

## Related documentation

* [Supplier scorecards](https://docs.silkline.ai/suppliers.md#supplier-scorecard) — how Issue Rate and other supplier metrics are calculated.
* [Integrations](https://docs.silkline.ai/integrations.md) — only some integrations support issues; check this page for which ones do.
* [Issues settings](https://docs.silkline.ai/profile-and-settings/organization-settings/issues.md) — enable issues and control whether users can create them in Silkline.
* [Email settings](https://docs.silkline.ai/profile-and-settings/organization-settings/email-settings.md) — customize the Send Issue email template.
