StorePeriod

A StorePeriod defines a named time window used to categorize warehouse inventory and contracts by when goods were stored or produced. In agricultural and commodity trading contexts, a storage period typically corresponds to a harvest season, a marketing year, or a fiscal quarter — for example "Harvest 2024" or "Q1 2025". This temporal categorization is fundamental for inventory management: goods from different periods can carry different prices, quality grades, certifications, or traceability requirements, even if they are physically the same commodity sitting in the same warehouse.

StorePeriods are referenced on contracts and contract positions to clearly communicate under which temporal frame the agreed quantities are expected. They also serve as a key filter dimension in reporting and stock accounting — the total incoming volume of a commodity in a given harvest year is a meaningful business metric, whereas a total without a period reference may inadvertently mix incompatible batches. By defining StorePeriods as managed master data rather than free-text date fields, the system ensures consistent grouping and comparability across all users, modules, and processes.