Whole raw Piper pepper at producer dispatch
- Lifecycle status
- Candidate
- Content maturity
- Authored methodology
- Current version
- No published versionLast updated
- Readiness
- Review required
Methodology and translation states come from the source record; publishing this website does not change their review status.
Content languages
Status, classification and source details
Readiness
- Warnings methodology_not_reviewed Authored methodology is candidate guidance and still requires methodology review.
Classification mapping
Source
1. Scope and Applicability
This PCR covers whole, neither crushed nor ground Piper spp. pepper berries at producer dispatch. It covers fresh berries and primary dried whole berries as separately declared physical states. The representative route is Piper nigrum vine cultivation, berry harvest, primary cleaning and drying, and grading of whole black pepper. White or green whole-pepper routes must declare their different maturity and conditioning, including soaking and pericarp removal when performed. Fresh dispatch omits drying. It excludes crushed, ground, extracted or blended pepper, Capsicum and Pimenta fruits, and post-dispatch stages. The raw/processed classification distinction follows un-cpc3; route facts follow fao-ecocrop-pepper and kau-pepper-harvest.
2. Product Category Identity
| Field | Value |
|---|---|
| canonical_pcr_id | pcr.agriculture-forestry-and-fishery-products.products-of-agriculture-horticulture-and-market-gardening.pepper-piper-spp-raw |
| classification_refs | CPC 3.0 01651, Pepper (Piper spp.), raw; mapping relation: exact |
| covered_products | Whole unground Piper berries, fresh or primary dried, with declared species, form and moisture |
| excluded_products | Processed, crushed, ground or extracted Piper pepper; Capsicum and Pimenta peppers |
| representative_product | Primary dried whole black Piper nigrum berries |
| production_route | Managed perennial vines → harvest → conditional primary cleaning/drying → grading → dispatch |
| market_state | Whole berries at producer gate, with colour/form, fresh/dried state, grade and moisture |
3. Reference Flow
| Field | Value |
|---|---|
| What | Whole raw Piper pepper berries at producer dispatch |
| How much | 1 kg net accepted berries |
| How well | Species, whole form, colour/conditioning branch, moisture and grade stated |
| How long or cycle | Output from a stated harvest season, with establishment attributed over recorded productive years |
| reference_flow_link | accepted_pepper |
| Field | Value |
|---|---|
| Reference amount | 1 |
| Reference product flow | Whole raw Piper pepper; UUID unresolved for dried state |
| 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 | species; whole unground form; black/white/green branch; fresh/dried state; moisture; grade; producer gate; harvest period |
| Reference identity status | unresolved |
The verified TianGong flow for fresh raw pepper is 1015c13e-e71a-4eb4-8a03-9ce3e096cee5. Its description says “Fresh, unprocessed produce”, so it is not assigned to the dried representative. The dried reference remains unmapped until identity review; fresh and dried kilograms are never silently interchanged.
4. Measurement and Unit Rules
| rule_id | Applies to | Required property | Required unit | Rule |
|---|---|---|---|---|
net_mass | Accepted pepper | Mass 93a60a56-a3c8-11da-a746-0800200b9a66 | kg | Weigh net whole berries after removing packaging, rejects and foreign matter. |
moisture | State conversion | Mass 93a60a56-a3c8-11da-a746-0800200b9a66 | kg | For a moisture-only comparison of the same dry constituent pool, equivalent mass = initial mass*(1-initial wet-basis moisture)/(1-target wet-basis moisture). This is not a fresh-to-dried production-yield formula where pericarp, rejects, solubles, other dry constituents or stocks leave or enter. For actual conditioning retain measured inlet/outlet masses and moisture and a complete component ledger including removed material and liquid paths; normalize by actual accepted output, never the moisture-only estimate. |
period | Perennial input | Mass 93a60a56-a3c8-11da-a746-0800200b9a66 | kg | Attribute establishment and replacement burdens to evidenced productive periods before dividing by accepted kg. |
5. System Boundary
Boundary Abstraction
| Field | Value |
|---|---|
| declared_starting_condition | Managed Piper vines, plot, support structures and upstream inputs at reporting-period start |
| starting_condition_role | Foreground starting stock and upstream supply interface, including attributable establishment |
| product_classification_scope | CPC 01651 whole unground Piper berries; keep each moisture and conditioning branch distinct |
| recursive_input_rule | Purchased same-category pepper is a separate input with upstream dataset and origin; do not recreate its cultivation within this foreground system. |
| upstream_dataset_requirement | Supply-specific planting, fertilizer, water, fuel, electricity and purchased-pepper datasets |
| disclosure | Species, plot, vine age, harvest, fresh/dried state, moisture, conditioning, grades, losses, rejects and destinations |
Boundary Rules
| rule_id | Applies to | Rule | source_ids |
|---|---|---|---|
boundary_dispatch | All routes | Include attributable vine establishment, cultivation, harvest, performed primary conditioning and grading to producer dispatch; exclude grinding, extraction, retail and later transport. | un-cpc3; fao-ecocrop-pepper |
boundary_branch | Fresh/black/white/green | Record only actual drying, soaking and pericarp removal with their inputs, effluent and residues; never assign zero drying to a dried lot. | fao-ecocrop-pepper; kau-pepper-harvest |
boundary_soil | Fertilized plots | Calculate direct and indirect soil N₂O and applicable lime/urea CO₂ from recorded inputs and documented factors. | ipcc-2019-afolu11 |
boundary_shared | Supports, pumps and dryers | Name consuming processes and years; attribute shared asset burden once. | fao-ecocrop-pepper |
6. Process Inventory Structure
Process Map
| process_id | process_name | inclusion | inclusion_condition | role | quantitative_reference |
|---|---|---|---|---|---|
pepper_cultivation | Perennial vine cultivation | required | Include establishment and replacements over served harvests | Standing berry crop | Plot-year and harvest kg |
pepper_harvest | Berry harvest | required | Distinct removal of berries from managed vines | Fresh collected berries | Harvest-lot kg |
pepper_conditioning | Primary conditioning | conditional | Include actual cleaning, drying, soaking or pericarp removal; omit for fresh direct dispatch | Prepared whole berries | Paired lot kg and moisture |
pepper_grading | Grading and dispatch | required | Distinguish accepted, downgraded and rejected states | Reference flow | Accepted net kg |
Cultivation produces standing berries; harvest independently removes them and hands fresh lots to conditioning or directly to grading. Conditioning transfers prepared whole berries to grading. Grading sends accepted and downgraded saleable whole lots to separately declared buyers. Every rejected lot has a rework, recovery or waste path; a rework loop returns to its named producing node, retaining prior burden once.
Process: Perennial vine cultivation (pepper_cultivation)
Inputs
Product flows
Piper nigrum rooted cuttings (cultivation_inputs)
Record Piper nigrum rooted cuttings 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. Raw activity or stage basis: Plot-year and accepted pepper output.
- Selected flow: Piper nigrum rooted cuttings
- Flow property / unit: Mass / kg
- Amount rule: Measured net quantity of Piper nigrum rooted cuttings, 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:
crop_cycle - Evidence kind:
collected_record - Collection protocol:
cp_cultivation
Required support-material records: identify each actual constructed support, tying material and replacement by its concrete material, measured quantity, installation date and service life. Keep live support vegetation and constructed assets distinct, and attribute each included asset once across all served crops, processes and periods. Missing material identity remains a completeness gap; do not substitute a generic support-material exchange.
Fertilizer, urea (cultivation_inputs_fertilizer)
Record Fertilizer, urea 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. Raw activity or stage basis: Plot-year and accepted pepper output.
- Selected flow: Fertilizer, urea
- Flow property / unit: Mass / kg product
- Amount rule: Measured net quantity of Fertilizer, urea, 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:
crop_cycle - Evidence kind:
collected_record - Collection protocol:
cp_cultivation
Fertilizer, monoammonium phosphate (cultivation_inputs_fertilizer_map)
Record Fertilizer, monoammonium phosphate 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. Raw activity or stage basis: Plot-year and accepted pepper output.
- Selected flow: Fertilizer, monoammonium phosphate
- Flow property / unit: Mass / kg product
- Amount rule: Measured net quantity of Fertilizer, monoammonium phosphate, 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:
crop_cycle - Evidence kind:
collected_record - Collection protocol:
cp_cultivation
Fertilizer, potassium chloride (cultivation_inputs_fertilizer_kcl)
Record Fertilizer, potassium chloride 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. Raw activity or stage basis: Plot-year and accepted pepper output.
- Selected flow: Fertilizer, potassium chloride
- Flow property / unit: Mass / kg product
- Amount rule: Measured net quantity of Fertilizer, potassium chloride, 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:
crop_cycle - Evidence kind:
collected_record - Collection protocol:
cp_cultivation
Cattle manure, as applied (cultivation_inputs_fertilizer_manure)
Record Cattle manure, as applied 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. Raw activity or stage basis: Plot-year and accepted pepper output.
- Selected flow: Cattle manure, as applied
- Flow property / unit: Mass / kg product
- Amount rule: Measured net quantity of Cattle manure, as applied, 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:
crop_cycle - Evidence kind:
collected_record - Collection protocol:
cp_cultivation
One identified irrigation-water source (cultivation_inputs_irrigation_water)
Use this conditional card for exactly one actual material, product or waste stream in the declared process. Confirm its identity, physical state, period and destination from route records; instantiate a separate card for every other distinct stream. The template does not assert use or generation.
-
Selected flow: One identified irrigation-water source; exact route identity unresolved
-
Flow property / unit: Volume / m3 water
-
Amount rule: Measure or calculate only this one identified stream for the declared process and period, with its own unit and destination; do not combine other products or waste states.
-
Value mode: Foreground record (
foreground_record) -
Specificity: Site-specific (
site_specific) Raw activity or stage basis: Plot-year and accepted pepper output. -
Normalization basis: per declared reference flow
-
Basis kind: Crop cycle (
crop_cycle) -
Evidence kind: Collected record (
collected_record) -
Collection protocol:
cp_cultivation
Diesel fuel (cultivation_inputs_fuel)
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: Plot-year and accepted pepper output.
- 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:
crop_cycle - Evidence kind:
collected_record - Collection protocol:
cp_cultivation
Waste flows
Pruned vines, spent supports and containers follow measured recovery or disposal routes under cp_residues.
Elementary flows
Record environmental irrigation withdrawal as an input only where water is taken directly from the environment rather than supplied as a purchased product.
Outputs
Product flows
Standing berries transfer to pepper_harvest; they are an intermediate, not an additional sold product.
Waste flows
Record vine residues by mass and destination under cp_residues.
Elementary flows
Report managed-soil gas outputs as separate pollutant exchanges.
Managed-soil nitrous oxide to air (soil_nitrous_oxide_emission)
Calculate direct and indirect N₂O from recorded nitrogen inputs and site-year activity. Keep its quantity separate from carbon dioxide and verify the receiving air subcompartment before binding a UUID.
-
Selected flow: Nitrous oxide to air; receiving air subcompartment to be verified
-
Flow property / unit: Mass / kg N2O
-
Amount rule: Apply the selected direct/indirect N2O method only to this nitrous-oxide exchange. Calculate lime/urea CO2 separately on its own carbon-dioxide card; never add CO2 mass to N2O.
-
Value mode: Calculated value (
calculated_value) -
Specificity: Site-specific (
site_specific) Raw activity or stage basis: Plot-year then accepted pepper output. -
Normalization basis: per declared reference flow
-
Basis kind: N input (
n_input) -
Evidence kind: Calculated from collection (
calculated_from_collection) -
Collection protocol:
cp_cultivation -
Sources:
ipcc-2019-afolu11
Calculation method corresponds to Section 8 rules: calc_soil_gases.
Carbon dioxide from lime or urea (soil_amendment_carbon_dioxide_emission)
Include this exchange only when lime or urea use and the selected method support a direct CO₂ calculation. Keep its quantity separate from N₂O and verify the receiving air subcompartment before binding a UUID.
-
Selected flow: Carbon dioxide to air from lime or urea; receiving air subcompartment to be verified
-
Flow property / unit: Mass / kg CO2
-
Amount rule: Calculate only molecular CO2 from the actual lime/carbonate or urea application using its compatible carbon-content and oxidation/release method. Keep source-specific applied product quantities, factor units and carbon origin. This CO2 card excludes N2O; apply the soil-N2O method to the separate N2O card and do not add supply-chain or combustion emissions already reported elsewhere. Attribute and normalize once.
-
Value mode: Calculated value (
calculated_value) -
Specificity: Site-specific (
site_specific) Raw activity or stage basis: Plot-year then accepted pepper output. -
Normalization basis: per declared reference flow
-
Basis kind: Crop cycle (
crop_cycle) -
Evidence kind: Calculated from collection (
calculated_from_collection) -
Collection protocol:
cp_cultivation -
Sources:
ipcc-2019-afolu11
Calculation method corresponds to Section 8 rules: calc_soil_gases.
Process: Berry harvest (pepper_harvest)
Inputs
Product flows
Standing crop and actual harvest energy enter from cultivation and supplier records.
Waste flows
No waste input is assumed.
Elementary flows
Direct equipment emissions require activity and factor evidence; avoid double counting upstream fuel burdens.
Outputs
Product flows
Fresh collected berries (fresh_berries)
Weigh each whole-berry lot before conditioning and record harvest maturity.
-
Selected flow: Fresh whole Piper berries; intermediate UUID unresolved
-
Flow property / unit: Mass / kg
-
Amount rule: Sum receiving scale tickets by lot
-
Value mode: Foreground record (
foreground_record) -
Specificity: Site-specific (
site_specific) Raw activity or stage basis: Harvest lot. -
Normalization basis: per declared reference flow
-
Basis kind: Process output (
process_output) -
Evidence kind: Collected record (
collected_record) -
Collection protocol:
cp_harvest
Waste flows
Damaged berries and field losses are kept outside accepted yield and routed under cp_residues.
Elementary flows
No elementary output is assumed without evidence.
Process: Primary conditioning (pepper_conditioning)
Inputs
Product flows
Fresh whole Piper berries (conditioning_inputs)
Record Fresh whole Piper berries 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. Raw activity or stage basis: Conditioned lot output.
- Selected flow: Fresh whole Piper berries
- Flow property / unit: Mass / kg
- Amount rule: Measured net quantity of Fresh whole Piper berries, 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_conditioning - Sources:
kau-pepper-harvest
Electricity, medium voltage (conditioning_inputs_electricity)
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: Conditioned lot output.
- 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_conditioning - Sources:
kau-pepper-harvest
Diesel fuel (conditioning_inputs_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: Conditioned lot output.
- 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_conditioning - Sources:
kau-pepper-harvest
Process water (conditioning_inputs_water)
Record Process water 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. Raw activity or stage basis: Conditioned lot output.
- Selected flow: Process water
- Flow property / unit: Volume / m3
- Amount rule: Measured net quantity of Process water, 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_conditioning - Sources:
kau-pepper-harvest
Waste flows
No waste input is assumed.
Elementary flows
Direct withdrawal is recorded only for environment-supplied water.
Outputs
Product flows
Prepared whole berries (prepared_berries)
Transfer cleaned or dried whole berries to grading with measured moisture and branch.
-
Selected flow: Whole prepared Piper pepper; UUID unresolved for dried state
-
Flow property / unit: Mass / kg
-
Amount rule: Net output scale weight
-
Value mode: Foreground record (
foreground_record) -
Specificity: Site-specific (
site_specific) Raw activity or stage basis: Conditioned lot. -
Normalization basis: per declared reference flow
-
Basis kind: Process output (
process_output) -
Evidence kind: Collected record (
collected_record) -
Collection protocol:
cp_conditioning
Waste flows
Detached stalks, damaged berries and any removed pericarp are weighed and routed under cp_residues.
Elementary flows
Moisture lost to air is calculated by paired mass/moisture balance; water-using routes record effluent and treatment. UUID remains unresolved by compartment.
Process: Grading and dispatch (pepper_grading)
Inputs
Product flows
Link prepared or fresh whole lots to grading. Purchased same-category pepper carries a separate upstream dataset. Record grading electricity under cp_grading.
Waste flows
Returned rejects require origin-lot linkage.
Elementary flows
No elementary output is assumed for mechanical grading.
Outputs
Product flows
Accepted whole raw pepper (accepted_pepper)
Only saleable whole berries meeting declared grade and moisture enter the reference output. This is an intended output, separately from the downgraded saleable grade.
-
Selected flow: Whole raw Piper pepper; UUID unresolved for dried state
-
Flow property / unit: Mass
93a60a56-a3c8-11da-a746-0800200b9a66/ kg Raw output measurement and reconciliation: Calibrated net dispatch mass -
Amount rule: 1 kg
-
Value mode: Foreground record (
foreground_record) -
Specificity: Site-specific (
site_specific) Raw activity or stage basis: 1 kg accepted raw pepper. -
Normalization basis: per declared reference flow
-
Basis kind: Reference flow (
reference_flow) -
Evidence kind: Collected record (
collected_record) -
Collection protocol:
cp_grading
Downgraded saleable whole pepper (downgraded_pepper)
Weigh each separately sold whole grade and record destination. This is a second intended output; dried-state UUID remains unresolved.
-
Selected flow: Whole raw Piper pepper; UUID unresolved for dried state
-
Flow property / unit: Mass / kg
-
Amount rule: Net weighed downgraded lot mass
-
Value mode: Foreground record (
foreground_record) -
Specificity: Site-specific (
site_specific) Raw activity or stage basis: Grading input. -
Normalization basis: per declared reference flow
-
Basis kind: Process output (
process_output) -
Evidence kind: Collected record (
collected_record) -
Collection protocol:
cp_grading
Waste flows
Grading rejects (grading_rejects)
Weigh off-spec berries and foreign matter by lot; record rework, recovery or disposal destination, excluding them from accepted kg.
-
Selected flow: Actual reject material; UUID unresolved by destination
-
Flow property / unit: Mass / kg
-
Amount rule: Lot-specific weighed rejects
-
Value mode: Foreground record (
foreground_record) -
Specificity: Site-specific (
site_specific) Raw activity or stage basis: Grading input. -
Normalization basis: per declared reference flow
-
Basis kind: Process output (
process_output) -
Evidence kind: Collected record (
collected_record) -
Collection protocol:
cp_residues
Elementary flows
No elementary output is assumed for mechanical grading.
7. Allocation and Co-product Handling
| rule_id | Applies to | Rule | source_ids |
|---|---|---|---|
allocate_periods | Establishment and replacements | Assign recorded vine and support burdens to evidenced productive years and outputs; retain nonproductive establishment and termination events and count each burden once. | fao-ecocrop-pepper |
allocate_shared | Supports, pumps and dryers | List consumers and service years, allocate by measured use or documented physical proxy, and reconcile assigned burden to recorded total. | fao-ecocrop-pepper |
allocate_grades | Saleable whole grades | Partition common burdens by measured mass when grades have the same physical function; justify another rule if materially different. Rejects receive no co-product credit. | un-cpc3 |
allocate_rework | Reworked or recovered berries | Keep prior lot burden and add incremental rework once; credit recovery only with evidenced destination and method. | kau-pepper-harvest |
| rule_id | Applies to | Rule | source_ids |
|---|---|---|---|
allocation_residual_precedence | remaining common burden with no specified primary branch | Resolve any study-specific joint-product instruction in this PCR that has no specified primary branch using this precedence; retain an already explicitly prescribed category-specific primary method. First directly assign separable output-specific activities. For the remaining common burden B, use a physical driver d_i only when measured operation or biological-service records demonstrate the causal consumption represented by that driver. A product being weighable, valuable or lower grade alone is insufficient; do not switch arbitrarily between area, time, mass and revenue. For comparable grades receiving the same common handling, measured processed mass is applicable only with the same service demand, state and moisture basis demonstrated. Share a_i=d_i/sum(d_j); B_i=Ba_i. If no defensible causal physical driver exists for that common operation, use gate- and period-matched economic shares a_i=(q_ip_i)/sum(q_j*p_j), with the complete independently intended output set, compatible quantity/price units, currency, representative prices and values before output-specific downstream processing. Missing price or denominator evidence makes the allocated result incomplete, not a zero-priced product or a single-output system. Report shares summing to one and sensitivity to a material alternative; an alternative is not an interchangeable primary result. Waste, retained residues and internal transfers receive no co-product share, while their attributable production/handling burdens remain with the producing saleable route. Retain unallocated physical quantities and mass balances separately. This branch gives no automatic substitution credit; any separately scoped substitution analysis retains the gross inventory and its actual displaced-function evidence. | ghg-protocol-product-standard-2011 |
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_cultivation | pepper_cultivation | vine, supports, inputs and soil gases | Plot-year ledger | plot; year; planting/replacement; material; nutrient content; quantity; supplier; meter | Invoice, field log and meter; Raw aggregation and attribution: Sum by material and year, then assign service periods | kg, plant, m3, kWh, L | Each event | Establishment through harvest | Each plot | per declared reference flow | Invoice, nutrient certificate and meter |
cp_harvest | pepper_harvest | standing and fresh berries | Harvest lot | plot; date; species; maturity; fresh kg; field loss; energy | Scale and field log; Raw aggregation and attribution: Sum non-overlapping lots | kg, kWh, L | Each lot | Every reported harvest | Each plot | per declared reference flow | Scale ticket and trace |
cp_conditioning | pepper_conditioning | state conversion, energy, water, losses | Batch ledger | lot; incoming/outgoing kg; moisture before/after; energy; water; effluent; branch | Scale, test and meter; Raw aggregation and attribution: Paired mass/moisture balance | kg, %, kWh, m3 | Each batch | Every conditioned lot | Each facility | per declared reference flow | Batch sheet and test |
cp_grading | pepper_grading | accepted and downgraded output | Grade ledger | lot; species; state; moisture; grade; accepted/downgraded kg; buyer | Scale and dispatch ticket; Raw aggregation and attribution: Sum accepted after rejects | kg, % | Each lot | All dispatches | Each facility | per declared reference flow | Scale ticket and sale |
cp_residues | all nodes | rejects, rework and residues | Destination ledger | origin lot; material; kg; return node; destination | Scale and destination receipt; Raw aggregation and attribution: Count each route once | kg | Each event | Same harvest period | Each site | per declared reference flow | Weigh ticket and receipt |
cp_phase1_environment_coverage | pepper_cultivation | managed environmental coverage by actual node | site/activity/method ledger | site and actual managed nodes; area; dated occupation intervals; co-users; establishment/immature history; actual prior/current land classes and transformation dates/areas; carbon-method coverage; upstream land coverage | Collect original records by the actual responsible production node and matched lot/period; retain provenance, method applicability and uncertainty. Reconcile with existing protocols and provider coverage, do not add duplicate events. Explicitly document inapplicability; absent evidence is a gap. | native activity units; kg N or substance; area/time as applicable | event and annual/lot reconciliation | matched production/cohort period | all actual managed-production nodes | apply applicable coverage calculations then final normalization once | original records, method worksheets and applicability evidence |
Calculation Rules
| rule_id | Applies to | Formula or rule | Inputs | Output | source_ids |
|---|---|---|---|---|---|
calc_conditioning_balance | Drying and cleaning | Incoming kg = prepared whole kg + separated solids + water loss + other recorded loss; investigate residual. | Paired weights, moisture and residues | Reconciled lot outputs | kau-pepper-harvest |
calc_soil_gases | Managed soil | Apply IPCC direct/indirect N₂O and applicable lime/urea CO₂ equations with site-year activity and documented factors. | Nitrogen/amendment inputs and factors | Gas-specific kg | ipcc-2019-afolu11 |
calc_intensity | All nodes | Sum attributed site-period inputs after shared-asset and rework reconciliation, divide by accepted kg in the same physical-state stratum. | Ledgers and accepted kg | Exchange per reference kg | |
chemical_species_mass_accounting | elementary_nutrient_emissions | Final elementary exchanges use the mass of the identified substance and one actual receiving compartment. Keep nutrient/activity ledgers separate: species-specific N2O-N × 44/28 gives N2O, NH3-N × 17/14 gives NH3, nitrate-N × 62/14 gives nitrate, and phosphate-P × 95/31 gives phosphate. If the selected flow is elemental phosphorus instead, report kg P and convert phosphate mass by 31/95 only when that species basis is evidenced. Apply a conversion exactly once only when the method output is on the elemental basis; measured compound mass is not reconverted. Total nutrient losses cannot be assigned to a single species without a supported split, and residual/retained soil nutrient is not an emission. Keep direct/indirect pathway ledgers and avoid repeating a pathway already included in the chosen method or upstream inventory. Factor uncertainty ranges screen factors on their stated basis, not final compound amounts or admissible site emissions. Normalize the attributable compound mass once using the accepted reference quantity and the matched measured output. Unknown activity, identity or compartment remains an evidence gap and blocks a completeness claim. | cp_cultivation; species-specific activity ledger, method pathway and factor basis, matched accepted output | Identity-specific exchanges and reconciled activity records |
Environmental Coverage Calculation Rules
| rule_id | Applies to | Formula or rule | Inputs | Output | source_ids |
|---|---|---|---|---|---|
calc_managed_land_coverage | actual managed-production nodes | For each actual owned managed-production site, collect the occupied area and dated occupation intervals, including attributable establishment/immature and production periods. Occupation is area multiplied by actual duration, converted explicitly to the selected area-time unit (1 ha = 10,000 m2; time in years); hectares per crop-cycle alone are not an area-time result without duration. Partition or take the union of overlapping establishment/management intervals so the same area-time is counted once, with shares across actual co-users summing to one. Record evidenced land transformation separately by actual from/to land class, event area and date under the declared land-use method; transformation has area units and is not added to occupation. Planting, continued occupation or missing prior-land data do not establish a transformation or zero transformation. Preserve actual historical-event attribution and carbon-stock/emission method coverage where applicable; no invented land conversion or generic carbon credit. Instantiate separate compatible elementary identities with verified UUIDs or explicit unresolved identities; attribute once and normalize to the matched final reference. Purchased completed biological inputs inherit compatible upstream land coverage once instead of duplicating it locally. Missing applicable land identity, area, duration or prior-state evidence remains a completeness gap; documented no transformation is a valid absence. | cp_phase1_environment_coverage | attributed native environmental quantities per matched final reference |
Data Quality Requirements
| requirement_id | Applies to | Requirement | Evidence |
|---|---|---|---|
dq_identity | Reference output | Verify Piper species, whole form, state and producer gate. | Classification and flow review |
dq_mass | Harvest to dispatch | Link lots, weights, moisture, grades and reject routes; disclose balance discrepancy. | Scale tickets and tests |
dq_period | Perennial assets | Identify establishment, productive, replacement and termination years and consumers. | Plot and asset ledger |
dq_coverage | Inputs and emissions | Disclose missing meters, estimated amounts, factor choices and unresolved UUIDs. | Completeness register |
9. Validation Rules
| rule_id | Applies to | Rule | source_ids |
|---|---|---|---|
validate_identity | Reference product | Reject processed, crushed, ground, non-Piper or unidentified state; require a reviewed dried-state flow UUID before publication. | un-cpc3 |
validate_balance | Harvest, conditioning and grading | Require moisture and reconcile input, accepted, downgraded, rejected and moisture-loss masses within documented tolerance. | kau-pepper-harvest |
validate_route | Process graph | Check cultivation → harvest → optional conditioning → grading hand-offs and every grade, reject and rework path. | fao-ecocrop-pepper |
validate_shared | Perennial/shared assets | Each attributed asset has service years and consumers; assigned totals equal recorded totals once. | fao-ecocrop-pepper |
validate_soil | Fertilized plots | Report N activity and direct/indirect factors; flag relevant uncalculated soil emissions. | ipcc-2019-afolu11 |
10. Published Dataset Profile
| Field | Value |
|---|---|
| dataset_role | Foreground production dataset for whole raw Piper pepper at producer dispatch |
| downstream_use | secondary_dataset or background_dataset for matching species, state, geography, time and gate |
| allowed_use | Per-kg whole raw pepper supply with compatible moisture and form |
| excluded_use | Ground/processed or non-Piper products; unqualified fresh/dried substitution; post-dispatch stages |
| required_metadata | Species, colour/form, moisture, grade, location, period, gate, route, asset attribution and flow identity review |
| required_quality_disclosure | Primary-data share, mass balance, missing inputs, factors, reject destinations and UUID gaps |
| update_trigger | New state/route, revised flow identity, changed CPC scope, moisture basis or material site-period data |
11. Data Sources
| Source id | Type | Reference | Used for |
|---|---|---|---|
un-cpc3 | official_guidance | UN Statistics Division, CPC 3.0 explanatory notes, 01651 and 23921, https://unstats.un.org/unsd/classifications/Econ/Download/In%20Text/CPC_Ver_3.0_Exp_Notes_30Jun2025.pdf | Product boundary |
fao-ecocrop-pepper | official_guidance | FAO Ecocrop, Piper nigrum, https://ecocrop.apps.fao.org/ecocrop/srv/en/cropView?id=1714 | Cultivated route and states |
kau-pepper-harvest | extension_guidance | Kerala Agricultural University, Pepper harvesting and processing, https://www.celkau.in/Crops/spices/pepper/harvesting.php | Harvest and conditioning |
ipcc-2019-afolu11 | method_factor | IPCC, 2019 Refinement, Vol. 4 Ch. 11, https://www.ipcc-nggip.iges.or.jp/public/2019rf/pdf/4_Volume4/19R_V4_Ch11_Soils_N2O_CO2.pdf | Managed-soil gases |
ghg-protocol-product-standard-2011 | standard | WRI/WBCSD, Product Life Cycle Accounting and Reporting Standard (2011), Chapter 9, https://ghgprotocol.org/sites/default/files/standards/Product-Life-Cycle-Accounting-Reporting-Standard_041613.pdf | General allocation hierarchy and comparable-gate economic basis. Applicability conditions and the explicit residual branch are this PCR's method convention; no product-specific causal coefficient, price or output quantity is prescribed by this source. |
Raw downloads
These files are byte-identical to the canonical files for this revision in the repository.
Structured rule index
This index comes from verified structured.yaml and retains the canonical English rule text.
System boundary rules · 4
| Rule ID | Applies to | Rule | Source IDs |
|---|---|---|---|
boundary_dispatch | All routes | Include attributable vine establishment, cultivation, harvest, performed primary conditioning and grading to producer dispatch; exclude grinding, extraction, retail and later transport. | un-cpc3, fao-ecocrop-pepper |
boundary_branch | Fresh/black/white/green | Record only actual drying, soaking and pericarp removal with their inputs, effluent and residues; never assign zero drying to a dried lot. | fao-ecocrop-pepper, kau-pepper-harvest |
boundary_soil | Fertilized plots | Calculate direct and indirect soil N₂O and applicable lime/urea CO₂ from recorded inputs and documented factors. | ipcc-2019-afolu11 |
boundary_shared | Supports, pumps and dryers | Name consuming processes and years; attribute shared asset burden once. | fao-ecocrop-pepper |
Allocation rules · 5
| Rule ID | Applies to | Rule | Source IDs |
|---|---|---|---|
allocate_periods | Establishment and replacements | Assign recorded vine and support burdens to evidenced productive years and outputs; retain nonproductive establishment and termination events and count each burden once. | fao-ecocrop-pepper |
allocate_shared | Supports, pumps and dryers | List consumers and service years, allocate by measured use or documented physical proxy, and reconcile assigned burden to recorded total. | fao-ecocrop-pepper |
allocate_grades | Saleable whole grades | Partition common burdens by measured mass when grades have the same physical function; justify another rule if materially different. Rejects receive no co-product credit. | un-cpc3 |
allocate_rework | Reworked or recovered berries | Keep prior lot burden and add incremental rework once; credit recovery only with evidenced destination and method. | kau-pepper-harvest |
allocation_residual_precedence | remaining common burden with no specified primary branch | Resolve any study-specific joint-product instruction in this PCR that has no specified primary branch using this precedence; retain an already explicitly prescribed category-specific primary method. First directly assign separable output-specific activities. For the remaining common burden B, use a physical driver d_i only when measured operation or biological-service records demonstrate the causal consumption represented by that driver. A product being weighable, valuable or lower grade alone is insufficient; do not switch arbitrarily between area, time, mass and revenue. For comparable grades receiving the same common handling, measured processed mass is applicable only with the same service demand, state and moisture basis demonstrated. Share a_i=d_i/sum(d_j); B_i=B*a_i. If no defensible causal physical driver exists for that common operation, use gate- and period-matched economic shares a_i=(q_i*p_i)/sum(q_j*p_j), with the complete independently intended output set, compatible quantity/price units, currency, representative prices and values before output-specific downstream processing. Missing price or denominator evidence makes the allocated result incomplete, not a zero-priced product or a single-output system. Report shares summing to one and sensitivity to a material alternative; an alternative is not an interchangeable primary result. Waste, retained residues and internal transfers receive no co-product share, while their attributable production/handling burdens remain with the producing saleable route. Retain unallocated physical quantities and mass balances separately. This branch gives no automatic substitution credit; any separately scoped substitution analysis retains the gross inventory and its actual displaced-function evidence. | ghg-protocol-product-standard-2011 |
Validation rules · 5
| Rule ID | Applies to | Rule | Source IDs |
|---|---|---|---|
validate_identity | Reference product | Reject processed, crushed, ground, non-*Piper* or unidentified state; require a reviewed dried-state flow UUID before publication. | un-cpc3 |
validate_balance | Harvest, conditioning and grading | Require moisture and reconcile input, accepted, downgraded, rejected and moisture-loss masses within documented tolerance. | kau-pepper-harvest |
validate_route | Process graph | Check cultivation → harvest → optional conditioning → grading hand-offs and every grade, reject and rework path. | fao-ecocrop-pepper |
validate_shared | Perennial/shared assets | Each attributed asset has service years and consumers; assigned totals equal recorded totals once. | fao-ecocrop-pepper |
validate_soil | Fertilized plots | Report N activity and direct/indirect factors; flag relevant uncalculated soil emissions. | ipcc-2019-afolu11 |
Processes and inputs/outputs · 4
| Process ID | Process name | Input flows | Output flows |
|---|---|---|---|
pepper_cultivation | Perennial vine cultivation | 7 | 2 |
pepper_harvest | Berry harvest | 0 | 1 |
pepper_conditioning | Primary conditioning | 4 | 1 |
pepper_grading | Grading and dispatch | 0 | 3 |
Complete field inspector
Loads this record’s complete manifest and structured projection on demand; values are never truncated. Requires JavaScript.