This commit is contained in:
seb
2026-09-17 11:46:22 +02:00
parent ab6d018a1f
commit 49efd5f8a1
23 changed files with 1384 additions and 79 deletions

View File

@@ -43,6 +43,10 @@ Generated from `@openapi` annotations in [`src/api/routes/`](../../src/api/route
| [`routes/article/delete-image.md`](routes/article/delete-image.md) | `DELETE /article/{sku}/image/{fullHash}` |
| [`routes/article/order-images.md`](routes/article/order-images.md) | `PUT /article/{sku}/images/order` |
| [`routes/article/set-prices.md`](routes/article/set-prices.md) | `PUT /article/{sku}/prices` |
| [`routes/article/supplier/list.md`](routes/article/supplier/list.md) | `GET /article/{sku}/supplier` |
| [`routes/article/supplier/create.md`](routes/article/supplier/create.md) | `POST /article/{sku}/supplier` |
| [`routes/article/supplier/delete.md`](routes/article/supplier/delete.md) | `DELETE /article/{sku}/supplier/{id}` |
| [`routes/article/supplier/update.md`](routes/article/supplier/update.md) | `PATCH /article/{sku}/supplier/{id}` |
| [`routes/article/set-weight.md`](routes/article/set-weight.md) | `PUT /article/{sku}/weight` |
| [`routes/articleIndex.md`](routes/articleIndex.md) | `GET /articleIndex` |
| [`routes/auth/login.md`](routes/auth/login.md) | `POST /auth/login` |
@@ -132,7 +136,7 @@ Clients subscribe via [`GET /events`](routes/events.md) (`text/event-stream`). A
| Signal | Emitted by |
|--------|------------|
| `article-<sku>` | `PUT /article/{sku}/brand`, `PUT /article/{sku}/categories`, `PUT /article/{sku}/eans`, `POST /article/{sku}/image`, `DELETE /article/{sku}/image/{fullHash}`, `PUT /article/{sku}/images/order`, `PUT /article/{sku}/prices`, `PUT /article/{sku}/weight` |
| `article-<sku>` | `PUT /article/{sku}/brand`, `PUT /article/{sku}/categories`, `PUT /article/{sku}/eans`, `POST /article/{sku}/image`, `DELETE /article/{sku}/image/{fullHash}`, `PUT /article/{sku}/images/order`, `PUT /article/{sku}/prices`, `POST /article/{sku}/supplier`, `DELETE /article/{sku}/supplier/{id}`, `PATCH /article/{sku}/supplier/{id}`, `PUT /article/{sku}/weight` |
| `articles` | `POST /article`, `DELETE /article/{sku}`, `PATCH /article/{sku}` |
| `category` | `POST /category`, `PUT /category/order`, `DELETE /category/{id}`, `PATCH /category/{id}`, `DELETE /category/{id}/image`, `POST /category/{id}/image` |

View File

@@ -762,7 +762,7 @@
"Quote"
],
"summary": "Create quote",
"description": "Creates a quote with header and lines in one transaction.\n`date` is the document date (valid-until).\n`entityId` must be a company customer (not Lieferanten/POS), or null.\nEach line requires `sku` or `name`, `amount`, `net`, and `tax` (rate); `pu` defaults to `1`; `rebate` defaults to `0`.\n",
"description": "Creates a quote with header and lines in one transaction.\n`date` is the document date (valid-until).\n`entityId` must be a company customer (not Lieferanten/POS), or null.\nEach line requires `sku` or `name`, `amount`, `net`, and `taxrate` (rate); `pu` defaults to `1`; `rebate` defaults to `0`.\n",
"security": [
{
"cookieAuth": []
@@ -812,7 +812,7 @@
"pu": 1,
"amount": 10,
"net": 99.5,
"tax": 19
"taxrate": 19
}
]
}
@@ -2014,7 +2014,7 @@
"Order"
],
"summary": "Create order",
"description": "Creates a sales order with header and lines in one transaction.\n`date` is the document date (expected delivery).\n`entityId` must be a company customer (not Lieferanten/POS), or null.\nEach line requires `sku` or `name`, `amount`, `net`, and `tax` (rate); `pu` defaults to `1`; `rebate` defaults to `0`.\n",
"description": "Creates a sales order with header and lines in one transaction.\n`date` is the document date (expected delivery).\n`entityId` must be a company customer (not Lieferanten/POS), or null.\nEach line requires `sku` or `name`, `amount`, `net`, and `taxrate` (rate); `pu` defaults to `1`; `rebate` defaults to `0`.\n",
"security": [
{
"cookieAuth": []
@@ -2064,7 +2064,7 @@
"pu": 1,
"amount": 10,
"net": 99.5,
"tax": 19
"taxrate": 19
}
]
}
@@ -4227,7 +4227,7 @@
"Delivery"
],
"summary": "Create delivery",
"description": "Creates a goods receipt with header and lines in one transaction.\nThe manifest `number` is allocated automatically via\n`nextNumber('delivery')`; the user-supplied reference is stored as\n`externalNumber`. Each line requires `sku` or `name`, `amount`, `net`, and\n`tax` (rate). `pu` defaults to `1`; `rebate` defaults to `0`.\n",
"description": "Creates a goods receipt with header and lines in one transaction.\nThe manifest `number` is allocated automatically via\n`nextNumber('delivery')`; the user-supplied reference is stored as\n`externalNumber`. Each line requires `sku` or `name`, `amount`, `net`, and\n`taxrate` (rate). `pu` defaults to `1`; `rebate` defaults to `0`.\n",
"security": [
{
"cookieAuth": []
@@ -4276,7 +4276,7 @@
"pu": 1,
"amount": 10,
"net": 99.5,
"tax": 19
"taxrate": 19
}
]
}
@@ -6735,6 +6735,460 @@
}
}
},
"/article/{sku}/supplier": {
"get": {
"tags": [
"Article"
],
"summary": "List article suppliers",
"description": "Fetches all suppliers linked to the specified article SKU.",
"security": [
{
"cookieAuth": []
}
],
"x-markdown": "article/supplier/list.md",
"parameters": [
{
"in": "path",
"name": "sku",
"required": true,
"schema": {
"type": "string"
},
"description": "Article SKU"
}
],
"responses": {
"200": {
"description": "List of suppliers linked to the article",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"suppliers": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ArticleSupplier"
}
}
}
}
}
}
},
"400": {
"description": "No company selected or invalid sku",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"403": {
"description": "Not authorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"404": {
"description": "Article or company not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
}
},
"post": {
"tags": [
"Article"
],
"summary": "Assign supplier to article",
"description": "Assigns a supplier to an article with optional purchase price, stock, and supplier SKU.\n",
"security": [
{
"cookieAuth": []
}
],
"x-signals": [
"article-<sku>"
],
"x-markdown": "article/supplier/create.md",
"parameters": [
{
"in": "path",
"name": "sku",
"required": true,
"schema": {
"type": "string"
},
"description": "Article SKU"
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"entityId"
],
"properties": {
"entityId": {
"type": "integer",
"description": "Supplier entity ID (in Lieferanten group)"
},
"sku": {
"type": "string",
"nullable": true,
"description": "Supplier's item number"
},
"pu": {
"type": "number",
"default": 1,
"description": "Packaging unit (VPE)"
},
"stock": {
"type": "number",
"nullable": true,
"description": "Supplier stock"
},
"netPrice": {
"type": "number",
"nullable": true,
"description": "Net purchase price"
},
"taxId": {
"type": "integer",
"nullable": true,
"description": "Tax ID for purchase price"
},
"taxRate": {
"type": "number",
"nullable": true,
"description": "Tax rate in percent"
}
},
"example": {
"entityId": 88,
"sku": "MET-44910",
"pu": 1,
"stock": 140,
"netPrice": 4.2,
"taxId": 1
}
}
}
}
},
"responses": {
"201": {
"description": "Created supplier assignment",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"supplier": {
"$ref": "#/components/schemas/ArticleSupplier"
}
}
}
}
}
},
"400": {
"description": "entityId required, invalid pu, invalid stock, invalid price, or no company selected",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"403": {
"description": "Not authorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"404": {
"description": "Article, supplier, or company not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"409": {
"description": "Supplier already assigned",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
}
}
},
"/article/{sku}/supplier/{id}": {
"patch": {
"tags": [
"Article"
],
"summary": "Update article supplier assignment",
"description": "Updates an existing article-supplier association (supplier SKU, packaging unit, stock, purchase price).\n",
"security": [
{
"cookieAuth": []
}
],
"x-signals": [
"article-<sku>"
],
"x-markdown": "article/supplier/update.md",
"parameters": [
{
"in": "path",
"name": "sku",
"required": true,
"schema": {
"type": "string"
},
"description": "Article SKU"
},
{
"in": "path",
"name": "id",
"required": true,
"schema": {
"type": "integer"
},
"description": "articlesupplier assignment ID"
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"sku": {
"type": "string",
"nullable": true
},
"pu": {
"type": "number"
},
"stock": {
"type": "number",
"nullable": true
},
"netPrice": {
"type": "number",
"nullable": true
},
"taxId": {
"type": "integer",
"nullable": true
},
"taxRate": {
"type": "number",
"nullable": true
}
},
"example": {
"sku": "MET-44910-B",
"pu": 6,
"stock": 95,
"netPrice": 22.5
}
}
}
}
},
"responses": {
"200": {
"description": "Updated supplier assignment",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"supplier": {
"$ref": "#/components/schemas/ArticleSupplier"
}
}
}
}
}
},
"400": {
"description": "Invalid pu, invalid stock, invalid price, invalid id, or no company selected",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"403": {
"description": "Not authorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"404": {
"description": "Supplier assignment, article, or company not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
}
},
"delete": {
"tags": [
"Article"
],
"summary": "Remove supplier assignment from article",
"description": "Removes a supplier assignment from the article and cleans up its associated purchase price.\n",
"security": [
{
"cookieAuth": []
}
],
"x-signals": [
"article-<sku>"
],
"x-markdown": "article/supplier/delete.md",
"parameters": [
{
"in": "path",
"name": "sku",
"required": true,
"schema": {
"type": "string"
},
"description": "Article SKU"
},
{
"in": "path",
"name": "id",
"required": true,
"schema": {
"type": "integer"
},
"description": "articlesupplier assignment ID"
}
],
"responses": {
"204": {
"description": "Deleted"
},
"400": {
"description": "Invalid id, invalid sku, or no company selected",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"401": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"403": {
"description": "Not authorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"404": {
"description": "Supplier assignment or article not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
}
}
},
"/article": {
"post": {
"tags": [
@@ -8680,6 +9134,74 @@
}
}
},
"ArticleSupplierPrice": {
"type": "object",
"required": [
"net",
"taxId"
],
"properties": {
"net": {
"type": "number",
"description": "Net purchase price"
},
"taxId": {
"type": "integer",
"description": "Tax ID"
},
"taxRate": {
"type": "number",
"nullable": true,
"description": "Tax rate in percent"
}
}
},
"ArticleSupplier": {
"type": "object",
"required": [
"id",
"articleId",
"entityId",
"pu"
],
"properties": {
"id": {
"type": "integer"
},
"articleId": {
"type": "integer"
},
"entityId": {
"type": "integer"
},
"supplierName": {
"type": "string",
"nullable": true
},
"sku": {
"type": "string",
"nullable": true,
"description": "Supplier-specific SKU (Lieferanten-Art.-Nr.)"
},
"pu": {
"type": "number",
"description": "Packaging unit (Verpackungseinheit / VPE)"
},
"stock": {
"type": "number",
"nullable": true,
"description": "Supplier stock"
},
"priceId": {
"type": "integer",
"nullable": true
},
"price": {
"$ref": "#/components/schemas/ArticleSupplierPrice",
"nullable": true
}
}
},
"Brand": {
"type": "object",
"required": [
@@ -8952,7 +9474,7 @@
"amount",
"net",
"rebate",
"tax",
"taxrate",
"comment"
],
"properties": {
@@ -8981,9 +9503,9 @@
"rebate": {
"type": "number"
},
"tax": {
"taxrate": {
"type": "number",
"description": "tax.rate (manifestarticle.taxrate)"
"description": "Tax rate in percent (e.g. 19)"
},
"comment": {
"type": "string",
@@ -8996,7 +9518,7 @@
"required": [
"amount",
"net",
"tax"
"taxrate"
],
"description": "Line item input. Requires `sku` or `name`.",
"properties": {
@@ -9020,9 +9542,9 @@
"net": {
"type": "number"
},
"tax": {
"taxrate": {
"type": "number",
"description": "Tax rate (resolved via tax.ensure)"
"description": "Tax rate in percent (resolved via tax.ensure)"
},
"rebate": {
"type": "number",
@@ -9065,7 +9587,7 @@
"amount",
"net",
"rebate",
"tax",
"taxrate",
"comment"
],
"description": "Line shape for quote and order",
@@ -9095,9 +9617,9 @@
"rebate": {
"type": "number"
},
"tax": {
"taxrate": {
"type": "number",
"description": "tax.rate (manifestarticle.taxrate)"
"description": "Tax rate in percent (e.g. 19)"
},
"comment": {
"type": "string",
@@ -9110,7 +9632,7 @@
"required": [
"amount",
"net",
"tax"
"taxrate"
],
"description": "Line item input. Requires `sku` or `name`.",
"properties": {
@@ -9134,9 +9656,9 @@
"net": {
"type": "number"
},
"tax": {
"taxrate": {
"type": "number",
"description": "Tax rate (resolved via tax.ensure)"
"description": "Tax rate in percent (resolved via tax.ensure)"
},
"rebate": {
"type": "number",

View File

@@ -0,0 +1,69 @@
# `POST /article/{sku}/supplier`
Protected. Requires a valid session cookie (`credentials: 'include'`).
Assign supplier to article
Assigns a supplier to an article with optional purchase price, stock, and supplier SKU.
## Path parameters
| Param | Required | Type | Description |
|-------|----------|------|-------------|
| `sku` | yes | string | Article SKU |
## Body (JSON)
```json
{
"entityId": 88,
"sku": "MET-44910",
"pu": 1,
"stock": 140,
"netPrice": 4.2,
"taxId": 1
}
```
## Signals
On success, emits SSE signal: `article-<sku>` (see [`GET /events`](../events.md)).
## Response `201`
Created supplier assignment
```json
{
"supplier": {
"id": 1,
"articleId": 1,
"entityId": 1,
"supplierName": "…",
"sku": "…",
"pu": 1,
"stock": 1,
"priceId": 1,
"price": {
"net": 1,
"taxId": 1,
"taxRate": 1
}
}
}
```
## Errors
| Status | Description |
|--------|-------------|
| 400 | entityId required, invalid pu, invalid stock, invalid price, or no company selected — `{"error":"…"}` |
| 401 | Unauthorized — `{"error":"…"}` |
| 403 | Not authorized — `{"error":"…"}` |
| 404 | Article, supplier, or company not found — `{"error":"…"}` |
| 409 | Supplier already assigned — `{"error":"…"}` |
---
_Generated from `@openapi` JSDoc. Do not edit by hand — run `npm run docs:api`._

View File

@@ -0,0 +1,38 @@
# `DELETE /article/{sku}/supplier/{id}`
Protected. Requires a valid session cookie (`credentials: 'include'`).
Remove supplier assignment from article
Removes a supplier assignment from the article and cleans up its associated purchase price.
## Path parameters
| Param | Required | Type | Description |
|-------|----------|------|-------------|
| `sku` | yes | string | Article SKU |
| `id` | yes | integer | articlesupplier assignment ID |
## Signals
On success, emits SSE signal: `article-<sku>` (see [`GET /events`](../events.md)).
## Response `204`
Deleted
_No content_
## Errors
| Status | Description |
|--------|-------------|
| 400 | Invalid id, invalid sku, or no company selected — `{"error":"…"}` |
| 401 | Unauthorized — `{"error":"…"}` |
| 403 | Not authorized — `{"error":"…"}` |
| 404 | Supplier assignment or article not found — `{"error":"…"}` |
---
_Generated from `@openapi` JSDoc. Do not edit by hand — run `npm run docs:api`._

View File

@@ -0,0 +1,52 @@
# `GET /article/{sku}/supplier`
Protected. Requires a valid session cookie (`credentials: 'include'`).
List article suppliers
Fetches all suppliers linked to the specified article SKU.
## Path parameters
| Param | Required | Type | Description |
|-------|----------|------|-------------|
| `sku` | yes | string | Article SKU |
## Response `200`
List of suppliers linked to the article
```json
{
"suppliers": [
{
"id": 1,
"articleId": 1,
"entityId": 1,
"supplierName": "…",
"sku": "…",
"pu": 1,
"stock": 1,
"priceId": 1,
"price": {
"net": 1,
"taxId": 1,
"taxRate": 1
}
}
]
}
```
## Errors
| Status | Description |
|--------|-------------|
| 400 | No company selected or invalid sku — `{"error":"…"}` |
| 401 | Unauthorized — `{"error":"…"}` |
| 403 | Not authorized — `{"error":"…"}` |
| 404 | Article or company not found — `{"error":"…"}` |
---
_Generated from `@openapi` JSDoc. Do not edit by hand — run `npm run docs:api`._

View File

@@ -0,0 +1,67 @@
# `PATCH /article/{sku}/supplier/{id}`
Protected. Requires a valid session cookie (`credentials: 'include'`).
Update article supplier assignment
Updates an existing article-supplier association (supplier SKU, packaging unit, stock, purchase price).
## Path parameters
| Param | Required | Type | Description |
|-------|----------|------|-------------|
| `sku` | yes | string | Article SKU |
| `id` | yes | integer | articlesupplier assignment ID |
## Body (JSON)
```json
{
"sku": "MET-44910-B",
"pu": 6,
"stock": 95,
"netPrice": 22.5
}
```
## Signals
On success, emits SSE signal: `article-<sku>` (see [`GET /events`](../events.md)).
## Response `200`
Updated supplier assignment
```json
{
"supplier": {
"id": 1,
"articleId": 1,
"entityId": 1,
"supplierName": "…",
"sku": "…",
"pu": 1,
"stock": 1,
"priceId": 1,
"price": {
"net": 1,
"taxId": 1,
"taxRate": 1
}
}
}
```
## Errors
| Status | Description |
|--------|-------------|
| 400 | Invalid pu, invalid stock, invalid price, invalid id, or no company selected — `{"error":"…"}` |
| 401 | Unauthorized — `{"error":"…"}` |
| 403 | Not authorized — `{"error":"…"}` |
| 404 | Supplier assignment, article, or company not found — `{"error":"…"}` |
---
_Generated from `@openapi` JSDoc. Do not edit by hand — run `npm run docs:api`._

View File

@@ -8,7 +8,7 @@ Creates a goods receipt with header and lines in one transaction.
The manifest `number` is allocated automatically via
`nextNumber('delivery')`; the user-supplied reference is stored as
`externalNumber`. Each line requires `sku` or `name`, `amount`, `net`, and
`tax` (rate). `pu` defaults to `1`; `rebate` defaults to `0`.
`taxrate` (rate). `pu` defaults to `1`; `rebate` defaults to `0`.
## Body (JSON)
@@ -25,7 +25,7 @@ The manifest `number` is allocated automatically via
"pu": 1,
"amount": 10,
"net": 99.5,
"tax": 19
"taxrate": 19
}
]
}
@@ -53,7 +53,7 @@ Created delivery
"amount": 1,
"net": 1,
"rebate": 1,
"tax": 1,
"taxrate": 1,
"comment": "…"
}
]

View File

@@ -34,7 +34,7 @@ Delivery
"amount": 1,
"net": 1,
"rebate": 1,
"tax": 1,
"taxrate": 1,
"comment": "…"
}
]

View File

@@ -47,7 +47,7 @@ Updated delivery
"amount": 1,
"net": 1,
"rebate": 1,
"tax": 1,
"taxrate": 1,
"comment": "…"
}
]

View File

@@ -7,7 +7,7 @@ Create order
Creates a sales order with header and lines in one transaction.
`date` is the document date (expected delivery).
`entityId` must be a company customer (not Lieferanten/POS), or null.
Each line requires `sku` or `name`, `amount`, `net`, and `tax` (rate); `pu` defaults to `1`; `rebate` defaults to `0`.
Each line requires `sku` or `name`, `amount`, `net`, and `taxrate` (rate); `pu` defaults to `1`; `rebate` defaults to `0`.
## Body (JSON)
@@ -24,7 +24,7 @@ Each line requires `sku` or `name`, `amount`, `net`, and `tax` (rate); `pu` defa
"pu": 1,
"amount": 10,
"net": 99.5,
"tax": 19
"taxrate": 19
}
]
}
@@ -51,7 +51,7 @@ Created order
"amount": 1,
"net": 1,
"rebate": 1,
"tax": 1,
"taxrate": 1,
"comment": "…"
}
]

