Cocoa beans

Lifecycle status: Candidate
Content maturity: Authored methodology
Current version: 0.1.0Last updated2026-10-20
Readiness: Review required

Methodology and translation states come from the source record; publishing this website does not change their review status.

Content languages

zh-CN · Aligned

Status, classification and source details

Readiness

Warnings methodology_not_reviewed Authored methodology is candidate guidance and still requires methodology review.

Classification mapping

CPC 3.0:01640 · narrower

Source

library/pcrs/agriculture-forestry-and-fishery-products/products-of-agriculture-horticulture-and-market-gardening/cocoa-beanssha256:21c1b00f3680…

1. Scope and Applicability

This PCR guides foreground data-package construction for cultivated cocoa beans from managed cacao production through pod harvest, pod breaking and wet-bean extraction to the fresh wet-bean farm-gate hand-off. Pod breaking and extraction are required for that reference result, including when performed by a contractor. When postharvest_extension is true, the additional route begins after this wet-bean hand-off and includes only the declared fermentation, drying, cleaning, grading and storage operations. Wet beans in pulp, fermented wet beans and dried graded beans remain separate states.

The exact platform reference identity is Cocoa beans with Production mix, at farm gate and Fresh, unprocessed produce. This candidate therefore declares fresh, unprocessed wet cocoa beans at the farm gate as the reference state. Fermented, dried or graded beans are route-specific downstream states and must not reuse the reference UUID as if their boundary metadata were identical. An extended post-harvest result must declare its gate and retain a lot-level mass and moisture conversion from the farm-gate reference state.

The scope applies to cultivated Theobroma cacao under smallholder, estate, cooperative or aggregated farm management when geography, cultivar group, production system, crop year and gate are disclosed. It covers attributable perennial establishment and productive phases, management inputs, field emissions, mature-pod harvest, pod opening, wet-bean extraction, fermentation, drying, cleaning, grading, storage, quality controls, residues, rejects and documented intended co-products. Wild collection, cocoa paste, cocoa liquor, cocoa butter, cocoa powder, chocolate, prepared foods, consumer products, retail packaging and post-gate distribution are excluded. Pod husk, pulp, sweatings, shell, dust and rejected beans are not automatically products; they remain residues or wastes unless a separate intended output and hand-off are documented.

No n.e.c. or “other” product scope is selected. The classification reference is CPC 3.0 01640, Cocoa beans.

2. Product Category Identity

Field	Value
canonical_pcr_id	`pcr.agriculture-forestry-and-fishery-products.products-of-agriculture-horticulture-and-market-gardening.cocoa-beans`
classification_refs	CPC 3.0 `01640`, Cocoa beans; mapping relation: narrower
covered_products	cultivated cocoa beans represented at the declared fresh farm-gate reference state, with an explicitly declared post-harvest route when fermented, dried or graded output is reported
excluded_products	wild-collected cocoa; cocoa paste, liquor, butter, powder, chocolate and prepared cocoa foods; cocoa pod husk, pulp, sweatings, shells, dust and rejects without an intended product hand-off; retail and consumer products
representative_product	fresh, unprocessed wet cocoa beans in pulp at the declared farm gate; fermented, dried and graded beans are separately identified route outputs
production_route	managed perennial cacao production, mature pod harvest, pod breaking and wet-bean extraction, fermentation, drying and stabilization, cleaning, grading and storage
market_state	fresh farm-gate cocoa-bean reference state, or separately declared fermented/dried/graded bean hand-off when the post-harvest extension is included

The product category identity follows the platform Cocoa beans row and does not imply identity with cocoa waste or cocoa paste. Route-specific flow cards may remain unmapped or parameterized until a distinct identity is confirmed; the reference UUID must not be copied into a changed material state.

3. Reference Flow

Field	Value
What	fresh, unprocessed wet cocoa beans in pulp at the declared farm gate
How much	1 kg
How well	Theobroma cacao genotype or cultivar group, geography, production system, crop year, wet-bean moisture basis, pulp inclusion, quality declaration and farm-gate hand-off
How long or cycle	one declared crop year and harvest season; perennial establishment, replacement and termination phases indexed and annualized to represented production years
reference_flow_link	cocoa_wet_beans_in_pulp

Field	Value
Reference amount	1
Reference product flow	Cocoa beans `3c54da37-f1ab-4b4c-8363-5c32b638005c`
Reference flow property	Mass `93a60a56-a3c8-11da-a746-0800200b9a66`
Reference unit group	Units of mass `93a60a57-a4c8-11da-a746-0800200c9a66`
Reference unit	kg
Required qualifiers	cultivar or genotype group; geography; farm, block or supplier scope; production system; crop year and harvest season; wet-bean or pod moisture basis; pulp inclusion; declared farm-gate condition; post-harvest extension flag; fermentation method and duration when included; drying method and final moisture when included; quality grade; residue, reject and intended co-product destination

The platform metadata is Production mix, at farm gate and Fresh, unprocessed produce. The reference amount is therefore not a kilogram of dried fermented beans. A post-harvest result may be normalized to 1 kg of the wet reference through measured pod-to-wet-bean and wet-bean-to-dried-bean balances, but its output card remains a distinct fermented/dried state. Tare, packaging, foreign matter, pod husk, pulp, sweatings, shells, dust, rejects and drying water loss are recorded separately.

Attribute	Candidate screening reference	Evidence
Wet-bean moisture	approximately 55–60% wet basis before fermentation; replace with lot measurement	`icco-cocoa-harvesting-post-harvest`; `icco-cocoa-processing`
Fermentation duration	approximately 4–7 days for the declared batch; method and cultivar can change duration	`fao-cocoa-ota-code`; `icco-cocoa-harvesting-post-harvest`
Dried-bean moisture	approximately 6–8% wet basis for storage screening; use measured lot result	`icco-cocoa-processing`; `icco-cocoa-quality-requirements`
Sun-drying duration	approximately 5–10 days when sun-dried; replace with actual weather and batch records	`fao-cocoa-production-guide`; `icco-global-cocoa-farming-systems`

4. Measurement and Unit Rules

rule_id	Applies to	Required property	Required unit	Rule
`measurement_01`	all cocoa states	Mass `93a60a56-a3c8-11da-a746-0800200b9a66`	kg	Record pods, wet beans in pulp, fermented wet beans, dried beans, graded beans, husk, pulp, sweatings, shells, rejects and losses on an as-received or dry-matter basis. Never mix wet and dry bases in one balance.
`measurement_02`	reference and post-harvest conversion	mass and moisture	kg; percent wet basis	Measure moisture for every conversion-critical lot. Use dry-matter conservation only when sampling basis and moisture method are documented.
`measurement_03`	perennial phases	area-time and crop-year identity	ha·year; crop year; phase	Link establishment, immature, productive, replacement and termination phases to the same block and represented crop years before annualizing.
`measurement_04`	fermentation	batch and time	batch id; day; kg	Identify method, start/end, turning, batch mass, pulp drainage and drying hand-off. Do not add fresh beans to an active batch without a new batch link.
`measurement_05`	drying and stabilization	mass, moisture, temperature and energy	kg; percent; °C; kWh, MJ, L or kg fuel	Record wet input, dry output, dryer/weather, operating time, carrier, final moisture and smoke or contamination controls.
`measurement_06`	cleaning, grading and storage	mass and lot identity	kg; lot id; day	Keep accepted grade, downgraded grade, rejected lot, shell, dust, foreign material, storage loss and final hand-off separate.
`measurement_07`	nutrients, crop protection and emissions	product and nutrient basis	kg product; kg nutrient; kg substance	Keep formulated product, nutrient or active-substance mass and emission-method inputs distinct; one method owns each pathway.
`measurement_08`	services and utilities	carrier-specific property	kWh, MJ, L, kg, m3	Preserve carrier, equipment, run or batch and original unit. Convert only with a documented factor and allocate shared services once.

5. System Boundary

The default foreground boundary starts with the managed cacao stand and declared crop year or perennial phase and ends with fresh wet beans in pulp at the farm gate. It includes attributable establishment and replacement, field management, direct field emissions, mature-pod harvest, pod breaking, separation of husk/placenta and wet-bean extraction. A fresh-pod sale or hand-off is an intermediate boundary and cannot be reported as the wet-bean reference result. Off-site or contracted extraction remains a linked operation with its input/output masses, service burdens and residues included once. The postharvest_extension flag controls fermentation and later operations only; turning it off never removes extraction. Purchased inputs use compatible upstream datasets at the actual receiving state, without also charging their included operations again.

The reference gate is the platform's fresh, unprocessed farm-gate state. Fermented, dried and graded beans are downstream route states within the extended process map, not alternative meanings of the same reference UUID. The data package must state whether the farm-gate reference stops at wet-bean hand-off or whether a post-harvest extension is reported. Roasting, grinding, alkalization, pressing, cocoa liquor, cocoa butter, cocoa powder, chocolate, prepared foods, retail and consumer use are downstream and excluded.

Boundary Abstraction

Field	Value
declared_starting_condition	managed cacao stand at the declared perennial phase and crop-year start, with planting material and purchased management inputs crossing the foreground boundary
starting_condition_role	perennial managed biological production condition
product_classification_scope	CPC 3.0 `01640`, Cocoa beans; exact platform reference identity is fresh, unprocessed cocoa beans at farm gate
recursive_input_rule	purchased cocoa beans entering post-harvest, blending or storage are separately identified lots and are not recursively traced through this PCR; cocoa paste, cocoa waste and downstream cocoa products are outside this category
upstream_dataset_requirement	reviewed upstream datasets for planting material, fertilizers, crop protection, water, energy, treatment, packaging and transport services when they cross the declared boundary
disclosure	block or supplier scope, crop year, cultivar group, production system, wet reference condition, extension flag, lot moisture, fermentation/drying records, quality grade, gate, storage, intended outputs, residues, rejects, wastewater and allocation decision

Boundary Rules

rule_id	Applies to	Rule	source_ids
`boundary_01`	managed production	Include cultivation, harvest, pod opening and wet-bean extraction through the fresh wet-bean farm-gate hand-off. Attribute establishment, replacement and termination to represented production. A pod-only hand-off cannot satisfy this reference boundary.	`fao-cocoa-production-guide`; `icco-cocoa-harvesting-post-harvest`; `iso-14044-2006`
`boundary_02`	reference gate	Treat `Cocoa beans` with `Production mix, at farm gate` and `Fresh, unprocessed produce` as the declared reference identity. Do not use the UUID for fermented, dried or graded bean states without a separate identity decision.	`iso-14044-2006`; `mass-balance-identity`
`boundary_03`	pod breaking and fermentation	Pod breaking and wet-bean extraction are required before the reference hand-off: link harvested pod mass to wet beans in pulp, husk/placenta, rejects and losses. Fermentation is additional and conditional on the declared extension; link its drainage, rejects and output separately.	`icco-cocoa-harvesting-post-harvest`; `fao-cocoa-ota-code`
`boundary_04`	drying, grading and storage	Include drying/stabilization, cleaning, grade separation and pre-gate storage only when they cross the declared extension. Record energy, moisture, storage time, contamination controls and losses.	`icco-cocoa-processing`; `icco-cocoa-quality-requirements`
`boundary_05`	upstream inputs	Treat purchased inputs, utilities, packaging, treatment and transport services as separately identified upstream inputs. Do not recurse into another cocoa PCR or silently use cocoa waste or paste as a bean input.	`iso-14044-2006`
`boundary_06`	losses and rejects	Keep field losses, damaged pods, unextracted beans, spoiled or unfermented beans, drying losses, mouldy beans, dust, shells, storage losses and rejected lots in the foreground until a documented recovery, co-product, treatment or disposal hand-off exists.	`fao-cocoa-ota-code`; `icco-cocoa-quality-requirements`; `mass-balance-identity`

