Agent-native supply network for components, fabrication, industrial RFQs, offers, and fulfillment.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional for public discovery. Protected tools support OAuth or a scoped SupplySlate bearer credential.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Ask the buyer a clarification question on an approved supplier RFQ without changing the immutable request package.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Ask the buyer a clarification question on an approved supplier RFQ without changing the immutable request package.
| Argument | Type | Description |
|---|---|---|
| match_id* | string | |
| question* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"match_id",
"question"
],
"properties": {
"match_id": {
"type": "string",
"pattern": "^rm_[A-Za-z0-9-]+$"
},
"question": {
"type": "string",
"maxLength": 4000,
"minLength": 3
}
}
}Attach an HTTPS repository, document, drawing, datasheet, BOM, or design reference to the current project revision without copying its bytes. Private or expiring URLs remain the buyer's responsibility until uploaded directly.
| Argument | Type | Description |
|---|---|---|
| purpose* | string | |
| media_type | string | |
| project_id* | string | |
| source_url* | string | |
| artifact_type* | string | |
| checksum_sha256 | string | |
| original_filename | string | |
| data_classification* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_id",
"source_url",
"artifact_type",
"purpose",
"data_classification"
],
"properties": {
"purpose": {
"enum": [
"design",
"drawing",
"bom_source",
"datasheet",
"photo",
"requirement_package",
"quote",
"certification",
"other"
],
"type": "string"
},
"media_type": {
"type": "string",
"default": "application/octet-stream",
"maxLength": 160,
"minLength": 3
},
"project_id": {
"type": "string",
"pattern": "^prj_[A-Za-z0-9-]+$"
},
"source_url": {
"type": "string",
"format": "uri",
"pattern": "^https:\\/\\/.*"
},
"artifact_type": {
"enum": [
"step",
"stp",
"stl",
"3mf",
"obj",
"iges",
"igs",
"dxf",
"gerber_zip",
"kicad",
"csv",
"xlsx",
"pdf",
"image",
"text",
"json",
"other"
],
"type": "string"
},
"checksum_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"original_filename": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"data_classification": {
"enum": [
"public",
"commercial",
"confidential",
"restricted"
],
"type": "string"
}
}
}Create a short-lived, one-time private artifact upload URL. The caller must stream the exact declared bytes with a SHA-256 checksum.
| Argument | Type | Description |
|---|---|---|
| purpose* | string | |
| media_type* | string | |
| project_id* | string | |
| size_bytes* | integer | |
| artifact_type* | string | |
| checksum_sha256* | string | |
| original_filename* | string | |
| data_classification* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_id",
"original_filename",
"media_type",
"artifact_type",
"purpose",
"data_classification",
"size_bytes",
"checksum_sha256"
],
"properties": {
"purpose": {
"enum": [
"design",
"drawing",
"bom_source",
"datasheet",
"photo",
"requirement_package",
"quote",
"certification",
"other"
],
"type": "string"
},
"media_type": {
"type": "string",
"maxLength": 160,
"minLength": 3
},
"project_id": {
"type": "string",
"pattern": "^prj_[A-Za-z0-9-]+$"
},
"size_bytes": {
"type": "integer",
"maximum": 52428800,
"exclusiveMinimum": 0
},
"artifact_type": {
"enum": [
"step",
"stp",
"stl",
"3mf",
"obj",
"iges",
"igs",
"dxf",
"gerber_zip",
"kicad",
"csv",
"xlsx",
"pdf",
"image",
"text",
"json",
"other"
],
"type": "string"
},
"checksum_sha256": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"original_filename": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"data_classification": {
"enum": [
"public",
"commercial",
"confidential",
"restricted"
],
"type": "string"
}
}
}Create a durable CSV, XLSX, JSON, feed, API, document, or manual catalog import. Supply parsed rows for immediate validation, or an artifact/source reference to enter the mapping workflow.
| Argument | Type | Description |
|---|---|---|
| rows | array | |
| mapping | object | |
| source_url | string | |
| source_type* | string | |
| idempotency_key* | string | |
| source_artifact_id | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"source_type",
"idempotency_key"
],
"properties": {
"rows": {
"type": "array",
"items": {
"type": "object",
"required": [
"supplier_sku",
"description"
],
"properties": {
"unit": {
"type": "string",
"maxLength": 40
},
"expires_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"source_url": {
"type": "string",
"format": "uri",
"pattern": "^https:\\/\\/.*"
},
"description": {
"type": "string",
"maxLength": 1000,
"minLength": 3
},
"observed_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"price_minor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"manufacturer": {
"type": "string",
"maxLength": 200
},
"supplier_sku": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"certifications": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 25
},
"equipment_make": {
"type": "string",
"maxLength": 200
},
"lead_time_days": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"price_currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"specifications": {
"type": "object",
"default": {},
"propertyNames": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"equipment_model": {
"type": "string",
"maxLength": 200
},
"package_multiple": {
"type": "number",
"exclusiveMinimum": 0
},
"quantity_available": {
"type": "number",
"minimum": 0
},
"availability_status": {
"enum": [
"in_stock",
"limited",
"backorder",
"made_to_order",
"unavailable",
"unknown"
],
"type": "string",
"default": "unknown"
},
"network_category_code": {
"type": "string",
"maxLength": 100
},
"fabrication_process_id": {
"type": "string",
"maxLength": 100
},
"minimum_order_quantity": {
"type": "number",
"exclusiveMinimum": 0
},
"manufacturer_part_number": {
"type": "string",
"maxLength": 200
}
}
},
"maxItems": 1000
},
"mapping": {
"type": "object",
"default": {},
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"source_url": {
"type": "string",
"format": "uri",
"pattern": "^https:\\/\\/.*"
},
"source_type": {
"enum": [
"csv",
"xlsx",
"json",
"api",
"feed",
"document",
"manual"
],
"type": "string"
},
"idempotency_key": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"source_artifact_id": {
"type": "string",
"maxLength": 100
}
}
}Create a durable supply project from an idea, file, BOM, exact part, or RFQ origin. Requires a scoped buyer credential.
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| brief* | string | |
| need_by | string | |
| demand_lane* | string | |
| external_id | string | |
| origin_type* | string | |
| budget_minor | integer | |
| fixture_kind | string | Explicit lineage for integration fixtures; never use synthetic records as market evidence. |
| project_type* | string | |
| requirements | array | |
| build_quantity |
After a human has approved the exact purchase plan, create one supplier-hosted payment link for a checkout-connected provider offer. This creates an unpaid provider order but never submits payment or exposes payment credentials to SupplySlate.
| Argument | Type | Description |
|---|---|---|
| contact | object | Optional. Omit to let the provider-hosted page collect contact details from the human. |
| ship_to | object | Optional. Omit to let the provider-hosted page collect the shipping address from the human. |
| return_url | string | |
| purchase_plan_id* | string | |
| merchant_group_key* | string | |
| shipping_option_id | string | Exact approved shipping option. Omit to use the least-cost option already priced into the approved plan. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"purchase_plan_id",
"merchant_group_key"
],
"properties": {
"contact": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"format": "email",
"pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"maxLength": 320
},
"phone": {
"type": "string",
"maxLength": 40,
"minLength": 5
}
},
"description": "Optional. Omit to let the provider-hosted page collect contact details from the human.",
"additionalProperties": false
},
"ship_to": {
"type": "object",
"required": [
"name",
"street1",
"city",
"state",
"zip"
],
"properties": {
"zip": {
"type": "string",
"maxLength": 20,
"minLength": 3
},
"city": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"state": {
"type": "string",
"maxLength": 2,
"minLength": 2
},
"country": {
"type": "string",
"default": "US",
"maxLength": 2,
"minLength": 2
},
"street1": {
"type": "string",
"maxLength": 300,
"minLength": 1
},
"street2": {
"type": "string",
"maxLength": 300
}
},
"description": "Optional. Omit to let the provider-hosted page collect the shipping address from the human.",
"additionalProperties": false
},
"return_url": {
"type": "string",
"format": "uri",
"pattern": "^https:\\/\\/.*",
"maxLength": 2048
},
"purchase_plan_id": {
"type": "string",
"pattern": "^ppl_[A-Za-z0-9-]+$"
},
"merchant_group_key": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"shipping_option_id": {
"type": "string",
"maxLength": 160,
"minLength": 1,
"description": "Exact approved shipping option. Omit to use the least-cost option already priced into the approved plan."
}
}
}Create an immutable, single-currency, multi-supplier purchase plan from selected current quote lines, choosing at most one commercial option per requested line. This records a plan only; it neither approves nor purchases anything.
| Argument | Type | Description |
|---|---|---|
| expires_at | string | |
| request_id* | string | |
| quote_item_ids* | array | |
| idempotency_key* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"request_id",
"quote_item_ids",
"idempotency_key"
],
"properties": {
"expires_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"request_id": {
"type": "string",
"pattern": "^sr_[A-Za-z0-9-]+$"
},
"quote_item_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^qit_[A-Za-z0-9-]+$"
},
"maxItems": 500,
"minItems": 1
},
"idempotency_key": {
"type": "string",
"maxLength": 160,
"minLength": 1
}
}
}Accept or reject a buyer cancellation request for the authenticated supplier's unshipped merchant order. Acceptance is the state-changing merchant decision.
| Argument | Type | Description |
|---|---|---|
| note | string | |
| decision* | string | |
| order_id* | string | |
| merchant_reference | string | |
| cancellation_request_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id",
"cancellation_request_id",
"decision"
],
"properties": {
"note": {
"type": "string",
"maxLength": 4000
},
"decision": {
"enum": [
"accepted",
"rejected"
],
"type": "string"
},
"order_id": {
"type": "string",
"pattern": "^ord_[A-Za-z0-9-]+$"
},
"merchant_reference": {
"type": "string",
"maxLength": 300
},
"cancellation_request_id": {
"type": "string",
"pattern": "^ocr_[A-Za-z0-9-]+$"
}
}
}Decline an approved RFQ with a structured reason so the buyer and network can route more accurately.
| Argument | Type | Description |
|---|---|---|
| reason* | string | |
| match_id* | string | |
| reason_code* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"match_id",
"reason_code",
"reason"
],
"properties": {
"reason": {
"type": "string",
"maxLength": 2000,
"minLength": 3
},
"match_id": {
"type": "string",
"pattern": "^rm_[A-Za-z0-9-]+$"
},
"reason_code": {
"enum": [
"no_capability",
"no_capacity",
"quantity_too_low",
"quantity_too_high",
"outside_geography",
"deadline",
"commercial_terms",
"insufficient_information",
"other"
],
"type": "string"
}
}
}Explain what SupplySlate does, what it does not do, and when a buyer-owned agent should use it.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}Read the current revision of one project BOM, including hierarchy, quantities, sourcing state, and interface dependencies.
| Argument | Type | Description |
|---|---|---|
| bom_id* | string | |
| project_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_id",
"bom_id"
],
"properties": {
"bom_id": {
"type": "string",
"pattern": "^bom_[A-Za-z0-9-]+$"
},
"project_id": {
"type": "string",
"pattern": "^prj_[A-Za-z0-9-]+$"
}
}
}List merchant-hosted checkout, supplier invoice, or merchant-order handoffs for an approved plan. Suppliers remain merchant of record and SupplySlate does not process funds.
| Argument | Type | Description |
|---|---|---|
| purchase_plan_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"purchase_plan_id"
],
"properties": {
"purchase_plan_id": {
"type": "string",
"pattern": "^ppl_[A-Za-z0-9-]+$"
}
}
}Read one published compatibility or substitution assertion with exact subject, object, conditions, confidence, evidence source, and observation time.
| Argument | Type | Description |
|---|---|---|
| compatibility_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"compatibility_id"
],
"properties": {
"compatibility_id": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
}
}Return the exact MCP and REST connection details a buyer, developer, or agent operator needs to connect to SupplySlate.
| Argument | Type | Description |
|---|---|---|
| client | string | The agent client or integration style that will connect to SupplySlate. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"client": {
"enum": [
"generic_mcp",
"custom_agent",
"chatgpt",
"claude",
"codex"
],
"type": "string",
"default": "generic_mcp",
"description": "The agent client or integration style that will connect to SupplySlate."
}
}
}Read attributed live fabrication capabilities from the connected AFN provider. This is discovery only and neither uploads a design nor requests a quote.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}Read one merchant-confirmed order with items, fulfillment, shipments, issues, evidence, and event history.
| Argument | Type | Description |
|---|---|---|
| order_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "string",
"pattern": "^ord_[A-Za-z0-9-]+$"
}
}
}Read one published canonical product with variants, category links, evidence scope, observation dates, and freshness.
| Argument | Type | Description |
|---|---|---|
| product_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"product_id"
],
"properties": {
"product_id": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
}
}Read a project, its current immutable-capable revision, requirements, artifacts, BOM summaries, and validation history.
| Argument | Type | Description |
|---|---|---|
| project_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_id"
],
"properties": {
"project_id": {
"type": "string",
"pattern": "^prj_[A-Za-z0-9-]+$"
}
}
}Read one exact purchase-plan version with selected lines, merchants, totals, risks, evidence, approvals, and checkout handoffs.
| Argument | Type | Description |
|---|---|---|
| purchase_plan_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"purchase_plan_id"
],
"properties": {
"purchase_plan_id": {
"type": "string",
"pattern": "^ppl_[A-Za-z0-9-]+$"
}
}
}Read the evidence-safe input schema for a configurable supply category or fabrication process, including required fields, recommended fields, accepted artifacts, and safety notes.
| Argument | Type | Description |
|---|---|---|
| type | string | Optional disambiguation when an identifier could exist in both namespaces. |
| identifier* | string | Category code, fabrication-process slug, or fabrication-process ID. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"identifier"
],
"properties": {
"type": {
"enum": [
"category",
"process"
],
"type": "string",
"description": "Optional disambiguation when an identifier could exist in both namespaces."
},
"identifier": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Category code, fabrication-process slug, or fabrication-process ID."
}
}
}Read the current status and normalized line items for one authenticated buyer sourcing request.
| Argument | Type | Description |
|---|---|---|
| request_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"request_id"
],
"properties": {
"request_id": {
"type": "string",
"pattern": "^sr_[A-Za-z0-9-]+$"
}
}
}Read one public supplier profile with source URLs and evidence for every category, capability, and brand claim.
| Argument | Type | Description |
|---|---|---|
| supplier_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"supplier_id"
],
"properties": {
"supplier_id": {
"type": "string",
"pattern": "^sup_[A-Za-z0-9_-]+$"
}
}
}Retrieve current normalized supplier quote revisions for one buyer sourcing request, including unquoted lines, compatibility, price, availability, lead time, terms, and evidence. SupplySlate returns explicit tradeoffs and applies no hidden winner score.
| Argument | Type | Description |
|---|---|---|
| request_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"request_id"
],
"properties": {
"request_id": {
"type": "string",
"pattern": "^sr_[A-Za-z0-9-]+$"
}
}
}Read the authenticated supplier's SupplySlate profile and current catalog-item count. Requires a supplier API key.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}Read an approved RFQ and its normalized buyer line items. Requires a supplier API key.
| Argument | Type | Description |
|---|---|---|
| match_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"match_id"
],
"properties": {
"match_id": {
"type": "string",
"pattern": "^rm_[A-Za-z0-9-]+$"
}
}
}List configurable fabrication, kitting, assembly, and test processes with their required artifacts and requirement schemas.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}List merchant-confirmed orders for the buyer organization. A plan or queued handoff is never represented as an order.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}List versioned validation reports for a project without implying licensed engineering approval.
| Argument | Type | Description |
|---|---|---|
| project_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_id"
],
"properties": {
"project_id": {
"type": "string",
"pattern": "^prj_[A-Za-z0-9-]+$"
}
}
}List the editable supply categories currently accepting requests. Agents may still submit a precise request outside this list.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}List recent sourcing requests owned by the authenticated buyer organization across API keys and OAuth agents.
| Argument | Type | Description |
|---|---|---|
| limit | integer |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1
}
}
}List merchant-confirmed orders attributable to the authenticated supplier. RFQs, quotes, plans, and checkout handoffs are not represented as orders.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}List approved RFQs matched to the authenticated supplier. Requires a supplier API key.
| Argument | Type | Description |
|---|---|---|
| limit | integer |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 50,
"minimum": 1
}
}
}List the product categories used by the public industrial compressor service-parts supplier directory, including verified supplier counts.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}Open a durable warranty claim on an accepted order or specific order line. This records the claim and notifies the supplier without asserting eligibility or approval.
| Argument | Type | Description |
|---|---|---|
| order_id* | string | |
| description* | string | |
| order_item_id | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id",
"description"
],
"properties": {
"order_id": {
"type": "string",
"pattern": "^ord_[A-Za-z0-9-]+$"
},
"description": {
"type": "string",
"maxLength": 4000,
"minLength": 3
},
"order_item_id": {
"type": "string",
"pattern": "^ori_[A-Za-z0-9-]+$"
}
}
}Open a durable post-purchase issue for a merchant-confirmed order. This notifies the supplier-side organization and records owner, status, and event history; it does not claim a resolution.
| Argument | Type | Description |
|---|---|---|
| summary* | string | |
| order_id* | string | |
| issue_type* | string | |
| owner_type | string | |
| order_item_id | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id",
"issue_type",
"summary"
],
"properties": {
"summary": {
"type": "string",
"maxLength": 4000,
"minLength": 3
},
"order_id": {
"type": "string",
"pattern": "^ord_[A-Za-z0-9-]+$"
},
"issue_type": {
"enum": [
"delay",
"damage",
"shortage",
"wrong_item",
"compatibility",
"quality",
"billing",
"other"
],
"type": "string"
},
"owner_type": {
"enum": [
"supplier",
"operator",
"merchant"
],
"type": "string",
"default": "supplier"
},
"order_item_id": {
"type": "string",
"pattern": "^ori_[A-Za-z0-9-]+$"
}
}
}Ask the merchant to cancel an unshipped order. This creates a request and notification; it never reports the order as cancelled until the supplier or an operator accepts it.
| Argument | Type | Description |
|---|---|---|
| reason* | string | |
| order_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id",
"reason"
],
"properties": {
"reason": {
"type": "string",
"maxLength": 4000,
"minLength": 3
},
"order_id": {
"type": "string",
"pattern": "^ord_[A-Za-z0-9-]+$"
}
}
}Open a return request after shipment. The supplier remains merchant of record and controls authorization and refund state.
| Argument | Type | Description |
|---|---|---|
| items | array | |
| reason* | string | |
| order_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id",
"reason"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"order_item_id",
"quantity"
],
"properties": {
"quantity": {
"type": "number",
"exclusiveMinimum": 0
},
"order_item_id": {
"type": "string",
"pattern": "^ori_[A-Za-z0-9-]+$"
}
},
"additionalProperties": false
},
"default": [],
"maxItems": 500
},
"reason": {
"type": "string",
"maxLength": 4000,
"minLength": 3
},
"order_id": {
"type": "string",
"pattern": "^ord_[A-Za-z0-9-]+$"
}
}
}Create a human review link bound to the exact purchase-plan version, suppliers, maximum amount, currency, risks, and expiry. This does not approve or purchase the plan.
| Argument | Type | Description |
|---|---|---|
| purchase_plan_id* | string | |
| expires_in_minutes | integer |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"purchase_plan_id"
],
"properties": {
"purchase_plan_id": {
"type": "string",
"pattern": "^ppl_[A-Za-z0-9-]+$"
},
"expires_in_minutes": {
"type": "integer",
"default": 1440,
"maximum": 10080,
"minimum": 5
}
}
}Create a new immutable revision of a supplier quote. The previous revision remains in history and the new revision becomes current.
| Argument | Type | Description |
|---|---|---|
| items* | array | |
| notes | string | |
| currency* | string | |
| match_id* | string | |
| quote_id* | string | |
| warranty | string | |
| tax_minor | integer | |
| fees_minor | integer | |
| valid_until | string | |
| quote_number | string | |
| payment_terms | string | |
Search attributed current electronic-component product, availability, lead-time, and price data from Mouser. Results retain provider, observation time, and merchant URLs; no checkout or order is created.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| query* | string | |
| search_type | string | |
| manufacturer | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 2
},
"search_type": {
"enum": [
"part_number",
"keyword"
],
"type": "string",
"default": "part_number"
},
"manufacturer": {
"type": "string",
"maxLength": 160,
"minLength": 1
}
}
}Search published canonical product facts. Commercial price, stock, compatibility, and lead time are returned only when separately supported by current evidence.
| Argument | Type | Description |
|---|---|---|
| q | string | |
| limit | integer | |
| category | string | |
| manufacturer | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"q": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1
},
"category": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"manufacturer": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
}
}Search source-backed public supplier profiles by product category, brand, company type, service, compressor type, industry, or text. No authentication required.
| Argument | Type | Description |
|---|---|---|
| q | string | Text contained in a supplier name, summary, or listed brand. |
| brand | string | Exact publicly listed brand, such as Atlas Copco. |
| limit | integer | |
| offset | integer | |
| country | string | Two-letter country code. Defaults to US; use all only when broader coverage is intentional. |
| service | string | |
| category | string | Exact category code from list_supplier_taxonomy. |
| industry | string | |
| company_type | string | |
| compressor_type | string |
Lock the validated project revision into an immutable sourcing package, create normalized request lines, and return transparent supplier candidates. This does not contact suppliers; a human operator must approve every outbound recipient, message, and artifact scope.
| Argument | Type | Description |
|---|---|---|
| items | array | Optional fast exact-part or RFQ lines. Omit to source the current BOM. |
| notes | string | |
| need_by | string | |
| category* | string | |
| project_id* | string | |
| external_id | string | Buyer-controlled idempotency key. |
| artifact_ids | array | |
| ship_to_country | string | |
| data_classification | string | |
| ship_to_postal_code | string |
Submit a real non-sensitive B2B sourcing request on behalf of the buyer. SupplySlate routes it to relevant suppliers and returns structured offers later. Requires a buyer API key.
| Argument | Type | Description |
|---|---|---|
| items* | array | |
| notes | string | |
| need_by | string | Requested delivery date in YYYY-MM-DD format. |
| category* | string | Supply category. Use a precise category even if it is not in the current category list. |
| external_id | string | Buyer-controlled idempotency key for this request. |
| fixture_kind | string | Explicit lineage for integration fixtures; never use synthetic records as market evidence. |
| ship_to_country* | string | Two-letter ISO country code. |
| data_classification | string | |
| ship_to_postal_code | string | |
Submit the first structured commercial quote for a human-approved RFQ. Money is integer minor units with an explicit currency; partial line coverage and labeled alternatives are allowed.
| Argument | Type | Description |
|---|---|---|
| items* | array | |
| notes | string | |
| currency* | string | |
| match_id* | string | |
| warranty | string | |
| tax_minor | integer | |
| fees_minor | integer | |
| valid_until | string | |
| quote_number | string | |
| payment_terms | string | |
| delivery_terms | string |
Append timestamped supplier availability evidence and update current catalog state by supplier SKU without rewriting historical snapshots.
| Argument | Type | Description |
|---|---|---|
| items* | array |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"supplier_sku",
"status",
"observed_at"
],
"properties": {
"status": {
"enum": [
"in_stock",
"limited",
"backorder",
"made_to_order",
"unavailable",
"unknown"
],
"type": "string"
},
"expires_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"observed_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"supplier_sku": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"lead_time_days": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"quantity_available": {
"type": "number",
"minimum": 0
}
}
},
"maxItems": 500,
"minItems": 1
}
}
}Replace the structured requirement set on an unlocked project revision. Confirmed flags distinguish buyer-confirmed facts from agent interpretation.
| Argument | Type | Description |
|---|---|---|
| project_id* | string | |
| requirements* | array |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_id",
"requirements"
],
"properties": {
"project_id": {
"type": "string",
"pattern": "^prj_[A-Za-z0-9-]+$"
},
"requirements": {
"type": "array",
"items": {
"type": "object",
"required": [
"requirement_type",
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"unit": {
"type": "string",
"maxLength": 40
},
"value": {},
"confirmed": {
"type": "boolean",
"default": false
},
"criticality": {
"enum": [
"required",
"preferred",
"context"
],
"type": "string",
"default": "required"
},
"source_type": {
"enum": [
"user_statement",
"agent_interpretation",
"artifact",
"supplier_claim",
"public_source",
"operator_decision"
],
"type": "string",
"default": "user_statement"
},
"verbatim_value": {
"type": "string",
"maxLength": 4000
},
"requirement_type": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"source_reference": {
"type": "string",
"maxLength": 500
}
}
},
"maxItems": 200
}
}
}Replace the supplier-submitted capability set while preserving separately sourced public, operator-verified, and transaction-proven evidence.
| Argument | Type | Description |
|---|---|---|
| capabilities* | array |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"capabilities"
],
"properties": {
"capabilities": {
"type": "array",
"items": {
"type": "object",
"required": [
"capability_type",
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 300,
"minLength": 1
},
"expires_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"process_id": {
"type": "string",
"maxLength": 100
},
"source_url": {
"type": "string",
"format": "uri",
"pattern": "^https:\\/\\/.*"
},
"constraints": {
"type": "object",
"default": {},
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"observed_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"category_code": {
"type": "string",
"maxLength": 100
},
"capability_type": {
"enum": [
"category",
"fabrication_process",
"material",
"service",
"certification",
"industry",
"geography",
"order_policy",
"assembly",
"testing"
],
"type": "string"
},
"evidence_excerpt": {
"type": "string",
"maxLength": 2000
},
"normalized_value": {
"type": "string",
"maxLength": 500
}
}
},
"maxItems": 500
}
}
}Acknowledge or update fulfillment on a merchant-confirmed supplier order, optionally recording a shipment. State transitions and order-item quantities are validated and audited.
| Argument | Type | Description |
|---|---|---|
| note | string | |
| status* | string | |
| order_id* | string | |
| shipment | object |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id",
"status"
],
"properties": {
"note": {
"type": "string",
"maxLength": 2000
},
"status": {
"enum": [
"accepted",
"processing",
"in_production",
"partially_shipped",
"shipped",
"delivered",
"completed",
"cancelled"
],
"type": "string"
},
"order_id": {
"type": "string",
"pattern": "^ord_[A-Za-z0-9-]+$"
},
"shipment": {
"type": "object",
"required": [
"status"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"order_item_id",
"quantity"
],
"properties": {
"quantity": {
"type": "number",
"exclusiveMinimum": 0
},
"order_item_id": {
"type": "string"
}
}
},
"default": [],
"maxItems": 500
},
"status": {
"enum": [
"pending",
"label_created",
"in_transit",
"delayed",
"out_for_delivery",
"delivered",
"exception",
"returned"
],
"type": "string"
},
"carrier": {
"type": "string",
"maxLength": 160
},
"service": {
"type": "string",
"maxLength": 160
},
"shipped_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"delivered_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"tracking_url": {
"type": "string",
"format": "uri",
"pattern": "^https:\\/\\/.*"
},
"tracking_number": {
"type": "string",
"maxLength": 300
},
"estimated_delivery_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
}
}
}
}
}Update ownership, status, or resolution for a buyer-reported issue on the authenticated supplier's merchant order.
| Argument | Type | Description |
|---|---|---|
| status* | string | |
| issue_id* | string | |
| order_id* | string | |
| owner_type | string | |
| resolution | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id",
"issue_id",
"status"
],
"properties": {
"status": {
"enum": [
"open",
"awaiting_buyer",
"awaiting_supplier",
"resolved",
"closed"
],
"type": "string"
},
"issue_id": {
"type": "string",
"pattern": "^ois_[A-Za-z0-9-]+$"
},
"order_id": {
"type": "string",
"pattern": "^ord_[A-Za-z0-9-]+$"
},
"owner_type": {
"enum": [
"buyer",
"supplier",
"operator",
"merchant"
],
"type": "string"
},
"resolution": {
"type": "string",
"maxLength": 4000
}
}
}Advance an authenticated supplier return through authorization, shipment, receipt, and refund states without changing historical order evidence.
| Argument | Type | Description |
|---|---|---|
| note | string | |
| status* | string | |
| currency | string | |
| order_id* | string | |
| return_id* | string | |
| refund_amount_minor | integer | |
| merchant_return_reference | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id",
"return_id",
"status"
],
"properties": {
"note": {
"type": "string",
"maxLength": 4000
},
"status": {
"enum": [
"authorized",
"shipped",
"received",
"refunded",
"rejected",
"cancelled"
],
"type": "string"
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"order_id": {
"type": "string",
"pattern": "^ord_[A-Za-z0-9-]+$"
},
"return_id": {
"type": "string",
"pattern": "^ret_[A-Za-z0-9-]+$"
},
"refund_amount_minor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"merchant_return_reference": {
"type": "string",
"maxLength": 300
}
}
}Advance a warranty claim through supplier review, approval, replacement, resolution, or rejection with a merchant reference and durable history.
| Argument | Type | Description |
|---|---|---|
| note | string | |
| status* | string | |
| order_id* | string | |
| warranty_claim_id* | string | |
| supplier_reference | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id",
"warranty_claim_id",
"status"
],
"properties": {
"note": {
"type": "string",
"maxLength": 4000
},
"status": {
"enum": [
"under_review",
"approved",
"rejected",
"replacement_sent",
"resolved",
"closed"
],
"type": "string"
},
"order_id": {
"type": "string",
"pattern": "^ord_[A-Za-z0-9-]+$"
},
"warranty_claim_id": {
"type": "string",
"pattern": "^war_[A-Za-z0-9-]+$"
},
"supplier_reference": {
"type": "string",
"maxLength": 300
}
}
}Create a BOM or a new BOM revision with assemblies, catalog items, custom parts, services, consumables, artifacts, and interface dependencies.
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| items* | array | |
| bom_id | string | |
| project_id* | string | |
| dependencies | array | |
| build_quantity | number | |
| source_artifact_id | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_id",
"name",
"items"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"line_number",
"item_kind",
"description",
"quantity_per_assembly",
"unit"
],
"properties": {
"unit": {
"type": "string",
"maxLength": 40,
"minLength": 1
},
"item_kind": {
"enum": [
"catalog_product",
"custom_part",
"service",
"consumable",
"requirement_only",
"assembly"
],
"type": "string"
},
"description": {
"type": "string",
"maxLength": 2000,
"minLength": 2
},
"line_number": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"make_or_buy": {
"enum": [
"make",
"buy",
"either"
],
"type": "string",
"default": "buy"
},
"artifact_ids": {
"type": "array",
"items": {
"type": "string"
},
"default": [],
"maxItems": 20
},
"manufacturer": {
"type": "string",
"maxLength": 200
},
"scrap_factor": {
"type": "number",
"default": 0,
"maximum": 10,
"minimum": 0
},
"specifications": {
"type": "object",
"default": {},
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"parent_line_number": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"substitution_policy": {
"enum": [
"exact_only",
"approval_required",
"equivalents_allowed"
],
"type": "string",
"default": "approval_required"
},
"canonical_product_id": {
"type": "string",
"maxLength": 100
},
"quantity_per_assembly": {
"type": "number",
"maximum": 1000000,
"exclusiveMinimum": 0
},
"manufacturer_part_number": {
"type": "string",
"maxLength": 200
},
"minimum_purchase_quantity": {
"type": "number",
"exclusiveMinimum": 0
}
}
},
"maxItems": 500,
"minItems": 1
},
"bom_id": {
"type": "string",
"pattern": "^bom_[A-Za-z0-9-]+$"
},
"project_id": {
"type": "string",
"pattern": "^prj_[A-Za-z0-9-]+$"
},
"dependencies": {
"type": "array",
"items": {
"type": "object",
"required": [
"source_line_number",
"target_line_number",
"dependency_type"
],
"properties": {
"requirements": {
"type": "object",
"default": {},
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"dependency_type": {
"enum": [
"mechanical_interface",
"electrical_interface",
"fluid_interface",
"software_interface",
"assembly_order",
"consumable_for"
],
"type": "string"
},
"source_line_number": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"target_line_number": {
"type": "string",
"maxLength": 80,
"minLength": 1
}
}
},
"default": [],
"maxItems": 1000
},
"build_quantity": {
"type": "number",
"default": 1,
"maximum": 1000000,
"exclusiveMinimum": 0
},
"source_artifact_id": {
"type": "string"
}
}
}Create or update normalized supplier catalog items through a durable manual import with row-level validation, history, evidence scope, availability, and commercial terms.
| Argument | Type | Description |
|---|---|---|
| items* | array | |
| idempotency_key* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"idempotency_key",
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"supplier_sku",
"description"
],
"properties": {
"unit": {
"type": "string",
"maxLength": 40
},
"expires_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"source_url": {
"type": "string",
"format": "uri",
"pattern": "^https:\\/\\/.*"
},
"description": {
"type": "string",
"maxLength": 1000,
"minLength": 3
},
"observed_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"price_minor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"manufacturer": {
"type": "string",
"maxLength": 200
},
"supplier_sku": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"certifications": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 25
},
"equipment_make": {
"type": "string",
"maxLength": 200
},
"lead_time_days": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"price_currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"specifications": {
"type": "object",
"default": {},
"propertyNames": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"equipment_model": {
"type": "string",
"maxLength": 200
},
"package_multiple": {
"type": "number",
"exclusiveMinimum": 0
},
"quantity_available": {
"type": "number",
"minimum": 0
},
"availability_status": {
"enum": [
"in_stock",
"limited",
"backorder",
"made_to_order",
"unavailable",
"unknown"
],
"type": "string",
"default": "unknown"
},
"network_category_code": {
"type": "string",
"maxLength": 100
},
"fabrication_process_id": {
"type": "string",
"maxLength": 100
},
"minimum_order_quantity": {
"type": "number",
"exclusiveMinimum": 0
},
"manufacturer_part_number": {
"type": "string",
"maxLength": 200
}
}
},
"maxItems": 1000,
"minItems": 1
},
"idempotency_key": {
"type": "string",
"maxLength": 160,
"minLength": 1
}
}
}Run the current versioned validators and return separate blocking errors, compatibility conflicts, warnings, missing information, passed checks, and unavailable checks.
| Argument | Type | Description |
|---|---|---|
| project_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_id"
],
"properties": {
"project_id": {
"type": "string",
"pattern": "^prj_[A-Za-z0-9-]+$"
}
}
}| number |
| budget_currency | string |
| ship_to_country | string |
| data_classification | string |
| ship_to_postal_code | string |
| substitution_policy | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"project_type",
"demand_lane",
"origin_type",
"brief"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 2
},
"brief": {
"type": "string",
"maxLength": 12000,
"minLength": 3
},
"need_by": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"demand_lane": {
"enum": [
"industrial",
"builder",
"research"
],
"type": "string"
},
"external_id": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"origin_type": {
"enum": [
"idea",
"file",
"bom",
"exact_part",
"rfq"
],
"type": "string"
},
"budget_minor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"fixture_kind": {
"enum": [
"real",
"internal_test",
"demo"
],
"type": "string",
"default": "real",
"description": "Explicit lineage for integration fixtures; never use synthetic records as market evidence."
},
"project_type": {
"enum": [
"industrial_replacement",
"catalog_build",
"fabricated_part",
"mixed_build",
"kit",
"assembly"
],
"type": "string"
},
"requirements": {
"type": "array",
"items": {
"type": "object",
"required": [
"requirement_type",
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 160,
"minLength": 1
},
"unit": {
"type": "string",
"maxLength": 40
},
"value": {},
"confirmed": {
"type": "boolean",
"default": false
},
"criticality": {
"enum": [
"required",
"preferred",
"context"
],
"type": "string",
"default": "required"
},
"source_type": {
"enum": [
"user_statement",
"agent_interpretation",
"artifact",
"supplier_claim",
"public_source",
"operator_decision"
],
"type": "string",
"default": "user_statement"
},
"verbatim_value": {
"type": "string",
"maxLength": 4000
},
"requirement_type": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"source_reference": {
"type": "string",
"maxLength": 500
}
}
},
"default": [],
"maxItems": 200
},
"build_quantity": {
"type": "number",
"default": 1,
"maximum": 1000000,
"exclusiveMinimum": 0
},
"budget_currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"ship_to_country": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"data_classification": {
"enum": [
"public",
"commercial",
"confidential",
"restricted"
],
"type": "string",
"default": "commercial"
},
"ship_to_postal_code": {
"type": "string",
"maxLength": 32
},
"substitution_policy": {
"enum": [
"exact_only",
"approval_required",
"equivalents_allowed"
],
"type": "string",
"default": "approval_required"
}
}
}| delivery_terms |
| string |
| shipping_minor | integer |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"match_id",
"quote_id",
"currency",
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"request_item_id",
"description",
"quantity",
"unit",
"unit_price_minor"
],
"properties": {
"unit": {
"type": "string",
"maxLength": 40,
"minLength": 1
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"required": [
"source_class",
"statement"
],
"properties": {
"statement": {
"type": "string",
"maxLength": 2000,
"minLength": 2
},
"source_url": {
"type": "string",
"format": "uri"
},
"observed_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"source_class": {
"enum": [
"supplier_submitted",
"supplier_api",
"supplier_document",
"public_official",
"transaction"
],
"type": "string"
}
}
},
"default": [],
"maxItems": 20
},
"quantity": {
"type": "number",
"exclusiveMinimum": 0
},
"description": {
"type": "string",
"maxLength": 1000,
"minLength": 3
},
"manufacturer": {
"type": "string",
"maxLength": 200
},
"relationship": {
"enum": [
"exact",
"compatible",
"alternative",
"unverified"
],
"type": "string",
"default": "unverified"
},
"lead_time_days": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"catalog_item_id": {
"type": "string",
"maxLength": 100
},
"request_item_id": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"package_multiple": {
"type": "number",
"exclusiveMinimum": 0
},
"unit_price_minor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"availability_status": {
"enum": [
"in_stock",
"limited",
"backorder",
"made_to_order",
"unavailable",
"unknown"
],
"type": "string",
"default": "unknown"
},
"minimum_order_quantity": {
"type": "number",
"exclusiveMinimum": 0
},
"manufacturer_part_number": {
"type": "string",
"maxLength": 200
}
}
},
"maxItems": 250,
"minItems": 1
},
"notes": {
"type": "string",
"maxLength": 4000
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"match_id": {
"type": "string",
"pattern": "^rm_[A-Za-z0-9-]+$"
},
"quote_id": {
"type": "string",
"pattern": "^quo_[A-Za-z0-9-]+$"
},
"warranty": {
"type": "string",
"maxLength": 2000
},
"tax_minor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"fees_minor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"valid_until": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"quote_number": {
"type": "string",
"maxLength": 200
},
"payment_terms": {
"type": "string",
"maxLength": 1000
},
"delivery_terms": {
"type": "string",
"maxLength": 1000
},
"shipping_minor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"q": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Text contained in a supplier name, summary, or listed brand."
},
"brand": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Exact publicly listed brand, such as Atlas Copco."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 10000,
"minimum": 0
},
"country": {
"type": "string",
"default": "US",
"pattern": "^(all|[A-Z]{2})$",
"description": "Two-letter country code. Defaults to US; use all only when broader coverage is intentional."
},
"service": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"category": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Exact category code from list_supplier_taxonomy."
},
"industry": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"company_type": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"compressor_type": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
}
}| substitutions_allowed | boolean |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"project_id",
"category"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"description",
"quantity",
"unit"
],
"properties": {
"unit": {
"type": "string",
"maxLength": 40,
"minLength": 1
},
"quantity": {
"type": "number",
"maximum": 1000000,
"exclusiveMinimum": 0
},
"item_kind": {
"enum": [
"catalog_product",
"custom_part",
"service",
"consumable",
"requirement_only"
],
"type": "string",
"default": "catalog_product"
},
"description": {
"type": "string",
"maxLength": 2000,
"minLength": 2
},
"part_number": {
"type": "string",
"maxLength": 200
},
"artifact_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"manufacturer": {
"type": "string",
"maxLength": 200
},
"certifications": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 30
},
"equipment_make": {
"type": "string",
"maxLength": 200
},
"specifications": {
"type": "object",
"default": {},
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"equipment_model": {
"type": "string",
"maxLength": 200
}
}
},
"maxItems": 250,
"minItems": 1,
"description": "Optional fast exact-part or RFQ lines. Omit to source the current BOM."
},
"notes": {
"type": "string",
"maxLength": 4000
},
"need_by": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"category": {
"type": "string",
"maxLength": 100,
"minLength": 2
},
"project_id": {
"type": "string",
"pattern": "^prj_[A-Za-z0-9-]+$"
},
"external_id": {
"type": "string",
"maxLength": 160,
"minLength": 1,
"description": "Buyer-controlled idempotency key."
},
"artifact_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 50
},
"ship_to_country": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"data_classification": {
"enum": [
"public",
"commercial"
],
"type": "string",
"default": "commercial"
},
"ship_to_postal_code": {
"type": "string",
"maxLength": 32
},
"substitutions_allowed": {
"type": "boolean",
"default": false
}
}
}| substitutions_allowed |
| boolean |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"category",
"ship_to_country",
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"description",
"quantity",
"unit"
],
"properties": {
"unit": {
"type": "string",
"maxLength": 40,
"minLength": 1,
"description": "Commercial unit such as each, box, kit, roll, or case."
},
"quantity": {
"type": "number",
"exclusiveMinimum": 0
},
"description": {
"type": "string",
"maxLength": 1000,
"minLength": 3,
"description": "Plain-language item or requirement description."
},
"part_number": {
"type": "string",
"maxLength": 200
},
"manufacturer": {
"type": "string",
"maxLength": 200
},
"certifications": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"equipment_make": {
"type": "string",
"maxLength": 200
},
"specifications": {
"type": "object",
"default": {},
"propertyNames": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"equipment_model": {
"type": "string",
"maxLength": 200
}
}
},
"maxItems": 25,
"minItems": 1
},
"notes": {
"type": "string",
"maxLength": 2000
},
"need_by": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Requested delivery date in YYYY-MM-DD format."
},
"category": {
"type": "string",
"maxLength": 80,
"minLength": 2,
"description": "Supply category. Use a precise category even if it is not in the current category list."
},
"external_id": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Buyer-controlled idempotency key for this request."
},
"fixture_kind": {
"enum": [
"real",
"internal_test",
"demo"
],
"type": "string",
"default": "real",
"description": "Explicit lineage for integration fixtures; never use synthetic records as market evidence."
},
"ship_to_country": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Two-letter ISO country code."
},
"data_classification": {
"enum": [
"public",
"commercial"
],
"type": "string",
"default": "commercial"
},
"ship_to_postal_code": {
"type": "string",
"maxLength": 20
},
"substitutions_allowed": {
"type": "boolean",
"default": false
}
}
}| shipping_minor | integer |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"match_id",
"currency",
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"request_item_id",
"description",
"quantity",
"unit",
"unit_price_minor"
],
"properties": {
"unit": {
"type": "string",
"maxLength": 40,
"minLength": 1
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"required": [
"source_class",
"statement"
],
"properties": {
"statement": {
"type": "string",
"maxLength": 2000,
"minLength": 2
},
"source_url": {
"type": "string",
"format": "uri"
},
"observed_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"source_class": {
"enum": [
"supplier_submitted",
"supplier_api",
"supplier_document",
"public_official",
"transaction"
],
"type": "string"
}
}
},
"default": [],
"maxItems": 20
},
"quantity": {
"type": "number",
"exclusiveMinimum": 0
},
"description": {
"type": "string",
"maxLength": 1000,
"minLength": 3
},
"manufacturer": {
"type": "string",
"maxLength": 200
},
"relationship": {
"enum": [
"exact",
"compatible",
"alternative",
"unverified"
],
"type": "string",
"default": "unverified"
},
"lead_time_days": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"catalog_item_id": {
"type": "string",
"maxLength": 100
},
"request_item_id": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"package_multiple": {
"type": "number",
"exclusiveMinimum": 0
},
"unit_price_minor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"availability_status": {
"enum": [
"in_stock",
"limited",
"backorder",
"made_to_order",
"unavailable",
"unknown"
],
"type": "string",
"default": "unknown"
},
"minimum_order_quantity": {
"type": "number",
"exclusiveMinimum": 0
},
"manufacturer_part_number": {
"type": "string",
"maxLength": 200
}
}
},
"maxItems": 250,
"minItems": 1
},
"notes": {
"type": "string",
"maxLength": 4000
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"match_id": {
"type": "string",
"pattern": "^rm_[A-Za-z0-9-]+$"
},
"warranty": {
"type": "string",
"maxLength": 2000
},
"tax_minor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"fees_minor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"valid_until": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"quote_number": {
"type": "string",
"maxLength": 200
},
"payment_terms": {
"type": "string",
"maxLength": 1000
},
"delivery_terms": {
"type": "string",
"maxLength": 1000
},
"shipping_minor": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
}