DocumentationProduct Catalog & Inventory

Product Catalog & Inventory

5 minLast updated: 2026-03-31

Creating a Catalog

A product catalog is the container for all your products. Each catalog has a name, optional description, and currency. Create one via the dashboard or API:

POST /api/v1/commerce/catalogs
{
  "name": "PetCenter Serbia",
  "description": "Pet food and accessories",
  "currency": "RSD"
}

A catalog belongs to a group. Multi-country setups use one catalog per country with the local currency.

Adding Products

Each product includes:

  • name: Product name
  • sku: Unique stock-keeping unit identifier
  • price: Base price in the catalog's currency
  • variants: JSON array of options (size, color, flavor, etc.)
  • images: Array of image URLs
  • description: Product description (used by AI shopping assistant)
  • status: active, draft, or archived
POST /api/v1/commerce/catalogs/:catalogId/products
{
  "name": "Premium Dog Food",
  "sku": "PDF-001",
  "price": 2450,
  "variants": [
    { "name": "size", "options": ["2kg", "5kg", "10kg"] }
  ],
  "images": ["https://..."],
  "description": "High-protein dry food for adult dogs"
}

Inventory Management

Inventory uses atomic operations (SELECT...FOR UPDATE) to prevent overselling:

  • Set inventory: Set absolute stock quantity for a product
  • Adjust inventory: Increment or decrement stock (positive/negative delta)
  • Check inventory: Get current stock level
  • Transfer: Move stock between locations/warehouses
POST /api/v1/commerce/inventory/adjust
{
  "product_id": 123,
  "delta": -5,
  "reason": "Manual adjustment"
}

Low Stock Alerts & CSV Import

Configure low stock thresholds per product. When inventory drops below the threshold, a low_stock workflow trigger fires. You can also bulk-import products via CSV with columns: name, sku, price, description, quantity.

Was this article helpful?