Commodity Class - Skyocean Ontology

Description

A skyocean:Commodity represents a specific type of agricultural product traded within the Skyocean ecosystem. The commodity class captures essential information about the agricultural product, including its classification, origin, growing conditions, quality specifications, certifications, and sustainability metrics. This class forms the foundation for standardizing commodity data across global agricultural supply chains.

Subclasses

skyocean:Grain - Grain commodities such as wheat, corn, rice, soybeans
skyocean:Meat - Meat commodities such as beef, pork, poultry
skyocean:Produce - Fresh produce such as fruits and vegetables
skyocean:Dairy - Dairy products such as milk, cheese, butter

Properties

Property	Type	Description	Cardinality
`schema:identifier`	xsd:string	Unique identifier for the commodity	1..1
`schema:name`	xsd:string	Human-readable name for the commodity	1..1
`schema:description`	xsd:string	Detailed description of the commodity	0..1
`skyocean:commodityType`	URI	Classification of the commodity (e.g., grain, meat)	1..1
`skyocean:commodityCode`	xsd:string	Standard commodity code (e.g., HS Code, SITC code)	0..1
`skyocean:variety`	xsd:string	Specific variety or breed of the commodity	0..1
`skyocean:cropYear`	xsd:gYear	Year in which the commodity was harvested	0..1
`skyocean:gradeClassification`	URI	Quality grade or classification of the commodity	0..1
`skyocean:originCountry`	schema:Country	Country of origin for the commodity	1..1
`skyocean:originRegion`	schema:AdministrativeArea	Specific region or area of origin within the country	0..1
`skyocean:sustainabilityScore`	xsd:decimal	Overall sustainability rating (0-100)	0..1
`skyocean:certifications`	Array of URI	Certifications held by the commodity	0..*
`skyocean:qualityParameters`	Object	Quality specifications for the commodity	0..1
`skyocean:packagingType`	URI	Standard packaging for the commodity	0..1
`skyocean:marketplaceStatus`	xsd:string	Status in the marketplace (e.g., available, sold out)	0..1

Private Properties

In DKG v8, the following properties are typically stored in the private section of the Knowledge Asset:

Property	Type	Description	Cardinality
`skyocean:referenceId`	URI	Reference to the public section URI	1..1
`skyocean:basePrice`	schema:MonetaryAmount	Base price per unit of the commodity	0..1
`skyocean:priceRange`	Object	Min and max prices for negotiation	0..1
`skyocean:availableQuantity`	schema:QuantitativeValue	Quantity available for sale	0..1
`skyocean:producer`	skyocean:TradeParty	Details of the commodity producer	0..1
`skyocean:productionCosts`	schema:MonetaryAmount	Cost of production per unit	0..1
`skyocean:profitMargin`	xsd:decimal	Target profit margin percentage	0..1
`skyocean:qualityTestResults`	Array of Objects	Detailed quality test results	0..*
`skyocean:transportationCosts`	schema:MonetaryAmount	Estimated costs for transportation	0..1
`skyocean:preferredBuyers`	Array of skyocean:TradeParty	List of preferred buyers	0..*

Example Usage

This example shows a basic Commodity Knowledge Asset with public and private sections:

Public Section

{
  "@context": {
    "schema": "http://schema.org/",
    "xsd": "http://www.w3.org/2001/XMLSchema#",
    "skyocean": "https://skyocean.io/ontology/",
    "commodity": "https://skyocean.io/ontology/terms/commodity/",
    "grade": "https://skyocean.io/ontology/terms/grade/",
    "certification": "https://skyocean.io/ontology/terms/certification/",
    "package": "https://skyocean.io/ontology/terms/packaging/"
  },
  "@id": "urn:skyocean:commodity:SOY-ORG-AR-2023",
  "@type": "skyocean:Commodity",
  "schema:identifier": "SOY-ORG-AR-2023",
  "schema:name": "Organic Soybeans - Argentina 2023",
  "schema:description": "Certified organic soybeans grown in Santa Fe, Argentina. Harvested 2023, high protein content.",
  "skyocean:commodityType": {
    "@id": "commodity:SOYBEAN"
  },
  "skyocean:commodityCode": "1201.90.00",
  "skyocean:variety": "Non-GMO Yellow Soybeans",
  "skyocean:cropYear": "2023",
  "skyocean:gradeClassification": {
    "@id": "grade:SOYBEAN_PREMIUM"
  },
  "skyocean:originCountry": {
    "@type": "schema:Country",
    "schema:name": "Argentina",
    "schema:identifier": "AR"
  },
  "skyocean:originRegion": {
    "@type": "schema:AdministrativeArea",
    "schema:name": "Santa Fe Province"
  },
  "skyocean:sustainabilityScore": 87.5,
  "skyocean:certifications": [
    {
      "@id": "certification:ORGANIC"
    },
    {
      "@id": "certification:NON_GMO"
    },
    {
      "@id": "certification:RAINFOREST_ALLIANCE"
    }
  ],
  "skyocean:qualityParameters": {
    "skyocean:moisture": "12.5%",
    "skyocean:protein": "38.2%",
    "skyocean:oilContent": "18.7%",
    "skyocean:foreignMaterial": "0.8%",
    "skyocean:damagedKernels": "2.1%"
  },
  "skyocean:packagingType": {
    "@id": "package:BULK_VESSEL"
  },
  "skyocean:marketplaceStatus": "AVAILABLE"
}

