# Products & Inventory {#products--inventory}


Product catalog, variants, pricing, and warehouse management.


## Overview {#overview}


The Products module provides a complete inventory management system with multi-variant support, warehousing, and merchant configuration.


## Core Entities {#core-entities}



### Product {#product}


| Field         | Type             | Description         |
| ------------- | ---------------- | ------------------- |
| `name`        | string           | Product name        |
| `code`        | string           | SKU / product code  |
| `description` | string           | Product description |
| `enabled`     | boolean          | Active/inactive     |
| `categoryId`  | UUID             | Product category    |
| `typeId`      | UUID             | Product type        |
| `imageUrl`    | string           | Primary image       |
| `variants`    | ProductVariant[] | Size/color variants |


### Product Variant {#product-variant}


| Field                    | Type            | Description           |
| ------------------------ | --------------- | --------------------- |
| `quantity`               | number          | Stock quantity        |
| `billingInvoicingPolicy` | enum            | Ordered / Delivered   |
| `internalReference`      | string          | Internal SKU          |
| `enabled`                | boolean         | Variant active        |
| `prices`                 | VariantPrice[]  | Multi-currency prices |
| `options`                | ProductOption[] | Variant attributes    |


### Product Category {#product-category}


Hierarchical categorization:

```
Electronics
  ├── Laptops
  │     ├── Gaming
  │     └── Business
  └── Accessories
        ├── Keyboards
        └── Monitors
```


### Warehouse {#warehouse}


| Field      | Type               | Description      |
| ---------- | ------------------ | ---------------- |
| `name`     | string             | Warehouse name   |
| `code`     | string             | Warehouse code   |
| `active`   | boolean            | Active status    |
| `contact`  | Contact            | Location/address |
| `products` | WarehouseProduct[] | Stocked products |


## Pricing {#pricing}


Multi-currency variant pricing:

| Field                 | Type   | Description     |
| --------------------- | ------ | --------------- |
| `unitCost`            | number | Cost price      |
| `unitCostCurrency`    | string | Cost currency   |
| `retailPrice`         | number | Retail price    |
| `retailPriceCurrency` | string | Retail currency |


## Merchant Configuration {#merchant-configuration}


| Field        | Description           |
| ------------ | --------------------- |
| `name`       | Merchant/store name   |
| `logo`       | Store logo            |
| `currency`   | Default currency      |
| `contact`    | Store contact info    |
| `warehouses` | Associated warehouses |


## API Endpoints {#api-endpoints}


```bash
# Products
GET    /api/products
POST   /api/products
PUT    /api/products/:id
DELETE /api/products/:id

# Categories
GET    /api/product-categories
POST   /api/product-categories

# Variants
GET    /api/product-variants
POST   /api/product-variants

# Warehouses
GET    /api/warehouses
POST   /api/warehouses
PUT    /api/warehouses/:id
```


## Related Pages {#related-pages}


- [HRM Features](https://sourcey-gauzy.pages.dev/features/hrm-overview/index.md)
- [Equipment Management](https://sourcey-gauzy.pages.dev/features/equipment-management/index.md)