View File

@@ -33,7 +33,7 @@ Order
"amount": 1,
"net": 1,
"rebate": 1,
"tax": 1,
"taxrate": 1,
"comment": "…"
}
]

View File

@@ -45,7 +45,7 @@ Updated order
"amount": 1,
"net": 1,
"rebate": 1,
"tax": 1,
"taxrate": 1,
"comment": "…"
}
]

View File

@@ -7,7 +7,7 @@ Create quote
Creates a quote with header and lines in one transaction.
`date` is the document date (valid-until).
`entityId` must be a company customer (not Lieferanten/POS), or null.
Each line requires `sku` or `name`, `amount`, `net`, and `tax` (rate); `pu` defaults to `1`; `rebate` defaults to `0`.
Each line requires `sku` or `name`, `amount`, `net`, and `taxrate` (rate); `pu` defaults to `1`; `rebate` defaults to `0`.
## Body (JSON)
@@ -24,7 +24,7 @@ Each line requires `sku` or `name`, `amount`, `net`, and `tax` (rate); `pu` defa
"pu": 1,
"amount": 10,
"net": 99.5,
"tax": 19
"taxrate": 19
}
]
}
@@ -51,7 +51,7 @@ Created quote
"amount": 1,
"net": 1,
"rebate": 1,
"tax": 1,
"taxrate": 1,
"comment": "…"
}
]

View File

@@ -33,7 +33,7 @@ Quote
"amount": 1,
"net": 1,
"rebate": 1,
"tax": 1,
"taxrate": 1,
"comment": "…"
}
]

View File

@@ -45,7 +45,7 @@ Updated quote
"amount": 1,
"net": 1,
"rebate": 1,
"tax": 1,
"taxrate": 1,
"comment": "…"
}
]