Ecommerce Store Entity

v2.0.1
Product Offering
Ecommerce Platform

Comprehensive schema for e-commerce stores and online retail platforms. Designed for AI agents to understand product offerings, shopping capabilities, and customer experience features.

Entity Hierarchy
EcommerceStore
product_offering
ecommerce_platform
ecommerce_store

Format: @type → entityCategory → subcategory → entityType

2

Required Modules

5

Recommended Modules

16+

Functional Features

8

Site Actions

Revolutionary AI Features in v2.0.1
Perfect AI understanding with zero ambiguity

Entity Capabilities

Machine-readable store features: payments, cart, search, reviews, inventory tracking

Site Capabilities

Available actions for AI agents: browsing, purchasing, reviewing, order tracking

Required Modules
Essential modules for e-commerce store entities
Required
auth

REQUIRED - User authentication and account management

Essential for user accounts, order history, and personalized shopping

Required
payments

REQUIRED - Payment processing and financial transactions

Core functionality for online commerce transactions

Recommended Modules
Enhance e-commerce functionality and user experience
Recommended
search
Recommended
recommendations
Recommended
location
Recommended
multilingual
Recommended
user-management
Entity Capabilities
Objective, verifiable e-commerce store features and services. Define functional capabilities using camelCase naming with prefixes: "has", "is", "accepts", "supports".
Naming Convention Rules
  • • Use camelCase formatting (e.g., "hasOnlinePayments", "hasShoppingCart")
  • • 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

Core E-commerce Features

hasOnlinePayments

Process online payments securely

hasShoppingCart

Shopping cart functionality

hasProductSearch

Search products by various criteria

hasInventoryTracking

Real-time inventory management

Customer Experience

hasWishlist

Save products for later purchase

hasProductReviews

Customer product reviews and ratings

hasProductComparison

Compare multiple products

hasLoyaltyProgram

Customer loyalty and rewards program

Order Management

hasOrderTracking

Track order status and shipping

hasReturnPolicy

Returns and refunds processing

hasCheckoutAsGuest

Guest checkout without account

hasGiftCards

Gift card purchase and redemption

Advanced Features

hasProductFilters

Advanced product filtering options

hasMultipleCurrencies

Support for multiple currencies

hasSubscriptionProducts

Recurring product subscriptions

hasDigitalProducts

Digital product delivery

Site Capabilities
Available actions for AI agents and automated systems. Define what users can actually do on your e-commerce store using snake_case action names.
Action Naming Rules
  • • Use snake_case formatting (e.g., "browse_products", "add_to_cart")
  • • 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 store
browse_products

Browse and discover products in store

add_to_cart

Add products to shopping cart

checkout

Complete purchase and payment

track_order

Monitor order status and shipping

write_review

Submit product reviews and ratings

create_wishlist

Save products to wishlist

compare_products

Compare product features and prices

apply_coupon

Apply discount codes and promotions

