Cropwise
powered by syngenta

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

ConceptDescription
Seed RegistrationRegulatory approval or certification for a seed product in a specific market
Registration NumberUnique identifier assigned by the regulatory authority
Registration StatusCurrent state of the registration (Application, Registered, Expired, etc.)
Registration SourceRegulatory authority or organization that issued the registration
Registration DateDate when the registration was officially granted
Expiration DateDate when the registration expires and renewal is required
Market Extension DateDate when the seed can be commercially marketed or sold
Seed VarietyThe 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

MethodEndpointDescription
POST/v2/catalog/seeds/registrationCreate 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/queryAdvanced 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

CodeMessageHTTP StatusWhen Triggered
ECSR001Seed Registration with registration number {id} does not exist404 NOT_FOUNDRequested seed registration ID not found during GET, UPDATE, or DELETE operations

Typical Workflows

Basic Seed Registration Management

  1. Create Seed Registration - Submit new regulatory approval record with status, dates, and source authority
  2. Update Seed Registration - Modify registration properties such as status, dates, or registration number
  3. Retrieve Seed Registration - Get registration details including associated seed information
  4. List Seed Registrations - Query registrations by status, source, or date ranges
  5. 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:

  1. Working with Seeds β†’
  2. Working with Seed Parameters β†’
  3. Working with Crops β†’