6. Process Inventory Structure

Process Map

process_id	process_name	inclusion	inclusion_condition	role	quantitative_reference
`cocoa_managed_production`	Managed cacao production	required	cultivated cacao route	managed biological production	per 1 kg wet cocoa beans at farm-gate reference
`cocoa_pod_harvest`	Mature cocoa-pod harvest and collection	required	pods are removed and transferred to pod opening	harvest and collected-output hand-off	per harvested pod lot and wet reference
`cocoa_pod_breaking_extraction`	Pod breaking and wet-bean extraction	required	required to obtain the wet-bean reference, including contracted extraction	primary conditioning	per pod lot and wet reference
`cocoa_fermentation`	Cocoa-bean fermentation	conditional	fermentation precedes drying or declared dry-bean hand-off	biochemical reaction and treatment	per fermentation batch
`cocoa_drying_stabilization`	Fermented-bean drying and stabilization	conditional	sun or artificial drying precedes post-harvest gate	preservation and stabilization	per drying batch
`cocoa_cleaning_grading`	Cleaning, grading and reject routing	conditional	cleaning or grade separation precedes post-harvest gate	grading, sorting and conditioning	per grading lot
`cocoa_storage_gate`	Storage and declared gate hand-off	conditional	pre-gate storage or warehouse handling is included	stabilization and hand-off	per kg and storage day

The mode is batch-based. Every crop year, harvest lot, pod-opening run, fermentation batch, drying batch, grading lot and storage lot receives an identifier. Sequential states are not co-products: wet, fermented wet, dried and graded beans are linked by hand-offs. Shared equipment, cleaning and changeover burdens attach to the run once.

Process: Managed cacao production (`cocoa_managed_production`)

Inputs

Product flows

Cocoa planting material and replacement plants (`cocoa_planting_material`)

Record seedlings, grafted plants, cuttings and replacements by block and phase; annualize only the attributable share.

Selected flow: Cocoa planting material [unmapped]
Flow property / unit: Count or mass / plant, item or kg
Amount rule: measured purchased, planted, replaced and surviving quantity by block and phase
Value mode: Calculated value (calculated_value)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.
Normalization basis: per declared reference flow
Basis kind: Reference flow (reference_flow)
Evidence kind: Calculated from collection (calculated_from_collection)
Collection protocol: cp_cocoa_perennial_phase_records
Sources: fao-cocoa-production-guide; iso-14044-2006
Range: Provisional planting-material screening estimate
- Range role: Default estimate (default_estimate)
- Lower: 0
- Upper: 0.05
- Unit: kg planting material/kg wet reference
- Basis: annualized establishment and replacement; replace with block records
- Basis kind: Reference flow (reference_flow)
- Evidence kind: Reasoned estimate (reasoned_estimate)

Fertilizer, urea input (`cocoa_managed_production_agricultural_nutrient_inputs`)

Include this conditional card only when Fertilizer, urea is actually used in the declared process. For every other actual product or carrier, create a separate atomic exchange with its own identity and measured amount; do not infer its use from this example.

Selected flow: Fertilizer, urea
Flow property / unit: Mass / kg product
Amount rule: Measured quantity of Fertilizer, urea used by this process and period; report zero or not applicable only when the route records establish absence.
Value mode: Foreground record (foreground_record)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.
Normalization basis: per declared reference flow
Basis kind: Reference flow (reference_flow)
Evidence kind: Collected record (collected_record)
Collection protocol: cp_cocoa_nutrient_records

Fertilizer, monoammonium phosphate input (`cocoa_managed_production_agricultural_nutrient_inputs_monoammonium_phosphate`)

Include this conditional card only when Fertilizer, monoammonium phosphate is actually used in the declared process. For every other actual product or carrier, create a separate atomic exchange with its own identity and measured amount; do not infer its use from this example.

Selected flow: Fertilizer, monoammonium phosphate
Flow property / unit: Mass / kg product
Amount rule: Measured quantity of Fertilizer, monoammonium phosphate used by this process and period; report zero or not applicable only when the route records establish absence.
Value mode: Foreground record (foreground_record)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.
Normalization basis: per declared reference flow
Basis kind: Reference flow (reference_flow)
Evidence kind: Collected record (collected_record)
Collection protocol: cp_cocoa_nutrient_records

Fertilizer, potassium chloride input (`cocoa_managed_production_agricultural_nutrient_inputs_potassium_chloride`)

Include this conditional card only when Fertilizer, potassium chloride is actually used in the declared process. For every other actual product or carrier, create a separate atomic exchange with its own identity and measured amount; do not infer its use from this example.

Selected flow: Fertilizer, potassium chloride
Flow property / unit: Mass / kg product
Amount rule: Measured quantity of Fertilizer, potassium chloride used by this process and period; report zero or not applicable only when the route records establish absence.
Value mode: Foreground record (foreground_record)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.
Normalization basis: per declared reference flow
Basis kind: Reference flow (reference_flow)
Evidence kind: Collected record (collected_record)
Collection protocol: cp_cocoa_nutrient_records

Cattle manure, as applied input (`cocoa_managed_production_agricultural_nutrient_inputs_cattle_manure`)

Include this conditional card only when Cattle manure, as applied is actually used in the declared process. For every other actual product or carrier, create a separate atomic exchange with its own identity and measured amount; do not infer its use from this example.

Selected flow: Cattle manure, as applied
Flow property / unit: Mass / kg product
Amount rule: Measured quantity of Cattle manure, as applied used by this process and period; report zero or not applicable only when the route records establish absence.
Value mode: Foreground record (foreground_record)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.
Normalization basis: per declared reference flow
Basis kind: Reference flow (reference_flow)
Evidence kind: Collected record (collected_record)
Collection protocol: cp_cocoa_nutrient_records

Agricultural limestone input (`cocoa_managed_production_agricultural_nutrient_inputs_agricultural_limestone`)

Include this conditional card only when Agricultural limestone is actually used in the declared process. For every other actual product or carrier, create a separate atomic exchange with its own identity and measured amount; do not infer its use from this example.

Selected flow: Agricultural limestone
Flow property / unit: Mass / kg product
Amount rule: Measured quantity of Agricultural limestone used by this process and period; report zero or not applicable only when the route records establish absence.
Value mode: Foreground record (foreground_record)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.
Normalization basis: per declared reference flow
Basis kind: Reference flow (reference_flow)
Evidence kind: Collected record (collected_record)
Collection protocol: cp_cocoa_nutrient_records

Required crop-protection records: before completing the foreground package, enumerate every actually applied formulated product separately, retaining trade name, active ingredient, salt or chemical form, concentration, density where needed, application quantity, date and treated area. Select one physically specific product identity per exchange. Derive active-substance releases separately by substance and receiving compartment. Missing formulation identity is a completeness gap; do not replace it with a generic pesticide, invented example, or assumed zero.

Irrigation water supplied (`cocoa_irrigation_water`)

Record delivered irrigation separately from rainfall and source withdrawal. A rainfed route records a justified zero.

Selected flow: Irrigation water supply [parameterized]
Flow property / unit: Volume / m3
Amount rule: metered or evidenced volume by source, block and crop year
Value mode: Foreground record (foreground_record)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.
Normalization basis: per declared reference flow
Basis kind: Reference flow (reference_flow)
Evidence kind: Collected record (collected_record)
Collection protocol: cp_cocoa_water_records
Sources: fao-cocoa-production-guide
Range: Provisional irrigation screening estimate
- Range role: Default estimate (default_estimate)
- Lower: 0
- Upper: 5
- Unit: m3/t wet reference
- Basis: broad delivered-irrigation interval; replace with meters and water balance
- Basis kind: Reference flow (reference_flow)
- Evidence kind: Reasoned estimate (reasoned_estimate)

Electricity, medium voltage (`cocoa_field_energy`)

Conditional one-material exchange: include Electricity, medium voltage only when the actual route and records establish its use or release. Other products, fuels, waste materials, or emitted species require separate atomic rows with independent quantity, state and identity. No use is inferred from this example.

Selected flow: Electricity, medium voltage
Flow property / unit: Energy / kWh
Amount rule: Measure or calculate only Electricity, medium voltage for this process and period using route-specific records; do not combine other species or carriers.
Value mode: Foreground record (foreground_record)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.
Normalization basis: per declared reference flow
Basis kind: Reference flow (reference_flow)
Evidence kind: Collected record (collected_record)
Collection protocol: cp_cocoa_energy_records

Diesel fuel (`cocoa_field_energy_diesel`)

Conditional one-material exchange: include Diesel fuel only when the actual route and records establish its use or release. Other products, fuels, waste materials, or emitted species require separate atomic rows with independent quantity, state and identity. No use is inferred from this example.

Selected flow: Diesel fuel
Flow property / unit: Mass / kg
Amount rule: Measure or calculate only Diesel fuel for this process and period using route-specific records; do not combine other species or carriers.
Value mode: Foreground record (foreground_record)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.
Normalization basis: per declared reference flow
Basis kind: Reference flow (reference_flow)
Evidence kind: Collected record (collected_record)
Collection protocol: cp_cocoa_energy_records

Elementary flows

Cacao land occupation (`cocoa_land_occupation`)

Record block area, production phase, shade/intercrop condition and crop year. Land transformation is separate.

Selected flow: Agricultural land occupation for cacao [unmapped]
Flow property / unit: Area-time / ha·year
Amount rule: Raw occupation = actual managed area multiplied by the dated attributable occupation duration in years, partitioned across non-overlapping phases and all co-users once. Convert ha to m2 by 10,000 only if the selected area-time identity requires m2*year. Area divided by product mass alone is not area-time. Attribute the area-time numerator using the original allocation rules, then normalize once to matched accepted final-reference mass, including actual wet-to-dry stage-throughput linkage where relevant; do not divide an already final intensity again.
Value mode: Calculated value (calculated_value)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.
Normalization basis: per declared reference flow
Basis kind: Reference flow (reference_flow)
Evidence kind: Calculated from collection (calculated_from_collection)
Collection protocol: cp_cocoa_perennial_phase_records
Sources: fao-cocoa-production-guide; iso-14044-2006
Range: Provisional land-occupation screening estimate
- Range role: QA guardrail (qa_guardrail)
- Lower: 0.00005
- Upper: 0.01
- Unit: ha·year/kg wet reference
- Basis: broad perennial-crop interval; replace with block area and yield records
- Basis kind: Reference flow (reference_flow)
- Evidence kind: Reasoned estimate (reasoned_estimate)

