Files
dashback/docs/api/routes/supplier/articles.get.md
2026-10-16 18:04:42 +02:00

1.7 KiB

GET /supplier/{id}/articles

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

List supplier articles by SKUs

Lists article-supplier assignments for the specified supplier (entity ID), optionally filtered by a list of SKUs (matching either article SKU or supplier SKU). Includes linked article details (name, slug, photos, eans).

Path parameters

Param Required Type Description
id yes integer Supplier entity ID

Query parameters

Param Required Type Description
skus no string Optional SKU or comma-separated SKUs to filter by

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
      },
      "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.