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, orarchived
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.