Files
dashback/docs/api/routes/supplier/articles.post.md
2026-10-19 02:28:17 +02:00

1.9 KiB

POST /supplier/{id}/articles

Protected. Requires a valid session cookie (credentials: 'include').

Query supplier articles by SKUs (bulk)

Queries article-supplier assignments for the specified supplier (entity ID) with a JSON list of SKUs in the request body, avoiding URL length limits for large SKU lists. Includes linked article details (name, slug, photos, eans).

Path parameters

Param Required Type Description
id yes integer Supplier entity ID

Body (JSON) — optional

Field Required Type Description
skus no string[] List of SKUs to filter by (empty array returns empty list)
{
  "skus": [
    "SKU-1",
    "SKU-2"
  ]
}

Response 200

List of supplier articles

{
  "articles": [
    {
      "id": 1,
      "articleId": 1,
      "entityId": 1,
      "supplierName": "…",
      "sku": "…",
      "pu": 1,
      "stock": 1,
      "sort": 1,
      "priceId": 1,
      "price": {
        "net": 1,
        "taxId": 1,
        "taxRate": 1
      },
      "incoming": [
        {
          "date": "2026-08-10T00:00:00.000Z",
          "amount": 1
        }
      ],
      "article": {
        "id": 1,
        "sku": "…",
        "name": "…",
        "slug": "…",
        "photos": [
          {
            "sort": 1,
            "fullHash": "…",
            "thumbW": 1,
            "thumbH": 1,
            "thumbHash": "…"
          }
        ],
        "eans": [
          "…"
        ]
      }
    }
  ]
}

Errors

Status Description
400 No company selected or invalid id — {"error":"…"}
401 Unauthorized — {"error":"…"}
403 Not authorized — {"error":"…"}
404 Supplier or company not found — {"error":"…"}

Generated from @openapi JSDoc. Do not edit by hand — run npm run docs:api.