u

src/api/openapi.js

@@ -50,6 +50,13 @@
  *           type: number
  *         reducedtaxrate:
  *           type: number
+ *     SuccessResponse:
+ *       type: object
+ *       required: [ok]
+ *       properties:
+ *         ok:
+ *           type: boolean
+ *           example: true
  *     CompanySetting:
  *       type: object
  *       required: [key, value]
@@ -73,14 +80,18 @@
  *           type: string
  *     Unit:
  *       type: object
+ *       description: Measurement unit with conversion factor to base SI unit (e.g. g -> kg, ml -> l)
  *       required: [si, basesi, basesifactor]
  *       properties:
  *         si:
  *           type: string
+ *           description: Unit code identifier (e.g. "g", "kg", "ml", "l", "stk")
  *         basesi:
  *           type: string
+ *           description: Base SI reference unit (e.g. "kg" for mass, "l" or "m3" for volume, "stk" for counts)
  *         basesifactor:
  *           type: number
+ *           description: Conversion factor to base SI (1 si = basesifactor * basesi; e.g. 0.001 for g -> kg)
  *         symbol:
  *           type: string
  *           nullable: true
@@ -130,9 +141,11 @@
  *         unitamount:
  *           type: number
  *           nullable: true
+ *           description: Net package content quantity measured in article unit (e.g. 500 for 500g, 0.75 for 0.75l)
  *         weight:
  *           type: number
  *           nullable: true
+ *           description: Shipping weight in kg (must be >= 0)
  *         unit:
  *           $ref: '#/components/schemas/Unit'
  *         brand:
@@ -353,6 +366,7 @@
  *           type: array
  *           description: Brand pictures sorted by sort
  *           items:
+ *             $ref: '#/components/schemas/BrandPic'
  *     ArticleBrand:
  *       type: object
  *       required: [name]