Overview
Procure maintains a supplier registry with capability profiles, certification records, bid history, and AI-generated performance scores. Over time, the system builds a comprehensive picture of each supplier's track record, enabling data-driven supplier selection and pre-qualification.
Registering Suppliers
Create a supplier profile with their capabilities and certifications:
curl -X POST http://localhost:8014/api/v1/suppliers \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-d '{
"name": "Gulf Technology Solutions",
"registration_number": "CR-2024-001234",
"category": "it_services",
"contact_email": "procurement@gulftech.example",
"contact_phone": "+971-2-555-0100",
"capabilities": [
"Cloud infrastructure deployment",
"Government system migration",
"Sovereign AI platform development",
"24/7 managed services"
],
"certifications": [
"ISO 27001:2022",
"SOC 2 Type II",
"CSA STAR Level 2"
]
}'Supplier Fields
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Company name (1-500 characters) |
registration_number | string | No | Commercial registration number |
category | string | No | Primary category (same as tender categories) |
contact_email | string | No | Primary contact email |
contact_phone | string | No | Primary contact phone |
capabilities | string[] | No | List of service capabilities |
certifications | string[] | No | List of held certifications |
AI Performance Scoring
Trigger an AI-generated performance score for any supplier:
curl -X POST http://localhost:8014/api/v1/suppliers/{supplier_id}/score \
-H "Authorization: Bearer $TOKEN"Response:
{
"supplier_id": "sup-001",
"overall_score": 82.5,
"breakdown": {
"bid_quality": 85.0,
"price_competitiveness": 78.0,
"delivery_reliability": 88.0,
"compliance_record": 90.0
},
"total_bids": 12,
"won_bids": 5,
"win_rate": 0.42
}Score Breakdown
| Dimension | Description |
|---|---|
bid_quality | Average quality of submitted proposals |
price_competitiveness | How competitive the supplier's pricing is relative to peers |
delivery_reliability | Track record of on-time, on-scope delivery |
compliance_record | History of meeting mandatory requirements |
The overall_score is a weighted composite of these dimensions, reflecting the supplier's general suitability for government procurement.
Browsing Suppliers
List Suppliers
Filter by category, minimum score, and search:
curl "http://localhost:8014/api/v1/suppliers?category=it_services&min_score=70&page=1&page_size=20" \
-H "Authorization: Bearer $TOKEN"Response:
{
"suppliers": [
{
"id": "sup-001",
"name": "Gulf Technology Solutions",
"registration_number": "CR-2024-001234",
"category": "it_services",
"capabilities": ["Cloud infrastructure deployment", ...],
"certifications": ["ISO 27001:2022", ...],
"overall_score": 82.5,
"total_bids": 12,
"won_bids": 5,
"created_at": "2024-01-01T00:00:00Z",
"updated_at": "2024-01-15T10:30:00Z"
}
],
"total": 15,
"page": 1,
"page_size": 20
}Query Parameters
| Parameter | Type | Description |
|---|---|---|
category | string | Filter by supplier category |
min_score | number | Minimum overall score (0-100) |
search | string | Search in supplier names |
page | integer | Page number (default: 1) |
page_size | integer | Results per page (default: 20, max: 100) |
Get Supplier Details
curl http://localhost:8014/api/v1/suppliers/{supplier_id} \
-H "Authorization: Bearer $TOKEN"Returns the full supplier profile including performance history, bid records, and score breakdown.
Updating Supplier Profiles
curl -X PUT http://localhost:8014/api/v1/suppliers/{supplier_id} \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-d '{
"capabilities": [
"Cloud infrastructure deployment",
"Government system migration",
"Sovereign AI platform development",
"24/7 managed services",
"Arabic NLP solutions"
],
"certifications": [
"ISO 27001:2022",
"SOC 2 Type II",
"CSA STAR Level 2",
"ISO 22301 Business Continuity"
]
}'Win Rate Tracking
Supplier win rates are automatically calculated as bids are evaluated and tenders are awarded. This metric provides a quick indicator of supplier competitiveness over time.
Performance History
Each supplier's profile includes a performance_history array that tracks scores and outcomes across past bids. This historical data feeds into the AI scoring model, producing more accurate overall scores as the supplier participates in more tenders.
Supplier Pre-Qualification
Use the supplier listing with min_score filtering to pre-qualify suppliers for specific tenders. For example, filtering by category=it_services&min_score=75 returns only IT service suppliers with a demonstrated track record, streamlining the invitation process for new tenders.