Getting Started with UOIS

The Universal Order Interchange Standard (UOIS) provides a standardized way for AI agents to interact with order management systems. This guide will help you get started quickly.

Choose Your Path

Quick Demo

Try UOIS in under 5 minutes:

1
2
3
4
5
6
7
8

# Install the reference implementation
npm install -g @universal-oms/mcp-server

# Start the server
npx @universal-oms/mcp-server

# The server is now running on localhost:3000
# Connect it to Claude Desktop or any MCP client

AI Developers

1. Install the MCP Server

1

npm install -g @universal-oms/mcp-server

2. Configure Claude Desktop

Add to your Claude Desktop configuration:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

{
  "mcpServers": {
    "universal-oms": {
      "command": "npx",
      "args": ["@universal-oms/mcp-server"],
      "env": {
        "OMS_ENDPOINT": "https://your-oms-api.example.com",
        "API_KEY": "your-api-key"
      }
    }
  }
}

3. Start Using UOIS

Now Claude can help with orders:

User: "Check inventory for product SKU-123"
Claude: I'll check the inventory for SKU-123...
[Uses get-inventory tool]
Product SKU-123 has 150 units available.

User: "Create an order for 2 units to ship to John Doe"
Claude: I'll create that order for you...
[Uses capture-order tool]
Order #ORD-001 created successfully for John Doe.

Next Steps for AI Developers

• Explore all 15 operations
• Learn about error handling
• See real-world examples

OMS Vendors

1. Understand the Specification

UOIS defines 15 core operations that your OMS should support:

Order Operations:

• capture-order - Create new orders
• cancel-order - Cancel orders
• update-order - Modify order details
• ship-order - Mark as shipped

Data Queries:

• get-order - Retrieve order details
• get-inventory - Check stock levels
• get-customer - Customer information

View complete specification →

2. Implement MCP Server

Create an MCP server that translates UOIS operations to your OMS API:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20

// Example MCP server implementation
import { MCPServer } from '@anthropic/mcp-server';

const server = new MCPServer({
  name: 'your-oms-uois-server',
  version: '1.0.0'
});

// Implement capture-order tool
server.addTool({
  name: 'capture-order',
  description: 'Create a new order',
  schema: {
    // UOIS-compliant schema
  },
  handler: async (params) => {
    // Translate to your OMS API calls
    return await yourOMS.createOrder(params);
  }
});

3. Test and Certify

• Test with our reference test suite
• Validate compliance with UOIS specification
• Submit for certification (coming soon)

Next Steps for OMS Vendors

• Download the full specification
• View implementation examples
• Join the technical working group

Commerce Platforms

1. Standardize on UOIS

Instead of building custom integrations for each OMS, standardize on UOIS:

1
2
3
4
5
6
7

// Before: Custom integration for each OMS
await vendorA.createOrder(orderData);
await vendorB.submitOrder(transformToVendorB(orderData));
await vendorC.newOrder(mapToVendorC(orderData));

// After: Standard UOIS interface
await uoisClient.captureOrder(orderData);

2. Enable AI Features

Add AI capabilities to your platform:

1
2
3
4
5
6
7
8
9

import { UOISClient } from '@universal-oms/client';

const oms = new UOISClient(omsEndpoint);

// Your platform can now offer AI-powered features
const aiAssistant = new CommerceAI({
  orderSystem: oms,
  capabilities: ['order-management', 'inventory-check', 'customer-service']
});

3. Reduce Integration Time

• Before UOIS: 3-6 months per OMS integration
• After UOIS: Days to weeks for compliant systems

Next Steps for Commerce Platforms

• See integration examples
• Learn about authentication
• Join our implementation program

3PLs & Merchants

1. Connect Your Systems

Use UOIS to connect AI agents to your fulfillment systems:

1
2
3
4
5
6
7
8
9

# Set up UOIS server for your 3PL system
npm install @universal-oms/3pl-adapter

# Configure for your warehouse system
export WMS_ENDPOINT="https://your-wms.example.com"
export WMS_API_KEY="your-api-key"

# Start the UOIS server
npx @universal-oms/3pl-adapter

2. Automate Order Processing

AI can now handle routine tasks:

• Order Ingestion: Automatically process orders from multiple channels
• Inventory Management: Real-time stock level updates
• Customer Service: Answer shipping and tracking questions
• Returns Processing: Handle return requests automatically

3. Scale Your Operations

• Reduce Manual Work: Eliminate data entry and order processing
• Handle Peak Seasons: AI scales automatically with demand
• Improve Accuracy: Reduce human errors in order processing

Next Steps for 3PLs & Merchants

• View 3PL-specific examples
• Learn about warehouse integration
• Connect with implementation partners

Need Help?

• Documentation: Complete UOIS specification
• Community: Join our Discord
• Support: implementation-help@commerceoperations.org
• Training: Upcoming webinars and workshops

What’s Next?

1. Try the Demo: Get hands-on experience with UOIS
2. Read the Spec: Understand the technical details
3. Join the Community: Connect with other implementers
4. Start Building: Implement UOIS in your systems

The future of commerce is AI-enabled, and it starts with open standards. Welcome to UOIS!