​

DataFactory Testing API

DataFactory is MasonHub’s powerful testing and simulation utility that allows you to trigger various OMS actions and callbacks in the sandbox environment. This comprehensive tool helps you test integration workflows, simulate real-world scenarios, and validate your system behavior before production deployment.

​

Overview

DataFactory provides comprehensive testing capabilities:

​

Inventory Operations

​

Create Available Inventory

Simulate inventory receipts and additions for testing purposes.

This operation will:

• Add inventory in ‘available’ status
• Trigger skuInventoryChange callbacks
• Update total available-to-sell quantities

​

Simulate Inventory Loss

Simulate inventory adjustments for damaged, lost, or spoiled items.

​

Order Fulfillment Simulation

​

Ship Orders

Simulate order shipments to test fulfillment workflows and callbacks.

• Basic Shipment
• Multi-Shipment with Shorts

​

Callback Testing

​

Trigger Specific Callbacks

```json Response
{
  "orders_processed": 1,
  "shipments_created": 2,
  "callbacks_triggered": [
    "orderEvent"
  ],
  "shipment_details": [
    {
      "shipment_id": "test-ship-001",
      "tracking_number": "1Z999AA1234567890",
      "line_items": [
        {
          "sku_customer_id": "sku-003",
          "quantity": 2
        }
      ]
    }
  ]
}

​

Parameters

​

Delivery Events

​

Available Events

​

Order Management Operations

​

Resolve Update Requests

​

Resolve Cancel Requests

POST /data_factory/resolveOrderCancel

[
  {
    "order_cancel_request_id": "1c855f3a-f779-5597-9eed-93639c6eb0ee",
    "resolution": "success",
    "refund_amount": 99.99,
    "refund_method": "original_payment"
  }
]

​

Inbound Shipment Simulation

​

Receiving Events

​

Event Types

• Arrival Events
• Randomization Options

​

Randomized Status Distribution

When randomize_inventory_statuses is enabled:

​

Returns Management (RMA)

​

RMA Processing Events

​

RMA Event Types

​

Testing Workflows

​

Basic Integration Test

// Create SKUs with inventory
POST /data_factory/createAvailable
[{"sku_id": "test-sku-001", "quantity": 100}]

// Create orders via standard API
POST /orders
[{"customer_identifier": "test-order-001", ...}]

// Ship the orders
POST /data_factory/shipOrder
[{"order_customer_id": "test-order-001"}]

​

Advanced Scenario Testing

​

Callback Validation

​

Expected Callback Events

DataFactory operations trigger production-equivalent callbacks:

​

Callback Testing Strategy

• Webhook Validation
• Error Handling

// Test webhook handler
const testWebhook = async (eventType, testData) => {
  // Trigger DataFactory event
  await triggerDataFactoryEvent(eventType, testData);
  
  // Wait for callback
  const callback = await waitForCallback(eventType, 30000);
  
  // Validate payload
  expect(callback.message_type).toBe(eventType);
  expect(callback.data).toBeDefined();
  
  // Verify business logic
  await verifyBusinessLogic(callback.data);
};

​

Performance Testing

​

Load Testing with DataFactory

​

Best Practices

​

Test Data Management

​

Integration Testing Strategy

1. Start Simple: Begin with basic CRUD operations
2. Add Complexity: Gradually introduce complex scenarios
3. Test Edge Cases: Validate error conditions and edge cases
4. Performance Testing: Test with realistic data volumes
5. End-to-End Validation: Test complete business workflows

​

Limitations & Considerations

• Rate Limits: Standard API rate limits apply to DataFactory operations
• State Consistency: Maintains sandbox state consistency but may not match production patterns
• Timing: Events are triggered immediately, not following real-world timing patterns

​

Next Steps

After using DataFactory for testing, explore:

• Callback Configuration for webhook setup
• Authentication for security testing
• Order Management for production order handling