Working with Seed Parameters 🌱

Overview

The Seed Parameters domain provides a comprehensive system for managing agronomic and phenotypic characteristics of seeds. This domain enables organizations to define, categorize, and track various seed characteristics such as maturity groups, disease resistance, calibration parameters, and other attributes across different crops and locations.

Seed parameters act as templates or definitions that can be assigned to individual seeds. Once a parameter is created (e.g., "Maturity Group"), it can be associated with multiple seeds, each having their own specific value for that parameter. This relationship between seed parameters and seed varieties allows for flexible and standardized characteristic tracking across the entire seed catalog.

Cardinality summary

• Seed Parameter ➜ 1..* Localized Crops (crop-location associations)
• Seed Parameter ➜ 0..* Parameter Ranges (predefined value ranges)
• Seed Parameter ➜ 0..* Seeds (many-to-many relationship through parameter values)

Seed Parameter
├── Localized Crops (1..*)
├── Parameter Ranges (0..*)
└── Seeds (0..*)

Key Concepts

Understanding Seed Parameter Interactions

Seed parameters have two key types of relationships:

1. Parameter ↔ Localized Crop Association (Definition Level)

   • When you create a parameter, you define which crop-location combinations it applies to
   • This determines the scope and availability of the parameter
   • Example: A "Maturity Group" parameter is defined for Corn in US, BR, and FR
   • Managed through: POST/PUT /v2/catalog/seeds/parameter endpoints

2. Parameter ↔ Seed Variety Relationship (Value Assignment Level)

   • After parameters are defined, you assign specific values to individual seeds
   • This creates the actual characteristic data for each seed
   • Example: Seed "Pioneer P1234" (Corn/US) gets assigned "Maturity Group: III"
   • Managed through: POST /v2/catalog/seeds/relationship endpoints

API Documentation

For complete API reference including request/response schemas, authentication, and interactive testing, visit:

📚 Seed Parameters API Documentation - Interactive API documentation with request/response examples

Available Endpoints

Important: You must first create a parameter and associate it with localized crops before you can assign values to seed varieties. The seed variety must also belong to one of the localized crops associated with the parameter.

Business Rules

Localized Crop Association (Parameter Definition)

Each seed parameter must be associated with at least one localized crop when created, to define the scope and availability of the parameter, which crop-location combinations can use it

Parameter Ranges

Parameters can define predefined value ranges to standardize data entry:

• Ranges are optional but provide value consistency when used
• Each range must have a sequence number for ordering
• Range types (BIT, TEXT, NUMERICAL) should align with parameter type
• Range values can include optional descriptions for clarification

Seed-Parameter Relationships (Value Assignment)

Managing the assignment of specific parameter values to individual seeds:

• Purpose: Assigns actual characteristic values to individual seeds (e.g., "Maturity Group: III" for Pioneer P1234)
• Prerequisites before creating a relationship:
  1. The parameter must exist and be defined
  2. The parameter must be associated with at least one localized crop
  3. The seed variety must exist
  4. The seed variety must belong to a localized crop that the parameter is associated with

Error Codes

Seed Parameter Errors

Typical Workflows

Basic Seed Parameter Management

1. Create Seed Parameter - Define new agronomic or phenotypic characteristics with categories, types, and optional ranges
2. Update Seed Parameter - Modify parameter properties like name, category, description, or associated crops
3. Retrieve Seed Parameter - Get parameter details including ranges and localized crop associations
4. List Seed Parameters - Query parameters by crop, location, category, or other filters
5. Delete Seed Parameter - Soft delete parameters no longer in use

Seed-Parameter Relationship Management

• Bulk Assignment - Create multiple parameter assignments for seed varieties in a single operation
• Value Assignment - Assign specific values to seed-parameter relationships (e.g., "Maturity Group: III")
• Metadata Tracking - Include source, pest information, rating year, and display order
• Multi-Status Response - Receive detailed status for each relationship in bulk operations
• Relationship Deletion - Remove parameter assignments from seed varieties when no longer applicable
• Data Validation - System validates that both seed variety and parameter exist before creating relationships

Search and Filtering

• Location-Based Search - Find parameters available for specific countries through localized crops
• Crop Association - Filter parameters by crop type
• Category Filtering - Query parameters by category (e.g., all disease rating parameters)
• Source Filtering - Filter by data source organization (AHDB, ARVALIS, CTPS/GEVES, etc.)

Next Steps

After creating your seed parameters, you can:

1. Working with Seeds →
2. Working with Crops →
3. Managing Growth Scales →