Private Section

{
  "@context": {
    "schema": "http://schema.org/",
    "xsd": "http://www.w3.org/2001/XMLSchema#",
    "skyocean": "https://skyocean.io/ontology/"
  },
  "@id": "urn:skyocean:commodity:SOY-ORG-AR-2023#private",
  "@type": "skyocean:CommodityPrivateData",
  "skyocean:referenceId": "urn:skyocean:commodity:SOY-ORG-AR-2023",
  "skyocean:basePrice": {
    "@type": "schema:MonetaryAmount",
    "schema:currency": "USD",
    "schema:value": 620.50
  },
  "skyocean:priceRange": {
    "skyocean:minPrice": {
      "@type": "schema:MonetaryAmount",
      "schema:currency": "USD",
      "schema:value": 610.00
    },
    "skyocean:maxPrice": {
      "@type": "schema:MonetaryAmount",
      "schema:currency": "USD", 
      "schema:value": 635.00
    }
  },
  "skyocean:availableQuantity": {
    "@type": "schema:QuantitativeValue",
    "schema:value": 15000,
    "schema:unitCode": "MT"
  },
  "skyocean:producer": {
    "@id": "urn:skyocean:tradeparty:PROD-7890"
  },
  "skyocean:productionCosts": {
    "@type": "schema:MonetaryAmount",
    "schema:currency": "USD",
    "schema:value": 485.25
  },
  "skyocean:profitMargin": 22.5,
  "skyocean:qualityTestResults": [
    {
      "skyocean:testDate": "2023-03-15",
      "skyocean:testType": "Moisture Content",
      "skyocean:testMethod": "ISO 711:1985",
      "skyocean:testResult": "12.5%",
      "skyocean:testLabName": "AgriTest Labs Argentina",
      "skyocean:testCertificateId": "ATL-2023-03459"
    },
    {
      "skyocean:testDate": "2023-03-15",
      "skyocean:testType": "Protein Content",
      "skyocean:testMethod": "AOAC 990.03",
      "skyocean:testResult": "38.2%",
      "skyocean:testLabName": "AgriTest Labs Argentina",
      "skyocean:testCertificateId": "ATL-2023-03460"
    }
  ],
  "skyocean:transportationCosts": {
    "@type": "schema:MonetaryAmount",
    "schema:currency": "USD",
    "schema:value": 42.75
  },
  "skyocean:preferredBuyers": [
    {
      "@id": "urn:skyocean:tradeparty:BUY-1234"
    },
    {
      "@id": "urn:skyocean:tradeparty:BUY-5678"
    }
  ]
}

Commodity Types

SOYBEAN - Soybean varieties
CORN - Corn/maize varieties
WHEAT - Wheat varieties (hard, soft, etc.)
RICE - Rice varieties
BEEF - Beef products
POULTRY - Chicken and other poultry
PORK - Pork products
DAIRY - Milk, cheese, and other dairy
COFFEE - Coffee beans
COCOA - Cocoa beans and products

DKG Integration

Commodities in the Skyocean ecosystem are stored as Knowledge Assets in the DKG network. The public part contains general information about the commodity that facilitates discovery, while commercially sensitive details like pricing and supplier details are stored in the private section.

Trade parties can discover commodities through the public DKG network, while only having access to private data when proper permissions have been granted by the commodity owner.

The standardized commodity structure enables interoperability across different agricultural supply chain systems and provides a foundation for commodity traceability and verification.

skyocean:Commodity