Outputs

Elementary flows

Process: Mature cocoa-pod harvest and collection (`cocoa_pod_harvest`)

Inputs

Product flows

Required harvest provenance: link each harvested cocoa pod lot to its producing block, cultivar and crop year through collection records. This provenance is metadata, not an additional product input or a second pod mass.

Outputs

Product flows

Harvested fresh cocoa pods (`cocoa_harvested_pods`)

Record mature pods collected and handed to pod opening. Pods are not the wet-bean reference flow.

Selected flow: Fresh cocoa pods [unmapped]
Flow property / unit: Mass / kg
Amount rule: weighed or documented harvested pod mass by lot and moisture basis
Value mode: Foreground record (foreground_record)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.
Normalization basis: per declared reference flow
Basis kind: Process output (process_output)
Evidence kind: Collected record (collected_record)
Collection protocol: cp_cocoa_harvest_lot_records
Sources: fao-cocoa-production-guide; icco-cocoa-harvesting-post-harvest
Range: Harvested-pod yield screen
- Range role: QA guardrail (qa_guardrail)
- Lower: 0.5
- Upper: 4
- Unit: kg fresh pods/kg wet reference
- Basis: broad pod-to-wet-bean interval; use the lot-specific balance
- Basis kind: Process output (process_output)
- Evidence kind: Reasoned estimate (reasoned_estimate)

Waste flows

Unharvested, damaged or field-dropped pods (`cocoa_field_pod_losses`)

Record pods left in the field, damaged before collection or discarded at harvest and declare soil return, decay, recovery, treatment or waste fate.

Selected flow: Cocoa pod harvest loss [unmapped]
Flow property / unit: Mass / kg
Amount rule: plot count or mass estimate reconciled with mature-pod observations
Value mode: Calculated value (calculated_value)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.
Normalization basis: per declared reference flow
Basis kind: Reference flow (reference_flow)
Evidence kind: Calculated from collection (calculated_from_collection)
Collection protocol: cp_cocoa_harvest_lot_records
Sources: fao-cocoa-production-guide; mass-balance-identity
Range: Field-loss screening range
- Range role: QA guardrail (qa_guardrail)
- Lower: 0
- Upper: 1
- Unit: kg fresh pod loss/kg wet reference
- Basis: broad harvest-loss interval; replace with observations
- Basis kind: Reference flow (reference_flow)
- Evidence kind: Reasoned estimate (reasoned_estimate)

Process: Pod breaking and wet-bean extraction (`cocoa_pod_breaking_extraction`)

Inputs

Product flows

Harvested fresh cocoa pods (`cocoa_pod_extraction_input`)

Use the exact harvested pod lot; do not substitute wet beans, dried beans or cocoa waste.

Selected flow: Fresh cocoa pods [unmapped]
Flow property / unit: Mass / kg
Amount rule: received pod mass by lot with measured or documented moisture
Value mode: Foreground record (foreground_record)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.
Normalization basis: per declared reference flow
Basis kind: Reference flow (reference_flow)
Evidence kind: Collected record (collected_record)
Collection protocol: cp_cocoa_pod_extraction_records
Sources: icco-cocoa-harvesting-post-harvest; fao-cocoa-production-guide
Range: Pod-input screening range
- Range role: QA guardrail (qa_guardrail)
- Lower: 0.5
- Upper: 4
- Unit: kg pods/kg wet reference
- Basis: same-lot pod-to-wet-bean balance
- Basis kind: Reference flow (reference_flow)
- Evidence kind: Reasoned estimate (reasoned_estimate)

Electricity, medium voltage (`cocoa_pod_opening_energy`)

Include this exchange only when Electricity, medium voltage is actually supplied to this process. Record every other actual carrier separately. For purchased operating services, retain the supplier boundary and do not also count fuel or electricity already included in that service. Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.

Selected flow: Electricity, medium voltage
Flow property / unit: Energy / kWh
Amount rule: Measured Electricity, medium voltage supplied to this process and period, normalized once to the declared reference output; convert carrier-native units only with documented density, calorific value or meter conventions where needed.
Value mode: foreground_record
Specificity: site_specific
Normalization basis: per declared reference flow
Basis kind: reference_flow
Evidence kind: collected_record
Collection protocol: cp_cocoa_energy_records
Sources: icco-cocoa-harvesting-post-harvest

Diesel fuel (`cocoa_pod_opening_energy_diesel`)

Include this exchange only when Diesel fuel is actually supplied to this process. Record every other actual carrier separately. For purchased operating services, retain the supplier boundary and do not also count fuel or electricity already included in that service. Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.

Selected flow: Diesel fuel
Flow property / unit: Mass / kg
Amount rule: Measured Diesel fuel supplied to this process and period, normalized once to the declared reference output; convert carrier-native units only with documented density, calorific value or meter conventions where needed.
Value mode: foreground_record
Specificity: site_specific
Normalization basis: per declared reference flow
Basis kind: reference_flow
Evidence kind: collected_record
Collection protocol: cp_cocoa_energy_records
Sources: icco-cocoa-harvesting-post-harvest

Outputs

Product flows

Wet cocoa beans in pulp (`cocoa_wet_beans_in_pulp`)

This state is handed to fermentation or direct drying. It is not the reference UUID unless explicitly declared as the platform's fresh farm-gate state.

Selected flow: Wet cocoa beans in pulp [unmapped]
Flow property / unit: Mass / kg Raw output measurement and reconciliation: weighed wet-bean and pulp mass by extraction lot with moisture and pulp inclusion
Amount rule: 1 kg
Value mode: Foreground record (foreground_record)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.
Normalization basis: per declared reference flow
Basis kind: Process output (process_output)
Evidence kind: Collected record (collected_record)
Collection protocol: cp_cocoa_pod_extraction_records
Sources: icco-cocoa-harvesting-post-harvest; mass-balance-identity
Range: Wet-bean extraction yield screen
- Range role: QA guardrail (qa_guardrail)
- Lower: 0.1
- Upper: 0.4
- Unit: kg wet beans in pulp/kg fresh pods
- Basis: broad pod-opening yield interval; replace with pod-lot balance
- Basis kind: Process output (process_output)
- Evidence kind: Reasoned estimate (reasoned_estimate)

Waste flows

Cocoa pod husk and placenta residue (`cocoa_pod_husk_residue`)

Record pod husk, placenta and attached non-bean material. It becomes an intended co-product only with a named destination, quantity, quality and hand-off.

Selected flow: Cocoa pod husk and placenta residue [unmapped]
Flow property / unit: Mass / kg
Amount rule: measured residual mass or reconciled difference from pod and wet-bean inputs
Value mode: Calculated value (calculated_value)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.
Normalization basis: per declared reference flow
Basis kind: Reference flow (reference_flow)
Evidence kind: Calculated from collection (calculated_from_collection)
Collection protocol: cp_cocoa_residue_destination_records
Sources: fao-cocoa-production-guide; mass-balance-identity
Range: Pod-residue screening range
- Range role: QA guardrail (qa_guardrail)
- Lower: 0.6
- Upper: 0.95
- Unit: kg residue/kg fresh pods
- Basis: broad residual fraction; replace with measured pod-opening records
- Basis kind: Reference flow (reference_flow)
- Evidence kind: Reasoned estimate (reasoned_estimate)

Unextracted or damaged wet-bean rejects (`cocoa_extraction_rejects`)

Identify broken, mouldy, germinated, contaminated or otherwise excluded beans and declare recovery, downgrade, rework, disposal or soil-return routing.

Selected flow: Wet-bean extraction reject [unmapped]
Flow property / unit: Mass / kg
Amount rule: weighed or estimated reject mass by lot and defect
Value mode: Foreground record (foreground_record)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.
Normalization basis: per declared reference flow
Basis kind: Reference flow (reference_flow)
Evidence kind: Collected record (collected_record)
Collection protocol: cp_cocoa_residue_destination_records
Sources: icco-cocoa-quality-requirements; fao-cocoa-ota-code
Range: Extraction-reject screening range
- Range role: QA guardrail (qa_guardrail)
- Lower: 0
- Upper: 0.15
- Unit: kg reject/kg wet-bean input
- Basis: broad first-pass reject interval; replace with inspection records
- Basis kind: Reference flow (reference_flow)
- Evidence kind: Reasoned estimate (reasoned_estimate)

Process: Cocoa-bean fermentation (`cocoa_fermentation`)

Inputs

Product flows

Wet cocoa beans in pulp (`cocoa_fermentation_input`)

Record the bean-in-pulp batch entering a named heap, box, basket or equivalent. Each batch has one start state, declared turning/mixing events and one downstream hand-off.

Selected flow: Wet cocoa beans in pulp [unmapped]
Flow property / unit: Mass / kg
Amount rule: weighed batch input with moisture, pulp inclusion and lot id
Value mode: Foreground record (foreground_record)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.
Normalization basis: per declared reference flow
Basis kind: Reference flow (reference_flow)
Evidence kind: Collected record (collected_record)
Collection protocol: cp_cocoa_fermentation_batch_records
Sources: icco-cocoa-harvesting-post-harvest; fao-cocoa-ota-code
Range: Fermentation-input screening range
- Range role: QA guardrail (qa_guardrail)
- Lower: 0.1
- Upper: 1.1
- Unit: kg wet beans/kg wet reference
- Basis: normalized batch input; replace with actual lot record
- Basis kind: Reference flow (reference_flow)
- Evidence kind: Reasoned estimate (reasoned_estimate)

Required fermentation inventory: separately record every actual fermentation-container material, liner, installation and purchased operating service included by the selected boundary, retaining composition, service life, reuse and supplier scope; do not assume that any particular material is used.

Electricity, medium voltage (`cocoa_fermentation_services`)

Selected flow: Electricity, medium voltage
Flow property / unit: Energy / kWh
Amount rule: Measured Electricity, medium voltage supplied to this process and period, normalized once to the declared reference output; convert carrier-native units only with documented density, calorific value or meter conventions where needed.
Value mode: foreground_record
Specificity: site_specific
Normalization basis: per declared reference flow
Basis kind: reference_flow
Evidence kind: collected_record
Collection protocol: cp_cocoa_fermentation_batch_records
Sources: fao-cocoa-ota-code; icco-cocoa-quality-requirements

Outputs

Product flows

Fermented wet cocoa beans (`cocoa_fermented_wet_beans`)

Record the changed composition state and hand-off to drying without inventing a pathway or yield beyond the batch record.

