Files
dashback/docs/api/routes/article/supplier/create.md

1.4 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)

{
  "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.