Files
dashback/docs/api/routes/article/set-eans.md
2026-10-08 12:59:14 +02:00

2.3 KiB

PUT /article/{sku}/eans

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

Replace article EANs by SKU

Replace-all EANs for the article. EANs must be non-empty unique strings; empty array clears all EANs. Returns the same shape as GET by SKU.

Path parameters

Param Required Type Description
sku yes string

Body (JSON)

Field Required Type Description
eans yes string[]
{
  "eans": [
    "4001234567890"
  ]
}

Signals

On success, emits SSE signal: article-<sku> (see GET /events).

Response 200

Updated article detail

{
  "article": {
    "id": 1,
    "sku": "…",
    "name": "…",
    "slug": "…",
    "desc": "…",
    "seo": "…",
    "track_stock": true,
    "unitamount": 1,
    "weight": 1,
    "unit": {
      "si": "…",
      "basesi": "…",
      "basesifactor": 1,
      "symbol": "…",
      "name": "…"
    },
    "brand": {
      "id": 1,
      "name": "…",
      "fullHash": "…",
      "thumbW": 1,
      "thumbH": 1,
      "thumbHash": "…"
    },
    "categoryIds": [
      1
    ],
    "photos": [
      {
        "sort": 1,
        "fullHash": "…",
        "fullW": 1,
        "fullH": 1,
        "fullSize": 1,
        "thumbW": 1,
        "thumbH": 1,
        "thumbHash": "…"
      }
    ],
    "eans": [
      "…"
    ],
    "prices": [
      {
        "minmultiplier": 1,
        "net": 1,
        "taxRate": 1,
        "customergroupId": 1
      }
    ],
    "suppliers": [
      {
        "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 Invalid eans — {"error":"…"}
401 Unauthorized — {"error":"…"}
403 Not authorized — {"error":"…"}
404 Article not found — {"error":"…"}
409 EAN already in use — {"error":"…"}

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