Selected flow: Fermented wet cocoa beans [unmapped]
Flow property / unit: Mass / kg
Amount rule: batch mass after fermentation and drainage with end moisture and quality observations
Value mode: Foreground record (foreground_record)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.
Normalization basis: per declared reference flow
Basis kind: Process output (process_output)
Evidence kind: Collected record (collected_record)
Collection protocol: cp_cocoa_fermentation_batch_records
Sources: fao-cocoa-ota-code; icco-cocoa-harvesting-post-harvest
Range: Fermented-wet output screen
- Range role: QA guardrail (qa_guardrail)
- Lower: 0.7
- Upper: 1
- Unit: kg fermented wet beans/kg wet input
- Basis: broad mass-retention screen before drying; replace with batch balance
- Basis kind: Process output (process_output)
- Evidence kind: Reasoned estimate (reasoned_estimate)

Waste flows

Spoiled, unfermented or off-spec fermentation rejects (`cocoa_fermentation_rejects`)

Identify mouldy, germinated, black, contaminated, insufficiently fermented or otherwise off-spec material and declare recovery, downgrade, rework, disposal or soil-return routing.

Selected flow: Fermentation reject or off-spec bean material [unmapped]
Flow property / unit: Mass / kg
Amount rule: lot inspection and weighed rejected mass by reason and destination
Value mode: Foreground record (foreground_record)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.
Normalization basis: per declared reference flow
Basis kind: Reference flow (reference_flow)
Evidence kind: Collected record (collected_record)
Collection protocol: cp_cocoa_quality_records
Sources: icco-cocoa-quality-requirements; fao-cocoa-ota-code
Range: Fermentation-reject screening range
- Range role: QA guardrail (qa_guardrail)
- Lower: 0
- Upper: 0.2
- Unit: kg reject/kg wet-bean input
- Basis: broad off-spec interval; replace with inspection records
- Basis kind: Reference flow (reference_flow)
- Evidence kind: Reasoned estimate (reasoned_estimate)

Elementary flows

Carbon dioxide, biogenic, to air (`cocoa_fermentation_emissions`)

Record Carbon dioxide, biogenic, to air as one substance and receiving-medium exchange only when measurement or the selected applicable method establishes this pathway. Retain the actual receiving compartment and verify the precise flow identity. Other substances require separate exchanges; this card does not imply a default release. Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.

Selected flow: Carbon dioxide, biogenic, to air
Flow property / unit: Mass / kg CO2
Amount rule: Measured or method-calculated mass of Carbon dioxide, biogenic, to air, retaining activity data, factors, substance basis and receiving compartment; normalize once to the declared reference output.
Value mode: calculated_value
Specificity: site_specific
Normalization basis: per declared reference flow
Basis kind: reference_flow
Evidence kind: calculated_from_collection
Collection protocol: cp_cocoa_emission_records
Sources: fao-cocoa-ota-code; mass-balance-identity

Methane, to air (`cocoa_fermentation_emissions_ch4`)

Record Methane, to air as one substance and receiving-medium exchange only when measurement or the selected applicable method establishes this pathway. Retain the actual receiving compartment and verify the precise flow identity. Other substances require separate exchanges; this card does not imply a default release. Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.

Selected flow: Methane, to air
Flow property / unit: Mass / kg CH4
Amount rule: Measured or method-calculated mass of Methane, to air, retaining activity data, factors, substance basis and receiving compartment; normalize once to the declared reference output.
Value mode: calculated_value
Specificity: site_specific
Normalization basis: per declared reference flow
Basis kind: reference_flow
Evidence kind: calculated_from_collection
Collection protocol: cp_cocoa_emission_records
Sources: fao-cocoa-ota-code; mass-balance-identity

Process: Fermented-bean drying and stabilization (`cocoa_drying_stabilization`)

Inputs

Product flows

Fermented wet cocoa beans (`cocoa_drying_input`)

Use the fermented batch hand-off, not the fresh reference identity. Record starting moisture and sun, artificial or combined drying route.

Selected flow: Fermented wet cocoa beans [unmapped]
Flow property / unit: Mass / kg
Amount rule: weighed drying input with starting moisture and fermentation-batch link
Value mode: Foreground record (foreground_record)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.
Normalization basis: per declared reference flow
Basis kind: Reference flow (reference_flow)
Evidence kind: Collected record (collected_record)
Collection protocol: cp_cocoa_drying_batch_records
Sources: icco-cocoa-processing; fao-cocoa-ota-code
Range: Drying-input screening range
- Range role: QA guardrail (qa_guardrail)
- Lower: 0.7
- Upper: 1
- Unit: kg fermented wet beans/kg wet reference
- Basis: same-lot fermentation-to-drying hand-off; replace with batch data
- Basis kind: Reference flow (reference_flow)
- Evidence kind: Reasoned estimate (reasoned_estimate)

Electricity, medium voltage (`cocoa_drying_energy`)

Selected flow: Electricity, medium voltage
Flow property / unit: Energy / kWh
Amount rule: Measured Electricity, medium voltage supplied to this process and period, normalized once to the declared reference output; convert carrier-native units only with documented density, calorific value or meter conventions where needed.
Value mode: foreground_record
Specificity: site_specific
Normalization basis: per declared reference flow
Basis kind: process_output
Evidence kind: collected_record
Collection protocol: cp_cocoa_energy_records
Sources: fao-cocoa-production-guide; icco-global-cocoa-farming-systems

Diesel fuel (`cocoa_drying_energy_diesel`)

Selected flow: Diesel fuel
Flow property / unit: Mass / kg
Amount rule: Measured Diesel fuel supplied to this process and period, normalized once to the declared reference output; convert carrier-native units only with documented density, calorific value or meter conventions where needed.
Value mode: foreground_record
Specificity: site_specific
Normalization basis: per declared reference flow
Basis kind: process_output
Evidence kind: collected_record
Collection protocol: cp_cocoa_energy_records
Sources: fao-cocoa-production-guide; icco-global-cocoa-farming-systems

Purchased steam (`cocoa_drying_energy_steam`)

Include this exchange only when Purchased steam is actually supplied to this process. Record every other actual carrier separately. For purchased operating services, retain the supplier boundary and do not also count fuel or electricity already included in that service. Raw activity or stage basis: per 1 kg dried fermented beans and per 1 kg wet reference.

Selected flow: Purchased steam
Flow property / unit: Energy / MJ
Amount rule: Measured Purchased steam supplied to this process and period, normalized once to the declared reference output; convert carrier-native units only with documented density, calorific value or meter conventions where needed.
Value mode: foreground_record
Specificity: site_specific
Normalization basis: per declared reference flow
Basis kind: process_output
Evidence kind: collected_record
Collection protocol: cp_cocoa_energy_records
Sources: fao-cocoa-production-guide; icco-global-cocoa-farming-systems

Outputs

Product flows

Fermented, dried cocoa beans (`cocoa_dried_fermented_beans`)

This is a distinct route output, not the platform reference flow. Record final moisture, drying technology, temperature/weather and quality status.

Selected flow: Fermented, dried cocoa beans [unmapped]
Flow property / unit: Mass / kg
Amount rule: weighed dried output with measured moisture and lot identity
Value mode: Foreground record (foreground_record)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference and per 1 kg dried output.
Normalization basis: per declared reference flow
Basis kind: Process output (process_output)
Evidence kind: Collected record (collected_record)
Collection protocol: cp_cocoa_drying_batch_records
Sources: icco-cocoa-processing; icco-cocoa-quality-requirements
Range: Final moisture screening range
- Range role: Typical range (typical_range)
- Lower: 6
- Upper: 8
- Unit: percent wet basis
- Basis: storage screening interval; replace with lot measurement
- Basis kind: Process output (process_output)
- Evidence kind: External source (external_source)
- Sources: icco-cocoa-processing; icco-cocoa-quality-requirements

No universal numeric bound is established by the cited balance identity or method. Derive a lot/site-specific check from measured inputs, outputs, moisture, growth where applicable, stocks, losses and uncertainty on compatible bases. Report numeric screening unavailable until supported; retain the measured exchange and investigate residuals without clipping or substituting a default.

Waste flows

Mouldy, contaminated or over-dried bean rejects (`cocoa_drying_rejects`)

Record rejected material and recovery, downgrade, treatment, destruction or soil-return destination. Do not include it in accepted output.

Selected flow: Drying reject or contaminated bean material [unmapped]
Flow property / unit: Mass / kg
Amount rule: weighed rejected mass by batch, defect and destination
Value mode: Foreground record (foreground_record)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.
Normalization basis: per declared reference flow
Basis kind: Reference flow (reference_flow)
Evidence kind: Collected record (collected_record)
Collection protocol: cp_cocoa_quality_records
Sources: fao-cocoa-ota-code; icco-cocoa-quality-requirements
Range: Drying-reject screening range
- Range role: QA guardrail (qa_guardrail)
- Lower: 0
- Upper: 0.1
- Unit: kg reject/kg dried output
- Basis: broad quality-loss interval; replace with inspection
- Basis kind: Process output (process_output)
- Evidence kind: Reasoned estimate (reasoned_estimate)

Elementary flows

Carbon dioxide, fossil, to air (`cocoa_drying_emissions`)

Record Carbon dioxide, fossil, to air as one substance and receiving-medium exchange only when measurement or the selected applicable method establishes this pathway. Retain the actual receiving compartment and verify the precise flow identity. Other substances require separate exchanges; this card does not imply a default release. Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.

Selected flow: Carbon dioxide, fossil, to air
Flow property / unit: Mass / kg CO2
Amount rule: Measured or method-calculated mass of Carbon dioxide, fossil, to air, retaining activity data, factors, substance basis and receiving compartment; normalize once to the declared reference output.
Value mode: calculated_value
Specificity: site_specific
Normalization basis: per declared reference flow
Basis kind: reference_flow
Evidence kind: calculated_from_collection
Collection protocol: cp_cocoa_emission_records
Sources: icco-cocoa-quality-requirements; ipcc-2019-refinement-afolu

Carbon dioxide, biogenic, to air (`cocoa_drying_emissions_co2_biogenic`)

Selected flow: Carbon dioxide, biogenic, to air
Flow property / unit: Mass / kg CO2
Amount rule: Measured or method-calculated mass of Carbon dioxide, biogenic, to air, retaining activity data, factors, substance basis and receiving compartment; normalize once to the declared reference output.
Value mode: calculated_value
Specificity: site_specific
Normalization basis: per declared reference flow
Basis kind: reference_flow
Evidence kind: calculated_from_collection
Collection protocol: cp_cocoa_emission_records
Sources: icco-cocoa-quality-requirements; ipcc-2019-refinement-afolu

Methane, to air (`cocoa_drying_emissions_ch4`)

Selected flow: Methane, to air
Flow property / unit: Mass / kg CH4
Amount rule: Measured or method-calculated mass of Methane, to air, retaining activity data, factors, substance basis and receiving compartment; normalize once to the declared reference output.
Value mode: calculated_value
Specificity: site_specific
Normalization basis: per declared reference flow
Basis kind: reference_flow
Evidence kind: calculated_from_collection
Collection protocol: cp_cocoa_emission_records
Sources: icco-cocoa-quality-requirements; ipcc-2019-refinement-afolu

Dinitrogen monoxide, to air (`cocoa_drying_emissions_n2o`)

Record Dinitrogen monoxide, to air as one substance and receiving-medium exchange only when measurement or the selected applicable method establishes this pathway. Retain the actual receiving compartment and verify the precise flow identity. Other substances require separate exchanges; this card does not imply a default release. Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.

