skyocean:TradeParty

An entity involved in agricultural commodity trading activities within the Skyocean ecosystem.

Class URI: https://skyocean.io/ontology/TradeParty

Description

A skyocean:TradeParty represents an organization or individual that participates in agricultural commodity trading activities. Trade parties can act in various roles within the trading ecosystem, such as producers, traders, brokers, carriers, inspectors, or financial institutions. Each trade party has a unique identifier, contact information, business credentials, and trading preferences, enabling secure and efficient trading operations within the Skyocean platform.

Subclasses

Properties

Property Type Description Cardinality
schema:identifier xsd:string Unique identifier for the trade party 1..1
schema:name xsd:string Legal name of the organization or individual 1..1
schema:description xsd:string Brief description of the trade party 0..1
skyocean:partyType URI Classification of the trade party (e.g., producer, trader) 1..1
schema:location schema:Place Primary business location 1..1
skyocean:establishedYear xsd:gYear Year the organization was established 0..1
skyocean:registrationNumber xsd:string Business registration number 0..1
skyocean:taxIdentifier xsd:string Tax identification number 0..1
skyocean:certifications Array of URI Certifications held by the trade party 0..*
skyocean:primaryCommodities Array of URI Main commodities traded by the party 0..*
skyocean:tradeRegions Array of schema:Place Geographic regions of operation 0..*
skyocean:sustainabilityScore xsd:decimal Overall sustainability rating (0-100) 0..1
skyocean:tradingStatus xsd:string Current status in the marketplace 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
schema:address schema:PostalAddress Business address 0..1
schema:email xsd:string Primary contact email address 0..1
schema:telephone xsd:string Primary contact telephone number 0..1
skyocean:contactPerson Object Detailed contact information for primary representatives 0..*
skyocean:creditScore xsd:decimal Credit worthiness score 0..1
skyocean:tradeHistory Array of URI References to past trades 0..*
skyocean:paymentPreferences Object Payment methods and terms preferences 0..1
skyocean:bankingDetails Object Banking information for transactions 0..1
skyocean:tradingVolume Object Annual trading volume statistics 0..1
skyocean:preferredPartners Array of URI List of preferred trading partners 0..*
skyocean:tradeRestrictions Array of Object Specific trade restrictions or limitations 0..*
skyocean:negotiationParameters Object Price, volume, and quality thresholds for negotiations 0..1

Example Usage

This example shows a basic TradeParty 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/",
    "party": "https://skyocean.io/ontology/terms/party/",
    "commodity": "https://skyocean.io/ontology/terms/commodity/",
    "certification": "https://skyocean.io/ontology/terms/certification/"
  },
  "@id": "urn:skyocean:tradeparty:PROD-7890",
  "@type": "skyocean:TradeParty",
  "schema:identifier": "PROD-7890",
  "schema:name": "AgroSur Argentina S.A.",
  "schema:description": "Leading organic soybean producer in Argentina with certified sustainable practices",
  "skyocean:partyType": {
    "@id": "party:PRODUCER"
  },
  "schema:location": {
    "@type": "schema:Place",
    "schema:name": "Santa Fe Province, Argentina",
    "schema:geo": {
      "@type": "schema:GeoCoordinates",
      "schema:latitude": "-31.5",
      "schema:longitude": "-60.9"
    }
  },
  "skyocean:establishedYear": "1985",
  "skyocean:registrationNumber": "CUIT 30-12345678-9",
  "skyocean:taxIdentifier": "AR12345678",
  "skyocean:certifications": [
    {
      "@id": "certification:ORGANIC"
    },
    {
      "@id": "certification:NON_GMO"
    },
    {
      "@id": "certification:RAINFOREST_ALLIANCE"
    }
  ],
  "skyocean:primaryCommodities": [
    {
      "@id": "commodity:SOYBEAN"
    },
    {
      "@id": "commodity:CORN"
    },
    {
      "@id": "commodity:WHEAT"
    }
  ],
  "skyocean:tradeRegions": [
    {
      "@type": "schema:Place",
      "schema:name": "South America"
    },
    {
      "@type": "schema:Place",
      "schema:name": "Europe"
    },
    {
      "@type": "schema:Place",
      "schema:name": "Asia"
    }
  ],
  "skyocean:sustainabilityScore": 92.5,
  "skyocean:tradingStatus": "ACTIVE"
}

Private Section

