Endpoints
| Method | Path | Description |
|---|---|---|
GET | /api/v1/supplier/products | List supplier products, optionally filtered by supplierId |
GET | /api/v1/supplier/products/{id} | Get a single supplier product |
POST | /api/v1/supplier/products | Create a new supplier product |
PATCH | /api/v1/supplier/products/{id} | Partially update a supplier product |
DELETE | /api/v1/supplier/products/{id} | Delete a supplier product |
GET /api/v1/supplier/products
| Query parameter | Type | Required | Description |
|---|---|---|---|
supplierId | uuid | — | Filter products that belong to one specific supplier |
Shell
curl "{{BASE_URL}}/api/v1/supplier/products?supplierId=3f2b9a1c-…"
Response 200 OK — JSON array of SupplierProductDto.
POST /api/v1/supplier/products
Request body (CreateSupplierProductDto)
| Field | Type | Required | Description |
|---|---|---|---|
supplierId | uuid | ✅ | Supplier this item belongs to |
name | string | ✅ | Product name |
code | string | — | Supplier SKU / article code |
description | string | — | Description |
unitOfMeasure | enum | ✅ | One of KG, G, T, L, ML, M3, M, CM, MM, M2, PCS, ROLL, BOX, PALLET |
unitPrice | string (decimal) | — | Unit price — use a string to preserve precision |
currency | string | — | ISO 4217 currency code (e.g. EUR) |
active | boolean | — | Whether the product is currently offered |
Shell
curl -X POST {{BASE_URL}}/api/v1/supplier/products \-H "Content-Type: application/json" \-d '{"supplierId": "3f2b9a1c-…","name": "Organic Cotton Yarn 30/1","code": "SUP-YRN-030","unitOfMeasure": "KG","unitPrice": "12.50","currency": "EUR","active": true}'
Response 201 Created — SupplierProductDto.
GET /api/v1/supplier/products/{id}
200 OK—SupplierProductDto.404 Not Found— product does not exist in your tenant.
PATCH /api/v1/supplier/products/{id}
Partial update. Fields allowed: name, code, description, unitOfMeasure, unitPrice, currency, active.
DELETE /api/v1/supplier/products/{id}
204 No Content— deleted.404 Not Found— product does not exist in your tenant.
Supplier product schema
SupplierProductDto:
JSON
{"id": "a1c3…","supplierId": "3f2b9a1c-…","name": "Organic Cotton Yarn 30/1","code": "SUP-YRN-030","description": null,"unitOfMeasure": "KG","unitPrice": "12.50","currency": "EUR","active": true,"createdAt": "2026-04-21T10:00:00.000Z","updatedAt": "2026-04-21T10:00:00.000Z"}