Selected flow: Dinitrogen monoxide, to air
Flow property / unit: Mass / kg N2O
Amount rule: Measured or method-calculated mass of Dinitrogen monoxide, to air, retaining activity data, factors, substance basis and receiving compartment; normalize once to the declared reference output. If reported as N2O-N, convert to N2O once using 44/28.
Value mode: calculated_value
Specificity: site_specific
Normalization basis: per declared reference flow
Basis kind: reference_flow
Evidence kind: calculated_from_collection
Collection protocol: cp_cocoa_emission_records
Sources: icco-cocoa-quality-requirements; ipcc-2019-refinement-afolu

Particulate matter, particle size unspecified, to air (`cocoa_drying_emissions_dust`)

Record Particulate matter, particle size unspecified, to air as one substance and receiving-medium exchange only when measurement or the selected applicable method establishes this pathway. Retain the actual receiving compartment and verify the precise flow identity. Other substances require separate exchanges; this card does not imply a default release. Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.

Selected flow: Particulate matter, particle size unspecified, to air
Flow property / unit: Mass / kg
Amount rule: Measured or method-calculated mass of Particulate matter, particle size unspecified, to air, retaining activity data, factors, substance basis and receiving compartment; normalize once to the declared reference output.
Value mode: calculated_value
Specificity: site_specific
Normalization basis: per declared reference flow
Basis kind: reference_flow
Evidence kind: calculated_from_collection
Collection protocol: cp_cocoa_emission_records
Sources: icco-cocoa-quality-requirements; ipcc-2019-refinement-afolu

Outputs

Elementary flows

Drying water loss (`cocoa_drying_water_loss`)

Calculate water removed from wet beans; it is not dried-bean product.

Selected flow: Water vapour emitted to air during cocoa drying (UUID unresolved)
Flow property / unit: Mass / kg water
Amount rule: Determine supported evaporation on a closed water-mass control volume: incoming material water + actual added water + opening water stock - water in all accepted/co-product/reject/residue exits - separate liquid discharge/exports - closing water stock. Use measured wet mass times wet-basis moisture for each material stream, and compatible density for liquid volumes. Internal recirculation cancels. Retain actual rain/rewetting where relevant; total fresh/dry mass difference is not all water. Independently support all terms and the evaporation pathway; investigate an unexplained or negative balance rather than force it into a vapour release or clip it to zero. Keep water quantities distinct from dry-solids loss and other volatiles. Attribute and normalize the evidenced water release once using the original matched final reference.
Value mode: Calculated value (calculated_value)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference.
Normalization basis: per declared reference flow
Basis kind: Reference flow (reference_flow)
Evidence kind: Calculated from collection (calculated_from_collection)
Collection protocol: cp_cocoa_drying_batch_records
Sources: mass-balance-identity; icco-cocoa-processing

This is an elementary output to air, not a waste sent to treatment. Account for rejected bean solids separately; do not include solids or drainage in the evaporated-water mass.

Process: Cleaning, grading and reject routing (`cocoa_cleaning_grading`)

Inputs

Product flows

Fermented, dried cocoa beans (`cocoa_cleaning_input`)

Record the dried lot entering cleaning and grading. Its identity remains distinct from the fresh farm-gate reference.

Selected flow: Fermented, dried cocoa beans [unmapped]
Flow property / unit: Mass / kg
Amount rule: weighed received lot with moisture, lot and quality observations
Value mode: Foreground record (foreground_record)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference and per 1 kg dried input.
Normalization basis: per declared reference flow
Basis kind: Reference flow (reference_flow)
Evidence kind: Collected record (collected_record)
Collection protocol: cp_cocoa_grade_lot_records
Sources: fao-cocoa-production-guide; icco-cocoa-quality-requirements

No fixed numerical screening bound is prescribed for this row. Derive any lot-specific consistency bound from measured incoming quantities, moisture, stocks, losses and uncertainty on the stated basis. Conservation alone supplies no universal yield, water-use or measurement-tolerance interval. Until compatible evidence is available, report quantitative range screening as unavailable; do not clip measurements or substitute an assumed value.

Electricity, medium voltage (`cocoa_cleaning_energy`)

Selected flow: Electricity, medium voltage
Flow property / unit: Energy / kWh
Amount rule: Measured Electricity, medium voltage supplied to this process and period, normalized once to the declared reference output; convert carrier-native units only with documented density, calorific value or meter conventions where needed.
Value mode: foreground_record
Specificity: site_specific
Normalization basis: per declared reference flow
Basis kind: process_output
Evidence kind: collected_record
Collection protocol: cp_cocoa_energy_records
Sources: fao-cocoa-production-guide; icco-cocoa-quality-requirements

Diesel fuel (`cocoa_cleaning_energy_diesel`)

Selected flow: Diesel fuel
Flow property / unit: Mass / kg
Amount rule: Measured Diesel fuel supplied to this process and period, normalized once to the declared reference output; convert carrier-native units only with documented density, calorific value or meter conventions where needed.
Value mode: foreground_record
Specificity: site_specific
Normalization basis: per declared reference flow
Basis kind: process_output
Evidence kind: collected_record
Collection protocol: cp_cocoa_energy_records
Sources: fao-cocoa-production-guide; icco-cocoa-quality-requirements

Outputs

Product flows

Accepted graded fermented cocoa beans (`cocoa_accepted_graded_beans`)

Record each accepted grade and downstream hand-off. An accepted grade is an intended output only when its grade and destination are declared.

Selected flow: Accepted graded fermented cocoa beans [unmapped]
Flow property / unit: Mass / kg
Amount rule: weighed accepted intended output by grade, moisture, defect basis and lot
Value mode: Foreground record (foreground_record)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference and per 1 kg accepted grade.
Normalization basis: per declared reference flow
Basis kind: Process output (process_output)
Evidence kind: Collected record (collected_record)
Collection protocol: cp_cocoa_grade_lot_records
Sources: fao-cocoa-production-guide; icco-cocoa-quality-requirements
Range: Accepted-grade recovery screen
- Range role: QA guardrail (qa_guardrail)
- Lower: 0.8
- Upper: 1
- Unit: kg accepted output/kg dried input
- Basis: broad cleaning and grading recovery interval; replace with lot reconciliation
- Basis kind: Process output (process_output)
- Evidence kind: Reasoned estimate (reasoned_estimate)

Intended downgraded cocoa-bean product (`cocoa_downgraded_intended_output`)

Use only when an off-grade but saleable bean lot has its own intended product status and hand-off. Otherwise use the reject row.

Selected flow: Downgraded but saleable cocoa beans [unmapped]
Flow property / unit: Mass / kg
Amount rule: weighed intended output downgraded product by grade and destination
Value mode: Foreground record (foreground_record)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg dried cocoa bean input.
Normalization basis: per declared reference flow
Basis kind: Process output (process_output)
Evidence kind: Collected record (collected_record)
Collection protocol: cp_cocoa_grade_lot_records
Sources: icco-cocoa-quality-requirements
Range: Downgraded-output screen
- Range role: QA guardrail (qa_guardrail)
- Lower: 0
- Upper: 0.2
- Unit: kg downgraded product/kg dried input
- Basis: broad saleable off-grade fraction; replace with lot records
- Basis kind: Process output (process_output)
- Evidence kind: Reasoned estimate (reasoned_estimate)

Waste flows

Cocoa shell, dust and foreign-material residue (`cocoa_shell_dust_residue`)

Record shells, dust, stones, metal, plant matter and other removed material separately. Shell is an intended co-product only with a named destination and hand-off.

Selected flow: Cocoa shell, dust and foreign-material residue [unmapped]
Flow property / unit: Mass / kg
Amount rule: weighed separated residue by grading lot and destination
Value mode: Foreground record (foreground_record)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg dried cocoa bean input.
Normalization basis: per declared reference flow
Basis kind: Reference flow (reference_flow)
Evidence kind: Collected record (collected_record)
Collection protocol: cp_cocoa_residue_destination_records
Sources: fao-cocoa-production-guide; icco-cocoa-quality-requirements
Range: Shell and cleaning-residue screen
- Range role: QA guardrail (qa_guardrail)
- Lower: 0
- Upper: 0.2
- Unit: kg residue/kg dried input
- Basis: broad cleaning and shell fraction; replace with lot balance
- Basis kind: Reference flow (reference_flow)
- Evidence kind: Reasoned estimate (reasoned_estimate)

Rejected cocoa-bean lot (`cocoa_grading_rejects`)

Identify mouldy, insect-damaged, broken, germinated, black, contaminated or otherwise rejected beans. Rejected material cannot be accepted output without a separate downgrade or recovery hand-off.

Selected flow: Rejected cocoa beans [unmapped]
Flow property / unit: Mass / kg
Amount rule: weighed rejected mass by defect, quality decision and destination
Value mode: Foreground record (foreground_record)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg dried cocoa bean input.
Normalization basis: per declared reference flow
Basis kind: Reference flow (reference_flow)
Evidence kind: Collected record (collected_record)
Collection protocol: cp_cocoa_quality_records
Sources: fao-cocoa-production-guide; icco-cocoa-quality-requirements; fao-cocoa-ota-code
Range: Grading-reject screen
- Range role: QA guardrail (qa_guardrail)
- Lower: 0
- Upper: 0.2
- Unit: kg reject/kg dried input
- Basis: broad first-pass reject interval; replace with grade inspection
- Basis kind: Reference flow (reference_flow)
- Evidence kind: Reasoned estimate (reasoned_estimate)

Elementary flows

Cleaning dust emissions (`cocoa_cleaning_dust`)

Record dust release or capture losses only when supported by equipment or method evidence; shell or dust residue is not automatically an air emission.

Selected flow: Cocoa cleaning dust elementary flow [unmapped]
Flow property / unit: Mass / kg substance
Amount rule: measured or calculated release after captured residue is accounted for
Value mode: Calculated value (calculated_value)
Specificity: Route-specific (route_specific) Raw activity or stage basis: per 1 kg dried cocoa bean input.
Normalization basis: per declared reference flow
Basis kind: Reference flow (reference_flow)
Evidence kind: Calculated from collection (calculated_from_collection)
Collection protocol: cp_cocoa_emission_records
Sources: mass-balance-identity; icco-cocoa-quality-requirements
Range: Cleaning-dust screen
- Range role: QA guardrail (qa_guardrail)
- Lower: 0
- Upper: 0.02
- Unit: kg substance/kg dried input
- Basis: broad dust-release interval; replace with capture records
- Basis kind: Reference flow (reference_flow)
- Evidence kind: Reasoned estimate (reasoned_estimate)

Process: Storage and declared gate hand-off (`cocoa_storage_gate`)

Inputs

Product flows

Accepted graded fermented cocoa beans (`cocoa_storage_input`)

Record storage lot, moisture, grade, packaging state and start date. This is not a second use of the wet farm-gate reference flow.

