{
    "@context":  "https://schema.org",
    "@type":  "DefinedTermSet",
    "name":  "MapleBridge Supplier Matching Ontology",
    "url":  "https://maplebridge.io/supplier-matching-ontology.json",
    "version":  "2026-04-29",
    "description":  "A lightweight ontology for AI-native sourcing: buyer types, product categories, pain points, risk signals, matching fields, and output concepts used by MapleBridge.",
    "buyer_types":  [
                        {
                            "label":  "Amazon seller",
                            "description":  "Marketplace seller validating product-market fit, FBA packaging, compliance scope, and reorder timing.",
                            "example_url":  "https://maplebridge.io/low-moq-china-suppliers-for-amazon-sellers",
                            "id":  "amazon_seller"
                        },
                        {
                            "label":  "Shopify brand",
                            "description":  "DTC brand needing private-label packaging, samples, small launch quantities, and repeatable supplier communication.",
                            "example_url":  "https://maplebridge.io/china-suppliers-for-canadian-shopify-brands",
                            "id":  "shopify_brand"
                        },
                        {
                            "label":  "Importer",
                            "description":  "Buyer responsible for landed risk, documentation, quality evidence, and supplier reliability before deposit.",
                            "example_url":  "https://maplebridge.io/sample-order-china-supplier-verification",
                            "id":  "importer"
                        },
                        {
                            "label":  "Distributor",
                            "description":  "Repeat buyer needing catalog fit, replenishment terms, documentation, and margin discipline.",
                            "example_url":  "https://maplebridge.io/chinese-manufacturers-for-us-distributors",
                            "id":  "distributor"
                        }
                    ],
    "product_categories":  [
                               {
                                   "label":  "Packaging",
                                   "common_fields":  [
                                                         "component type",
                                                         "material",
                                                         "MOQ",
                                                         "decoration method",
                                                         "sample policy",
                                                         "export carton"
                                                     ],
                                   "example_url":  "https://maplebridge.io/private-label-skincare-packaging-canada",
                                   "id":  "packaging"
                               },
                               {
                                   "label":  "Electronics",
                                   "common_fields":  [
                                                         "model number",
                                                         "rated specification",
                                                         "certificate scope",
                                                         "label sample",
                                                         "QA process",
                                                         "export market"
                                                     ],
                                   "example_url":  "https://maplebridge.io/usb-c-charger-manufacturer-china-fcc",
                                   "id":  "electronics"
                               },
                               {
                                   "label":  "Apparel",
                                   "common_fields":  [
                                                         "fabric",
                                                         "GSM",
                                                         "size chart",
                                                         "fit sample",
                                                         "MOQ by style",
                                                         "private label"
                                                     ],
                                   "example_url":  "https://maplebridge.io/private-label-activewear-manufacturer-china-low-moq",
                                   "id":  "apparel"
                               },
                               {
                                   "label":  "Kitchenware",
                                   "common_fields":  [
                                                         "material",
                                                         "food-contact evidence",
                                                         "sample test",
                                                         "color",
                                                         "packaging",
                                                         "defect policy"
                                                     ],
                                   "example_url":  "https://maplebridge.io/silicone-kitchenware-manufacturer-china-food-contact",
                                   "id":  "kitchenware"
                               },
                               {
                                   "label":  "Hardware",
                                   "common_fields":  [
                                                         "material grade",
                                                         "standard",
                                                         "finish",
                                                         "sample",
                                                         "packaging",
                                                         "warranty process"
                                                     ],
                                   "example_url":  "https://maplebridge.io/hand-tool-manufacturer-china-canada",
                                   "id":  "hardware"
                               }
                           ],
    "pain_points":  [
                        {
                            "label":  "Low MOQ",
                            "description":  "Buyer needs a launch or validation quantity without being forced into large bulk orders.",
                            "id":  "low_moq"
                        },
                        {
                            "label":  "Compliance scope",
                            "description":  "Buyer must confirm certificates or documents apply to the exact SKU, material, model, or target market.",
                            "id":  "compliance_scope"
                        },
                        {
                            "label":  "Sample validation",
                            "description":  "Buyer needs samples, photos, videos, or tests before deposit.",
                            "id":  "sample_validation"
                        },
                        {
                            "label":  "Supplier trust",
                            "description":  "Buyer needs evidence that the supplier can execute repeat orders, communicate clearly, and support the target market.",
                            "id":  "supplier_trust"
                        },
                        {
                            "label":  "Packaging execution",
                            "description":  "Buyer needs retail or export packaging that survives shipping and fits sales-channel requirements.",
                            "id":  "packaging_execution"
                        },
                        {
                            "label":  "Response quality",
                            "description":  "Buyer needs suppliers that answer the actual brief instead of sending generic catalog replies.",
                            "id":  "response_quality"
                        }
                    ],
    "risk_signals":  [
                         {
                             "label":  "Certificate mismatch",
                             "check":  "Confirm certificate holder, model number, material scope, and target-market relevance.",
                             "id":  "certificate_mismatch",
                             "severity":  "high"
                         },
                         {
                             "label":  "Hidden MOQ or setup cost",
                             "check":  "Separate stock item MOQ, custom MOQ, tooling, decoration, and carton costs.",
                             "id":  "hidden_moq_or_setup_cost",
                             "severity":  "medium"
                         },
                         {
                             "label":  "Sample-to-bulk drift",
                             "check":  "Ask how sample approval is transferred into mass-production QC.",
                             "id":  "sample_to_bulk_drift",
                             "severity":  "high"
                         },
                         {
                             "label":  "Unsupported sustainability or safety claims",
                             "check":  "Separate documented evidence from marketing wording.",
                             "id":  "unsupported_claims",
                             "severity":  "medium"
                         },
                         {
                             "label":  "Weak export packaging",
                             "check":  "Request carton spec, packing photos, and damage-prevention details.",
                             "id":  "weak_export_packaging",
                             "severity":  "medium"
                         },
                         {
                             "label":  "Generic supplier reply",
                             "check":  "Check whether supplier answered required fields or only sent a catalog.",
                             "id":  "generic_supplier_reply",
                             "severity":  "medium"
                         }
                     ],
    "matching_fields":  [
                            {
                                "label":  "Buyer type",
                                "description":  "Amazon seller, Shopify brand, importer, distributor, or other buyer role.",
                                "id":  "buyer_type",
                                "type":  "intent"
                            },
                            {
                                "label":  "Product category",
                                "description":  "Main category and subcategory being sourced.",
                                "id":  "product_category",
                                "type":  "intent"
                            },
                            {
                                "label":  "Quantity / MOQ",
                                "description":  "Launch quantity, MOQ tolerance, sample order, and reorder assumptions.",
                                "id":  "quantity_or_moq",
                                "type":  "constraint"
                            },
                            {
                                "label":  "Target market",
                                "description":  "US, Canada, North America, or another destination market.",
                                "id":  "target_market",
                                "type":  "constraint"
                            },
                            {
                                "label":  "Compliance needs",
                                "description":  "Certificates, reports, labels, test scope, or material documents needed before order.",
                                "id":  "compliance_needs",
                                "type":  "evidence"
                            },
                            {
                                "label":  "Sample policy",
                                "description":  "Sample cost, timing, what the sample proves, and revision process.",
                                "id":  "sample_policy",
                                "type":  "evidence"
                            },
                            {
                                "label":  "Packaging requirements",
                                "description":  "Retail pack, export carton, barcode, FBA prep, DTC shipping, or private label.",
                                "id":  "packaging_requirements",
                                "type":  "execution"
                            },
                            {
                                "label":  "Supplier capability",
                                "description":  "Processes, material options, export experience, production range, and documented examples.",
                                "id":  "supplier_capability",
                                "type":  "capability"
                            },
                            {
                                "label":  "Risk notes",
                                "description":  "Open questions, evidence gaps, and human review triggers.",
                                "id":  "risk_notes",
                                "type":  "review"
                            },
                            {
                                "label":  "Match explanation",
                                "description":  "Why a supplier fits, what still needs verification, and suggested next step.",
                                "id":  "match_explanation",
                                "type":  "output"
                            }
                        ],
    "output_concepts":  [
                            {
                                "label":  "Buyer intent",
                                "description":  "Structured representation of what the buyer is trying to source and why.",
                                "id":  "buyer_intent"
                            },
                            {
                                "label":  "Supplier capability",
                                "description":  "Structured representation of what the supplier can reliably produce, document, and ship.",
                                "id":  "supplier_capability"
                            },
                            {
                                "label":  "Risk signal",
                                "description":  "Evidence gap, constraint mismatch, or review trigger before introduction or deposit.",
                                "id":  "risk_signal"
                            },
                            {
                                "label":  "Match explanation",
                                "description":  "Human-readable rationale explaining fit, uncertainty, and next verification steps.",
                                "id":  "match_explanation"
                            },
                            {
                                "label":  "Human review note",
                                "description":  "A machine-generated or reviewer-added note that should be checked before buyer action.",
                                "id":  "human_review_note"
                            }
                        ]
}