1.9 KiB
1.9 KiB
POST /article/{sku}/supplier
Protected. Requires a valid session cookie (credentials: 'include').
Assign supplier to article
Assigns a supplier to an article with optional purchase price, stock, and supplier SKU.
Path parameters
| Param | Required | Type | Description |
|---|---|---|---|
sku |
yes | string | Article SKU |
Body (JSON)
| Field | Required | Type | Description |
|---|---|---|---|
entityId |
yes | integer | Supplier entity ID (in Lieferanten group) |
sku |
no | string | Supplier's item number |
pu |
no | number | Packaging unit (VPE) |
stock |
no | number | Supplier stock |
sort |
no | integer | Display sort order (defaults to next sort) |
netPrice |
no | number | Net purchase price |
taxId |
no | integer | Tax ID for purchase price |
taxRate |
no | number | Tax rate in percent |
{
"entityId": 88,
"sku": "MET-44910",
"pu": 1,
"stock": 140,
"sort": 0,
"netPrice": 4.2,
"taxId": 1
}
Signals
On success, emits SSE signal: article-<sku> (see GET /events).
Response 201
Created supplier assignment
{
"supplier": {
"id": 1,
"articleId": 1,
"entityId": 1,
"supplierName": "…",
"sku": "…",
"pu": 1,
"stock": 1,
"sort": 1,
"priceId": 1,
"price": {
"net": 1,
"taxId": 1,
"taxRate": 1
}
}
}
Errors
| Status | Description |
|---|---|
| 400 | entityId required, invalid pu, invalid stock, invalid price, or no company selected — {"error":"…"} |
| 401 | Unauthorized — {"error":"…"} |
| 403 | Not authorized — {"error":"…"} |
| 404 | Article, supplier, or company not found — {"error":"…"} |
| 409 | Supplier already assigned — {"error":"…"} |
Generated from @openapi JSDoc. Do not edit by hand — run npm run docs:api.