Vendor Application Overview

1. Purpose

The Vendor Application feature enables producers to formally onboard as vendors within the marketplace.
It replaces manual approval processes by directly integrating with the Jumpseller API, allowing automatic seller creation upon submission.

This ensures a fast, transparent, and traceable onboarding process aligned with Fairtrade standards.

---

2. Objectives

• Provide an intuitive form for producers to submit business and certification data.
• Guide producers through a progressive onboarding experience (with completion bar).
• Enable smooth document uploads (logo, certificates, etc.).
• Automatically create vendor profiles through the Jumpseller API.
• Maintain traceability for certifications and compliance checks.

---

3. User Roles

Role	Responsibilities
Producer	Fills in business profile, uploads certificates, submits application
System	Sends confirmation email, handles uploads, integrates with Jumpseller API

---

4. User Flow Diagram

┌──────────────────────────┐
│ Producer accesses Vendor │
│ Application page         │
└────────────┬─────────────┘
             ↓
Fills in business details
             ↓
Uploads logo + certification
             ↓
Progress bar updates (50%, 75%, etc.)
             ↓
Clicks “Submit Application”
             ↓
┌──────────────────────────┐
│ System validates input   │
│ and sends data to API    │
│ → Jumpseller Vendor Created │
└────────────┬─────────────┘
             ↓
Email confirmation sent to producer

---

5. Application States

State	Description	Trigger
Draft	Producer is filling out the form	Auto-save or manual draft
Submitted	Data sent to Jumpseller API	User submits form

---

6. Core Form Fields

Field	Type	Validation	Description
Business Name	Text	Required, min 3 chars	Official vendor name
Country	Dropdown	Required	ISO country list
Description / Story	Text area	Optional, max 2000 chars	Brand’s story
Contact Email	Email	Required, valid format	Used for communication
Logo	File upload	Optional, JPG/PNG max 2MB	Company logo
Fairtrade Certificate	File upload	Required, PDF/JPG max 10MB	Proof of certification
Supporting Documents	File upload	Optional	Additional documentation
Social Impact	Text area	Optional	Highlights environmental or social initiatives

---

7. Notifications

Event	Email Subject	Recipient	Purpose
Submission	“We’ve received your vendor application”	Producer	Confirms submission and next steps