Add delivery and supplier HTTP APIs with expanded response docs.

Wire store-backed CRUD for goods receipts and suppliers, and teach the API doc generator to expand $ref/allOf/array samples so route markdown shows full JSON shapes.

docs/api/routes/delivery/create.md

@@ -0,0 +1,70 @@
+# `POST /delivery`
+
+Protected. Requires a valid session cookie (`credentials: 'include'`).
+
+Create delivery
+
+Creates a goods receipt with header and lines in one transaction.
+Each line requires `sku`, `amount`, `net`, and `tax` (rate).
+`rebate` defaults to `0`; `transactedAmount` defaults to `amount`.
+
+
+## Body (JSON)
+
+```json
+{
+  "number": "DHL-123",
+  "date": "2026-08-10",
+  "supplierId": 1,
+  "lines": [
+    {
+      "sku": "1",
+      "amount": 10,
+      "net": 99.5,
+      "tax": 19
+    }
+  ]
+}
+```
+
+## Response `201`
+
+Created delivery
+
+```json
+{
+  "delivery": {
+    "id": 1,
+    "number": "…",
+    "type": "delivery",
+    "supplierId": 1,
+    "date": "2026-08-10T00:00:00.000Z",
+    "lines": [
+      {
+        "id": 1,
+        "articleId": 1,
+        "sku": "…",
+        "amount": 1,
+        "net": 1,
+        "transactedAmount": 1,
+        "rebate": 1,
+        "tax": 1,
+        "comment": "…"
+      }
+    ]
+  }
+}
+```
+
+## Errors
+
+| Status | Description |
+|--------|-------------|
+| 400 | Invalid delivery, invalid lines, or no company selected — `{"error":"…"}` |
+| 401 | Unauthorized — `{"error":"…"}` |
+| 403 | Not authorized — `{"error":"…"}` |
+| 404 | Company, supplier, or article not found — `{"error":"…"}` |
+
+---
+
+_Generated from `@openapi` JSDoc. Do not edit by hand — run `npm run docs:api`._