Supplier APIs¶
Why This Exists¶
This document defines API responsibilities for the Supplier Domain.
It does not define implementation code or final OpenAPI specifications.
Owner¶
The owner is the Chief Product Officer and Enterprise Architect.
Business Value¶
Supplier APIs expose governed supplier profile, relationship, quote, performance, rating, review, and trust behavior.
API Groups¶
| API group | Responsibilities | Example endpoints |
|---|---|---|
| Supplier Profile API | Create and manage supplier profiles. | POST /suppliers, GET /suppliers/{supplierId} |
| Supplier Capability API | Manage supplier capabilities. | POST /suppliers/{id}/capabilities |
| Supplier Relationship API | Manage customer-supplier relationships. | POST /organizations/{organizationId}/supplier-relationships |
| Supplier Quote API | Manage quote requests and responses. | POST /suppliers/{id}/quotes |
| Supplier Performance API | Record supplier performance. | POST /suppliers/{id}/performance |
| Rating and Review API | Manage ratings and reviews. | POST /suppliers/{id}/ratings, POST /suppliers/{id}/reviews |
| Supplier Trust API | Read and update governed trust state. | GET /suppliers/{id}/trust |
| Preferred Supplier API | Manage preferred supplier relationships. | POST /organizations/{organizationId}/preferred-suppliers |
API Principles¶
- APIs must not mutate Organization, Marketplace, Contract, or Intelligence source facts.
- APIs must preserve source context for quotes, performance, ratings, and reviews.
- APIs must enforce relationship-specific preferred supplier rules.
- APIs must publish supplier events for meaningful state changes.