{
  "@context": {
    "schema": "http://schema.org/",
    "xsd": "http://www.w3.org/2001/XMLSchema#",
    "skyocean": "https://skyocean.io/ontology/"
  },
  "@id": "urn:skyocean:tradeparty:PROD-7890#private",
  "@type": "skyocean:TradePartyPrivateData",
  "skyocean:referenceId": "urn:skyocean:tradeparty:PROD-7890",
  "schema:address": {
    "@type": "schema:PostalAddress",
    "schema:streetAddress": "Av. Rivadavia 1615",
    "schema:addressLocality": "Rosario",
    "schema:addressRegion": "Santa Fe",
    "schema:postalCode": "S2000",
    "schema:addressCountry": "Argentina"
  },
  "schema:email": "[email protected]",
  "schema:telephone": "+54-341-4569800",
  "skyocean:contactPerson": [
    {
      "schema:name": "Carlos Rodriguez",
      "schema:jobTitle": "Export Director",
      "schema:email": "[email protected]",
      "schema:telephone": "+54-341-4569801",
      "skyocean:preferredLanguages": ["Spanish", "English", "Portuguese"]
    },
    {
      "schema:name": "Maria Gonzalez",
      "schema:jobTitle": "Sales Manager",
      "schema:email": "[email protected]",
      "schema:telephone": "+54-341-4569802",
      "skyocean:preferredLanguages": ["Spanish", "English"]
    }
  ],
  "skyocean:creditScore": 87.4,
  "skyocean:tradeHistory": [
    {
      "@id": "urn:skyocean:trade:T2023-0456"
    },
    {
      "@id": "urn:skyocean:trade:T2023-0389"
    },
    {
      "@id": "urn:skyocean:trade:T2022-1245"
    }
  ],
  "skyocean:paymentPreferences": {
    "skyocean:preferredCurrencies": ["USD", "EUR"],
    "skyocean:preferredPaymentTerms": ["Letter of Credit", "Cash Against Documents"],
    "skyocean:paymentPeriod": "60 days"
  },
  "skyocean:bankingDetails": {
    "skyocean:bankName": "Banco de Argentina",
    "skyocean:accountHolder": "AgroSur Argentina S.A.",
    "skyocean:accountNumber": "AR98765432101234567890",
    "skyocean:swiftCode": "ARGBARA1XXX",
    "skyocean:correspondentBank": "Citibank N.A."
  },
  "skyocean:tradingVolume": {
    "skyocean:annualVolume": {
      "@type": "schema:QuantitativeValue",
      "schema:value": 85000,
      "schema:unitCode": "MT"
    },
    "skyocean:annualRevenue": {
      "@type": "schema:MonetaryAmount",
      "schema:currency": "USD",
      "schema:value": 52000000
    }
  },
  "skyocean:preferredPartners": [
    {
      "@id": "urn:skyocean:tradeparty:BUY-1234"
    },
    {
      "@id": "urn:skyocean:tradeparty:BUY-5678"
    }
  ],
  "skyocean:tradeRestrictions": [
    {
      "skyocean:restrictionType": "REGIONAL",
      "skyocean:restrictedRegion": "North Korea",
      "skyocean:restrictionReason": "International sanctions"
    }
  ],
  "skyocean:negotiationParameters": {
    "skyocean:minimumOrderSize": {
      "@type": "schema:QuantitativeValue",
      "schema:value": 500,
      "schema:unitCode": "MT"
    },
    "skyocean:priceRangeParameters": {
      "skyocean:minimumAcceptablePrice": {
        "@type": "schema:MonetaryAmount",
        "schema:currency": "USD",
        "schema:value": 590
      },
      "skyocean:targetPrice": {
        "@type": "schema:MonetaryAmount",
        "schema:currency": "USD",
        "schema:value": 620
      }
    }
  }
}

Related Classes

Party Types

  • PRODUCER - Primary commodity producers/growers
  • TRADER - Buy/sell parties without production
  • PROCESSOR - Process raw commodities into products
  • BROKER - Intermediaries who facilitate trades
  • CARRIER - Transportation and logistics providers
  • INSPECTOR - Quality inspection and certification
  • FINANCIER - Banks and financial institutions
  • INSURER - Insurance providers for commodities
  • WAREHOUSE - Storage and warehousing providers
  • REGULATOR - Regulatory authorities and bodies

DKG Integration

Trade parties in the Skyocean ecosystem are stored as Knowledge Assets in the DKG network. The public part contains general information that facilitates discovery and business matching, while sensitive commercial and operational details are stored in the private section.

Each trade party maintains full control over its private data in the DKG, selectively granting access to specific trading partners based on business relationships and needs.

The standardized trade party structure enables secure, permission-based identity verification across the agricultural supply chain, enabling trust without requiring centralized intermediaries to manage sensitive business information.