> For the complete documentation index, see [llms.txt](https://help.fairmarkit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.fairmarkit.com/product-guides/supplier-management.md).

# Supplier Management

Supplier Management gives you a central directory to manage all your suppliers in one place — independent of any specific event or request.

### Overview

Supplier Management gives you a central directory to manage all your suppliers in one place — independent of any specific event or request. Add suppliers individually or in bulk, organise them into groups, and view a full history of changes per supplier.

**Where to find it:** Top navigation  → Suppliers&#x20;

### Who can use it

| Role                         | View suppliers | Add / edit | Bulk import | Activate / deactivate | Manage groups |
| ---------------------------- | -------------- | ---------- | ----------- | --------------------- | ------------- |
| **Platform Admin**           | ✓              | ✓          | ✓           | ✓                     | ✓             |
| **Buyer**                    | ✓              | ✓          | ✓           | ✓                     | ✓             |
| **Observer**                 | ✓              | ✗          | ✗           | ✗                     | ✗             |
| **Requester / Collaborator** | ✗              | ✗          | ✗           | ✗                     | ✗             |

***

### Supplier directory

The **Suppliers** page lists all suppliers in your organisation. From here you can search, filter, add new suppliers, and take bulk actions.

#### Search and filter

* Use the **search bar** to find suppliers by name, email, or External ID.
* Use the **Status filter** to show Active or Inactive suppliers only.
* Use the **Group filter** to show suppliers belonging to a specific group.
* Use the **Created by filter** to show suppliers added by a specific user.

#### Supplier statuses

| Status       | Meaning                                                                               |
| ------------ | ------------------------------------------------------------------------------------- |
| **Active**   | Supplier is available to be invited to events                                         |
| **Inactive** | Supplier is deactivated — not available for event invitations but record is preserved |

***

### Adding a single supplier

1. Go to **Top Navigation → Suppliers**.
2. Click **+ Add supplier** in the top-right corner.
3. Search for the supplier first — the system checks for existing records by name and External ID to prevent duplicates.
4. If no match is found, fill in the supplier details:

| Field         | Required | Description                                                        |
| ------------- | -------- | ------------------------------------------------------------------ |
| Supplier name | Yes      | Legal or display name of the supplier                              |
| Email         | Yes      | Primary contact email — must be a valid email address              |
| External ID   | No       | Identifier from your ERP system — must be linked to a specific ERP |
| Contact name  | No       | Name of the individual point of contact                            |
| Phone         | No       | Contact phone number                                               |
| Address       | No       | Mailing or business address                                        |
| Groups        | No       | Assign to one or more supplier groups                              |

5. Click **Save**. The supplier is created with **Active** status and appears at the top of the list.

{% hint style="info" %}
The same Add Supplier form is used when inviting suppliers directly from an event. Any supplier you add there is also saved to the central directory.
{% endhint %}

{% hint style="warning" %}
External IDs must always be linked to a specific ERP system. A standalone External ID without an ERP reference cannot be saved.
{% endhint %}

***

### Editing a supplier

1. Find the supplier in the list.
2. Click the kebab menu (⋮) on their row and select **Edit**, or click the supplier name to open their detail page and click **Edit** there.
3. Update the fields as needed.
4. Click **Save**. A "Details updated" entry is added to the supplier's activity log showing which fields changed.

***

### Activating and deactivating suppliers

Deactivating a supplier prevents them from being invited to new events. Their record, history, and past event participation are fully preserved. You can reactivate them at any time.

#### Single supplier

1. Click the kebab menu (⋮) on the supplier's row.
2. Select **Deactivate** or **Activate**.
3. Confirm the action.

#### Bulk activate / deactivate

1. Select multiple suppliers using the checkboxes on the left of each row.
2. Click **Deactivate** or **Activate** in the bulk action bar that appears at the bottom of the screen.
3. Confirm the action.

***

### Bulk import via CSV

Use bulk import to onboard or update large numbers of suppliers at once from a spreadsheet or ERP export.

#### Step 1 — Download the template

Click **Download template** on the Suppliers page to get `suppliers_template.csv`. The template includes all supported columns and one example row.

**Supported columns:**

| Column         | Required | Description                                            |
| -------------- | -------- | ------------------------------------------------------ |
| `name`         | Yes      | Supplier legal or display name                         |
| `email`        | Yes      | Primary contact email — used to match existing records |
| `external_id`  | No       | ERP system identifier                                  |
| `contact_name` | No       | Name of the point of contact                           |
| `phone`        | No       | Contact phone number                                   |
| `address`      | No       | Mailing or business address                            |

#### Step 2 — Upload your file

1. Click **Import suppliers** on the Suppliers page.
2. Drag and drop your CSV file, or click to browse and select it.

#### Step 3 — Review the preview

Before anything is saved, every row is validated and classified:

| Classification | What it means                                                        |
| -------------- | -------------------------------------------------------------------- |
| ✅ **Create**   | Email not found in the system — a new supplier will be created       |
| 🔄 **Update**  | Email matches an existing supplier — their record will be updated    |
| ❌ **Error**    | Missing name or email, or invalid email format — row will be skipped |

A summary strip shows the total count of each classification. Review any errors before proceeding — error rows are skipped and do not block the rest of the import.

#### Step 4 — Confirm

Click **Confirm import**. The system creates and updates all valid rows, skips error rows, and shows a completion summary — for example: *"12 created, 3 updated, 1 skipped"*.

Each affected supplier receives an entry in their activity log referencing the import file name.

{% hint style="success" %}
Re-running an import with the same file is safe. Rows where nothing has changed are treated as an Update with identical values — no duplicates are created.
{% endhint %}

{% hint style="info" %}
Rows with duplicate emails within the same file are handled last-row-wins — the final row for a given email address is the one that is saved.
{% endhint %}

***

### Supplier groups

Supplier groups let you organise suppliers into named lists for easier management and faster event setup. Groups are flat — there is no nesting.

#### Create a group

1. Go to **Top Nav → Suppliers → Supplier Groups**.
2. Click **+ Create group**.
3. Enter a **Group name** (required) and an optional **Description**.
4. Use the member picker to add suppliers to the group at creation time.
5. Click **Save**.

#### Add suppliers to a group

**From the group detail page:**

1. Open the group by clicking its name.
2. Click **+ Add suppliers** and search for the suppliers you want to add.

**Bulk assignment from the supplier list:**

1. Select multiple suppliers using the checkboxes.
2. Click **Add to group** in the bulk action bar.
3. Select the target group and confirm.

#### Remove a supplier from a group

1. Open the group detail page.
2. Find the supplier in the member list.
3. Click the remove icon next to their name.

#### Edit or delete a group

Open the group detail page and click **Edit** or **Delete** from the action menu.

{% hint style="info" %}
Deleting a group removes the group association from all its members but does not delete the supplier records themselves.
{% endhint %}

#### Group membership rules

* A supplier can belong to any number of groups.
* Groups are flat — no nested groups or subgroups.
* Removing a supplier from all groups does not deactivate them.

***

### Supplier detail page

Click any supplier's name to open their detail page. This shows:

* **Contact information** — name, email, phone, address, External IDs, and group memberships

***

### Frequently asked questions

**I tried to add a supplier and the system found a possible duplicate — what should I do?** Review the existing record shown in the duplicate warning. If it is the same supplier, click **Edit existing** to update their details rather than creating a second record. If it is a different supplier, proceed with creating a new one.

**Can I delete a supplier?** No — suppliers cannot be deleted. Deactivate the supplier instead. Their record, activity history, and past event participation are fully preserved and can be reactivated at any time.

**What happens to open events if I deactivate a supplier?** The supplier's existing bids and event participation are not affected. They simply cannot be invited to new events while inactive.

**Can I add a supplier without an email address?** No — email is required. It is used as the primary identifier for the supplier record and as the match key during bulk imports.

**Can I import suppliers without an External ID?** Yes — External ID is optional. You only need it if you are mapping suppliers to records in your ERP system.

**I ran an import and one of my rows was skipped — how do I find out why?** After import, the completion summary shows how many rows were skipped. Download the error report from the summary screen to see each skipped row with the specific reason — missing name, invalid email format, etc.

**Does adding a supplier in the Administration directory automatically invite them to events?** No. Adding a supplier to the directory makes them available to invite. You still invite them explicitly from each event's Suppliers tab.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.fairmarkit.com/product-guides/supplier-management.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
