​

Catalog Management API

The Catalog API manages SKUs (Stock Keeping Units), which are the primary catalog items in the MasonHub system. SKUs provide comprehensive product information and support complex scenarios like kits, multiple barcodes, and special handling requirements.

​

Core Endpoints

​

Get SKUs

Retrieve SKUs with filtering and pagination support.

| limit | integer | Number of results [1..100] | 30 | | offset | integer | Pagination offset | 0 | | include_counts | boolean | Include inventory counts (detail only) | false |

​

Create SKUs

Create one or more SKUs in the catalog system.

​

Required Fields

​

Update SKUs

PUT /skus
Authorization: Bearer your_jwt_token
Content-Type: application/json

[
  {
    "customer_identifier": "pants4523",
    "customer_bar_code": "2345687902",
    // ... all other fields
    "price": 180  // Updated price
  }
]

​

Delete SKUs

DELETE /skus
Authorization: Bearer your_jwt_token
Content-Type: application/json

[
  {
    "customer_identifier": "pants4523"
  },
  {
    "customer_identifier": "shirts450293" 
  }
]

​

Advanced Features

​

Kit SKUs

MasonHub supports complex kit configurations for bundled products:

• Pre-built Kits
• Kit-to-Ship

​

Kit SKU Example

{
  "customer_identifier": "kit00001",
  "customer_bar_code": "1234567890",
  "brand_name": "Freddie's",
  "product_name": "Shirt and Pants Combo",
  "product_category": "Apparel",
  "product_description": "Complete outfit kit",
  "is_kit": true,
  "kit_skus": [
    {
      "customer_identifier": "shirt-001",
      "quantity": 1
    },
    {
      "customer_identifier": "pants-001", 
      "quantity": 1
    }
  ],
  "dim_weight": 1.25,
  "dim_length": 12,
  "dim_width": 10,
  "dim_height": 3
}

​

Pick Strategies

Control how inventory is allocated using pick strategies:

​

Barcode Management

SKUs support comprehensive barcode management:

{
  "bar_codes": [
    "85962198623",
    "3459189485324", 
    "UPC123456789"
  ]
}

​

Data Validation

​

Required Field Validation

Common validation errors:

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Required field missing",
    "details": {
      "field": "customer_identifier",
      "value": null
    }
  }
}

​

Unique Constraints

​

Best Practices

​

SKU Creation

​

Performance Optimization

1. Use Summary Lists: Start with list_type=summary for browsing
2. Specific Queries: Filter by cid array for targeted retrieval
3. Appropriate Limits: Use reasonable limit values to avoid timeouts
4. Include Counts Sparingly: Only use include_counts=true when needed

​

Error Handling

Common error scenarios and solutions:

​

Next Steps

After setting up your catalog, proceed to:

• Inventory Management for stock tracking
• Order Management for order processing
• Inbound Shipments for receiving inventory