Marketplace Entity

v2.0.1
Product Offering
Ecommerce Platform

Comprehensive schema for marketplace platforms. Designed for AI agents to understand multi-vendor commerce, vendor management, and complex transaction flows.

Marketplace
product_offering
ecommerce_platform
marketplace

Format: @type → entityCategory → subcategory → entityType

3

Required Modules

4

Recommended Modules

16+

Functional Features

9

Site Actions

⭐ New Features in v2.0.1
Perfect AI understanding with machine-readable marketplace capabilities

entityCapabilities

Objective business capabilities with rules:

  • • camelCase (hasShoppingCart, supportsMultipleVendors)
  • • Prefixes: has, is, accepts, supports
  • • Boolean values for objective verification
  • • Examples expandable - no limitations

siteCapabilities

Website actions available with rules:

  • • snake_case (browse_products, contact_vendor)
  • • Verb-based (what users can do)
  • • Only actually working actions
  • • Examples expandable without limitations
Required Modules
Essential modules for marketplace entities
Required
auth

REQUIRED - User authentication and authorization

Essential for vendor and customer account management

Required
payments

REQUIRED - Payment processing for transactions

Critical for handling multi-vendor payments and commissions

Required
user-management

REQUIRED - Multi-role user management system

Essential for managing vendors, customers, and administrators

Recommended Modules
Enhance marketplace functionality and user experience
Recommended
search
Recommended
recommendations
Recommended
compliance
Recommended
location
Entity Capabilities
Objective, verifiable marketplace features and services. Define functional capabilities using camelCase naming with prefixes: "has", "is", "accepts", "supports".
Naming Convention Rules
  • • Use camelCase formatting (e.g., "hasShoppingCart", "supportsMultipleVendors")
  • • Start with prefixes: "has", "is", "accepts", "supports"
  • • Examples shown below can be extended - no limitations on additional capabilities
  • • All values are boolean (true/false) for objective verification

Platform Features

supportsMultipleVendors

Multiple sellers on platform

hasVendorVerification

Vendor authentication process

hasCommissionModel

Revenue sharing system

supportsOnlinePayments

Digital payment processing

Shopping Experience

hasShoppingCart

Multi-vendor cart system

hasWishlist

Save items for later

hasProductReviews

Customer feedback system

hasBulkPurchasing

Volume ordering capabilities

Customer Services

hasLiveChat

Real-time customer support

hasReturnPolicy

Product return management

hasLoyaltyProgram

Customer reward system

hasUserAccounts

Personalized user profiles

Product Management

supportsDigitalProducts

Digital goods support

hasInventoryManagement

Stock tracking system

hasCategoryFilters

Product categorization

supportsVariations

Product variants support

Site Capabilities
Available actions for AI agents and automated systems. Define what users can actually do on your website using snake_case action names.
Action Naming Rules
  • • Use snake_case formatting (e.g., "browse_products", "contact_vendor")
  • • Actions should be verb-based describing what users can do
  • • Examples shown below are common patterns - extend with your specific actions
  • • List only actions that actually work on your website
browse_products

Explore product catalog

compare_products

Compare multiple items

add_to_cart

Add items to shopping cart

checkout

Complete purchase process

track_order

Monitor order status

write_review

Submit product feedback

contact_vendor

Communicate with sellers

filter_search

Refine product searches

manage_wishlist

Organize saved items

