Source of truth for implementation is the canonical schema host:
https://schemas.meta-aiml.org/v3.0.0/. If any page text conflicts with canonical schema files, follow canonical files. Documentation home.EcommerceStore
v3.0.0
DigitalEntity
Commerce
v3 schema for first-party ecommerce stores as static website intelligence profile: stable commerce metadata plus external source links for dynamic catalog/pricing/review data.
Top-level required
10
Required modules
0
Capability groups
1
Entity properties
5
Canonical Files
Inheritance Chain
https://schemas.meta-aiml.org/v3.0.0/ontology/digital_entity.json
https://schemas.meta-aiml.org/v3.0.0/archetypes/direct_service.json
Interaction archetype
DirectService
Required Top-level Fields
These fields are enforced by JSON Schema required[] at root level.
@type
ontologicalMode
interactionArchetype
domain
name
description
deliveryFormat
capabilities
structuralMetadata
modules
Non-universal required fields
interactionArchetype
Entity-specific Properties
Keys under
properties.properties dedicated to this entity contract.catalogStrategy
pricingEngineType
supportsBackorders
supportsInternationalShipping
supportsPreorders
Modules Contract
Required modules
No required modules for this entity.
Optional modules
catalog
checkout
fulfillment
pricing
reviews
Capabilities Contract
Required capability groups
interaction
Optional capability groups
commerce
community
content
financial
Governance Validation Rules
Normative rule list from
governanceMetadata.sdkValidationRules.RULE-ECOM-001: @type MUST equal "EcommerceStore"
RULE-ECOM-002: ontologicalMode MUST equal "DigitalEntity"
RULE-ECOM-003: interactionArchetype MUST contain "DirectService"
RULE-ECOM-004: capabilities.interaction MUST be present
RULE-ECOM-005: structuralMetadata.topology MUST equal "binary"
RULE-ECOM-006: structuralMetadata.transactionFlow MUST equal "direct"
RULE-ECOM-007: modules.catalog.catalogDiscovery.dataSources MUST include sourceType/sourceUrl/format
RULE-ECOM-008: modules.pricing.pricingDiscovery.dataSources MUST include sourceType/sourceUrl/format when pricing source links are declared
Canonical Contract JSON
https://schemas.meta-aiml.org/v3.0.0/entity/ecommerce_store.json
https://schemas.meta-aiml.org/v3.0.0/entity/ecommerce_store.json
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"@context": [
"https://schemas.meta-aiml.org/v3.0.0/context.jsonld"
],
"@id": "https://schemas.meta-aiml.org/v3.0.0/entity/ecommerce_store.json",
"$id": "https://schemas.meta-aiml.org/v3.0.0/entity/ecommerce_store.json",
"@type": "EcommerceStore",
"schemaVersion": "3.0.0",
"aimlVersion": "3.0.0",
"title": "Ecommerce Store Entity Schema",
"description": "v3 schema for first-party ecommerce stores as static website intelligence profile: stable commerce metadata plus external source links for dynamic catalog/pricing/review data.",
"examples": [
{
"description": "Direct-to-consumer store with dynamic catalog and checkout automation",
"reference": "ecommerce_store_example_d2c"
},
{
"description": "Online retail store with subscriptions and loyalty program workflows",
"reference": "ecommerce_store_example_loyalty"
}
],
"type": "object",
"additionalProperties": false,
"allOf": [
{
"$ref": "../ontology/digital_entity.json"
},
{
"$ref": "../archetypes/direct_service.json"
}
],
"properties": {
"@type": {
"const": "EcommerceStore"
},
"ontologicalMode": {
"const": "DigitalEntity"
},
"interactionArchetype": {
"type": "array",
"contains": {
"const": "DirectService"
},
"items": {
"type": "string",
"enum": [
"DirectService"
]
}
},
"domain": {
"const": "Commerce"
},
"businessModel": {
"type": "array",
"items": {
"type": "string",
"enum": [
"Transactional",
"Subscription",
"Freemium"
]
}
},
"deliveryFormat": {
"type": "array",
"items": {
"type": "string",
"enum": [
"WebApp",
"MobileApp",
"API"
]
}
},
"name": {
"$ref": "../components/multilingual_format.json#/$defs/LocalizedText"
},
"description": {
"$ref": "../components/multilingual_format.json#/$defs/LocalizedText"
},
"shortDescription": {
"$ref": "../components/multilingual_format.json#/$defs/LocalizedTextOrString"
},
"url": {
"type": "string",
"format": "uri"
},
"foundingDate": {
"type": "string",
"format": "date"
},
"properties": {
"type": "object",
"properties": {
"catalogStrategy": {
"type": "string",
"enum": [
"single_brand",
"multi_brand",
"niche",
"broad"
]
},
"supportsPreorders": {
"type": "boolean"
},
"supportsBackorders": {
"type": "boolean"
},
"supportsInternationalShipping": {
"type": "boolean"
},
"pricingEngineType": {
"type": "string",
"enum": [
"fixed",
"rule_based_dynamic",
"hybrid"
]
}
}
},
"capabilities": {
"type": "object",
"required": [
"interaction"
],
"properties": {
"interaction": {
"$ref": "../components/capability_groups.json#/$defs/InteractionCapabilities"
},
"commerce": {
"$ref": "../components/capability_groups.json#/$defs/CommerceCapabilities"
},
"financial": {
"$ref": "../components/capability_groups.json#/$defs/FinancialCapabilities"
},
"content": {
"$ref": "../components/capability_groups.json#/$defs/ContentCapabilities"
},
"community": {
"$ref": "../components/capability_groups.json#/$defs/CommunityCapabilities"
}
}
},
"modules": {
"type": "object",
"properties": {
"catalog": {
"type": "object",
"properties": {
"facetedSearchEnabled": {
"type": "boolean"
},
"taxonomyVersioned": {
"type": "boolean"
},
"recommendationBlocksEnabled": {
"type": "boolean"
},
"catalogDiscovery": {
"type": "object",
"required": [
"dataSources"
],
"properties": {
"canonicalCatalogUrl": {
"type": "string",
"format": "uri"
},
"dataSources": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"required": [
"sourceType",
"sourceUrl",
"format"
],
"properties": {
"sourceType": {
"type": "string",
"enum": [
"file_export",
"public_feed_page",
"public_api_endpoint",
"other"
]
},
"sourceUrl": {
"type": "string",
"format": "uri"
},
"format": {
"type": "string",
"enum": [
"json",
"xml",
"csv",
"rss",
"html",
"other"
]
},
"updateCadence": {
"type": "string",
"enum": [
"real_time",
"hourly",
"daily",
"weekly",
"manual"
]
}
}
}
}
}
}
}
},
"checkout": {
"type": "object",
"properties": {
"guestCheckoutEnabled": {
"type": "boolean"
},
"oneClickCheckoutEnabled": {
"type": "boolean"
},
"addressValidationEnabled": {
"type": "boolean"
}
}
},
"fulfillment": {
"type": "object",
"properties": {
"warehouseRoutingEnabled": {
"type": "boolean"
},
"returnWorkflowEnabled": {
"type": "boolean"
},
"deliveryEtaPredictionEnabled": {
"type": "boolean"
}
}
},
"pricing": {
"type": "object",
"properties": {
"dynamicPricingEnabled": {
"type": "boolean"
},
"pricingDiscovery": {
"type": "object",
"required": [
"dataSources"
],
"properties": {
"dataSources": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"required": [
"sourceType",
"sourceUrl",
"format"
],
"properties": {
"sourceType": {
"type": "string",
"enum": [
"file_export",
"public_feed_page",
"public_api_endpoint",
"other"
]
},
"sourceUrl": {
"type": "string",
"format": "uri"
},
"format": {
"type": "string",
"enum": [
"json",
"xml",
"csv",
"rss",
"html",
"other"
]
},
"updateCadence": {
"type": "string",
"enum": [
"real_time",
"hourly",
"daily",
"weekly",
"manual"
]
}
}
}
}
}
}
}
},
"reviews": {
"type": "object",
"properties": {
"ratingSources": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"required": [
"provider",
"sourceUrl"
],
"properties": {
"provider": {
"type": "string",
"enum": [
"google_business_profile",
"yelp",
"tripadvisor",
"opentable",
"facebook",
"custom"
]
},
"sourceType": {
"type": "string",
"enum": [
"public_page",
"official_export",
"public_api_endpoint",
"other"
]
},
"sourceUrl": {
"type": "string",
"format": "uri"
},
"format": {
"type": "string",
"enum": [
"json",
"xml",
"csv",
"rss",
"html",
"other"
]
},
"updateCadence": {
"type": "string",
"enum": [
"real_time",
"hourly",
"daily",
"weekly",
"manual"
]
}
}
}
},
"retrievalPolicy": {
"type": "object",
"properties": {
"requiresLiveFetch": {
"type": "boolean"
},
"recommendedRefreshHours": {
"type": "integer",
"minimum": 1
}
}
}
}
}
}
},
"structuralMetadata": {
"type": "object",
"properties": {
"topology": {
"const": "binary"
},
"roles": {
"const": [
"user",
"platform"
]
},
"valueSource": {
"const": "platform_provided"
},
"transactionFlow": {
"const": "direct"
},
"networkEffects": {
"const": "none"
},
"commerceMode": {
"type": "string",
"enum": [
"inventory_led",
"drop_ship_enabled",
"hybrid"
]
}
}
},
"targetAudience": {
"type": "array",
"items": {
"type": "string"
}
},
"siteCapabilities": {
"type": "object",
"properties": {
"supportedDevices": {
"type": "array",
"items": {
"type": "string",
"enum": [
"desktop",
"mobile",
"tablet"
]
}
},
"languages": {
"type": "array",
"items": {
"type": "string"
}
},
"accessibilityFeatures": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"required": [
"@type",
"ontologicalMode",
"interactionArchetype",
"domain",
"name",
"description",
"deliveryFormat",
"capabilities",
"structuralMetadata",
"modules"
],
"validationMetadata": {
"schemaVersion": "3.0.0",
"phase": "entity",
"status": "draft",
"lastValidated": "2026-02-20T12:00:00Z",
"validator": "META-AIML QA"
},
"semanticAnnotations": {
"classificationRationale": "EcommerceStore is modeled as DigitalEntity + DirectService because the platform sells directly to end customers with first-party checkout and fulfillment orchestration.",
"disambiguationNotes": "Different from marketplaces where platform mediates third-party seller transactions. For static website deployment, avoid embedding full product/review snapshots; use source links in modules.catalog.catalogDiscovery, modules.pricing.pricingDiscovery, and modules.reviews.ratingSources."
},
"governanceMetadata": {
"entityVersion": "3.0.0",
"introducedIn": "META-AIML v3.0.0",
"stabilityLevel": "draft",
"sdkValidationRules": [
"RULE-ECOM-001: @type MUST equal \"EcommerceStore\"",
"RULE-ECOM-002: ontologicalMode MUST equal \"DigitalEntity\"",
"RULE-ECOM-003: interactionArchetype MUST contain \"DirectService\"",
"RULE-ECOM-004: capabilities.interaction MUST be present",
"RULE-ECOM-005: structuralMetadata.topology MUST equal \"binary\"",
"RULE-ECOM-006: structuralMetadata.transactionFlow MUST equal \"direct\"",
"RULE-ECOM-007: modules.catalog.catalogDiscovery.dataSources MUST include sourceType/sourceUrl/format",
"RULE-ECOM-008: modules.pricing.pricingDiscovery.dataSources MUST include sourceType/sourceUrl/format when pricing source links are declared"
]
}
}Filled Example Instance
https://schemas.meta-aiml.org/v3.0.0/examples/ecommerce_store_example_schema_v3.json
https://schemas.meta-aiml.org/v3.0.0/examples/ecommerce_store_example_schema_v3.json
{
"@context": [
"https://schemas.meta-aiml.org/v3.0.0/context.jsonld"
],
"@id": "https://data.meta-aiml.org/v3.0.0/examples/ecommerce_store/lumen-d2c",
"$id": "https://data.meta-aiml.org/v3.0.0/examples/ecommerce_store/lumen-d2c",
"@type": "EcommerceStore",
"schemaVersion": "3.0.0",
"aimlVersion": "3.0.0",
"title": "Example Filled EcommerceStore Entity Example (Lumen D2C)",
"ontologicalMode": "DigitalEntity",
"interactionArchetype": [
"DirectService"
],
"domain": "Commerce",
"businessModel": [
"Transactional",
"Subscription"
],
"deliveryFormat": [
"WebApp",
"MobileApp",
"API"
],
"name": {
"en": "Lumen D2C",
"es": "Lumen D2C",
"fr": "Lumen D2C"
},
"description": {
"en": "Lumen D2C is a fictional first-party ecommerce storefront with source-link catalog and pricing discovery for runtime AI retrieval.",
"es": "Lumen D2C es una tienda ecommerce ficticia de primera parte con descubrimiento de catalogo y precios por enlaces para consulta en tiempo de ejecucion.",
"fr": "Lumen D2C est une boutique ecommerce fictive avec decouverte du catalogue et des prix par liens pour recuperation dynamique par IA."
},
"shortDescription": {
"en": "Direct ecommerce storefront with external catalog and pricing sources.",
"es": "Tienda ecommerce directa con fuentes externas de catalogo y precios.",
"fr": "Boutique ecommerce directe avec sources externes de catalogue et de prix."
},
"url": "https://lumen-d2c.example",
"foundingDate": "2020-03-01",
"createdDate": "2026-02-20T18:10:00Z",
"lastModified": "2026-02-20T18:10:00Z",
"examples": [
{
"scenario": "Flash sale day",
"note": "Agent uses pricing source links to fetch current campaign prices before generating recommendations."
},
{
"scenario": "New collection release",
"note": "Catalog feed updates externally while static schema remains stable in website header."
}
],
"properties": {
"catalogStrategy": "single_brand",
"supportsPreorders": true,
"supportsBackorders": false,
"supportsInternationalShipping": true,
"pricingEngineType": "hybrid",
"identifiers": [
{
"type": "url",
"value": "https://lumen-d2c.example"
},
{
"type": "custom",
"value": "ECOM-LUMEN-001"
}
]
},
"capabilities": {
"interaction": {
"features": [
"messaging",
"rating",
"reviews",
"notifications"
],
"interactionMethods": [
"chat",
"email",
"online_form"
],
"availableActions": [
"browse_catalog",
"track_order",
"contact_support"
],
"hasMessaging": true,
"hasComments": false,
"hasRating": true,
"hasReviews": true,
"hasSocialGraph": false,
"hasFeed": true,
"hasNotifications": true,
"hasMatching": false,
"realTimeCommunication": true,
"moderationEnabled": true,
"privacyControls": [
"public",
"private"
]
},
"commerce": {
"features": [
"productCatalog",
"cart",
"checkout",
"orderTracking",
"inventory",
"search",
"filtering"
],
"hasProductCatalog": true,
"catalogSize": 3400,
"supportsCart": true,
"supportsCheckout": true,
"hasOrderTracking": true,
"recommendationEngine": true,
"vendorManagement": false,
"searchCapability": true,
"filteringOptions": [
"category",
"price",
"availability",
"size"
]
},
"financial": {
"features": [
"payments",
"refunds",
"billing",
"subscriptionManagement"
],
"paymentMethods": [
"credit_card",
"debit_card",
"digital_wallet",
"bank_transfer"
],
"acceptsCreditCards": true,
"currencies": [
"USD",
"EUR"
],
"priceRange": "$$",
"commissionModel": "fixed_price",
"commissionRate": 0,
"supportsSubscriptions": true,
"supportsInvoicing": true,
"refundPolicy": "partial_refund"
},
"content": {
"features": [
"publishing",
"mediaHosting",
"search",
"categories",
"tags"
],
"contentTypes": [
"product_page",
"image",
"video",
"review"
],
"contentFormats": [
"html",
"json",
"webp",
"mp4"
],
"contentAccess": [
"public"
],
"editorialControl": true,
"userGeneratedContent": true,
"mediaHosting": true,
"searchPossible": true,
"hasCategorization": true,
"hasTagging": true,
"archiveAccess": false,
"rssFeeds": true
},
"community": {
"features": [
"communities",
"discovery",
"moderation"
],
"supportsGroups": false,
"supportsChannels": false,
"communitiesCount": 0,
"hasDiscovery": true,
"hasModeration": true,
"moderationModel": "ai_assisted_human",
"hasMembershipManagement": true,
"membershipTypes": [
"free",
"premium"
],
"supportsGroupEvents": false,
"supportsPolls": false,
"hasGovernance": false,
"governanceModel": "centralized",
"privacyLevels": [
"public"
]
}
},
"modules": {
"catalog": {
"facetedSearchEnabled": true,
"taxonomyVersioned": true,
"recommendationBlocksEnabled": true,
"catalogDiscovery": {
"canonicalCatalogUrl": "https://lumen-d2c.example/catalog",
"dataSources": [
{
"sourceType": "file_export",
"sourceUrl": "https://lumen-d2c.example/data/catalog-feed.csv",
"format": "csv",
"updateCadence": "daily"
}
]
}
},
"pricing": {
"dynamicPricingEnabled": true,
"pricingDiscovery": {
"dataSources": [
{
"sourceType": "file_export",
"sourceUrl": "https://lumen-d2c.example/data/pricing-feed.json",
"format": "json",
"updateCadence": "daily"
}
]
}
},
"checkout": {
"guestCheckoutEnabled": true,
"oneClickCheckoutEnabled": true,
"addressValidationEnabled": true
},
"fulfillment": {
"warehouseRoutingEnabled": true,
"returnWorkflowEnabled": true,
"deliveryEtaPredictionEnabled": true
},
"reviews": {
"ratingSources": [
{
"provider": "google_business_profile",
"sourceType": "public_page",
"sourceUrl": "https://www.google.com/search?q=Lumen+D2C+reviews",
"format": "html",
"updateCadence": "daily"
},
{
"provider": "custom",
"sourceType": "public_page",
"sourceUrl": "https://lumen-d2c.example/reviews",
"format": "html",
"updateCadence": "daily"
}
],
"retrievalPolicy": {
"requiresLiveFetch": true,
"recommendedRefreshHours": 12
}
}
},
"structuralMetadata": {
"topology": "binary",
"roles": [
"user",
"platform"
],
"valueSource": "platform_provided",
"transactionFlow": "direct",
"networkEffects": "none",
"commerceMode": "inventory_led"
},
"targetAudience": [
"digital_shoppers",
"repeat_customers",
"subscription_members"
],
"siteCapabilities": {
"supportedDevices": [
"desktop",
"mobile",
"tablet"
],
"languages": [
"en",
"es",
"fr"
],
"accessibilityFeatures": [
"keyboard_navigation",
"screen_reader_labels",
"text_scaling",
"high_contrast_mode"
]
},
"validationMetadata": {
"schemaVersion": "3.0.0",
"phase": "example_instance",
"status": "reference",
"lastValidated": "2026-02-20T18:10:00Z",
"validator": "META-AIML SDK v3"
},
"semanticAnnotations": {
"classificationRationale": "EcommerceStore maps to DigitalEntity plus DirectService because the platform performs first-party direct transaction, checkout, and fulfillment orchestration.",
"disambiguationNotes": "This is not a marketplace for third-party sellers. Dynamic catalog, pricing, and review signals are retrieved via source links at runtime.",
"intendedUse": "Canonical filled reference for static ecommerce website schema with source-link discovery model."
},
"governanceMetadata": {
"entityVersion": "3.0.0",
"introducedIn": "META-AIML v3.0.0",
"stabilityLevel": "reference",
"sdkValidationRules": [
"RULE-ECOMG-001: @type MUST equal \"EcommerceStore\"",
"RULE-ECOMG-002: ontologicalMode MUST equal \"DigitalEntity\"",
"RULE-ECOMG-003: interactionArchetype MUST contain exactly one value: \"DirectService\"",
"RULE-ECOMG-004: modules.catalog.catalogDiscovery MUST declare source links and avoid embedded product snapshots",
"RULE-ECOMG-005: modules.pricing.pricingDiscovery MUST declare source links when pricing source data is provided",
"RULE-ECOMG-006: modules.reviews MUST declare source links and avoid embedded fixed rating snapshots",
"RULE-ECOMG-007: examples MUST include at least two practical scenarios",
"RULE-ECOMG-008: validationMetadata and governanceMetadata MUST be present and version-aligned"
]
}
}