Selected flow: Accepted graded fermented cocoa beans [unmapped]
Flow property / unit: Mass / kg
Amount rule: weighed storage input by lot and grade
Value mode: Foreground record (foreground_record)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at farm-gate reference and per 1 kg dry output.
Normalization basis: per declared reference flow
Basis kind: Reference flow (reference_flow)
Evidence kind: Collected record (collected_record)
Collection protocol: cp_cocoa_storage_records
Sources: icco-cocoa-processing; icco-cocoa-quality-requirements

Electricity, medium voltage (`cocoa_storage_services`)

Selected flow: Electricity, medium voltage
Flow property / unit: Energy / kWh
Amount rule: Measured Electricity, medium voltage supplied to this process and period, normalized once to the declared reference output; convert carrier-native units only with documented density, calorific value or meter conventions where needed.
Value mode: foreground_record
Specificity: site_specific
Normalization basis: per declared reference flow
Basis kind: process_output
Evidence kind: collected_record
Collection protocol: cp_cocoa_storage_records
Sources: icco-cocoa-quality-requirements

Paperboard packaging (`cocoa_storage_services_paper`)

Record Paperboard packaging only when this material crosses the declared process boundary. Retain lot, physical state, composition where relevant, and actual destination. Record other materials independently rather than treating this card as a selector or material bundle. This is a conditional material example, not a packaging requirement. Measure reuse and replacement and allocate the material once across its documented uses. Raw activity or stage basis: per 1 kg dried cocoa bean output and storage day.

Selected flow: Paperboard packaging
Flow property / unit: Mass / kg
Amount rule: Measured net quantity of Paperboard packaging, reconciled to the linked lot and process balance, then normalized once to the declared reference output; retain moisture and any density conversion evidence.
Value mode: foreground_record
Specificity: site_specific
Normalization basis: per declared reference flow
Basis kind: process_output
Evidence kind: collected_record
Collection protocol: cp_cocoa_storage_records
Sources: icco-cocoa-quality-requirements

Polyethylene packaging film (`cocoa_storage_services_film`)

Record Polyethylene packaging film only when this material crosses the declared process boundary. Retain lot, physical state, composition where relevant, and actual destination. Record other materials independently rather than treating this card as a selector or material bundle. This is a conditional material example, not a packaging requirement. Measure reuse and replacement and allocate the material once across its documented uses. Raw activity or stage basis: per 1 kg dried cocoa bean output and storage day.

Selected flow: Polyethylene packaging film
Flow property / unit: Mass / kg
Amount rule: Measured net quantity of Polyethylene packaging film, reconciled to the linked lot and process balance, then normalized once to the declared reference output; retain moisture and any density conversion evidence.
Value mode: foreground_record
Specificity: site_specific
Normalization basis: per declared reference flow
Basis kind: process_output
Evidence kind: collected_record
Collection protocol: cp_cocoa_storage_records
Sources: icco-cocoa-quality-requirements

Outputs

Product flows

Declared post-harvest dried-bean gate output (`cocoa_declared_dried_gate_output`)

Use only when the data package declares the extended post-harvest gate. It is a separate route output and must not be labelled as the platform's fresh farm-gate state.

Selected flow: Fermented, dried and graded cocoa beans at declared post-harvest gate [unmapped]
Flow property / unit: Mass / kg
Amount rule: weighed final lot after storage with moisture, grade and loss record
Value mode: Foreground record (foreground_record)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg wet cocoa beans at platform farm-gate reference and per 1 kg dried gate output.
Normalization basis: per declared reference flow
Basis kind: Process output (process_output)
Evidence kind: Collected record (collected_record)
Collection protocol: cp_cocoa_storage_records
Sources: icco-cocoa-processing; icco-cocoa-quality-requirements

Waste flows

Storage loss and quality downgrade (`cocoa_storage_losses`)

Record mould, pests, moisture change, foreign-material removal and other storage events. A downgraded saleable lot uses its intended-output card rather than this waste card.

Selected flow: Cocoa storage loss or rejected storage material [unmapped]
Flow property / unit: Mass / kg
Amount rule: Measure the actual damaged/rejected/lost stream by lot and destination, with mutually exclusive material quantities. Reconcile opening stock + receipts = accepted dispatch + other external transfers + rejected removals + independently evidenced physical loss + closing stock on matched moisture/component bases. Rework returned across this node is one paired transfer, or retained in closing stock if still held; it is not another final output. An unexplained balance difference is an investigation item, not automatically a physical waste or emission. Do not add removed lots to receipts, omit closing stock, or subtract a loss again when it is already part of this reported stream. Attribute and normalize each supported exported quantity once to accepted final output.
Value mode: Calculated value (calculated_value)
Specificity: Site-specific (site_specific) Raw activity or stage basis: per 1 kg dried cocoa bean storage input.
Normalization basis: per declared reference flow
Basis kind: Reference flow (reference_flow)
Evidence kind: Calculated from collection (calculated_from_collection)
Collection protocol: cp_cocoa_storage_records
Sources: icco-cocoa-quality-requirements; mass-balance-identity
Range: Storage-loss screening range
- Range role: QA guardrail (qa_guardrail)
- Lower: 0
- Upper: 0.1
- Unit: kg loss/kg dried storage input
- Basis: broad pre-gate storage-loss interval; replace with warehouse records
- Basis kind: Reference flow (reference_flow)
- Evidence kind: Reasoned estimate (reasoned_estimate)

7. Allocation and Co-product Handling

Sequential wet, fermented, dried and graded bean states are not co-products and receive no allocation between states. First subdivide by pod lot, fermentation batch, drying batch and grading lot. Record every intended output hand-off before applying allocation.

rule_id	Applies to	Rule	source_ids
`allocation_01`	sequential cocoa states	Do not allocate burdens between wet, fermented wet, dried and graded beans; link them by mass and moisture balances.	`iso-14044-2006`; `mass-balance-identity`
`allocation_02`	pod breaking and fermentation	Treat pod husk, placenta, pulp and sweatings as residues by default. An intended co-product requires a named destination, quantity, quality specification and hand-off.	`icco-cocoa-harvesting-post-harvest`; `fao-cocoa-ota-code`
`allocation_03`	intended co-products	Prefer subdivision. If intended outputs remain, use measured mass allocation for comparable material outputs; use an economic sensitivity when functions differ materially and retain price period and denominator.	`iso-14044-2006`; `mass-balance-identity`
`allocation_04`	rejects and downgrade	Do not allocate rejected beans to accepted cocoa output. A downgraded saleable lot requires its own intended-output hand-off; recovered material retains producing-node burden unless a documented recovery boundary exists.	`icco-cocoa-quality-requirements`; `fao-cocoa-ota-code`
`allocation_05`	batches and perennial phases	Attach shared equipment, cleaning, changeover, drying platforms and plantation phase burdens to the generating run, crop year or phase exactly once.	`iso-14044-2006`; `mass-balance-identity`

8. Foreground Data Collection, Calculation, and Quality Rules

Inventory completeness: conditional named cards are examples of individual exchanges, not an exhaustive recipe or a requirement to use those products. Before completing a foreground package, enumerate every actual planting stock, nutrient, crop-protection formulation, asset material, operating service, carrier, packaging material, waste stream and applicable elementary substance separately, using its physical identity, state, native property/unit, origin or receiving compartment, and measured or method-calculated quantity. Missing identity or quantity remains a completeness gap, never an assumed zero. Preserve the actual lot and phase basis; do not sum intermediate transfers as additional final output or duplicate burdens included in purchased services.

Retain raw site, lot, cycle and stage quantities and denominators in each collection protocol. Reconcile stocks, losses, moisture and co-product attribution first, then normalize: normalized exchange = attributable raw exchange × declared reference quantity / accepted hand-off product quantity on the same boundary and measurement basis. Apply perennial-establishment and shared-operation attribution before this normalization. Never set an internal-transfer quantity equal to the final reference quantity. Per declared reference flow means the amount, unit and product state in section 3; the data package must declare its actual route and gate.

Data Collection Protocols

