u

src/api/routes/article.js

@@ -717,12 +717,14 @@ export function register(app, basePath = '') {
      * /article/{sku}/prices:
      *   put:
      *     tags: [Article]
-     *     summary: Replace POS prices by SKU
+     *     summary: Replace POS prices by SKU (net > gross; price=net, tax=taxRate %)
      *     description: |
      *       Replace-all prices for the company POS customer group.
-     *       Each entry accepts `net` OR `gross` price (or legacy `price`), `taxRate` OR `tax` (percentage, e.g. 19 for 19%, ensured via tax.ensure), optional `minmultiplier` (default 1).
+     *       `net` takes precedence over `price` (legacy alias for net) and `gross`.
+     *       `tax` and `taxRate` both specify the tax rate percentage (e.g. 19 for 19%), not monetary tax.
      *       When `gross` is provided, net price is computed as `gross / (1 + taxRate / 100)`.
-     *       Empty `prices` clears all POS prices. Returns the same shape as GET by SKU (article `prices` array contains `{ minmultiplier, net, taxRate, customergroupId }`).
+     *       Prices are strictly scoped to the company's designated POS customer group (customergroupId returned on GET).
+     *       Empty `prices` clears all POS prices. Returns the same shape as GET by SKU.
      *     security:
      *       - cookieAuth: []
      *     x-signals: [article-<sku>]
@@ -1199,7 +1201,7 @@ export function register(app, basePath = '') {
      * /article/{sku}/brand:
      *   put:
      *     tags: [Article]
-     *     summary: Set or clear article brand by SKU
+     *     summary: Set or clear article brand by SKU (null to clear)
      *     description: |
      *       Sets the article's `brandId` (must belong to the article's company).
      *       Pass `null` to clear the brand. Returns the same shape as GET by SKU.
@@ -1224,6 +1226,7 @@ export function register(app, basePath = '') {
      *               brandId:
      *                 type: integer
      *                 nullable: true
+     *                 description: Brand ID to assign, or null to remove the brand
      *             example:
      *               brandId: 3
      *     responses:
@@ -1585,6 +1588,15 @@ export function register(app, basePath = '') {
      *     responses:
      *       200:
      *         description: Print job dispatched
+     *         content:
+     *           application/json:
+     *             schema:
+     *               type: object
+     *               required: [success]
+     *               properties:
+     *                 success:
+     *                   type: boolean
+     *                   example: true
      *       400:
      *         description: Invalid parameters
      *       404:

src/api/routes/articleproperty.js

@@ -178,6 +178,10 @@ export function register(app, basePath = '') {
      *     responses:
      *       200:
      *         description: Deleted successfully
+     *         content:
+     *           application/json:
+     *             schema:
+     *               $ref: '#/components/schemas/SuccessResponse'
      */
     app.delete(`${basePath}/article/:sku/property/:propertyId`, async (req, res) => {
         const selected = requireSelectedCompany(req);

src/api/routes/attributename.js

@@ -133,6 +133,10 @@ export function register(app, basePath = '') {
      *     responses:
      *       200:
      *         description: Reordered successfully
+     *         content:
+     *           application/json:
+     *             schema:
+     *               $ref: '#/components/schemas/SuccessResponse'
      */
     app.put(`${basePath}/attributename/order`, async (req, res) => {
         const selected = requireSelectedCompany(req);
@@ -202,6 +206,10 @@ export function register(app, basePath = '') {
      *     responses:
      *       200:
      *         description: Deleted successfully
+     *         content:
+     *           application/json:
+     *             schema:
+     *               $ref: '#/components/schemas/SuccessResponse'
      *       400:
      *         description: Bad request or no company selected
      *         content:

src/api/routes/attributevalue.js

@@ -150,6 +150,10 @@ export function register(app, basePath = '') {
      *     responses:
      *       200:
      *         description: Reordered successfully
+     *         content:
+     *           application/json:
+     *             schema:
+     *               $ref: '#/components/schemas/SuccessResponse'
      */
     app.put(`${basePath}/attributename/:attributeId/value/order`, async (req, res) => {
         const selected = requireSelectedCompany(req);
@@ -218,6 +222,10 @@ export function register(app, basePath = '') {
      *     responses:
      *       200:
      *         description: Deleted successfully
+     *         content:
+     *           application/json:
+     *             schema:
+     *               $ref: '#/components/schemas/SuccessResponse'
      *       400:
      *         description: Bad request or no company selected
      *         content:

src/api/routes/categoryproperty.js

@@ -180,6 +180,10 @@ export function register(app, basePath = '') {
      *     responses:
      *       200:
      *         description: Deleted successfully
+     *         content:
+     *           application/json:
+     *             schema:
+     *               $ref: '#/components/schemas/SuccessResponse'
      */
     app.delete(`${basePath}/category/:id/property/:propertyId`, async (req, res) => {
         const selected = requireSelectedCompany(req);

src/api/routes/propertyname.js

@@ -145,6 +145,10 @@ export function register(app, basePath = '') {
      *     responses:
      *       200:
      *         description: Reordered successfully
+     *         content:
+     *           application/json:
+     *             schema:
+     *               $ref: '#/components/schemas/SuccessResponse'
      *       400:
      *         description: Bad request
      */
@@ -216,6 +220,10 @@ export function register(app, basePath = '') {
      *     responses:
      *       200:
      *         description: Deleted successfully
+     *         content:
+     *           application/json:
+     *             schema:
+     *               $ref: '#/components/schemas/SuccessResponse'
      *       400:
      *         description: Bad request or no company selected
      *         content: