> ## Documentation Index
> Fetch the complete documentation index at: https://docs.seloria.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing Suppliers

> Add, edit, search, and remove suppliers in your organization's supplier directory

The supplier directory is the single source of truth for every vendor your organization works with. Open it from **Suppliers** in the sidebar.

## The supplier directory

The directory shows every supplier in your organization with a KPI strip at the top: **Total**, **Active**, **PO Spend** (calculated from issued purchase orders in your base currency), and **Avg. Rating** (from supplier evaluations). Click **Total** or **Active** to filter the table by status.

Each row shows the company, primary contact, location, rating, number of purchase orders, total spend, and status (**Active**, **Inactive**, or **Suspended**). Click any row to open the supplier's detail page.

### Search and filters

* Use the **search box** to filter by company name, contact, email, or location.
* Each column header has a filter icon to filter by specific values and sort ascending or descending.
* Click **Clear filters** to reset everything at once.
* Use the column manager to show, hide, or reorder columns, and the table toggles to switch width, gridlines, and a sticky header.

## Adding a supplier

Only users with the **Buyer**, **PM**, or **Admin** role can create, edit, or delete suppliers.

1. Click **Add Supplier** on the directory page.
2. Complete the form, organized in five tabs:
   * **Basic**: company name (the only required field), location, website, address, and tax ID.
   * **Contacts**: add one or more contact people, each with name, email, phone, role (Sales, Operations, Procurement, etc.), and a **notification language** (Spanish or English) that controls the language of emails Seloria sends that contact, such as RFQ invitations. Mark exactly one contact as the **primary contact** — the primary contact must have a name.
   * **Categories**: select at least one procurement category (MEP, HVAC, and so on). Categories are managed by your organization in Settings.
   * **Commercial**: payment terms (defaults to Net 30), currency (defaults to USD), minimum order, and delivery time.
   * **Certifications**: tick the supplier's accreditations (ISO 9001, ISO 45001, etc.) and add free-text notes.
3. Click **Save**. The supplier is created with **Active** status and you return to the directory.

If anything is missing — for example, no category selected or an invalid email — Seloria jumps to the tab with the first error and highlights it.

## The supplier detail page

The detail page opens with a KPI strip showing **real spend**, **POs**, **RFQs** the supplier was invited to, **evaluations** received, and the average **rating** (when at least one evaluation exists). Below, six tabs:

* **Overview**: basic information, contacts, categories, commercial terms, certifications, and notes at a glance.
* **Commercial**: payment terms, currency, minimum order, and delivery time in detail.
* **Contacts**: the full contact list with roles, notification language, and clickable email and phone links.
* **Activity**: a chronological table of every RFQ the supplier was invited to, every quotation they submitted (including revisions), and every purchase order issued to them — each linked to its record.
* **Documents**: upload and manage files attached to the supplier, such as trade licenses or insurance certificates.
* **Evaluations**: rating summary and the history of performance evaluations.

## Editing a supplier

1. Open the supplier and click **Edit**.
2. Update fields directly on the **Overview** tab (name, contact, email, phone, website, location, notes) or the **Commercial** tab (payment terms, currency, minimum order, delivery time).
3. Click **Save** to apply your changes, or **Cancel** to discard them.

## Deleting a supplier

1. Open the supplier and click **Delete** (also available from the row menu in the directory).
2. Confirm in the dialog.

Deletion is **permanent and cannot be undone**, so use it only for records created by mistake. The supplier's status badge distinguishes active from inactive vendors in day-to-day work.