Servidor MCP
SupplySlate
com.supplyslate/sourcing
Qué hace este MCP
Supports component sourcing, fabrication requests, supplier RFQs, catalog imports, quotes, purchase planning, checkout handoffs, and order fulfillment.
Capacidades
Herramientas
55
herramientas
ask_rfq_clarification
Ask the buyer a clarification question on an approved supplier RFQ without changing the immutable request package.
Acceso externo
Esquema de entrada
{'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}}}
Esquema de salida
{'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.
Esquema de entrada
{'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'}}}
Esquema de salida
{'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.
Esquema de entrada
{'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'}}}
Esquema de salida
{'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.
Idempotente
Esquema de entrada
{'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}}}
Esquema de salida
{'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.
Idempotente
Esquema de entrada
{'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'}}}
Esquema de salida
{'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.
Acceso externo
Esquema de entrada
{'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.'}}}
Esquema de salida
{'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.
Idempotente
Esquema de entrada
{'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}}}
Esquema de salida
{'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.
Acceso externo
Esquema de entrada
{'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-]+$'}}}
Esquema de salida
{'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.
Acceso externo
Esquema de entrada
{'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'}}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'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-]+$'}}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'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-]+$'}}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['compatibility_id'], 'properties': {'compatibility_id': {'type': 'string', 'maxLength': 100, 'minLength': 1}}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'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.'}}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'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-]+$'}}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['product_id'], 'properties': {'product_id': {'type': 'string', 'maxLength': 100, 'minLength': 1}}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'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-]+$'}}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'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-]+$'}}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'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.'}}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'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-]+$'}}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'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_-]+$'}}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'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-]+$'}}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'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-]+$'}}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'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-]+$'}}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1}}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'default': 25, 'maximum': 50, 'minimum': 1}}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
Esquema de salida
{'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.
Acceso externo
Esquema de entrada
{'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-]+$'}}}
Esquema de salida
{'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.
Acceso externo
Esquema de entrada
{'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-]+$'}}}
Esquema de salida
{'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.
Acceso externo
Esquema de entrada
{'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-]+$'}}}
Esquema de salida
{'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.
Acceso externo
Esquema de entrada
{'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-]+$'}}}
Esquema de salida
{'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.
Esquema de entrada
{'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}}}
Esquema de salida
{'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.
Acceso externo
Esquema de entrada
{'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}}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'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}}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'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}}}
Esquema de salida
{'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.
Solo lectura
Idempotente
Esquema de entrada
{'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}}}
Esquema de salida
{'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.
Esquema de entrada
{'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}}}
Esquema de salida
{'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.
Idempotente
Esquema de entrada
{'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}}}
Esquema de salida
{'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.
Acceso externo
Esquema de entrada
{'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}}}
Esquema de salida
{'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.
Acceso externo
Esquema de entrada
{'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}}}
Esquema de salida
{'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.
Esquema de entrada
{'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}}}
Esquema de salida
{'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.
Esquema de entrada
{'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}}}
Esquema de salida
{'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.
Acceso externo
Esquema de entrada
{'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))$'}}}}}
Esquema de salida
{'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.
Acceso externo
Esquema de entrada
{'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}}}
Esquema de salida
{'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.
Acceso externo
Esquema de entrada
{'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}}}
Esquema de salida
{'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.
Acceso externo
Esquema de entrada
{'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}}}
Esquema de salida
{'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.
Esquema de entrada
{'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'}}}
Esquema de salida
{'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.
Idempotente
Esquema de entrada
{'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}}}
Esquema de salida
{'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.
Esquema de entrada
{'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-]+$'}}}
Esquema de salida
{'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': {}}
Historial
Cambios recientes en herramientas
Añadido
get_supplier_offers
17 de September de 2026 a las 12:37
Añadido
get_sourcing_request
17 de September de 2026 a las 12:37
Añadido
list_sourcing_requests
17 de September de 2026 a las 12:37
Añadido
submit_sourcing_request
17 de September de 2026 a las 12:37
Añadido
update_supplier_warranty_claim
17 de September de 2026 a las 12:37
Añadido
update_supplier_order_return
17 de September de 2026 a las 12:37
Añadido
decide_supplier_order_cancellation
17 de September de 2026 a las 12:37
Añadido
update_supplier_order_issue
17 de September de 2026 a las 12:37
Añadido
update_supplier_order
17 de September de 2026 a las 12:37
Añadido
list_supplier_orders
17 de September de 2026 a las 12:37
Añadido
decline_supplier_rfq
17 de September de 2026 a las 12:37
Añadido
revise_supplier_quote
17 de September de 2026 a las 12:37
Añadido
ask_rfq_clarification
17 de September de 2026 a las 12:37
Añadido
submit_supplier_quote
17 de September de 2026 a las 12:37
Añadido
get_supplier_rfq
17 de September de 2026 a las 12:37
Añadido
list_supplier_rfqs
17 de September de 2026 a las 12:37
Añadido
update_availability
17 de September de 2026 a las 12:37
Añadido
update_supplier_capabilities
17 de September de 2026 a las 12:37
Añadido
create_catalog_import
17 de September de 2026 a las 12:37
Añadido
upsert_supplier_catalog
17 de September de 2026 a las 12:37
Añadido
get_supplier_profile
17 de September de 2026 a las 12:37
Añadido
open_warranty_claim
17 de September de 2026 a las 12:37
Añadido
request_order_return
17 de September de 2026 a las 12:37
Añadido
request_order_cancellation
17 de September de 2026 a las 12:37
Añadido
report_order_issue
17 de September de 2026 a las 12:37
Añadido
get_order
17 de September de 2026 a las 12:37
Añadido
list_orders
17 de September de 2026 a las 12:37
Añadido
create_provider_checkout_handoff
17 de September de 2026 a las 12:37
Añadido
get_checkout_handoffs
17 de September de 2026 a las 12:37
Añadido
request_purchase_approval
17 de September de 2026 a las 12:37
Descubrir
Servidores MCP similares
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.