---
module: claims.vendors
title: Vendors
tab: Testing
order: 35
audience: dev
---

Frontend test checklist for the **Vendor Registry** (`claims.bcos.dev`). Click through in the UI and mark each row Pass or Fail.

## Set up
Log in at **claims.bcos.dev** — test accounts (all password `Passw0rd-d3v!`):

| Login | Role | Sees |
|-------|------|------|
| `bcos_a@bcos.dev` | Admin | All institutions |
| `msp_a@msp1.bcos.dev` | MSP admin | C1 + C2 |
| `customer_a@customer1.bcos.dev` | Customer | C1 only |

Vendors are the CIT / SP companies you register per institution — there are no simulator devices for this screen.

## What to test

| # | Do this | ✅ Pass if |
|---|---------|-----------|
| 1 | As `msp_a`, open **Vendors** | Page loads with header **Vendor Registry**, a **{n} vendors** count, and two sections: **CIT — Cash-in-Transit** and **SP — Service Provider**, each with its own count |
| 2 | Click **+ Add Vendor** in the toolbar | A panel slides in **from the right** with fields **Vendor Name\***, **Type** (CIT / SP), **Contact Name**, **Contact Email**, **Contact Phone** |
| 3 | Fill Name `Acme CIT`, Type **CIT**, add contact/email/phone → **Add Vendor** | Success toast **"Acme CIT registered successfully"**, panel closes, and the new row appears in the **CIT** table with its details |
| 4 | Click **+ Add Vendor** again, Type **SP**, submit | New vendor appears under the **SP** section (not CIT), and the **SP** count goes up by one |
| 5 | Open the panel, leave **Vendor Name** blank, click **Add Vendor** | Inline error **"Vendor name is required"** under Name, and nothing is saved |
| 6 | Type an invalid email like `nope` into **Contact Email**, submit | Inline error **"Enter a valid email address"** and the submit is blocked (an empty email is allowed) |
| 7 | Add a vendor with **only** Name + Type (no contact fields) | Its **Contact / Email / Phone** cells show a dash **(—)**, not blank or an error |
| 8 | Look at any existing vendor row | There is **no edit and no delete** control — once added, a vendor can't be changed from the UI (this is expected, not a bug) |
| 9 | Log in as `customer_a`, open **Vendors** | The **+ Add Vendor** button is **still shown** (customers can add here), and you see **only your own institution's** vendors — there is no "all institutions" list |

**Report a fail with:** the row #, which login you used, and what you actually saw.