Conformance Testing

onX Conformance Test Suite

Validate any onX endpoint against the standard. Tests all 7 entity schemas, 12 tool-input schemas, and all 12 onX operations.

Commerce Operations Foundation ·GitHub Repo

7Entity Schemas

orderSales order with line items, addresses, and payment status
productProduct catalog entry with categories, tags, and options
product-variantSKU-level variant with price, cost, and weight
customerIndividual or company with addresses and custom fields
fulfillmentShipment with tracking numbers and carrier details
inventoryStock levels per SKU per warehouse location
returnRMA with line items, reason codes, and refund details

12Tool-Input Schemas

get-productsJSON schema
get-product-variantsJSON schema
get-inventoryJSON schema
get-customersJSON schema
get-ordersJSON schema
create-sales-orderJSON schema
fulfill-orderJSON schema
get-fulfillmentsJSON schema
get-returnsJSON schema
update-orderJSON schema
cancel-orderJSON schema
create-returnJSON schema

12onX Operations

get-productsList product catalog with filters and pagination
get-product-variantsList SKUs and option combinations
get-inventoryStock levels by SKU and warehouse location
get-customersCustomer lookup by email, type, and status
get-ordersOrder history with filtering and pagination
create-sales-orderPlace a new order with line items and addresses
update-orderModify an existing order (status, shipping, etc.)
cancel-orderCancel an order with a reason code
fulfill-orderMark order as shipped with carrier and tracking
get-fulfillmentsFulfillment status and tracking by order
create-returnInitiate a return or RMA with line items
get-returnsReturn history and refund status by order

Run Tests Against an Endpoint

CLI Usage

npx onx-conform --endpoint