BusinessServices

v3.0.0
DigitalEntity
B2B

v3 schema for digital B2B service platforms that provide operational business workflows directly to organizations through managed software and process automation.

Top-level required
10
Required modules
0
Capability groups
1
Entity properties
9
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.
contactPoints
dataResidencySupport
identifiers
serviceCategory
socialProfiles
supportsAuditLogging
supportsRoleBasedAccess
supportsSso
tenantModel
Modules Contract

Required modules

No required modules for this entity.

Optional modules

integrations
onboarding
reporting
Capabilities Contract

Required capability groups

interaction

Optional capability groups

commerce
content
financial
Governance Validation Rules
Normative rule list from governanceMetadata.sdkValidationRules.
RULE-BSERV-001: @type MUST equal "BusinessServices"
RULE-BSERV-002: ontologicalMode MUST equal "DigitalEntity"
RULE-BSERV-003: interactionArchetype MUST contain "DirectService"
RULE-BSERV-004: capabilities.interaction MUST be present
RULE-BSERV-005: structuralMetadata.topology MUST equal "binary"
RULE-BSERV-006: structuralMetadata.valueSource MUST equal "platform_provided"
Canonical Contract JSON
https://schemas.meta-aiml.org/v3.0.0/entity/business_services.json
https://schemas.meta-aiml.org/v3.0.0/entity/business_services.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/business_services.json",
  "$id": "https://schemas.meta-aiml.org/v3.0.0/entity/business_services.json",
  "@type": "BusinessServices",
  "schemaVersion": "3.0.0",
  "aimlVersion": "3.0.0",
  "title": "Business Services Entity Schema",
  "description": "v3 schema for digital B2B service platforms that provide operational business workflows directly to organizations through managed software and process automation.",
  "examples": [
    {
      "description": "Business operations platform with vendor onboarding and workflow automation",
      "reference": "business_services_example_operations"
    },
    {
      "description": "B2B back-office services platform with analytics and enterprise integrations",
      "reference": "business_services_example_backoffice"
    }
  ],
  "type": "object",
  "additionalProperties": false,
  "allOf": [
    {
      "$ref": "../ontology/digital_entity.json"
    },
    {
      "$ref": "../archetypes/direct_service.json"
    }
  ],
  "properties": {
    "@type": {
      "const": "BusinessServices"
    },
    "ontologicalMode": {
      "const": "DigitalEntity"
    },
    "interactionArchetype": {
      "type": "array",
      "contains": {
        "const": "DirectService"
      },
      "items": {
        "type": "string",
        "enum": [
          "DirectService"
        ]
      }
    },
    "domain": {
      "const": "B2B"
    },
    "businessModel": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "Subscription",
          "EnterpriseLicense",
          "UsageBased"
        ]
      }
    },
    "deliveryFormat": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "WebApp",
          "API",
          "MobileApp"
        ]
      }
    },
    "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": {
        "serviceCategory": {
          "type": "string",
          "enum": [
            "operations",
            "procurement",
            "finance",
            "hr",
            "compliance"
          ]
        },
        "tenantModel": {
          "type": "string",
          "enum": [
            "single_tenant",
            "multi_tenant",
            "hybrid"
          ]
        },
        "supportsSso": {
          "type": "boolean"
        },
        "supportsRoleBasedAccess": {
          "type": "boolean"
        },
        "supportsAuditLogging": {
          "type": "boolean"
        },
        "dataResidencySupport": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "contactPoints": {
          "type": "array",
          "items": {
            "$ref": "../components/common_defs.json#/$defs/ContactPoint"
          }
        },
        "socialProfiles": {
          "type": "array",
          "items": {
            "$ref": "../components/common_defs.json#/$defs/SocialProfile"
          }
        },
        "identifiers": {
          "type": "array",
          "items": {
            "$ref": "../components/common_defs.json#/$defs/Identifier"
          }
        }
      }
    },
    "capabilities": {
      "type": "object",
      "required": [
        "interaction"
      ],
      "properties": {
        "interaction": {
          "$ref": "../components/capability_groups.json#/$defs/InteractionCapabilities"
        },
        "content": {
          "$ref": "../components/capability_groups.json#/$defs/ContentCapabilities"
        },
        "financial": {
          "$ref": "../components/capability_groups.json#/$defs/FinancialCapabilities"
        },
        "commerce": {
          "$ref": "../components/capability_groups.json#/$defs/CommerceCapabilities"
        }
      }
    },
    "modules": {
      "type": "object",
      "properties": {
        "onboarding": {
          "type": "object",
          "properties": {
            "migrationToolsEnabled": {
              "type": "boolean"
            },
            "guidedSetupEnabled": {
              "type": "boolean"
            }
          }
        },
        "integrations": {
          "type": "object",
          "properties": {
            "prebuiltConnectorsCount": {
              "type": "integer",
              "minimum": 0
            },
            "webhookSupport": {
              "type": "boolean"
            },
            "apiRateLimitTiering": {
              "type": "boolean"
            }
          }
        },
        "reporting": {
          "type": "object",
          "properties": {
            "dashboardTemplatesCount": {
              "type": "integer",
              "minimum": 0
            },
            "scheduledReportsEnabled": {
              "type": "boolean"
            },
            "dataExportFormats": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        }
      }
    },
    "structuralMetadata": {
      "type": "object",
      "properties": {
        "topology": {
          "const": "binary"
        },
        "roles": {
          "const": [
            "user",
            "platform"
          ]
        },
        "valueSource": {
          "const": "platform_provided"
        },
        "transactionFlow": {
          "const": "direct"
        },
        "networkEffects": {
          "const": "none"
        },
        "deliveryOrientation": {
          "type": "string",
          "enum": [
            "self_service",
            "assisted_service",
            "managed_service"
          ]
        }
      }
    },
    "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": "BusinessServices is DigitalEntity because service delivery occurs through software channels independent of physical location. DirectService applies because the platform directly provides workflows and tooling to business users.",
    "disambiguationNotes": "Different from marketplace-style B2B exchanges where platform mediates third-party transactions. This schema models first-party service delivery."
  },
  "governanceMetadata": {
    "entityVersion": "3.0.0",
    "introducedIn": "META-AIML v3.0.0",
    "stabilityLevel": "draft",
    "sdkValidationRules": [
      "RULE-BSERV-001: @type MUST equal \"BusinessServices\"",
      "RULE-BSERV-002: ontologicalMode MUST equal \"DigitalEntity\"",
      "RULE-BSERV-003: interactionArchetype MUST contain \"DirectService\"",
      "RULE-BSERV-004: capabilities.interaction MUST be present",
      "RULE-BSERV-005: structuralMetadata.topology MUST equal \"binary\"",
      "RULE-BSERV-006: structuralMetadata.valueSource MUST equal \"platform_provided\""
    ]
  }
}
Filled Example Instance
https://schemas.meta-aiml.org/v3.0.0/examples/business_services_example_schema_v3.json
https://schemas.meta-aiml.org/v3.0.0/examples/business_services_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/business_services/opsforge-b2b-suite",
  "$id": "https://data.meta-aiml.org/v3.0.0/examples/business_services/opsforge-b2b-suite",
  "@type": "BusinessServices",
  "schemaVersion": "3.0.0",
  "aimlVersion": "3.0.0",
  "title": "Example Filled Business Services Example (OpsForge B2B Suite)",
  "ontologicalMode": "DigitalEntity",
  "interactionArchetype": [
    "DirectService"
  ],
  "domain": "B2B",
  "businessModel": [
    "Subscription",
    "EnterpriseLicense",
    "UsageBased"
  ],
  "deliveryFormat": [
    "WebApp",
    "API",
    "MobileApp"
  ],
  "name": {
    "en": "OpsForge B2B Suite",
    "es": "OpsForge B2B Suite",
    "fr": "OpsForge B2B Suite"
  },
  "description": {
    "en": "OpsForge B2B Suite is a fictional business operations platform delivering procurement, compliance, and workflow automation services directly to enterprise and mid-market teams.",
    "es": "OpsForge B2B Suite es una plataforma ficticia de servicios empresariales para operaciones, compras y cumplimiento con automatizacion de flujos.",
    "fr": "OpsForge B2B Suite est une plateforme fictive de services B2B pour operations, achats et conformite avec automatisation des workflows."
  },
  "shortDescription": {
    "en": "B2B operations platform for procurement, compliance workflows, and enterprise automation.",
    "es": "Plataforma B2B de operaciones para compras, cumplimiento y automatizacion empresarial.",
    "fr": "Plateforme B2B d operations pour achats, conformite et automatisation entreprise."
  },
  "url": "https://opsforge-b2b.example",
  "foundingDate": "2016-08-25",
  "createdDate": "2026-02-20T20:38:00Z",
  "lastModified": "2026-02-20T20:38:00Z",
  "examples": [
    {
      "scenario": "Enterprise rollout across 12 regional business units",
      "note": "AI should prioritize tenant isolation, role policies, and onboarding migration workflows under direct-service platform assumptions."
    },
    {
      "scenario": "Quarter-end compliance reporting deadline",
      "note": "AI should route requests through reporting and audit logging modules, with focus on export formats and schedule automation."
    }
  ],
  "properties": {
    "serviceCategory": "operations",
    "tenantModel": "hybrid",
    "supportsSso": true,
    "supportsRoleBasedAccess": true,
    "supportsAuditLogging": true,
    "dataResidencySupport": [
      "US",
      "EU",
      "APAC"
    ],
    "contactPoints": [
      {
        "contactType": "support",
        "telephone": "+1-617-555-0192",
        "email": "support@opsforge-b2b.example",
        "url": "https://opsforge-b2b.example/help",
        "areaServed": "global",
        "availableLanguages": [
          "en",
          "es",
          "fr"
        ]
      },
      {
        "contactType": "sales",
        "telephone": "+1-617-555-0140",
        "email": "enterprise@opsforge-b2b.example",
        "url": "https://opsforge-b2b.example/enterprise",
        "areaServed": "global",
        "availableLanguages": [
          "en"
        ]
      }
    ],
    "socialProfiles": [
      {
        "platform": "linkedin",
        "url": "https://www.linkedin.com/company/opsforge-b2b-suite",
        "username": "opsforge-b2b-suite"
      },
      {
        "platform": "github",
        "url": "https://github.com/opsforge-b2b",
        "username": "opsforge-b2b"
      }
    ],
    "identifiers": [
      {
        "type": "url",
        "value": "https://opsforge-b2b.example"
      },
      {
        "type": "custom",
        "value": "BSRV-OFB-001"
      }
    ]
  },
  "capabilities": {
    "interaction": {
      "features": [
        "messaging",
        "commenting",
        "feed",
        "notifications"
      ],
      "interactionMethods": [
        "online_form",
        "chat",
        "email"
      ],
      "availableActions": [
        "create_workflow",
        "approve_request",
        "assign_owner",
        "run_report",
        "open_support_case"
      ],
      "hasMessaging": true,
      "hasComments": true,
      "hasRating": false,
      "hasReviews": false,
      "hasSocialGraph": false,
      "hasFeed": true,
      "hasNotifications": true,
      "hasMatching": false,
      "realTimeCommunication": true,
      "moderationEnabled": true,
      "privacyControls": [
        "private",
        "semi_anonymous"
      ]
    },
    "content": {
      "features": [
        "publishing",
        "search",
        "categories",
        "tags",
        "archives"
      ],
      "contentTypes": [
        "workflow_template",
        "policy_document",
        "audit_report",
        "knowledge_base"
      ],
      "contentFormats": [
        "text",
        "html",
        "markdown",
        "json",
        "csv"
      ],
      "contentAccess": [
        "member",
        "restricted"
      ],
      "editorialControl": true,
      "userGeneratedContent": true,
      "mediaHosting": false,
      "searchPossible": true,
      "hasCategorization": true,
      "hasTagging": true,
      "archiveAccess": true,
      "rssFeeds": false
    },
    "financial": {
      "features": [
        "payments",
        "invoicing",
        "refunds",
        "billing",
        "subscriptionManagement"
      ],
      "paymentMethods": [
        "bank_transfer",
        "credit_card",
        "invoice_terms"
      ],
      "acceptsCreditCards": true,
      "currencies": [
        "USD",
        "EUR"
      ],
      "priceRange": "enterprise_tiered",
      "commissionModel": "fixed_price",
      "commissionRate": 0,
      "supportsSubscriptions": true,
      "supportsInvoicing": true,
      "refundPolicy": "partial_refund"
    },
    "commerce": {
      "features": [
        "productCatalog",
        "checkout",
        "pricing",
        "search",
        "filtering"
      ],
      "hasProductCatalog": true,
      "catalogSize": 84,
      "supportsCart": false,
      "supportsCheckout": true,
      "hasOrderTracking": true,
      "recommendationEngine": false,
      "vendorManagement": false,
      "searchCapability": true,
      "filteringOptions": [
        "industry",
        "service_tier",
        "compliance_scope"
      ]
    }
  },
  "modules": {
    "onboarding": {
      "migrationToolsEnabled": true,
      "guidedSetupEnabled": true
    },
    "integrations": {
      "prebuiltConnectorsCount": 48,
      "webhookSupport": true,
      "apiRateLimitTiering": true
    },
    "reporting": {
      "dashboardTemplatesCount": 36,
      "scheduledReportsEnabled": true,
      "dataExportFormats": [
        "csv",
        "json",
        "pdf"
      ]
    },
    "security": {
      "ssoEnforced": true,
      "rbacEnabled": true,
      "anomalyDetectionEnabled": true
    }
  },
  "structuralMetadata": {
    "topology": "binary",
    "roles": [
      "user",
      "platform"
    ],
    "valueSource": "platform_provided",
    "transactionFlow": "direct",
    "networkEffects": "none",
    "deliveryOrientation": "managed_service"
  },
  "targetAudience": [
    "operations_teams",
    "procurement_teams",
    "finance_teams",
    "compliance_officers"
  ],
  "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-20T20:38:00Z",
    "validator": "META-AIML SDK v3"
  },
  "semanticAnnotations": {
    "classificationRationale": "BusinessServices is modeled as DigitalEntity plus DirectService because operational workflows are delivered directly by platform software to business users.",
    "disambiguationNotes": "This model is not a two-sided B2B marketplace. It describes first-party managed service delivery with enterprise governance controls.",
    "intendedUse": "Canonical filled reference for B2B service platforms embedding static META-AIML v3 schema metadata."
  },
  "governanceMetadata": {
    "entityVersion": "3.0.0",
    "introducedIn": "META-AIML v3.0.0",
    "stabilityLevel": "reference",
    "sdkValidationRules": [
      "RULE-BSGF-001: @type MUST equal \"BusinessServices\"",
      "RULE-BSGF-002: ontologicalMode MUST equal \"DigitalEntity\"",
      "RULE-BSGF-003: interactionArchetype MUST contain exactly one value: \"DirectService\"",
      "RULE-BSGF-004: capabilities MUST include interaction and financial groups",
      "RULE-BSGF-005: modules.onboarding, modules.integrations, and modules.reporting MUST be present",
      "RULE-BSGF-006: structuralMetadata constants MUST align with DirectService archetype",
      "RULE-BSGF-007: examples MUST include at least two operational scenarios",
      "RULE-BSGF-008: schema MUST NOT expose credential or secret fields"
    ]
  }
}