Partially update growing_season
PATCH /obp/v7.0.0/banks/dylan-bank/dynamic-entities/growing_season/GROWING_SEASON_ID
OBPv7.0.0-dynamicEntity_patchgrowing_season_dylan-bank Roles: CanUpdateDynamicEntityRecord_growing_season(per bank) _Growing_season(dylan-bank)Dynamic-EntityDynamic
Partially update growing_season: only the fields supplied in the body are changed; others are preserved.
This is also the write path for field-level write-restricted fields (those declared with
write_role_required or an explicit write_role). Authorisation is per field present in the body:
a write-restricted field requires that field's write role, and an unrestricted field requires the entity
update role. You may change a field if (and only if) you hold the role that governs it; the request is
rejected with 403 (missing role) listing the roles you lack. There is no blanket entity-update
precondition — holding only a field's write role is sufficient to PATCH that field alone.
Records one growing season of a specific crop on a specific parcel. Because a single parcel can host multiple crops across seasons (rotation) or simultaneously (intercropping), this entity is separate from the parcel and linked to it via parcel_id. Each record captures what was grown, when, on how much area, and how much was harvested. This Dynamic Entity is part of OGCR.
Property List:
- growing_season_id: Unique internal identifier automatically assigned to each crop season record.
- parcel_id: The identifier of the parcel on which this crop was grown. Links this crop season to the parcel's geometry, ownership, and dNFT records.
- crop_id: Reference to the crop type entry in the Crop reference table. Determines commodity category and emission factor for Scope 3 calculations.
- start_date: The date the crop was sown or planted on this parcel. Used to define the growing season window for MRV alignment and corporate reporting period matching.
- end_date: The date the crop was harvested or the growing season ended. Together with season_start_date, this defines the period covered by any yield and dMRV observations for this crop instance.
- year: The calendar year in which the majority of this growing season falls. Used as a simple label for annual reporting and filtering, especially when a season spans two calendar years.
- is_cover_crop: Indicates whether this crop is grown primarily to protect or enrich the soil between main cash crop seasons, rather than for commercial harvest. Cover crops are a key carbon farming practice that can affect SOC baselines and additionality assessments.
- crop_area_ha: The area of the parcel actually planted with this crop, in hectares. This may be less than the total parcel area if part of the parcel is left as buffer strips, tracks, or planted with a different crop. Required for dMRV spatial weighting (SOC and biomass estimates are per hectare and must be scaled to area) and for Scope 3 supply shed area aggregation.
- yield_kg_per_ha: The harvested yield of this crop expressed in kilograms per hectare. This is the core denominator for emission intensity calculations under the GHG Protocol FLAG approach (e.g., kg CO2e per tonne of wheat), which agrifood companies use for Scope 3 reporting.
- yield_total_kg: Total harvested yield for this crop season on this parcel, in kilograms. Can be entered directly by the farmer or derived from yield_kg_ha × crop_area_ha. Used to report sourcing volumes in lease contracts.
- yield_source: Indicates how the yield figure was obtained, affecting the assurance level buyers can claim in CSRD or SBTi reports. Controlled vocabulary: farmer_reported, dMRV_estimated, third_party_verified.
- farming_practice: The farming management approach applied during this growing season. This is what distinguishes a carbon farming activity from a conventional baseline and drives additionality. Controlled vocabulary: conventional, no_till, reduced_till, organic, regenerative, agroforestry.
- fertiliser_use_kg_per_ha: Total nitrogen fertiliser applied during this season, in kilograms per hectare. Used to estimate N2O emissions (a potent greenhouse gas from agricultural soils), which must be subtracted from the net carbon benefit under CRCF accounting rules.
- residue_management: How crop residues (straw, stems, leaves) are handled after harvest. This directly affects soil organic carbon dynamics. Controlled vocabulary: incorporated (ploughed back in), removed (baled and sold), burned.
MethodRouting settings example:
<details>
{
"is_bank_id_exact_match":false,
"method_name":"dynamicEntityProcess",
"connector_name":"rest_vMar2019",
"bank_id_pattern":".*",
"parameters":[
{
"key":"entityName",
"value":"growing_season"
}
{
"key":"url",
"value":"http://mydomain.com/xxx"
}
]
}
</details>
User Authentication is Required. The User must be logged in. The Application must also be authenticated.
Example request body
{
"growing_season_id": "3dece208-c95c-11f0-9041-54e1adfac5b1",
"parcel_id": "3dece208-c95c-11f0-9041-54e1adfac5b1",
"crop_id": "3dece208-c95c-11f0-9041-54e1adfac5b1",
"start_date": "2026-10-15",
"end_date": "2027-07-20",
"year": 2027,
"is_cover_crop": true,
"crop_area_ha": 7.4,
"yield_kg_per_ha": 6200,
"yield_total_kg": 45880,
"yield_source": "farmer_reported",
"farming_practice": "no_till",
"fertiliser_use_kg_per_ha": 120,
"residue_management": "incorporated"
}Example success response
{
"bank_id": "dylan-bank",
"growing_season": {
"growing_season_id": "3dece208-c95c-11f0-9041-54e1adfac5b1",
"parcel_id": "3dece208-c95c-11f0-9041-54e1adfac5b1",
"crop_id": "3dece208-c95c-11f0-9041-54e1adfac5b1",
"start_date": "2026-10-15",
"end_date": "2027-07-20",
"year": 2027,
"is_cover_crop": true,
"crop_area_ha": 7.4,
"yield_kg_per_ha": 6200,
"yield_total_kg": 45880,
"yield_source": "farmer_reported",
"farming_practice": "no_till",
"fertiliser_use_kg_per_ha": 120,
"residue_management": "incorporated"
},
"metadata": {
"created": {
"at": "2026-09-30T10:12:00Z",
"user_id": "a9f2c7e1-3d4b-4a5c-8e6f-7a8b9c0d1e2f",
"on_behalf_of_user_id": "9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1"
},
"updated": {
"at": "2026-09-30T11:40:00Z",
"user_id": "9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1",
"on_behalf_of_user_id": "9ca9a7e4-6d02-40e3-a129-0b2bf89de9b1"
}
}
}Possible errors (4)
- OBP-20001: User not logged in. Authentication is required!
- OBP-20006: User is missing one or more roles:
- OBP-10001: Incorrect json format.
- OBP-50000: Unknown Error.