Schema Structure
E-commerce store entity schema definition
ecommerce_store.json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "aimlVersion": "2.0.1",
  "schemaVersion": "2.0.1",
  "title": "E-commerce Store Schema",
  "description": "Schema for an e-commerce store selling products online",
  "type": "object",
  "properties": {
    "entityType": {
      "const": "ecommerce_store",
      "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": "E-commerce store name"
    },
    "description": {
      "oneOf": [
        { "type": "string" },
        { "$ref": "../components/multilingual-format.json#/$defs/LocalizedText" }
      ],
      "description": "Detailed description of the e-commerce store"
    },
    "modules": {
      "type": "object",
      "description": "AIML modules used by this entity"
    },
    "properties": {
      "type": "object",
      "description": "E-commerce store specific properties",
      "properties": {
        "businessModel": {
          "type": "string",
          "enum": ["retail", "wholesale", "dropshipping", "marketplace", "subscription", "hybrid"]
        },
        "mainCategories": {
          "type": "array",
          "description": "Main product categories featured on the store",
          "items": { "type": "string" }
        },
        "brandType": {
          "type": "string",
          "enum": ["single-brand", "multi-brand", "private-label", "mixed"]
        }
      }
    },
    "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 e-commerce store entity with all v2.0.1 features
ShopElite Online Store - Complete Schema
{
  "@context": "https://schemas.meta-aiml.org/v2.0.1/context.jsonld",
  "@id": "https://shopelite.com/entity",
  "@type": "EcommerceStore",
  "schemaVersion": "2.0.1",
  "entityType": "ecommerce_store",
  "entityCategory": "product_offering",
  "subcategory": "ecommerce_platform",

  "name": {
    "en": "ShopElite Online Store",
    "es": "Tienda Online ShopElite"
  },
  "description": {
    "en": "Premium e-commerce destination offering curated fashion, electronics, and lifestyle products with exceptional customer service and fast shipping."
  },
  "url": "https://shopelite.com",
  "foundingDate": "2019-03-10",

  "properties": {
    "businessModel": "retail",
    "mainCategories": ["fashion", "electronics", "home", "beauty"],
    "brandType": "multi-brand",
    "unique_selling_proposition": "Curated premium products with 24/7 customer support",
    "target_audience": [
      {
        "segment": "premium_shoppers",
        "demographics": {
          "ageRange": "25-45",
          "incomeLevel": "high",
          "location": "urban"
        },
        "interests": ["fashion", "technology", "lifestyle"]
      }
    ],
    "fulfillmentMethods": [
      {
        "type": "in-house",
        "description": "Same-day processing from our fulfillment center",
        "typicalProcessingTime": "24 hours"
      }
    ],
    "siteFeatures": [
      "advanced_search", "product_reviews", "wishlists",
      "recommendations", "live_chat", "size_guides"
    ]
  },

  "modules": {
    "auth": {
      "version": "2.0.1",
      "enabled": true,
      "methods": ["email", "social"],
      "providers": ["local", "google", "facebook"]
    },
    "payments": {
      "version": "2.0.1",
      "enabled": true,
      "providers": ["stripe", "paypal", "apple_pay", "google_pay"],
      "currencies": ["USD", "EUR", "GBP"]
    },
    "search": {
      "version": "2.0.1",
      "enabled": true,
      "features": ["semantic_search", "faceted_search", "autocomplete"]
    }
  },

  "entityCapabilities": {
    "functionalFeatures": {
      "hasOnlinePayments": true,
      "hasShoppingCart": true,
      "hasWishlist": true,
      "hasProductReviews": true,
      "hasInventoryTracking": true,
      "hasOrderTracking": true,
      "hasReturnPolicy": true,
      "hasLoyaltyProgram": true,
      "hasGiftCards": true,
      "hasProductSearch": true,
      "hasProductFilters": true,
      "hasProductComparison": true,
      "hasCheckoutAsGuest": true,
      "hasMultipleCurrencies": false
    },
    "contentTypes": ["products", "reviews", "guides", "blog"],
    "businessModel": "ecommerce_retail",
    "productCategories": ["fashion", "electronics", "home", "beauty"],
    "paymentMethods": ["credit_card", "paypal", "digital_wallet"],
    "shippingOptions": ["standard", "express", "overnight", "international"]
  },

  "siteCapabilities": {
    "availableActions": [
      "browse_products", "add_to_cart", "checkout", "track_order",
      "write_review", "create_wishlist", "compare_products", "apply_coupon"
    ],
    "interactionMethods": ["online_form", "live_chat", "email"],
    "contentAccess": ["public", "members_only"],
    "supportedDevices": ["desktop", "mobile", "tablet"],
    "languages": ["en", "es"],
    "realTimeFeatures": ["live_inventory", "price_updates", "order_status"]
  }
}
AI Performance Impact
28x

More Efficient

vs HTML parsing

100%

Accuracy

No guesswork

0.1s

Processing Time

Instant understanding

Schema URL
Direct access to the e-commerce store entity schema
https://schemas.meta-aiml.org/v2.0.1/entity/ecommerce_store.json

Inherits from product_offering base schema via allOf reference