Overview
# Vendor Management — Master End-to-End Lifecycle (Overview)

> **Audience:** placta end-users, their managers, and leaders.
> **Purpose:** A single-glance view of the entire vendor lifecycle — from registration through qualification, audit, approval, and post-qualification states.
> **Use this when:** introducing someone to how vendor management works in placta, or when a manager needs to see the "big picture" before drilling into a specific stage.
## Mermaid source (editable)
Copy this block into any Mermaid-compatible viewer (GitHub, Mermaid Live Editor, draw.io with Mermaid plugin) to edit and re-render:
```mermaid
%% Vendor Management — Master End-to-End Lifecycle Overview (16:9, 3-level)
%% Audience: placta end-users, managers, and leaders
flowchart TB
subgraph L1["VENDOR ONBOARDING AND ACTIVATION"]
direction LR
S1["<b>1. VENDOR REGISTRATION</b><br/><br/>Add Vendor<br/>(Site, Materials, Documents,<br/>Terms and Conditions,<br/>Manufacturer if Trader)<br/><br/><i>Role: Purchase Department</i>"]
S2["<b>2. ACCOUNTS ENTRY</b><br/><br/>Accounts user logs in<br/>Enters account details<br/>(bank, payment terms)<br/>Clicks checkbox and submits<br/><br/><i>Role: Accounts Department</i>"]
S3["<b>3. ACTIVATION REVIEW</b><br/><br/>Activation Approver reviews<br/>Approves or Rejects<br/><br/>Reject -> back to Registration<br/>Approve -> proceed to Qual Init<br/><br/><i>Role: Vendor Onboard<br/>Activate Approver</i>"]
S1 --> S2 --> S3
end
subgraph L2["QUALIFICATION LIFECYCLE"]
direction LR
S4["<b>4. QUALIFICATION INITIATION</b><br/><br/>Initiator clicks Start Qualification<br/>Fills metadata<br/>Assigns approvers<br/>Submits<br/><br/><i>API: vendor/initiate_<br/>vendor_qualification</i>"]
S5["<b>5. PRE-ASSESSMENT</b><br/><br/>Coordinator assigns forms<br/>Input Provider fills data<br/>(electronic signature + IP +<br/>timestamp auto-recorded)<br/>Reviewer reviews<br/>Form Sign-Off approves<br/><br/><i>Status -> Complete</i>"]
S6["<b>6. ASSESSMENTS</b><br/><br/><b>With forms:</b><br/>Coordinator assigns access<br/>Input Provider / External Vendor<br/>Reviewer -> Sign-Off<br/>(reject-back-to-previous)<br/><br/><b>Without forms:</b><br/>Input Provider uploads docs<br/>Reviewer approves or rejects<br/><br/><i>Status -> Completed</i>"]
S7["<b>7. AUDIT FLOW</b><br/><br/>Initiator starts audit<br/>Coordinator assigns audit forms<br/>Input Provider fills<br/>Coordinator submits for review<br/>Reviewer approves<br/>Approver certifies<br/><br/><i>Status -> Audit Completed</i>"]
S8["<b>8. QUALIFICATION APPROVAL</b><br/><br/>Coordinator: Pre-Req Done<br/>Submit for Review or Reject<br/><br/>Qualification Reviewer:<br/>Approve / Reject (comments)<br/><br/>Final Approver:<br/>Mark Qualified / Reject<br/><br/><i>Status -> Qualified<br/>Final Report auto-generated</i>"]
S9["<b>9. POST-QUALIFICATION</b><br/><br/><b>Monitor:</b> periodic audits<br/><b>Requalify:</b> on date triggers<br/><b>Suspend:</b> Coord -> Reviewer<br/>-> Final Approver<br/><b>Delete:</b> remove qualification<br/><br/><i>Loops back to Stage 4</i>"]
S4 --> S5 --> S6 --> S7 --> S8 --> S9
end
L1 --> L2
classDef stage fill:#e6f4ff,stroke:#1677ff,stroke-width:3px,color:#000,font-size:18px,padding:18px
class S1,S2,S3,S4,S5,S6,S7,S8,S9 stage
```
## Stage-by-stage narrative
### 1. Vendor Registration (Purchase Department)
A new vendor record is created with sites, materials, documents, terms & conditions, and (for Traders) a disclosed manufacturer. Trader-type vendors require additional manufacturer site, material, document, and T&C entries.
### 2. Accounts Entry (Accounts Department)
After Purchase submits, the Accounts user logs in to enter account-related details (bank info, payment terms) and submits. Purchase then sends the vendor for activation.
### 3. Activation Review (Vendor Onboard Activate Approver)
Only the **Vendor Onboard Activate Approver** role can activate a vendor. On rejection, the record is sent back to Purchase with comments for correction.
### 4. Qualification Initiation (Initiator)
Once activated, the Initiator clicks **Start Qualification**, fills in qualification metadata, assigns approvers, and submits. (API: `vendor/initiate_vendor_qualification`.)
### 5. Pre-Assessment (Template-driven)
The Coordinator assigns forms. Input Providers fill data; the Reviewer reviews and either submits or returns. The Form Sign-Off user finalizes. Status becomes **Complete**. Rejection can send the form back to any previous level.
### 6. Assessments (per Workflow Visualizer sequence)
Admin-configured assessment steps run after pre-assessment completes. Two parallel paths exist:
- **With forms:** External Vendors may log in to fill their sections (only accessible fields are enabled).
- **Without forms:** Input Providers upload supporting documents and notes via the Attachments tab.
### 7. Audit Flow
Audit runs as part of the qualification if the template includes an audit step. (A standalone Audit Management module exists separately — see flowchart 03.)
### 8. Qualification Approval
The Qualification Coordinator sets **Pre-Req Done**, then submits for review. The Qualification Reviewer approves (with comments) and forwards to the Final Approver, who marks the vendor as **Qualified**. A final report is auto-generated.
### 9. Post-Qualification States
- **Monitor:** Ongoing periodic re-assessments and audit cycles.
- **Requalify:** When the requalification date arrives, the same qualification flow runs again.
- **Suspend:** Coordinator → Reviewer → Final Approver chain; qualification status becomes **Suspended**.
- **Delete:** Permanent removal of the qualification record.
## Cross-references
- Detailed onboarding & activation: [01-vendor-onboarding.md](./01-vendor-onboarding.md)
- Detailed qualification flow: [02-qualification-flow.md](./02-qualification-flow.md)
- Audit (both contexts): [03-audit-flow.md](./03-audit-flow.md)
- Reports module: [04-reports.md](./04-reports.md)
- Post-qualification states: [05-post-qualification.md](./05-post-qualification.md)
- Admin settings menu: [06-admin-settings.md](./06-admin-settings.md)
3 articles