Files
dashback/docs/api/routes/supplier/articles.post.md

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/articlepic, eans/articleean).

Path parameters

Param Required Type Description
id yes integer Supplier entity ID

Body (JSON)

{
  "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
      },
      "article": {
        "id": 1,
        "sku": "…",
        "name": "…",
        "slug": "…",
        "photos": [
          {
            "sort": 1,
            "thumbhash": "…",
            "hash": "…",
            "thumbw": 1,
            "thumbh": 1
          }
        ],
        "articlepic": [
          {
            "sort": 1,
            "thumbhash": "…",
            "hash": "…",
            "thumbw": 1,
            "thumbh": 1
          }
        ],
        "eans": [
          "…"
        ],
        "articleean": [
          "…"
        ]
      }
    }
  ]
}

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.