protocol_id	process_id	flow_role	record_type	raw_fields	collection_method	unit	frequency	temporal_coverage	site_scope	aggregation_rule	quality_evidence
`cp_cocoa_perennial_phase_records`	`cocoa_managed_production`	planting material, land occupation, perennial phases	block register and planting/removal record	block_id; area; cultivar; phase; tree_count; establishment_date; replacement_date; termination_date; crop_year	reconcile phase events and area to each represented cocoa block; Raw aggregation and attribution: annualize establishment, replacement and termination by block and represented year	ha; tree; date; kg reference output	annual and event-based	represented perennial phases and crop years	all included cocoa blocks	per declared reference flow	block register; land record; phase review
`cp_cocoa_nutrient_records`	`cocoa_managed_production`	nutrient and soil-amendment inputs	invoice, field log and nutrient statement	product; nutrient_content; quantity; date; block_id; purpose; supplier; reporting_basis	reconcile product quantities and nutrient content to each field event; Raw aggregation and attribution: aggregate by product, nutrient, block and crop year without merging reporting bases	kg product; kg nutrient; ha	each application event	complete represented crop year	all included cocoa blocks	per declared reference flow	invoices; product labels; nutrient statements; field logs
`cp_cocoa_crop_protection_records`	`cocoa_managed_production`	crop-protection products	product record and application log	product; active_substance; rate; quantity; date; block_id; target; method; operator	reconcile product identity, active substance and dose to each application; Raw aggregation and attribution: aggregate by product, active substance, block and crop year	kg or L product; kg active substance; ha	each application	complete represented crop year	all included cocoa blocks	per declared reference flow	product label; application log; operator record
`cp_cocoa_water_records`	`cocoa_managed_production`	irrigation, process water, recirculation and wastewater	meter record, water invoice or documented estimate	source; delivered_volume; withdrawal; meter_id; block_id; date; recirculation; discharge; quality	separate irrigation and post-harvest water and reconcile withdrawals to discharge; Raw aggregation and attribution: aggregate by use, source, block or process and route; do not merge wastewater with supply	m3 water; kg pollutant where measured	each event or meter period	complete represented crop year and post-harvest route	included farm and post-harvest equipment	per declared reference flow	calibrated meter; invoice; water log; discharge record
`cp_cocoa_energy_records`	`cocoa_managed_production` and post-harvest route processes	field, pod-opening, drying, grading and storage energy or service	meter, invoice, fuel ticket or service log	carrier; quantity; equipment; operation; run_id; batch_id; original_unit; service_scope	reconcile carrier use or service quantity to the generating run or batch; Raw aggregation and attribution: aggregate by process and batch; allocate shared services once by documented driver	kWh; MJ; L fuel; service unit	each run, batch or meter period	complete represented crop year and included extension	all included field and post-harvest equipment	per declared reference flow	meter calibration; invoice; fuel ticket; service log
`cp_cocoa_emission_records`	`cocoa_managed_production` and post-harvest route processes	managed-soil, residue, fermentation and combustion emissions	emission-model record or measurement record	activity; substance; method; factor_set; factor_version; medium; quantity; uncertainty	calculate or measure each pathway with one declared applicable method; Raw aggregation and attribution: keep pathways separate and retain factor, activity basis and uncertainty	kg substance; kg CO2e; ha; kg activity	each event and calculation period	complete represented crop year and included extension	all included field and post-harvest emission sources	per declared reference flow	method citation; factor file; measurement report; model version
`cp_cocoa_harvest_lot_records`	`cocoa_pod_harvest`	mature pod harvest, field loss and hand-off	harvest lot ticket and field record	block_id; crop_year; maturity; pod_mass; harvest_date; field_loss; receiver; lot_id	reconcile harvested pods, field losses and receiver hand-off for each lot; Raw aggregation and attribution: sum harvested pods, field losses and hand-offs by block, crop year and lot	kg pods; kg loss; date; lot	each harvest lot	complete harvest season	all included cocoa blocks and receivers	per declared reference flow	lot ticket; field log; scale record; receiver evidence
`cp_cocoa_pod_extraction_records`	`cocoa_pod_breaking_extraction`	pod input, wet beans, husk, placenta and rejects	pod-opening run sheet and scale record	run_id; pod_input; wet_bean_output; husk; placenta; reject_mass; equipment; operator; date	close the pod-input mass balance and record every destination per opening run; Raw aggregation and attribution: reconcile pod input to wet beans, husk, placenta, rejects and unexplained difference	kg as received; kg wet beans; date; run	each pod-opening run	all included pod-breaking operations	included farm or post-harvest facility	per declared reference flow	calibrated scale; run sheet; destination ticket; mass-balance review
`cp_cocoa_fermentation_batch_records`	`cocoa_fermentation`	wet-bean input, fermentation operation, drainage and fermented output	fermentation batch log	batch_id; input_mass; method; container; start_date; end_date; turns; temperature; drainage; output_mass; reject_mass	link wet-bean input, batch conditions, drainage, fermented output and rejects; Raw aggregation and attribution: aggregate by batch and link each output to its input lot without double counting	kg wet beans; kg drainage; °C; days; date	each fermentation batch and turn	complete included fermentation route	all included fermentation containers	per declared reference flow	batch log; temperature record; turning record; drainage ticket; quality check
`cp_cocoa_drying_batch_records`	`cocoa_drying_stabilization`	fermented wet input, drying energy, dried output and water loss	drying log and moisture sample record	batch_id; wet_input; method; platform_or_dryer; weather_or_fuel; start_time; end_time; temperature; moisture; output_mass; reject_mass ; all inlet/outlet material water including rejects/residues; actual added/rain water; separate liquid exports; opening/closing water stock; wet-basis moisture/density; supported evaporation and uncertainty	reconcile wet input, dry output and loss using documented moisture samples; Raw aggregation and attribution: calculate wet-to-dry balance per batch and preserve measured moisture basis	kg wet input; kg dry beans; percent moisture; °C; days; MJ	each drying batch and moisture sample	complete included drying route	all included drying platforms and dryers	per declared reference flow	drying log; moisture test; fuel or weather record; smoke-control record
`cp_cocoa_grade_lot_records`	`cocoa_cleaning_grading`	dried input, accepted grades, downgraded product, shell, dust and rejects	inspection, grading and scale record	lot_id; input_mass; grade; moisture; defects; accepted_mass; downgrade_mass; shell_mass; dust_mass; reject_mass; destination	enumerate every grade and material destination and reconcile the lot mass balance; Raw aggregation and attribution: sum accepted grades, intended downgrade, residues and rejects separately by lot	kg; percent moisture; grade code; date	each grading lot	complete included cleaning and grading route	all included grading equipment and lots	per declared reference flow	inspection sheet; calibrated scale; moisture and defect record; destination evidence
`cp_cocoa_quality_records`	`cocoa_fermentation` and `cocoa_cleaning_grading`	moisture, fermentation, mould, insects, foreign matter and grade decision	laboratory or documented lot inspection record	sample_id; lot_id; moisture; fermentation_index; mould; insects; foreign_matter; defect_class; grade_decision; method; coverage	retain sampling plan, analytical method, result and decision for each lot; Raw aggregation and attribution: link quality decisions to lot and route state; do not convert rejected material to accepted output	percent; score; kg sample; date	each lot and quality decision	complete included fermentation, drying and grading route	all lots used for declared outputs	per declared reference flow	lab report; sampling plan; method version; inspector sign-off
`cp_cocoa_storage_records`	`cocoa_storage_gate`	accepted dried beans, packaging, storage service, output and loss	warehouse record and storage-period balance	lot_id; opening_mass; packaging; warehouse; start_date; end_date; conditions; receipts; outputs; losses; closing_mass ; opening and closing stock; receipts; dispatch; other external transfers; measured rejects; independently evidenced losses; paired rework; moisture/component basis; unexplained balance	Measure each actual stream and reconcile opening stock + receipts = accepted dispatch + other external transfers + rejected removals + independently evidenced physical losses + closing stock on matching moisture/component bases. Pair rework/returns and keep retained material in stocks. Unexplained residual is an evidence gap, not an automatic waste or release. Preserve attribution and normalize once to matched accepted final output.	kg dried beans; kg loss; storage days; packaging unit	each storage period and lot	complete pre-gate storage period	all included warehouses and lots	per declared reference flow	warehouse log; scale record; condition log; packaging record
`cp_cocoa_residue_destination_records`	route-wide cocoa processes	shell, pulp, sweatings, dust, rejects and other residues	destination ticket, recovery record or treatment/disposal record	residue_type; quantity; destination; receiver; intended_function; treatment; disposal; date; lot_id	document whether each material is a named co-product, recovery, retained residue or waste and record hand-off; Raw aggregation and attribution: classify and aggregate each destination separately; keep undocumented destinations as unresolved	kg material; destination code; date	each residue event	complete included route and storage period	all included field, processing and storage sites	per declared reference flow	destination ticket; receiver evidence; treatment record; waste manifest

Raw downloads

These files are byte-identical to the canonical files for this revision in the repository.

pcr.en-US.md103 KB · 21c1b00f3680…
manifest.yaml19 KB · f83f496e87c0…
pcr.zh-CN.md92 KB · ea6b2768d16d…
structured.yaml137 KB · 88e808a5aa5e…

Structured rule index

This index comes from verified structured.yaml and retains the canonical English rule text.

System boundary rules · 8

Rule ID	Applies to	Rule	Source IDs
`system_boundary_rule_1`	foreground_system_boundary	The default foreground boundary starts with the managed cacao stand and declared crop year or perennial phase and ends with fresh wet beans in pulp at the farm gate. It includes attributable establishment and replacement, field management, direct field emissions, mature-pod harvest, pod breaking, separation of husk/placenta and wet-bean extraction. A fresh-pod sale or hand-off is an intermediate boundary and cannot be reported as the wet-bean reference result. Off-site or contracted extraction remains a linked operation with its input/output masses, service burdens and residues included once. The postharvest_extension flag controls fermentation and later operations only; turning it off never removes extraction. Purchased inputs use compatible upstream datasets at the actual receiving state, without also charging their included operations again.
`system_boundary_rule_2`	foreground_system_boundary	The reference gate is the platform's fresh, unprocessed farm-gate state. Fermented, dried and graded beans are downstream route states within the extended process map, not alternative meanings of the same reference UUID. The data package must state whether the farm-gate reference stops at wet-bean hand-off or whether a post-harvest extension is reported. Roasting, grinding, alkalization, pressing, cocoa liquor, cocoa butter, cocoa powder, chocolate, prepared foods, retail and consumer use are downstream and excluded.
`boundary_01`	managed production	Include cultivation, harvest, pod opening and wet-bean extraction through the fresh wet-bean farm-gate hand-off. Attribute establishment, replacement and termination to represented production. A pod-only hand-off cannot satisfy this reference boundary.	fao-cocoa-production-guide, icco-cocoa-harvesting-post-harvest, iso-14044-2006
`boundary_02`	reference gate	Treat Cocoa beans with Production mix, at farm gate and Fresh, unprocessed produce as the declared reference identity. Do not use the UUID for fermented, dried or graded bean states without a separate identity decision.	iso-14044-2006, mass-balance-identity
`boundary_03`	pod breaking and fermentation	Pod breaking and wet-bean extraction are required before the reference hand-off: link harvested pod mass to wet beans in pulp, husk/placenta, rejects and losses. Fermentation is additional and conditional on the declared extension; link its drainage, rejects and output separately.	icco-cocoa-harvesting-post-harvest, fao-cocoa-ota-code
`boundary_04`	drying, grading and storage	Include drying/stabilization, cleaning, grade separation and pre-gate storage only when they cross the declared extension. Record energy, moisture, storage time, contamination controls and losses.	icco-cocoa-processing, icco-cocoa-quality-requirements
`boundary_05`	upstream inputs	Treat purchased inputs, utilities, packaging, treatment and transport services as separately identified upstream inputs. Do not recurse into another cocoa PCR or silently use cocoa waste or paste as a bean input.	iso-14044-2006
`boundary_06`	losses and rejects	Keep field losses, damaged pods, unextracted beans, spoiled or unfermented beans, drying losses, mouldy beans, dust, shells, storage losses and rejected lots in the foreground until a documented recovery, co-product, treatment or disposal hand-off exists.	fao-cocoa-ota-code, icco-cocoa-quality-requirements, mass-balance-identity

Allocation rules · 6

Rule ID	Applies to	Rule	Source IDs
`allocation_rule_1`	foreground_burden_allocation	Sequential wet, fermented, dried and graded bean states are not co-products and receive no allocation between states. First subdivide by pod lot, fermentation batch, drying batch and grading lot. Record every intended output hand-off before applying allocation.
`allocation_01`	sequential cocoa states	Do not allocate burdens between wet, fermented wet, dried and graded beans; link them by mass and moisture balances.	iso-14044-2006, mass-balance-identity
`allocation_02`	pod breaking and fermentation	Treat pod husk, placenta, pulp and sweatings as residues by default. An intended co-product requires a named destination, quantity, quality specification and hand-off.	icco-cocoa-harvesting-post-harvest, fao-cocoa-ota-code
`allocation_03`	intended co-products	Prefer subdivision. If intended outputs remain, use measured mass allocation for comparable material outputs; use an economic sensitivity when functions differ materially and retain price period and denominator.	iso-14044-2006, mass-balance-identity
`allocation_04`	rejects and downgrade	Do not allocate rejected beans to accepted cocoa output. A downgraded saleable lot requires its own intended-output hand-off; recovered material retains producing-node burden unless a documented recovery boundary exists.	icco-cocoa-quality-requirements, fao-cocoa-ota-code
`allocation_05`	batches and perennial phases	Attach shared equipment, cleaning, changeover, drying platforms and plantation phase burdens to the generating run, crop year or phase exactly once.	iso-14044-2006, mass-balance-identity

Validation rules · 10