Schema Structure
Marketplace entity schema definition
marketplace.json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "aimlVersion": "2.0.1",
  "schemaVersion": "2.0.1",
  "title": "Marketplace Entity Schema",
  "description": "Schema for comprehensive marketplace platforms",
  "type": "object",
  "properties": {
    "entityType": {
      "const": "marketplace",
      "description": "Entity type identifier"
    },
    "entityCategory": {
      "const": "product_offering",
      "description": "Entity category"
    },
    "subcategory": {
      "const": "ecommerce_platform",
      "description": "Subcategory of product offering"
    },
    "name": {
      "oneOf": [
        { "type": "string" },
        { "$ref": "../components/multilingual-format.json#/$defs/LocalizedText" }
      ],
      "description": "Marketplace name"
    },
    "description": {
      "oneOf": [
        { "type": "string" },
        { "$ref": "../components/multilingual-format.json#/$defs/LocalizedText" }
      ],
      "description": "Detailed description of the marketplace"
    },
    "modules": {
      "type": "object",
      "description": "AIML modules used by this entity"
    },
    "properties": {
      "type": "object",
      "description": "Marketplace specific properties",
      "properties": {
        "vendorCount": {
          "type": "number",
          "description": "Number of vendors on platform"
        },
        "marketplaceType": {
          "type": "string",
          "description": "Type of marketplace (B2B, B2C, C2C)"
        },
        "businessModel": {
          "type": "string",
          "description": "Revenue model of marketplace"
        }
      }
    },
    "entityCapabilities": {
      "$ref": "../components/entity-capabilities-format.json#/$defs/EntityCapabilities",
      "description": "Objective capabilities and features of the entity"
    },
    "siteCapabilities": {
      "$ref": "../components/site-capabilities-format.json#/$defs/SiteCapabilities",
      "description": "Website capabilities and interaction features"
    }
  },
  "required": ["entityType", "entityCategory", "subcategory", "name", "description", "properties"],
  "allOf": [{ "$ref": "../base/product_offering.json" }]
}
Complete Implementation Example
Real-world marketplace entity with all v2.0.1 features
TechBazaar Marketplace - Complete Schema
{
  "@context": "https://schemas.meta-aiml.org/v2.0.1/context.jsonld",
  "@id": "https://techbazaar.com/entity",
  "@type": "Marketplace",
  "schemaVersion": "2.0.1",
  "entityType": "marketplace",
  "entityCategory": "product_offering",
  "subcategory": "ecommerce_platform",

  "name": {
    "en": "TechBazaar Global Marketplace",
    "es": "Mercado Global TechBazaar",
    "zh": "TechBazaar全球市场"
  },
  "description": {
    "en": "Leading B2B2C technology marketplace connecting vendors and buyers worldwide",
    "es": "Mercado tecnológico B2B2C líder que conecta vendedores y compradores en todo el mundo"
  },
  "url": "https://techbazaar.com",
  "shortDescription": "Global technology marketplace platform",
  "foundingDate": "2020-03-15",

  "properties": {
    "vendorCount": 50000,
    "activeListings": 2500000,
    "supportedCountries": 195,
    "averageOrderValue": "$127.50",
    "platforms": ["web", "mobile", "api"],
    "marketplaceType": "business_to_consumer",
    "businessModel": "marketplace",
    "mainCategories": ["electronics", "fashion", "home", "books"]
  },

  "modules": {
    "auth": {
      "version": "2.0.1",
      "enabled": true,
      "methods": ["email", "social", "phone"],
      "providers": ["local", "google", "facebook"]
    },
    "payments": {
      "version": "2.0.1",
      "enabled": true,
      "providers": ["stripe", "paypal", "klarna", "apple_pay", "google_pay"],
      "currencies": ["USD", "EUR", "GBP", "JPY", "CAD"]
    },
    "user-management": {
      "version": "2.0.1",
      "enabled": true,
      "roles": ["customer", "vendor", "admin"],
      "features": ["profiles", "preferences", "order_history"]
    }
  },

  "entityCapabilities": {
    "functionalFeatures": {
      "supportsOnlinePayments": true,
      "hasShoppingCart": true,
      "hasUserAccounts": true,
      "hasWishlist": true,
      "hasProductReviews": true,
      "hasLiveChat": true,
      "hasReturnPolicy": true,
      "hasLoyaltyProgram": false,
      "hasVendorVerification": true,
      "hasBulkPurchasing": true,
      "supportsMultipleVendors": true,
      "hasCommissionModel": true,
      "supportsDigitalProducts": true,
      "hasInventoryManagement": true
    },
    "contentTypes": ["products", "reviews", "guides", "support", "vendor_profiles"],
    "businessModel": "marketplace",
    "productCategories": ["electronics", "home_garden", "clothing", "sports"],
    "paymentMethods": ["credit_card", "paypal", "bank_transfer", "digital_wallet"],
    "shippingOptions": ["standard", "express", "international", "vendor_shipping"]
  },

  "siteCapabilities": {
    "availableActions": [
      "browse_products", "compare_products", "add_to_cart",
      "checkout", "track_order", "write_review",
      "contact_vendor", "filter_search", "manage_wishlist"
    ],
    "interactionMethods": ["online_form", "live_chat", "email", "messaging_system"],
    "contentAccess": ["public", "members_only"],
    "supportedDevices": ["desktop", "mobile", "tablet"],
    "languages": ["en", "es", "fr", "de"],
    "realTimeFeatures": ["live_chat", "real_time_inventory", "instant_messaging"]
  }
}
Related Entities
Similar entities in the ecommerce platform category

EcommerceStore

Single-vendor online stores selling products

ecommerce_platform

Store

Physical or digital retail establishments

ecommerce_platform