Marketplace Entity
Comprehensive schema for marketplace platforms. Designed for AI agents to understand multi-vendor commerce, vendor management, and complex transaction flows.
Format: @type → entityCategory → subcategory → entityType
Required Modules
Recommended Modules
Functional Features
Site Actions
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 - User authentication and authorization
Essential for vendor and customer account management
REQUIRED - Payment processing for transactions
Critical for handling multi-vendor payments and commissions
REQUIRED - Multi-role user management system
Essential for managing vendors, customers, and administrators
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
supportsMultipleVendorsMultiple sellers on platform
hasVendorVerificationVendor authentication process
hasCommissionModelRevenue sharing system
supportsOnlinePaymentsDigital payment processing
Shopping Experience
hasShoppingCartMulti-vendor cart system
hasWishlistSave items for later
hasProductReviewsCustomer feedback system
hasBulkPurchasingVolume ordering capabilities
Customer Services
hasLiveChatReal-time customer support
hasReturnPolicyProduct return management
hasLoyaltyProgramCustomer reward system
hasUserAccountsPersonalized user profiles
Product Management
supportsDigitalProductsDigital goods support
hasInventoryManagementStock tracking system
hasCategoryFiltersProduct categorization
supportsVariationsProduct variants support
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_productsExplore product catalog
compare_productsCompare multiple items
add_to_cartAdd items to shopping cart
checkoutComplete purchase process
track_orderMonitor order status
write_reviewSubmit product feedback
contact_vendorCommunicate with sellers
filter_searchRefine product searches
manage_wishlistOrganize saved items
{
"$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" }]
}{
"@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"]
}
}EcommerceStore
Single-vendor online stores selling products
Store
Physical or digital retail establishments