Rule ID	Applies to	Rule	Source IDs
`validation_01`	reference flow	Confirm UUID 3c54da37-f1ab-4b4c-8363-5c32b638005c, Mass property 93a60a56-a3c8-11da-a746-0800200b9a66 and Units of mass group 93a60a57-a4c8-11da-a746-0800200c9a66; retain farm-gate fresh/unprocessed metadata.	mass-balance-identity
`validation_02`	state identity	Reject use of the reference UUID for fermented, dried, graded, cocoa waste or cocoa paste material without a reviewed identity decision.	mass-balance-identity, iso-14044-2006
`validation_03`	process graph	Require production-to-harvest-to-pod-opening-to-wet-bean hand-offs for every wet-reference result, even with postharvest_extension=false. Check pod, wet-bean, husk/placenta and loss records and contracted-service scope. Reject a pod-only result labelled as wet beans. For an extension, additionally validate each included fermentation, drying, grading and storage hand-off.	icco-cocoa-harvesting-post-harvest, fao-cocoa-ota-code
`validation_04`	mass balance	Reconcile each lot's inputs, accepted outputs, intended co-products, residues, rejects, storage losses and moisture-related water loss within measurement uncertainty.	mass-balance-identity
`validation_05`	fermentation	Require batch id, dates, method, drainage, output hand-off and inspection evidence; unresolved off-spec routing blocks the extended route.	fao-cocoa-ota-code, icco-cocoa-harvesting-post-harvest
`validation_06`	drying	Require method, input/output, final moisture and smoke or contamination control. Use 6–8% only as screening; measured lot moisture governs.	icco-cocoa-processing, icco-cocoa-quality-requirements
`validation_07`	grades and rejects	Every accepted grade and intended downgrade has a hand-off; mouldy, broken, contaminated or off-spec material cannot be counted as accepted beans.	fao-cocoa-production-guide, icco-cocoa-quality-requirements
`validation_08`	allocation	Confirm every intended output, residue destination and allocation denominator. Sequential states are not allocated against each other and shared burdens are not double-counted.	iso-14044-2006, mass-balance-identity
`validation_09`	data quality	Check crop-year coverage, lot completeness, moisture basis, protocol linkage, sources, method version and units for every important quantitative flow.	iso-14044-2006, ipcc-2019-refinement-afolu
`validation_10`	boundary disclosure	Require a fresh wet-bean base result with extraction included. Report any downstream extension as a separate boundary/result with its own state, gate and measured conversion; extension operations must not be folded into the base wet farm-gate inventory. State storage and downstream exclusions.	iso-14044-2006

Processes and inputs/outputs · 7

Process ID	Process name	Input flows	Output flows
`cocoa_managed_production`	Managed cacao production	10	0
`cocoa_pod_harvest`	Mature cocoa-pod harvest and collection	0	2
`cocoa_pod_breaking_extraction`	Pod breaking and wet-bean extraction	3	3
`cocoa_fermentation`	Cocoa-bean fermentation	2	4
`cocoa_drying_stabilization`	Fermented-bean drying and stabilization	4	8
`cocoa_cleaning_grading`	Cleaning, grading and reject routing	3	5
`cocoa_storage_gate`	Storage and declared gate hand-off	4	2

Complete field inspector

Loads this record’s complete manifest and structured projection on demand; values are never truncated. Requires JavaScript.

Cocoa beans

Content languages

Readiness

Classification mapping

Source

1. Scope and Applicability

2. Product Category Identity

3. Reference Flow

4. Measurement and Unit Rules

5. System Boundary

Boundary Abstraction

Boundary Rules

6. Process Inventory Structure

Process Map

Process: Managed cacao production (cocoa_managed_production)

Inputs

Product flows

Cocoa planting material and replacement plants (cocoa_planting_material)

Fertilizer, urea input (cocoa_managed_production_agricultural_nutrient_inputs)

Fertilizer, monoammonium phosphate input (cocoa_managed_production_agricultural_nutrient_inputs_monoammonium_phosphate)

Fertilizer, potassium chloride input (cocoa_managed_production_agricultural_nutrient_inputs_potassium_chloride)

Cattle manure, as applied input (cocoa_managed_production_agricultural_nutrient_inputs_cattle_manure)

Agricultural limestone input (cocoa_managed_production_agricultural_nutrient_inputs_agricultural_limestone)

Irrigation water supplied (cocoa_irrigation_water)

Electricity, medium voltage (cocoa_field_energy)

Diesel fuel (cocoa_field_energy_diesel)

Elementary flows

Cacao land occupation (cocoa_land_occupation)

Outputs

Elementary flows

Process: Mature cocoa-pod harvest and collection (cocoa_pod_harvest)

Inputs

Product flows

Outputs

Product flows

Harvested fresh cocoa pods (cocoa_harvested_pods)

Waste flows

Unharvested, damaged or field-dropped pods (cocoa_field_pod_losses)

Process: Pod breaking and wet-bean extraction (cocoa_pod_breaking_extraction)

Inputs

Product flows

Harvested fresh cocoa pods (cocoa_pod_extraction_input)

Electricity, medium voltage (cocoa_pod_opening_energy)

Diesel fuel (cocoa_pod_opening_energy_diesel)

Outputs

Product flows

Wet cocoa beans in pulp (cocoa_wet_beans_in_pulp)

Waste flows

Cocoa pod husk and placenta residue (cocoa_pod_husk_residue)

Unextracted or damaged wet-bean rejects (cocoa_extraction_rejects)

Process: Cocoa-bean fermentation (cocoa_fermentation)

Inputs

Product flows

Wet cocoa beans in pulp (cocoa_fermentation_input)

Electricity, medium voltage (cocoa_fermentation_services)

Outputs

Product flows

Fermented wet cocoa beans (cocoa_fermented_wet_beans)

Waste flows

Spoiled, unfermented or off-spec fermentation rejects (cocoa_fermentation_rejects)

Elementary flows

Carbon dioxide, biogenic, to air (cocoa_fermentation_emissions)

Methane, to air (cocoa_fermentation_emissions_ch4)

Process: Fermented-bean drying and stabilization (cocoa_drying_stabilization)

Inputs

Product flows

Fermented wet cocoa beans (cocoa_drying_input)

Electricity, medium voltage (cocoa_drying_energy)

Diesel fuel (cocoa_drying_energy_diesel)

Purchased steam (cocoa_drying_energy_steam)

Outputs

Product flows

Fermented, dried cocoa beans (cocoa_dried_fermented_beans)

Waste flows

Mouldy, contaminated or over-dried bean rejects (cocoa_drying_rejects)

Elementary flows

Carbon dioxide, fossil, to air (cocoa_drying_emissions)

Carbon dioxide, biogenic, to air (cocoa_drying_emissions_co2_biogenic)

Methane, to air (cocoa_drying_emissions_ch4)

Dinitrogen monoxide, to air (cocoa_drying_emissions_n2o)

Process: Managed cacao production (`cocoa_managed_production`)

Cocoa planting material and replacement plants (`cocoa_planting_material`)

Fertilizer, urea input (`cocoa_managed_production_agricultural_nutrient_inputs`)

Fertilizer, monoammonium phosphate input (`cocoa_managed_production_agricultural_nutrient_inputs_monoammonium_phosphate`)

Fertilizer, potassium chloride input (`cocoa_managed_production_agricultural_nutrient_inputs_potassium_chloride`)

Cattle manure, as applied input (`cocoa_managed_production_agricultural_nutrient_inputs_cattle_manure`)

Agricultural limestone input (`cocoa_managed_production_agricultural_nutrient_inputs_agricultural_limestone`)

Irrigation water supplied (`cocoa_irrigation_water`)

Electricity, medium voltage (`cocoa_field_energy`)

Diesel fuel (`cocoa_field_energy_diesel`)

Cacao land occupation (`cocoa_land_occupation`)

Process: Mature cocoa-pod harvest and collection (`cocoa_pod_harvest`)

Harvested fresh cocoa pods (`cocoa_harvested_pods`)

Unharvested, damaged or field-dropped pods (`cocoa_field_pod_losses`)

Process: Pod breaking and wet-bean extraction (`cocoa_pod_breaking_extraction`)

Harvested fresh cocoa pods (`cocoa_pod_extraction_input`)

Electricity, medium voltage (`cocoa_pod_opening_energy`)

Diesel fuel (`cocoa_pod_opening_energy_diesel`)

Wet cocoa beans in pulp (`cocoa_wet_beans_in_pulp`)

Cocoa pod husk and placenta residue (`cocoa_pod_husk_residue`)

Unextracted or damaged wet-bean rejects (`cocoa_extraction_rejects`)

Process: Cocoa-bean fermentation (`cocoa_fermentation`)

Wet cocoa beans in pulp (`cocoa_fermentation_input`)

Electricity, medium voltage (`cocoa_fermentation_services`)

Fermented wet cocoa beans (`cocoa_fermented_wet_beans`)

Spoiled, unfermented or off-spec fermentation rejects (`cocoa_fermentation_rejects`)

Carbon dioxide, biogenic, to air (`cocoa_fermentation_emissions`)

Methane, to air (`cocoa_fermentation_emissions_ch4`)

Process: Fermented-bean drying and stabilization (`cocoa_drying_stabilization`)

Fermented wet cocoa beans (`cocoa_drying_input`)

Electricity, medium voltage (`cocoa_drying_energy`)

Diesel fuel (`cocoa_drying_energy_diesel`)

Purchased steam (`cocoa_drying_energy_steam`)

Fermented, dried cocoa beans (`cocoa_dried_fermented_beans`)

Mouldy, contaminated or over-dried bean rejects (`cocoa_drying_rejects`)

Carbon dioxide, fossil, to air (`cocoa_drying_emissions`)

Carbon dioxide, biogenic, to air (`cocoa_drying_emissions_co2_biogenic`)

Methane, to air (`cocoa_drying_emissions_ch4`)

Dinitrogen monoxide, to air (`cocoa_drying_emissions_n2o`)

Particulate matter, particle size unspecified, to air (`cocoa_drying_emissions_dust`)

Drying water loss (`cocoa_drying_water_loss`)

Process: Cleaning, grading and reject routing (`cocoa_cleaning_grading`)

Fermented, dried cocoa beans (`cocoa_cleaning_input`)

Electricity, medium voltage (`cocoa_cleaning_energy`)

Diesel fuel (`cocoa_cleaning_energy_diesel`)

Accepted graded fermented cocoa beans (`cocoa_accepted_graded_beans`)

Intended downgraded cocoa-bean product (`cocoa_downgraded_intended_output`)

Cocoa shell, dust and foreign-material residue (`cocoa_shell_dust_residue`)

Rejected cocoa-bean lot (`cocoa_grading_rejects`)

Cleaning dust emissions (`cocoa_cleaning_dust`)

Process: Storage and declared gate hand-off (`cocoa_storage_gate`)

Accepted graded fermented cocoa beans (`cocoa_storage_input`)

Electricity, medium voltage (`cocoa_storage_services`)

Paperboard packaging (`cocoa_storage_services_paper`)

Polyethylene packaging film (`cocoa_storage_services_film`)

Declared post-harvest dried-bean gate output (`cocoa_declared_dried_gate_output`)

Storage loss and quality downgrade (`cocoa_storage_losses`)