Working with Seed Registrations π
Overview
The Seed Registrations domain provides a comprehensive system for managing regulatory approvals and certifications of commercial seeds. This domain enables organizations to track registration status, approval dates, expiration dates, and compliance requirements for seeds across different markets and regulatory jurisdictions.
Cardinality summary
- Seed Registration β 1 Seed (seed product association)
- Seed β 0..* Seed Registrations (multiple registrations per seed)
Seed Registration
βββ Seed (1)
Key Concepts
| Concept | Description |
|---|---|
| Seed Registration | Regulatory approval or certification for a seed product in a specific market |
| Registration Number | Unique identifier assigned by the regulatory authority |
| Registration Status | Current state of the registration (Application, Registered, Expired, etc.) |
| Registration Source | Regulatory authority or organization that issued the registration |
| Registration Date | Date when the registration was officially granted |
| Expiration Date | Date when the registration expires and renewal is required |
| Market Extension Date | Date when the seed can be commercially marketed or sold |
| Seed Variety | The specific seed product associated with this registration |
API Documentation
For complete API reference including request/response schemas, authentication, and interactive testing, visit:
π Seed Registrations API Documentation - Interactive API documentation with request/response examples
Seed Registration Endpoints
| Method | Endpoint | Description |
|---|---|---|
| POST | /v2/catalog/seeds/registration | Create a new seed registration with regulatory approval details |
| GET | /v2/catalog/seeds/registration/{id} | Get a specific seed registration by UUID |
| PUT | /v2/catalog/seeds/registration/{id} | Update an existing seed registration's status, dates, or registration number |
| DELETE | /v2/catalog/seeds/registration/{id} | Soft delete a seed registration by UUID |
| POST | /v2/catalog/seeds/registration/query | Advanced search for seed registrations with filtering and pagination |
Business Rules
Seed Association
Each seed registration must be associated with a valid seed:
- Registration must reference an existing seed ID
- A seed can have multiple registrations for different markets or purposes
- Registration lifecycle is independent of the seed lifecycle
Registration Status Lifecycle
Registrations follow a defined status lifecycle:
- Application - Initial application submitted to regulatory authority
- Registered - Registration approved and active
- Expired - Registration period has ended
- Rejected - Application denied by regulatory authority
- Surrendered - Registration voluntarily given up by holder
- Terminated - Registration ended by regulatory authority
- Withdrawn - Application withdrawn before approval
Date Management
Registration dates must follow logical constraints:
- Registration date should precede or equal the market extension date
- Expiration date defines the validity period of the registration
- All dates are optional to accommodate different registration stages
Registration Source
Registrations can originate from various regulatory authorities:
- CTPS/GEVES - French regulatory authority
- ARVALIS - French agricultural institute
- AHDB - Agriculture and Horticulture Development Board (UK)
- GOV/UK - UK Government
- COBOROU/PL - Polish regulatory authority
- BUNDESSORTENAMT/DE - German Federal Plant Variety Office
- AGROSCOPE/CH - Swiss agricultural research center
Error Codes
Seed Registration Errors
| Code | Message | HTTP Status | When Triggered |
|---|---|---|---|
| ECSR001 | Seed Registration with registration number {id} does not exist | 404 NOT_FOUND | Requested seed registration ID not found during GET, UPDATE, or DELETE operations |
Typical Workflows
Basic Seed Registration Management
- Create Seed Registration - Submit new regulatory approval record with status, dates, and source authority
- Update Seed Registration - Modify registration properties such as status, dates, or registration number
- Retrieve Seed Registration - Get registration details including associated seed information
- List Seed Registrations - Query registrations by status, source, or date ranges
- Delete Seed Registration - Soft delete registrations no longer applicable
Status Tracking
- Application Monitoring - Track registrations in Application status awaiting approval
- Active Registrations - Monitor Registered status seeds available for market
- Expiration Management - Identify registrations approaching or past expiration date
- Status Transitions - Update registration status as it progresses through lifecycle
Search and Filtering
- Status-Based Search - Find all registrations by status (e.g., all Expired registrations)
- Source Filtering - Query registrations by regulatory authority
- Date Range Queries - Filter by expiration date range or market extension date range
- Seed Association - Retrieve all registrations for a specific seed product
Next Steps
After creating your seed registrations, you can: