> 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/suppliers/supplier-requests.md).

# Supplier Requests

Let anyone in your organization ask for a new supplier, and give your supply chain team a queue to approve or reject each request

A supplier request lets a team member who cannot create suppliers ask for one. The request creates the supplier in **Requested** approval status, so it can be named on quotes, orders and evaluations right away. Your supply chain team reviews the request and approves or rejects it.

{% hint style="info" %}
Supplier requests must be enabled for your organization. If you don't see **Request Supplier** on the Suppliers page, contact Silkline support.
{% endhint %}

## Request a supplier

Team members with the **Create Supplier Request** permission who cannot create suppliers see **Request Supplier** in place of supplier creation.

{% stepper %}
{% step %}

### Open the form

Open **Suppliers** and click **Request Supplier**.
{% endstep %}

{% step %}

### Describe the supplier

Enter the supplier name, and the website, a contact and the reason if you know them. The contact is saved on the requested supplier. Under **Documents**, attach files you already have from the supplier, such as an NDA or a certificate. Each file is saved as a document on the requested supplier, and Silkline fills in the type, title, summary and dates from PDF and image files. Silkline lists existing suppliers and pending requests with a similar name so you can avoid a duplicate.
{% endstep %}

{% step %}

### Submit

Click **Request Supplier**. The supplier appears in your supplier list as Requested. Silkline emails the [Supplier Request Approver](#require-one-approver) if one is set, or otherwise the team members with the **Edit Supplier Request** permission whose email is on one of your organization's domains.
{% endstep %}
{% endstepper %}

While a request is pending, the requester can edit it, attach more documents, or cancel it from the request page. Cancelling archives the requested supplier.

## Review supplier requests

Team members with the **Edit Supplier Request** permission review requests under **Suppliers → Requests**, which shows the number of pending requests. **Waiting on Me** lists the pending requests you decide, **Open** lists every pending request, **Resolved** lists approved, rejected, linked and cancelled ones, and **All** lists every request. With a [Supplier Request Approver](#require-one-approver) set, Waiting on Me holds that approver's requests; without one, it holds every pending request.

Suppliers you requested show in **Suppliers** with **Approval Status** Requested until they are decided. The email Silkline sends when your request is decided links to its request page.

Team members with the **Edit Supplier Request** permission can act on a pending request. **Reject** and **Approve** sit at the top right of the request page, and **Edit** and **Start Evaluation** sit beside the page title:

<table><thead><tr><th width="191">Action</th><th>Result</th></tr></thead><tbody><tr><td>Approve</td><td>Choose <strong>Approve</strong>, or <strong>Approve with note</strong> from its menu to add a note for the requester. The supplier moves to <strong>Evaluation</strong> approval status and the request closes as Approved. Silkline screens the supplier against the denied party list and emails the requester.</td></tr><tr><td>Reject</td><td>Asks for a reason, archives the requested supplier, and emails the requester the reason.</td></tr><tr><td>Link to Supplier</td><td>In the <strong>Approve</strong> menu. When the request duplicates an existing supplier, merges the requested supplier into it and closes the request as Linked. Silkline emails the requester the supplier it was linked to. Requires the <a href="https://docs.silkline.ai/administration-tools/merging-records.md">Execute record merge</a> permission.</td></tr><tr><td>Edit</td><td>Corrects the supplier name, website, contact or reason, and attaches more documents.</td></tr><tr><td>Start Evaluation</td><td>Starts a <a href="https://docs.silkline.ai/suppliers/supplier-evaluations.md">supplier evaluation</a> for the requested supplier. Requires the evaluation permissions.</td></tr></tbody></table>

The **Approval** section of a request page shows each step as a card: who requested the supplier, when and why; who started an evaluation and when, if one was started; then who is reviewing the request, or who decided it, when, the outcome and any note.

Every step is also recorded in the supplier's activity: the request being filed, an evaluation starting, approvals and rejections with their note, and cancellations on the requested supplier, and links on the existing supplier the request was linked to. On a wide screen that activity sits beside the request, where you can discuss the request with @mentions; on a narrower screen, click **Activity** to open it. A linked request shows the activity of the supplier it was linked to, which holds its requested and evaluation steps and its notes, and **View Supplier** opens that supplier.

### Require one approver

By default, anyone with the **Edit Supplier Request** permission can approve, reject or link a request. To route every decision to one person, open **Organization Settings → Suppliers** and choose a **Supplier request approver** from the active team members who have that permission. Only that team member can then approve, reject or link, including requests they filed themselves, and only they are emailed about new requests.

A change of approver applies to requests that are already pending. Silkline emails the new approver one summary of the pending requests, or emails everyone with the **Edit Supplier Request** permission when you clear the setting.

{% hint style="warning" %}
If the approver is later archived or loses the **Edit Supplier Request** permission, nobody can decide pending requests until you choose another approver or clear the setting. The setting and each pending request show a warning while this is the case.
{% endhint %}

## Requested suppliers

A requested supplier behaves like any other supplier, with these differences:

* **Approval status.** Requested is set only by a supplier request and cannot be chosen when editing a supplier.
* **Purchase orders.** An order whose supplier is requested fails the **No Requested Suppliers** validation check. The check clears when the supplier request is approved or the order uses a different supplier. When requesting approval, users can choose **Proceed Anyway** unless **Block actions when validation errors exist** is on; users with the **Edit Organization Settings** permission can always proceed.
* **Supplier Request section.** The supplier page shows the request next to its approval status: the request's status, the requester and reason, the approver while it is pending or the decision and its note once decided, and a link to the request page.

## Permissions

<table><thead><tr><th width="232">Permission</th><th>Allows</th></tr></thead><tbody><tr><td>Create Supplier Request</td><td>Request a supplier, attach documents to it, and edit or cancel your own pending requests.</td></tr><tr><td>Edit Supplier Request</td><td>Edit, approve and reject supplier requests.</td></tr></tbody></table>
