MCP Server
SupplySlate
com.supplyslate/sourcing
What this MCP does
Supports component sourcing, fabrication requests, supplier RFQs, catalog imports, quotes, purchase planning, checkout handoffs, and order fulfillment.
Capabilities
Tools
55
tools
ask_rfq_clarification
Ask the buyer a clarification question on an approved supplier RFQ without changing the immutable request package.
Open world
Input schema
{'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}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['clarification'], 'properties': {'clarification': {'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'question': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
attach_artifact_reference
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.
Input schema
{'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'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['artifact'], 'properties': {'artifact': {'type': 'object', 'required': ['id', 'original_filename', 'media_type', 'artifact_type', 'purpose', 'data_classification', 'scan_status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'purpose': {'type': 'string'}, 'media_type': {'type': 'string'}, 'project_id': {'type': 'string', 'minLength': 1}, 'size_bytes': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}]}, 'scan_status': {'type': 'string'}, 'artifact_type': {'type': 'string'}, 'checksum_sha256': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'disclosure_status': {'type': 'string'}, 'original_filename': {'type': 'string'}, 'data_classification': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
create_artifact_upload
Create a short-lived, one-time private artifact upload URL. The caller must stream the exact declared bytes with a SHA-256 checksum.
Input schema
{'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'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['artifact'], 'properties': {'upload': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'method': {'type': 'string'}, 'expires_at': {'type': 'string'}}, 'additionalProperties': {}}, 'artifact': {'type': 'object', 'required': ['id', 'original_filename', 'media_type', 'artifact_type', 'purpose', 'data_classification', 'scan_status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'purpose': {'type': 'string'}, 'media_type': {'type': 'string'}, 'project_id': {'type': 'string', 'minLength': 1}, 'size_bytes': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}]}, 'scan_status': {'type': 'string'}, 'artifact_type': {'type': 'string'}, 'checksum_sha256': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'disclosure_status': {'type': 'string'}, 'original_filename': {'type': 'string'}, 'data_classification': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
create_catalog_import
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.
Idempotent
Input schema
{'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}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['catalog_import'], 'properties': {'catalog_import': {'type': 'object', 'required': ['id', 'status', 'source_type'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'total_rows': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'source_type': {'type': 'string'}, 'accepted_rows': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'rejected_rows': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'validation_errors': {'type': 'array', 'items': {}}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
create_project
Create a durable supply project from an idea, file, BOM, exact part, or RFQ origin. Requires a scoped buyer credential.
Idempotent
Input schema
{'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'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['project'], 'properties': {'project': {'type': 'object', 'required': ['id', 'name', 'project_type', 'demand_lane', 'origin_type', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'boms': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'name': {'type': 'string'}, 'current_revision_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': {}}}, 'name': {'type': 'string'}, 'brief': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'status': {'type': 'string'}, 'artifacts': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'original_filename', 'media_type', 'artifact_type', 'purpose', 'data_classification', 'scan_status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'purpose': {'type': 'string'}, 'media_type': {'type': 'string'}, 'project_id': {'type': 'string', 'minLength': 1}, 'size_bytes': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}]}, 'scan_status': {'type': 'string'}, 'artifact_type': {'type': 'string'}, 'checksum_sha256': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'disclosure_status': {'type': 'string'}, 'original_filename': {'type': 'string'}, 'data_classification': {'type': 'string'}}, 'additionalProperties': {}}}, 'demand_lane': {'type': 'string'}, 'origin_type': {'type': 'string'}, 'fixture_kind': {'type': 'string'}, 'project_type': {'type': 'string'}, 'requirements': {'type': 'array', 'items': {'type': 'object', 'required': ['requirement_type', 'name', 'value'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'name': {'type': 'string'}, 'value': {}, 'requirement_type': {'type': 'string'}}, 'additionalProperties': {}}}, 'current_revision': {'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'version': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'revision_number': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': {}}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
create_provider_checkout_handoff
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.
Open world
Input schema
{'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.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['checkout_handoff', 'merchant_of_record', 'payment_boundary'], 'properties': {'checkout_handoff': {'type': 'object', 'required': ['id', 'supplier_id', 'merchant_group_key', 'handoff_type', 'status', 'amount_minor', 'currency'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'currency': {'type': 'string'}, 'expires_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'supplier_id': {'type': 'string', 'minLength': 1}, 'amount_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'checkout_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'handoff_type': {'type': 'string'}, 'purchase_plan_id': {'type': 'string', 'minLength': 1}, 'merchant_group_key': {'type': 'string'}, 'merchant_reference': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}, 'payment_boundary': {'type': 'string'}, 'idempotent_replay': {'type': 'boolean'}, 'merchant_of_record': {'type': 'string'}}, 'additionalProperties': {}}
create_purchase_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.
Idempotent
Input schema
{'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}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['purchase_plan'], 'properties': {'purchase_plan': {'type': 'object', 'required': ['id', 'request_id', 'version', 'status', 'currency', 'subtotal_minor', 'total_minor', 'immutable_hash', 'unresolved_risks', 'items', 'approvals', 'checkout_handoffs'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'supplier_id', 'supplier_name', 'merchant_group_key', 'description', 'quantity', 'unit', 'unit_price_minor', 'line_total_minor', 'relationship'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'unit': {'type': 'string'}, 'quantity': {'type': 'number'}, 'description': {'type': 'string'}, 'supplier_id': {'type': 'string', 'minLength': 1}, 'relationship': {'type': 'string'}, 'supplier_name': {'type': 'string'}, 'line_total_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'unit_price_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'evidence_snapshot': {'type': 'array', 'items': {}}, 'provider_checkout': {'anyOf': [{'type': 'object', 'required': ['provider', 'offer_id', 'fulfillment', 'shipping_options'], 'properties': {'offer_id': {'type': 'string', 'minLength': 1}, 'provider': {'type': 'string'}, 'expires_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'fulfillment': {'type': 'string'}, 'shipping_options': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'cost_cents'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'label': {'type': 'string'}, 'eta_date': {'type': 'string'}, 'cost_cents': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'eta_business_days': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': {}}}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'merchant_group_key': {'type': 'string'}}, 'additionalProperties': {}}}, 'status': {'type': 'string'}, 'version': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'currency': {'type': 'string'}, 'approvals': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'currency': {'type': 'string'}, 'expires_at': {'type': 'string'}, 'review_url': {'type': 'string', 'format': 'uri'}, 'exact_plan_hash': {'type': 'string'}, 'maximum_amount_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': {}}}, 'tax_minor': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}]}, 'fees_minor': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}]}, 'project_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}]}, 'request_id': {'type': 'string', 'minLength': 1}, 'total_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'immutable_hash': {'type': 'string'}, 'shipping_minor': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}]}, 'subtotal_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'unresolved_risks': {'type': 'array', 'items': {}}, 'checkout_handoffs': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'supplier_id', 'merchant_group_key', 'handoff_type', 'status', 'amount_minor', 'currency'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'currency': {'type': 'string'}, 'expires_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'supplier_id': {'type': 'string', 'minLength': 1}, 'amount_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'checkout_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'handoff_type': {'type': 'string'}, 'purchase_plan_id': {'type': 'string', 'minLength': 1}, 'merchant_group_key': {'type': 'string'}, 'merchant_reference': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}}, 'additionalProperties': {}}, 'idempotent_replay': {'type': 'boolean'}}, 'additionalProperties': {}}
decide_supplier_order_cancellation
Accept or reject a buyer cancellation request for the authenticated supplier's unshipped merchant order. Acceptance is the state-changing merchant decision.
Open world
Input schema
{'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-]+$'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['order'], 'properties': {'order': {'type': 'object', 'required': ['id', 'purchase_plan_id', 'merchant_order_reference', 'status', 'currency', 'total_minor', 'ordered_at'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'description', 'unit', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'unit': {'type': 'string'}, 'status': {'type': 'string'}, 'description': {'type': 'string'}, 'quantity_ordered': {'type': 'number'}}, 'additionalProperties': {}}}, 'events': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'event_type', 'occurred_at'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'event_type': {'type': 'string'}, 'occurred_at': {'type': 'string'}}, 'additionalProperties': {}}}, 'issues': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'status': {'type': 'string'}, 'returns': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'reason'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'currency': {'type': 'string'}, 'shipments': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'carrier': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'tracking_number': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'ordered_at': {'type': 'string'}, 'project_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}]}, 'supplier_id': {'type': 'string', 'minLength': 1}, 'total_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'supplier_name': {'type': 'string'}, 'warranty_claims': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'description'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': {}}}, 'purchase_plan_id': {'type': 'string', 'minLength': 1}, 'cancellation_requests': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'reason'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'merchant_order_reference': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
decline_supplier_rfq
Decline an approved RFQ with a structured reason so the buyer and network can route more accurately.
Open world
Input schema
{'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'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['status', 'declined_at'], 'properties': {'status': {'type': 'string', 'const': 'declined'}, 'declined_at': {'type': 'string'}}, 'additionalProperties': {}}
describe_supplyslate
Explain what SupplySlate does, what it does not do, and when a buyer-owned agent should use it.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['service', 'purpose', 'use_when', 'boundaries', 'mcp_endpoint', 'rest_api', 'openapi', 'supplier_directory', 'access'], 'properties': {'access': {'type': 'string'}, 'openapi': {'type': 'string', 'format': 'uri'}, 'purpose': {'type': 'string'}, 'service': {'type': 'string'}, 'rest_api': {'type': 'string', 'format': 'uri'}, 'use_when': {'type': 'array', 'items': {'type': 'string'}}, 'boundaries': {'type': 'array', 'items': {'type': 'string'}}, 'mcp_endpoint': {'type': 'string', 'format': 'uri'}, 'supplier_directory': {'type': 'string'}}, 'additionalProperties': {}}
get_bom
Read the current revision of one project BOM, including hierarchy, quantities, sourcing state, and interface dependencies.
Read only
Idempotent
Input schema
{'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-]+$'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['bom'], 'properties': {'bom': {'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'name': {'type': 'string'}, 'project_id': {'type': 'string', 'minLength': 1}, 'current_revision': {'type': 'object', 'required': ['id', 'revision_number'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'items': {'type': 'array', 'items': {}}, 'dependencies': {'type': 'array', 'items': {}}, 'revision_number': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}}, 'additionalProperties': {}}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
get_checkout_handoffs
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.
Read only
Idempotent
Input schema
{'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-]+$'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['purchase_plan_id', 'data', 'merchant_of_record'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'supplier_id', 'merchant_group_key', 'handoff_type', 'status', 'amount_minor', 'currency'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'currency': {'type': 'string'}, 'expires_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'supplier_id': {'type': 'string', 'minLength': 1}, 'amount_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'checkout_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'handoff_type': {'type': 'string'}, 'purchase_plan_id': {'type': 'string', 'minLength': 1}, 'merchant_group_key': {'type': 'string'}, 'merchant_reference': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'purchase_plan_id': {'type': 'string', 'minLength': 1}, 'merchant_of_record': {'type': 'string'}}, 'additionalProperties': {}}
get_compatibility
Read one published compatibility or substitution assertion with exact subject, object, conditions, confidence, evidence source, and observation time.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['compatibility_id'], 'properties': {'compatibility_id': {'type': 'string', 'maxLength': 100, 'minLength': 1}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['compatibility'], 'properties': {'compatibility': {'type': 'object', 'required': ['id', 'relationship'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'relationship': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
get_connection_guide
Return the exact MCP and REST connection details a buyer, developer, or agent operator needs to connect to SupplySlate.
Read only
Idempotent
Input schema
{'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.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['client', 'mcp', 'rest', 'obtain_access', 'first_action'], 'properties': {'mcp': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'rest': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'client': {'type': 'string'}, 'first_action': {'type': 'string'}, 'obtain_access': {'type': 'string'}}, 'additionalProperties': {}}
get_live_fabrication_capabilities
Read attributed live fabrication capabilities from the connected AFN provider. This is discovery only and neither uploads a design nor requests a quote.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['provider', 'attribution', 'source_url', 'observed_at', 'capabilities', 'commercial_boundary'], 'properties': {'provider': {'type': 'string'}, 'source_url': {'type': 'string', 'format': 'uri'}, 'attribution': {'type': 'string'}, 'observed_at': {'type': 'string'}, 'capabilities': {}, 'commercial_boundary': {'type': 'string'}}, 'additionalProperties': {}}
get_order
Read one merchant-confirmed order with items, fulfillment, shipments, issues, evidence, and event history.
Read only
Idempotent
Input schema
{'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-]+$'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['order'], 'properties': {'order': {'type': 'object', 'required': ['id', 'purchase_plan_id', 'merchant_order_reference', 'status', 'currency', 'total_minor', 'ordered_at'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'description', 'unit', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'unit': {'type': 'string'}, 'status': {'type': 'string'}, 'description': {'type': 'string'}, 'quantity_ordered': {'type': 'number'}}, 'additionalProperties': {}}}, 'events': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'event_type', 'occurred_at'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'event_type': {'type': 'string'}, 'occurred_at': {'type': 'string'}}, 'additionalProperties': {}}}, 'issues': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'status': {'type': 'string'}, 'returns': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'reason'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'currency': {'type': 'string'}, 'shipments': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'carrier': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'tracking_number': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'ordered_at': {'type': 'string'}, 'project_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}]}, 'supplier_id': {'type': 'string', 'minLength': 1}, 'total_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'supplier_name': {'type': 'string'}, 'warranty_claims': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'description'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': {}}}, 'purchase_plan_id': {'type': 'string', 'minLength': 1}, 'cancellation_requests': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'reason'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'merchant_order_reference': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
get_product
Read one published canonical product with variants, category links, evidence scope, observation dates, and freshness.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['product_id'], 'properties': {'product_id': {'type': 'string', 'maxLength': 100, 'minLength': 1}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['product'], 'properties': {'product': {'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'name': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
get_project
Read a project, its current immutable-capable revision, requirements, artifacts, BOM summaries, and validation history.
Read only
Idempotent
Input schema
{'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-]+$'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['project'], 'properties': {'project': {'type': 'object', 'required': ['id', 'name', 'project_type', 'demand_lane', 'origin_type', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'boms': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'name': {'type': 'string'}, 'current_revision_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': {}}}, 'name': {'type': 'string'}, 'brief': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'status': {'type': 'string'}, 'artifacts': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'original_filename', 'media_type', 'artifact_type', 'purpose', 'data_classification', 'scan_status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'purpose': {'type': 'string'}, 'media_type': {'type': 'string'}, 'project_id': {'type': 'string', 'minLength': 1}, 'size_bytes': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}]}, 'scan_status': {'type': 'string'}, 'artifact_type': {'type': 'string'}, 'checksum_sha256': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'disclosure_status': {'type': 'string'}, 'original_filename': {'type': 'string'}, 'data_classification': {'type': 'string'}}, 'additionalProperties': {}}}, 'demand_lane': {'type': 'string'}, 'origin_type': {'type': 'string'}, 'fixture_kind': {'type': 'string'}, 'project_type': {'type': 'string'}, 'requirements': {'type': 'array', 'items': {'type': 'object', 'required': ['requirement_type', 'name', 'value'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'name': {'type': 'string'}, 'value': {}, 'requirement_type': {'type': 'string'}}, 'additionalProperties': {}}}, 'current_revision': {'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'version': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'revision_number': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': {}}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
get_purchase_plan
Read one exact purchase-plan version with selected lines, merchants, totals, risks, evidence, approvals, and checkout handoffs.
Read only
Idempotent
Input schema
{'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-]+$'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['purchase_plan'], 'properties': {'purchase_plan': {'type': 'object', 'required': ['id', 'request_id', 'version', 'status', 'currency', 'subtotal_minor', 'total_minor', 'immutable_hash', 'unresolved_risks', 'items', 'approvals', 'checkout_handoffs'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'supplier_id', 'supplier_name', 'merchant_group_key', 'description', 'quantity', 'unit', 'unit_price_minor', 'line_total_minor', 'relationship'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'unit': {'type': 'string'}, 'quantity': {'type': 'number'}, 'description': {'type': 'string'}, 'supplier_id': {'type': 'string', 'minLength': 1}, 'relationship': {'type': 'string'}, 'supplier_name': {'type': 'string'}, 'line_total_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'unit_price_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'evidence_snapshot': {'type': 'array', 'items': {}}, 'provider_checkout': {'anyOf': [{'type': 'object', 'required': ['provider', 'offer_id', 'fulfillment', 'shipping_options'], 'properties': {'offer_id': {'type': 'string', 'minLength': 1}, 'provider': {'type': 'string'}, 'expires_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'fulfillment': {'type': 'string'}, 'shipping_options': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'cost_cents'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'label': {'type': 'string'}, 'eta_date': {'type': 'string'}, 'cost_cents': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'eta_business_days': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': {}}}}, 'additionalProperties': {}}, {'type': 'null'}]}, 'merchant_group_key': {'type': 'string'}}, 'additionalProperties': {}}}, 'status': {'type': 'string'}, 'version': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'currency': {'type': 'string'}, 'approvals': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'currency': {'type': 'string'}, 'expires_at': {'type': 'string'}, 'review_url': {'type': 'string', 'format': 'uri'}, 'exact_plan_hash': {'type': 'string'}, 'maximum_amount_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': {}}}, 'tax_minor': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}]}, 'fees_minor': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}]}, 'project_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}]}, 'request_id': {'type': 'string', 'minLength': 1}, 'total_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'immutable_hash': {'type': 'string'}, 'shipping_minor': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}]}, 'subtotal_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'unresolved_risks': {'type': 'array', 'items': {}}, 'checkout_handoffs': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'supplier_id', 'merchant_group_key', 'handoff_type', 'status', 'amount_minor', 'currency'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'currency': {'type': 'string'}, 'expires_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'supplier_id': {'type': 'string', 'minLength': 1}, 'amount_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'checkout_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'handoff_type': {'type': 'string'}, 'purchase_plan_id': {'type': 'string', 'minLength': 1}, 'merchant_group_key': {'type': 'string'}, 'merchant_reference': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
get_requirement_schema
Read the evidence-safe input schema for a configurable supply category or fabrication process, including required fields, recommended fields, accepted artifacts, and safety notes.
Read only
Idempotent
Input schema
{'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.'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['requirement_schema', 'guidance'], 'properties': {'guidance': {'type': 'string'}, 'requirement_schema': {'type': 'object', 'required': ['kind', 'id', 'name', 'status', 'schema'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'kind': {'enum': ['category', 'process'], 'type': 'string'}, 'name': {'type': 'string'}, 'schema': {'type': 'object', 'required': ['required', 'recommended'], 'properties': {'required': {'type': 'array', 'items': {'type': 'string'}}, 'recommended': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': {}}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
get_sourcing_request
Read the current status and normalized line items for one authenticated buyer sourcing request.
Read only
Idempotent
Input schema
{'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-]+$'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['sourcing_request'], 'properties': {'sourcing_request': {'type': 'object', 'required': ['id', 'category', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'description', 'quantity', 'unit'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'unit': {'type': 'string'}, 'quantity': {'type': 'number'}, 'description': {'type': 'string'}}, 'additionalProperties': {}}}, 'status': {'type': 'string'}, 'matches': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'supplier_id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'supplier_id': {'type': 'string', 'minLength': 1}, 'match_reasons': {'type': 'array', 'items': {}}, 'supplier_name': {'type': 'string'}}, 'additionalProperties': {}}}, 'category': {'type': 'string'}, 'artifacts': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'original_filename', 'media_type', 'artifact_type', 'purpose', 'data_classification', 'scan_status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'purpose': {'type': 'string'}, 'media_type': {'type': 'string'}, 'project_id': {'type': 'string', 'minLength': 1}, 'size_bytes': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}]}, 'scan_status': {'type': 'string'}, 'artifact_type': {'type': 'string'}, 'checksum_sha256': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'disclosure_status': {'type': 'string'}, 'original_filename': {'type': 'string'}, 'data_classification': {'type': 'string'}}, 'additionalProperties': {}}}, 'dispatches': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'supplier_id', 'channel', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'channel': {'type': 'string'}, 'supplier_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': {}}}, 'project_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}]}, 'demand_lane': {'type': 'string'}, 'workflow_status': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
get_supplier
Read one public supplier profile with source URLs and evidence for every category, capability, and brand claim.
Read only
Idempotent
Input schema
{'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_-]+$'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data'], 'properties': {'data': {'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'name': {'type': 'string'}, 'website': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['source_class'], 'properties': {'statement': {'type': 'string'}, 'confidence': {'anyOf': [{'type': 'string'}, {'type': 'number'}]}, 'expires_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'observed_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_class': {'type': 'string'}, 'verification_status': {'type': 'string'}}, 'additionalProperties': {}}}, 'hq_country_code': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'profile_summary': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'verification_status': {'type': 'string'}, 'participation_status': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
get_supplier_offers
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.
Read only
Idempotent
Input schema
{'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-]+$'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['offers'], 'properties': {'offers': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'currency', 'total_minor', 'items'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'description', 'quantity', 'unit', 'unit_price_minor', 'relationship'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'unit': {'type': 'string'}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['source_class'], 'properties': {'statement': {'type': 'string'}, 'confidence': {'anyOf': [{'type': 'string'}, {'type': 'number'}]}, 'expires_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'observed_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_class': {'type': 'string'}, 'verification_status': {'type': 'string'}}, 'additionalProperties': {}}}, 'quantity': {'type': 'number'}, 'description': {'type': 'string'}, 'relationship': {'type': 'string'}, 'request_item_id': {'type': 'string', 'minLength': 1}, 'unit_price_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': {}}}, 'status': {'type': 'string'}, 'currency': {'type': 'string'}, 'supplier_id': {'type': 'string', 'minLength': 1}, 'total_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'supplier_name': {'type': 'string'}}, 'additionalProperties': {}}}, 'unquoted_items': {'type': 'array', 'items': {}}}, 'additionalProperties': {}}
get_supplier_profile
Read the authenticated supplier's SupplySlate profile and current catalog-item count. Requires a supplier API key.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['supplier'], 'properties': {'supplier': {'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'name': {'type': 'string'}, 'website': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['source_class'], 'properties': {'statement': {'type': 'string'}, 'confidence': {'anyOf': [{'type': 'string'}, {'type': 'number'}]}, 'expires_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'observed_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_class': {'type': 'string'}, 'verification_status': {'type': 'string'}}, 'additionalProperties': {}}}, 'hq_country_code': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'profile_summary': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'verification_status': {'type': 'string'}, 'participation_status': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
get_supplier_rfq
Read an approved RFQ and its normalized buyer line items. Requires a supplier API key.
Read only
Idempotent
Input schema
{'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-]+$'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['rfq'], 'properties': {'rfq': {'type': 'object', 'required': ['supplier', 'match_id', 'request', 'permitted_artifacts', 'messages', 'quotes', 'response_actions'], 'properties': {'quotes': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'currency'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'currency': {'type': 'string'}}, 'additionalProperties': {}}}, 'request': {'type': 'object', 'required': ['id', 'category', 'workflow_status', 'items'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'description', 'quantity', 'unit'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'unit': {'type': 'string'}, 'quantity': {'type': 'number'}, 'description': {'type': 'string'}}, 'additionalProperties': {}}}, 'category': {'type': 'string'}, 'workflow_status': {'type': 'string'}}, 'additionalProperties': {}}, 'match_id': {'type': 'string', 'minLength': 1}, 'messages': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'sender_type', 'message_type', 'body'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'body': {'type': 'string'}, 'sender_type': {'type': 'string'}, 'message_type': {'type': 'string'}}, 'additionalProperties': {}}}, 'supplier': {'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'name': {'type': 'string'}}, 'additionalProperties': {}}, 'expires_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'response_actions': {'type': 'object', 'required': ['clarify', 'quote', 'decline'], 'properties': {'quote': {'type': 'string'}, 'clarify': {'type': 'string'}, 'decline': {'type': 'string'}}, 'additionalProperties': False}, 'permitted_artifacts': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'original_filename', 'media_type', 'artifact_type', 'purpose', 'content_url'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'purpose': {'type': 'string'}, 'media_type': {'type': 'string'}, 'content_url': {'type': 'string'}, 'artifact_type': {'type': 'string'}, 'original_filename': {'type': 'string'}}, 'additionalProperties': {}}}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
list_fabrication_processes
List configurable fabrication, kitting, assembly, and test processes with their required artifacts and requirement schemas.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'code': {'type': 'string'}, 'name': {'type': 'string'}, 'active': {'anyOf': [{'type': 'boolean'}, {'type': 'number'}]}}, 'additionalProperties': {}}}}, 'additionalProperties': {}}
list_orders
List merchant-confirmed orders for the buyer organization. A plan or queued handoff is never represented as an order.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data', 'summary'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'purchase_plan_id', 'merchant_order_reference', 'status', 'currency', 'total_minor', 'ordered_at'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'description', 'unit', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'unit': {'type': 'string'}, 'status': {'type': 'string'}, 'description': {'type': 'string'}, 'quantity_ordered': {'type': 'number'}}, 'additionalProperties': {}}}, 'events': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'event_type', 'occurred_at'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'event_type': {'type': 'string'}, 'occurred_at': {'type': 'string'}}, 'additionalProperties': {}}}, 'issues': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'status': {'type': 'string'}, 'returns': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'reason'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'currency': {'type': 'string'}, 'shipments': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'carrier': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'tracking_number': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'ordered_at': {'type': 'string'}, 'project_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}]}, 'supplier_id': {'type': 'string', 'minLength': 1}, 'total_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'supplier_name': {'type': 'string'}, 'warranty_claims': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'description'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': {}}}, 'purchase_plan_id': {'type': 'string', 'minLength': 1}, 'cancellation_requests': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'reason'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'merchant_order_reference': {'type': 'string'}}, 'additionalProperties': {}}}, 'summary': {'type': 'object', 'required': ['total_orders'], 'properties': {'total_orders': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': {}}
list_project_validations
List versioned validation reports for a project without implying licensed engineering approval.
Read only
Idempotent
Input schema
{'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-]+$'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'findings': {'type': 'array', 'items': {'type': 'object', 'required': ['severity', 'code', 'message'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'severity': {'type': 'string'}}, 'additionalProperties': {}}}, 'project_id': {'type': 'string', 'minLength': 1}, 'errors_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'missing_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'warnings_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'conflicts_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': {}}}}, 'additionalProperties': {}}
list_sourcing_categories
List the editable supply categories currently accepting requests. Agents may still submit a precise request outside this list.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'name'], 'properties': {'code': {'type': 'string'}, 'name': {'type': 'string'}, 'active': {'anyOf': [{'type': 'boolean'}, {'type': 'number'}]}}, 'additionalProperties': {}}}}, 'additionalProperties': {}}
list_sourcing_requests
List recent sourcing requests owned by the authenticated buyer organization across API keys and OAuth agents.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data', 'summary'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'category', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'description', 'quantity', 'unit'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'unit': {'type': 'string'}, 'quantity': {'type': 'number'}, 'description': {'type': 'string'}}, 'additionalProperties': {}}}, 'status': {'type': 'string'}, 'matches': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'supplier_id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'supplier_id': {'type': 'string', 'minLength': 1}, 'match_reasons': {'type': 'array', 'items': {}}, 'supplier_name': {'type': 'string'}}, 'additionalProperties': {}}}, 'category': {'type': 'string'}, 'artifacts': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'original_filename', 'media_type', 'artifact_type', 'purpose', 'data_classification', 'scan_status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'purpose': {'type': 'string'}, 'media_type': {'type': 'string'}, 'project_id': {'type': 'string', 'minLength': 1}, 'size_bytes': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}]}, 'scan_status': {'type': 'string'}, 'artifact_type': {'type': 'string'}, 'checksum_sha256': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'disclosure_status': {'type': 'string'}, 'original_filename': {'type': 'string'}, 'data_classification': {'type': 'string'}}, 'additionalProperties': {}}}, 'dispatches': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'supplier_id', 'channel', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'channel': {'type': 'string'}, 'supplier_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': {}}}, 'project_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}]}, 'demand_lane': {'type': 'string'}, 'workflow_status': {'type': 'string'}}, 'additionalProperties': {}}}, 'summary': {'type': 'object', 'required': ['total_requests', 'active_requests'], 'properties': {'total_requests': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'active_requests': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': {}}
list_supplier_orders
List merchant-confirmed orders attributable to the authenticated supplier. RFQs, quotes, plans, and checkout handoffs are not represented as orders.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data', 'summary'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'purchase_plan_id', 'merchant_order_reference', 'status', 'currency', 'total_minor', 'ordered_at'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'description', 'unit', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'unit': {'type': 'string'}, 'status': {'type': 'string'}, 'description': {'type': 'string'}, 'quantity_ordered': {'type': 'number'}}, 'additionalProperties': {}}}, 'events': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'event_type', 'occurred_at'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'event_type': {'type': 'string'}, 'occurred_at': {'type': 'string'}}, 'additionalProperties': {}}}, 'issues': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'status': {'type': 'string'}, 'returns': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'reason'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'currency': {'type': 'string'}, 'shipments': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'carrier': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'tracking_number': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'ordered_at': {'type': 'string'}, 'project_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}]}, 'supplier_id': {'type': 'string', 'minLength': 1}, 'total_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'supplier_name': {'type': 'string'}, 'warranty_claims': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'description'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': {}}}, 'purchase_plan_id': {'type': 'string', 'minLength': 1}, 'cancellation_requests': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'reason'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'merchant_order_reference': {'type': 'string'}}, 'additionalProperties': {}}}, 'summary': {'type': 'object', 'required': ['total_orders'], 'properties': {'total_orders': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': {}}
list_supplier_rfqs
List approved RFQs matched to the authenticated supplier. Requires a supplier API key.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'default': 25, 'maximum': 50, 'minimum': 1}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data', 'summary'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'minLength': 1}, 'category': {'type': 'string'}, 'match_id': {'type': 'string', 'minLength': 1}, 'request_id': {'type': 'string', 'minLength': 1}, 'workflow_status': {'type': 'string'}}, 'additionalProperties': {}}}, 'summary': {'type': 'object', 'required': ['total_rfqs', 'actionable_rfqs', 'active_quotes'], 'properties': {'total_rfqs': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'active_quotes': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'actionable_rfqs': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': {}}
list_supplier_taxonomy
List the product categories used by the public industrial compressor service-parts supplier directory, including verified supplier counts.
Read only
Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data'], 'properties': {'data': {'type': 'array', 'items': {}}}, 'additionalProperties': {}}
open_warranty_claim
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.
Open world
Input schema
{'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-]+$'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['order'], 'properties': {'order': {'type': 'object', 'required': ['id', 'purchase_plan_id', 'merchant_order_reference', 'status', 'currency', 'total_minor', 'ordered_at'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'description', 'unit', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'unit': {'type': 'string'}, 'status': {'type': 'string'}, 'description': {'type': 'string'}, 'quantity_ordered': {'type': 'number'}}, 'additionalProperties': {}}}, 'events': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'event_type', 'occurred_at'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'event_type': {'type': 'string'}, 'occurred_at': {'type': 'string'}}, 'additionalProperties': {}}}, 'issues': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'status': {'type': 'string'}, 'returns': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'reason'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'currency': {'type': 'string'}, 'shipments': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'carrier': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'tracking_number': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'ordered_at': {'type': 'string'}, 'project_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}]}, 'supplier_id': {'type': 'string', 'minLength': 1}, 'total_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'supplier_name': {'type': 'string'}, 'warranty_claims': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'description'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': {}}}, 'purchase_plan_id': {'type': 'string', 'minLength': 1}, 'cancellation_requests': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'reason'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'merchant_order_reference': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
report_order_issue
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.
Open world
Input schema
{'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-]+$'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['order'], 'properties': {'order': {'type': 'object', 'required': ['id', 'purchase_plan_id', 'merchant_order_reference', 'status', 'currency', 'total_minor', 'ordered_at'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'description', 'unit', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'unit': {'type': 'string'}, 'status': {'type': 'string'}, 'description': {'type': 'string'}, 'quantity_ordered': {'type': 'number'}}, 'additionalProperties': {}}}, 'events': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'event_type', 'occurred_at'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'event_type': {'type': 'string'}, 'occurred_at': {'type': 'string'}}, 'additionalProperties': {}}}, 'issues': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'status': {'type': 'string'}, 'returns': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'reason'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'currency': {'type': 'string'}, 'shipments': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'carrier': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'tracking_number': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'ordered_at': {'type': 'string'}, 'project_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}]}, 'supplier_id': {'type': 'string', 'minLength': 1}, 'total_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'supplier_name': {'type': 'string'}, 'warranty_claims': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'description'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': {}}}, 'purchase_plan_id': {'type': 'string', 'minLength': 1}, 'cancellation_requests': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'reason'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'merchant_order_reference': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
request_order_cancellation
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.
Open world
Input schema
{'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-]+$'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['order'], 'properties': {'order': {'type': 'object', 'required': ['id', 'purchase_plan_id', 'merchant_order_reference', 'status', 'currency', 'total_minor', 'ordered_at'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'description', 'unit', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'unit': {'type': 'string'}, 'status': {'type': 'string'}, 'description': {'type': 'string'}, 'quantity_ordered': {'type': 'number'}}, 'additionalProperties': {}}}, 'events': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'event_type', 'occurred_at'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'event_type': {'type': 'string'}, 'occurred_at': {'type': 'string'}}, 'additionalProperties': {}}}, 'issues': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'status': {'type': 'string'}, 'returns': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'reason'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'currency': {'type': 'string'}, 'shipments': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'carrier': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'tracking_number': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'ordered_at': {'type': 'string'}, 'project_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}]}, 'supplier_id': {'type': 'string', 'minLength': 1}, 'total_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'supplier_name': {'type': 'string'}, 'warranty_claims': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'description'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': {}}}, 'purchase_plan_id': {'type': 'string', 'minLength': 1}, 'cancellation_requests': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'reason'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'merchant_order_reference': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
request_order_return
Open a return request after shipment. The supplier remains merchant of record and controls authorization and refund state.
Open world
Input schema
{'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-]+$'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['order'], 'properties': {'order': {'type': 'object', 'required': ['id', 'purchase_plan_id', 'merchant_order_reference', 'status', 'currency', 'total_minor', 'ordered_at'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'description', 'unit', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'unit': {'type': 'string'}, 'status': {'type': 'string'}, 'description': {'type': 'string'}, 'quantity_ordered': {'type': 'number'}}, 'additionalProperties': {}}}, 'events': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'event_type', 'occurred_at'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'event_type': {'type': 'string'}, 'occurred_at': {'type': 'string'}}, 'additionalProperties': {}}}, 'issues': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'status': {'type': 'string'}, 'returns': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'reason'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'currency': {'type': 'string'}, 'shipments': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'carrier': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'tracking_number': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'ordered_at': {'type': 'string'}, 'project_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}]}, 'supplier_id': {'type': 'string', 'minLength': 1}, 'total_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'supplier_name': {'type': 'string'}, 'warranty_claims': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'description'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': {}}}, 'purchase_plan_id': {'type': 'string', 'minLength': 1}, 'cancellation_requests': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'reason'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'merchant_order_reference': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
request_purchase_approval
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.
Input schema
{'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}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['approval'], 'properties': {'approval': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'currency': {'type': 'string'}, 'expires_at': {'type': 'string'}, 'review_url': {'type': 'string', 'format': 'uri'}, 'exact_plan_hash': {'type': 'string'}, 'maximum_amount_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
revise_supplier_quote
Create a new immutable revision of a supplier quote. The previous revision remains in history and the new revision becomes current.
Open world
Input schema
{'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}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['quote'], 'properties': {'quote': {'type': 'object', 'required': ['id', 'status', 'currency'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'description', 'quantity', 'unit', 'unit_price_minor', 'relationship'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'unit': {'type': 'string'}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['source_class'], 'properties': {'statement': {'type': 'string'}, 'confidence': {'anyOf': [{'type': 'string'}, {'type': 'number'}]}, 'expires_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'observed_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_class': {'type': 'string'}, 'verification_status': {'type': 'string'}}, 'additionalProperties': {}}}, 'quantity': {'type': 'number'}, 'description': {'type': 'string'}, 'relationship': {'type': 'string'}, 'request_item_id': {'type': 'string', 'minLength': 1}, 'unit_price_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': {}}}, 'status': {'type': 'string'}, 'currency': {'type': 'string'}, 'request_id': {'type': 'string', 'minLength': 1}, 'supplier_id': {'type': 'string', 'minLength': 1}, 'quote_number': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
search_live_components
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.
Read only
Idempotent
Input schema
{'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}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data', 'count', 'provider', 'attribution', 'cached'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'required': ['provider_part_number', 'description', 'availability_status', 'price_breaks', 'source_url', 'observed_at'], 'properties': {'source_url': {'type': 'string', 'format': 'uri'}, 'description': {'type': 'string'}, 'observed_at': {'type': 'string'}, 'manufacturer': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'price_breaks': {'type': 'array', 'items': {}}, 'availability_status': {'type': 'string'}, 'provider_part_number': {'type': 'string'}}, 'additionalProperties': {}}}, 'count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'cached': {'type': 'boolean'}, 'provider': {'type': 'string'}, 'attribution': {'type': 'string'}}, 'additionalProperties': {}}
search_products
Search published canonical product facts. Commercial price, stock, compatibility, and lead time are returned only when separately supported by current evidence.
Read only
Idempotent
Input schema
{'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}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'name': {'type': 'string'}, 'manufacturer': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'verification_status': {'type': 'string'}}, 'additionalProperties': {}}}}, 'additionalProperties': {}}
search_suppliers
Search source-backed public supplier profiles by product category, brand, company type, service, compressor type, industry, or text. No authentication required.
Read only
Idempotent
Input schema
{'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}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data'], 'properties': {'data': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'name': {'type': 'string'}, 'website': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['source_class'], 'properties': {'statement': {'type': 'string'}, 'confidence': {'anyOf': [{'type': 'string'}, {'type': 'number'}]}, 'expires_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'observed_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_class': {'type': 'string'}, 'verification_status': {'type': 'string'}}, 'additionalProperties': {}}}, 'hq_country_code': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'profile_summary': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'verification_status': {'type': 'string'}, 'participation_status': {'type': 'string'}}, 'additionalProperties': {}}}, 'count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'total': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': {}}
source_project
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.
Input schema
{'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}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['sourcing_request', 'matching'], 'properties': {'matching': {'type': 'object', 'required': ['candidate_supplier_count', 'line_count', 'supplier_set_requires_human_approval', 'outbound_sent'], 'properties': {'line_count': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'outbound_sent': {'type': 'boolean', 'const': False}, 'candidate_supplier_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'supplier_set_requires_human_approval': {'type': 'boolean', 'const': True}}, 'additionalProperties': {}}, 'sourcing_request': {'type': 'object', 'required': ['id', 'category', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'description', 'quantity', 'unit'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'unit': {'type': 'string'}, 'quantity': {'type': 'number'}, 'description': {'type': 'string'}}, 'additionalProperties': {}}}, 'status': {'type': 'string'}, 'matches': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'supplier_id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'supplier_id': {'type': 'string', 'minLength': 1}, 'match_reasons': {'type': 'array', 'items': {}}, 'supplier_name': {'type': 'string'}}, 'additionalProperties': {}}}, 'category': {'type': 'string'}, 'artifacts': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'original_filename', 'media_type', 'artifact_type', 'purpose', 'data_classification', 'scan_status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'purpose': {'type': 'string'}, 'media_type': {'type': 'string'}, 'project_id': {'type': 'string', 'minLength': 1}, 'size_bytes': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}]}, 'scan_status': {'type': 'string'}, 'artifact_type': {'type': 'string'}, 'checksum_sha256': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'disclosure_status': {'type': 'string'}, 'original_filename': {'type': 'string'}, 'data_classification': {'type': 'string'}}, 'additionalProperties': {}}}, 'dispatches': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'supplier_id', 'channel', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'channel': {'type': 'string'}, 'supplier_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': {}}}, 'project_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}]}, 'demand_lane': {'type': 'string'}, 'workflow_status': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
submit_sourcing_request
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.
Idempotent
Input schema
{'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}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['sourcing_request', 'matching'], 'properties': {'matching': {'type': 'object', 'required': ['candidate_supplier_count', 'line_count', 'supplier_set_requires_human_approval', 'outbound_sent'], 'properties': {'line_count': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'outbound_sent': {'type': 'boolean', 'const': False}, 'candidate_supplier_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'supplier_set_requires_human_approval': {'type': 'boolean', 'const': True}}, 'additionalProperties': {}}, 'sourcing_request': {'type': 'object', 'required': ['id', 'category', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'description', 'quantity', 'unit'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'unit': {'type': 'string'}, 'quantity': {'type': 'number'}, 'description': {'type': 'string'}}, 'additionalProperties': {}}}, 'status': {'type': 'string'}, 'matches': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'supplier_id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'supplier_id': {'type': 'string', 'minLength': 1}, 'match_reasons': {'type': 'array', 'items': {}}, 'supplier_name': {'type': 'string'}}, 'additionalProperties': {}}}, 'category': {'type': 'string'}, 'artifacts': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'original_filename', 'media_type', 'artifact_type', 'purpose', 'data_classification', 'scan_status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'purpose': {'type': 'string'}, 'media_type': {'type': 'string'}, 'project_id': {'type': 'string', 'minLength': 1}, 'size_bytes': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}]}, 'scan_status': {'type': 'string'}, 'artifact_type': {'type': 'string'}, 'checksum_sha256': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'disclosure_status': {'type': 'string'}, 'original_filename': {'type': 'string'}, 'data_classification': {'type': 'string'}}, 'additionalProperties': {}}}, 'dispatches': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'supplier_id', 'channel', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'channel': {'type': 'string'}, 'supplier_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': {}}}, 'project_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}]}, 'demand_lane': {'type': 'string'}, 'workflow_status': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
submit_supplier_quote
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.
Open world
Input schema
{'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}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['quote'], 'properties': {'quote': {'type': 'object', 'required': ['id', 'status', 'currency'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'description', 'quantity', 'unit', 'unit_price_minor', 'relationship'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'unit': {'type': 'string'}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['source_class'], 'properties': {'statement': {'type': 'string'}, 'confidence': {'anyOf': [{'type': 'string'}, {'type': 'number'}]}, 'expires_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_url': {'anyOf': [{'type': 'string', 'format': 'uri'}, {'type': 'null'}]}, 'observed_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'source_class': {'type': 'string'}, 'verification_status': {'type': 'string'}}, 'additionalProperties': {}}}, 'quantity': {'type': 'number'}, 'description': {'type': 'string'}, 'relationship': {'type': 'string'}, 'request_item_id': {'type': 'string', 'minLength': 1}, 'unit_price_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': {}}}, 'status': {'type': 'string'}, 'currency': {'type': 'string'}, 'request_id': {'type': 'string', 'minLength': 1}, 'supplier_id': {'type': 'string', 'minLength': 1}, 'quote_number': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
update_availability
Append timestamped supplier availability evidence and update current catalog state by supplier SKU without rewriting historical snapshots.
Open world
Input schema
{'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}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['updated_catalog_item_ids', 'updated_count'], 'properties': {'updated_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'updated_catalog_item_ids': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}}}, 'additionalProperties': {}}
update_project_requirements
Replace the structured requirement set on an unlocked project revision. Confirmed flags distinguish buyer-confirmed facts from agent interpretation.
Input schema
{'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}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['project'], 'properties': {'project': {'type': 'object', 'required': ['id', 'name', 'project_type', 'demand_lane', 'origin_type', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'boms': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'name': {'type': 'string'}, 'current_revision_id': {'type': 'string', 'minLength': 1}}, 'additionalProperties': {}}}, 'name': {'type': 'string'}, 'brief': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'status': {'type': 'string'}, 'artifacts': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'original_filename', 'media_type', 'artifact_type', 'purpose', 'data_classification', 'scan_status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'purpose': {'type': 'string'}, 'media_type': {'type': 'string'}, 'project_id': {'type': 'string', 'minLength': 1}, 'size_bytes': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}]}, 'scan_status': {'type': 'string'}, 'artifact_type': {'type': 'string'}, 'checksum_sha256': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'disclosure_status': {'type': 'string'}, 'original_filename': {'type': 'string'}, 'data_classification': {'type': 'string'}}, 'additionalProperties': {}}}, 'demand_lane': {'type': 'string'}, 'origin_type': {'type': 'string'}, 'fixture_kind': {'type': 'string'}, 'project_type': {'type': 'string'}, 'requirements': {'type': 'array', 'items': {'type': 'object', 'required': ['requirement_type', 'name', 'value'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'name': {'type': 'string'}, 'value': {}, 'requirement_type': {'type': 'string'}}, 'additionalProperties': {}}}, 'current_revision': {'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'version': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'revision_number': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'additionalProperties': {}}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
update_supplier_capabilities
Replace the supplier-submitted capability set while preserving separately sourced public, operator-verified, and transaction-proven evidence.
Input schema
{'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}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['data'], 'properties': {'data': {'type': 'array', 'items': {}}}, 'additionalProperties': {}}
update_supplier_order
Acknowledge or update fulfillment on a merchant-confirmed supplier order, optionally recording a shipment. State transitions and order-item quantities are validated and audited.
Open world
Input schema
{'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))$'}}}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['order'], 'properties': {'order': {'type': 'object', 'required': ['id', 'purchase_plan_id', 'merchant_order_reference', 'status', 'currency', 'total_minor', 'ordered_at'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'description', 'unit', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'unit': {'type': 'string'}, 'status': {'type': 'string'}, 'description': {'type': 'string'}, 'quantity_ordered': {'type': 'number'}}, 'additionalProperties': {}}}, 'events': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'event_type', 'occurred_at'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'event_type': {'type': 'string'}, 'occurred_at': {'type': 'string'}}, 'additionalProperties': {}}}, 'issues': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'status': {'type': 'string'}, 'returns': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'reason'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'currency': {'type': 'string'}, 'shipments': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'carrier': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'tracking_number': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'ordered_at': {'type': 'string'}, 'project_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}]}, 'supplier_id': {'type': 'string', 'minLength': 1}, 'total_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'supplier_name': {'type': 'string'}, 'warranty_claims': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'description'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': {}}}, 'purchase_plan_id': {'type': 'string', 'minLength': 1}, 'cancellation_requests': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'reason'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'merchant_order_reference': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
update_supplier_order_issue
Update ownership, status, or resolution for a buyer-reported issue on the authenticated supplier's merchant order.
Open world
Input schema
{'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}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['order'], 'properties': {'order': {'type': 'object', 'required': ['id', 'purchase_plan_id', 'merchant_order_reference', 'status', 'currency', 'total_minor', 'ordered_at'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'description', 'unit', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'unit': {'type': 'string'}, 'status': {'type': 'string'}, 'description': {'type': 'string'}, 'quantity_ordered': {'type': 'number'}}, 'additionalProperties': {}}}, 'events': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'event_type', 'occurred_at'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'event_type': {'type': 'string'}, 'occurred_at': {'type': 'string'}}, 'additionalProperties': {}}}, 'issues': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'status': {'type': 'string'}, 'returns': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'reason'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'currency': {'type': 'string'}, 'shipments': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'carrier': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'tracking_number': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'ordered_at': {'type': 'string'}, 'project_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}]}, 'supplier_id': {'type': 'string', 'minLength': 1}, 'total_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'supplier_name': {'type': 'string'}, 'warranty_claims': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'description'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': {}}}, 'purchase_plan_id': {'type': 'string', 'minLength': 1}, 'cancellation_requests': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'reason'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'merchant_order_reference': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
update_supplier_order_return
Advance an authenticated supplier return through authorization, shipment, receipt, and refund states without changing historical order evidence.
Open world
Input schema
{'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}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['order'], 'properties': {'order': {'type': 'object', 'required': ['id', 'purchase_plan_id', 'merchant_order_reference', 'status', 'currency', 'total_minor', 'ordered_at'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'description', 'unit', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'unit': {'type': 'string'}, 'status': {'type': 'string'}, 'description': {'type': 'string'}, 'quantity_ordered': {'type': 'number'}}, 'additionalProperties': {}}}, 'events': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'event_type', 'occurred_at'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'event_type': {'type': 'string'}, 'occurred_at': {'type': 'string'}}, 'additionalProperties': {}}}, 'issues': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'status': {'type': 'string'}, 'returns': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'reason'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'currency': {'type': 'string'}, 'shipments': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'carrier': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'tracking_number': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'ordered_at': {'type': 'string'}, 'project_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}]}, 'supplier_id': {'type': 'string', 'minLength': 1}, 'total_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'supplier_name': {'type': 'string'}, 'warranty_claims': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'description'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': {}}}, 'purchase_plan_id': {'type': 'string', 'minLength': 1}, 'cancellation_requests': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'reason'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'merchant_order_reference': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
update_supplier_warranty_claim
Advance a warranty claim through supplier review, approval, replacement, resolution, or rejection with a merchant reference and durable history.
Open world
Input schema
{'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}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['order'], 'properties': {'order': {'type': 'object', 'required': ['id', 'purchase_plan_id', 'merchant_order_reference', 'status', 'currency', 'total_minor', 'ordered_at'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'description', 'unit', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'unit': {'type': 'string'}, 'status': {'type': 'string'}, 'description': {'type': 'string'}, 'quantity_ordered': {'type': 'number'}}, 'additionalProperties': {}}}, 'events': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'event_type', 'occurred_at'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'event_type': {'type': 'string'}, 'occurred_at': {'type': 'string'}}, 'additionalProperties': {}}}, 'issues': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'status': {'type': 'string'}, 'returns': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'reason'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'currency': {'type': 'string'}, 'shipments': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'carrier': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'tracking_number': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': {}}}, 'ordered_at': {'type': 'string'}, 'project_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}]}, 'supplier_id': {'type': 'string', 'minLength': 1}, 'total_minor': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'supplier_name': {'type': 'string'}, 'warranty_claims': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'description'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'description': {'type': 'string'}}, 'additionalProperties': {}}}, 'purchase_plan_id': {'type': 'string', 'minLength': 1}, 'cancellation_requests': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'status', 'reason'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'reason': {'type': 'string'}, 'status': {'type': 'string'}}, 'additionalProperties': {}}}, 'merchant_order_reference': {'type': 'string'}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
upsert_bom
Create a BOM or a new BOM revision with assemblies, catalog items, custom parts, services, consumables, artifacts, and interface dependencies.
Input schema
{'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'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['bom'], 'properties': {'bom': {'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'name': {'type': 'string'}, 'project_id': {'type': 'string', 'minLength': 1}, 'current_revision': {'type': 'object', 'required': ['id', 'revision_number'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'items': {'type': 'array', 'items': {}}, 'dependencies': {'type': 'array', 'items': {}}, 'revision_number': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}}, 'additionalProperties': {}}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
upsert_supplier_catalog
Create or update normalized supplier catalog items through a durable manual import with row-level validation, history, evidence scope, availability, and commercial terms.
Idempotent
Input schema
{'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}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['catalog_import'], 'properties': {'catalog_import': {'type': 'object', 'required': ['id', 'status', 'source_type'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'total_rows': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'source_type': {'type': 'string'}, 'accepted_rows': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'rejected_rows': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'validation_errors': {'type': 'array', 'items': {}}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
validate_project
Run the current versioned validators and return separate blocking errors, compatibility conflicts, warnings, missing information, passed checks, and unavailable checks.
Input schema
{'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-]+$'}}}
Output schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['validation'], 'properties': {'validation': {'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'status': {'type': 'string'}, 'findings': {'type': 'array', 'items': {'type': 'object', 'required': ['severity', 'code', 'message'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'severity': {'type': 'string'}}, 'additionalProperties': {}}}, 'project_id': {'type': 'string', 'minLength': 1}, 'errors_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'missing_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'warnings_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'conflicts_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': {}}}, 'additionalProperties': {}}
History
Recent tool changes
Added
get_supplier_offers
Sept. 17, 2026, 12:37 p.m.
Added
get_sourcing_request
Sept. 17, 2026, 12:37 p.m.
Added
list_sourcing_requests
Sept. 17, 2026, 12:37 p.m.
Added
submit_sourcing_request
Sept. 17, 2026, 12:37 p.m.
Added
update_supplier_warranty_claim
Sept. 17, 2026, 12:37 p.m.
Added
update_supplier_order_return
Sept. 17, 2026, 12:37 p.m.
Added
decide_supplier_order_cancellation
Sept. 17, 2026, 12:37 p.m.
Added
update_supplier_order_issue
Sept. 17, 2026, 12:37 p.m.
Added
update_supplier_order
Sept. 17, 2026, 12:37 p.m.
Added
list_supplier_orders
Sept. 17, 2026, 12:37 p.m.
Added
decline_supplier_rfq
Sept. 17, 2026, 12:37 p.m.
Added
revise_supplier_quote
Sept. 17, 2026, 12:37 p.m.
Added
ask_rfq_clarification
Sept. 17, 2026, 12:37 p.m.
Added
submit_supplier_quote
Sept. 17, 2026, 12:37 p.m.
Added
get_supplier_rfq
Sept. 17, 2026, 12:37 p.m.
Added
list_supplier_rfqs
Sept. 17, 2026, 12:37 p.m.
Added
update_availability
Sept. 17, 2026, 12:37 p.m.
Added
update_supplier_capabilities
Sept. 17, 2026, 12:37 p.m.
Added
create_catalog_import
Sept. 17, 2026, 12:37 p.m.
Added
upsert_supplier_catalog
Sept. 17, 2026, 12:37 p.m.
Added
get_supplier_profile
Sept. 17, 2026, 12:37 p.m.
Added
open_warranty_claim
Sept. 17, 2026, 12:37 p.m.
Added
request_order_return
Sept. 17, 2026, 12:37 p.m.
Added
request_order_cancellation
Sept. 17, 2026, 12:37 p.m.
Added
report_order_issue
Sept. 17, 2026, 12:37 p.m.
Added
get_order
Sept. 17, 2026, 12:37 p.m.
Added
list_orders
Sept. 17, 2026, 12:37 p.m.
Added
create_provider_checkout_handoff
Sept. 17, 2026, 12:37 p.m.
Added
get_checkout_handoffs
Sept. 17, 2026, 12:37 p.m.
Added
request_purchase_approval
Sept. 17, 2026, 12:37 p.m.
Discover
Similar MCP servers
AgentLot Marketplace
io.agentlot/marketplace
Enables agents and users to discover, bid on, purchase, deliver, and settle paid digital services and compute work.
zobrx
com.zobrx/zobrx
Provides read-only ecommerce operations and analytics for orders, inventory, marketplace performance, advertising, settlements, t…
Obriym CRM
com.obriym-crm/mcp
Manages CRM records, sales pipelines, activities, orders, products, inventory, and marketplace catalog operations.
velora
com.somosvelora/velora
Provides Argentine commerce operations including catalog and inventory, customer and supplier management, cash register tracking,…
Shopify
io.github.pipeworx-io/shopify
Provides read access to Shopify Admin data for store operations through the Shopify REST API.
Woocommerce
io.github.pipeworx-io/woocommerce
Provides access to WooCommerce store data through the WooCommerce REST API.
Troostwijk
io.github.pipeworx-io/troostwijk
Searches European industrial and insolvency liquidation auctions and retrieves auction lot details.
Bigiron
io.github.pipeworx-io/bigiron
Searches active and sold BigIron auction lots for agricultural, construction, livestock, and transportation equipment.