multipart

docs/api/openapi.json

@@ -4480,7 +4480,7 @@
                   },
                   "files": {
                     "type": "array",
-                    "description": "Attached documents (pdf or txt) stored with the delivery\nand returned in `files` on every delivery response.\n",
+                    "description": "Attached documents (pdf or txt) stored with the delivery\nand returned in `files` on every delivery response.\nThumbnails (AVIF) are generated server-side.\n",
                     "items": {
                       "$ref": "#/components/schemas/DeliveryFileInput"
                     }
@@ -4509,6 +4509,28 @@
                   ]
                 }
               }
+            },
+            "multipart/form-data": {
+              "schema": {
+                "type": "object",
+                "required": [
+                  "data"
+                ],
+                "properties": {
+                  "data": {
+                    "type": "string",
+                    "description": "JSON string containing manifest header and line items ({ externalNumber, date, supplierId, lines, filesMeta? }).\n"
+                  },
+                  "files": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "format": "binary"
+                    },
+                    "description": "Raw binary PDF or text files attached natively via standard HTTP multipart upload."
+                  }
+                }
+              }
             }
           }
         },
@@ -4702,7 +4724,7 @@
                   },
                   "files": {
                     "type": "array",
-                    "description": "Appends attachments (pdf or txt) to the delivery.\nOmit to leave existing files unchanged.\n",
+                    "description": "Appends attachments (pdf or txt) to the delivery.\nOmit to leave existing files unchanged.\nThumbnails (AVIF) are generated server-side.\n",
                     "items": {
                       "$ref": "#/components/schemas/DeliveryFileInput"
                     }
@@ -4713,6 +4735,25 @@
                   "lines": []
                 }
               }
+            },
+            "multipart/form-data": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "data": {
+                    "type": "string",
+                    "description": "JSON string containing patch fields ({ externalNumber, date, supplierId, lines, filesMeta? }).\n"
+                  },
+                  "files": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "format": "binary"
+                    },
+                    "description": "Raw binary PDF or text files to append to the delivery."
+                  }
+                }
+              }
             }
           }
         },
@@ -10047,7 +10088,7 @@
       },
       "DeliveryFile": {
         "type": "object",
-        "description": "Attachment metadata (binary content is served via the attachment content endpoints)",
+        "description": "Attachment metadata (binary content is served via the attachment content endpoints). Thumbnails (AVIF) are generated server-side.",
         "required": [
           "id",
           "manifestId",
@@ -10097,7 +10138,8 @@
           "thumbavif": {
             "type": "string",
             "format": "byte",
-            "nullable": true
+            "nullable": true,
+            "description": "Base64-encoded AVIF thumbnail generated server-side (null for text files)"
           },
           "thumbx": {
             "type": "integer",
@@ -10124,7 +10166,7 @@
           "name",
           "content"
         ],
-        "description": "Attachment input. Only application/pdf and text/plain are accepted.",
+        "description": "Attachment input. Only application/pdf and text/plain are accepted. Thumbnails are generated server-side and must not be supplied by the client.",
         "properties": {
           "mimetype": {
             "type": "string",

docs/api/routes/delivery/create.md

@@ -38,6 +38,14 @@ The manifest `number` is allocated automatically via
 }
 ```
 
+## Body (`multipart/form-data`)
+
+| Field | Required | Type | Description |
+|-------|----------|------|-------------|
+| `data` | yes | string | JSON string containing manifest header and line items ({ externalNumber, date, supplierId, lines, filesMeta? }).
+ |
+| `files` | no | file | Raw binary PDF or text files attached natively via standard HTTP multipart upload. |
+
 ## Response `201`
 
 Created delivery

docs/api/routes/delivery/update.md

@@ -25,6 +25,14 @@ replaces all lines; if omitted, leaves lines unchanged.
 }
 ```
 
+## Body (`multipart/form-data`)
+
+| Field | Required | Type | Description |
+|-------|----------|------|-------------|
+| `data` | no | string | JSON string containing patch fields ({ externalNumber, date, supplierId, lines, filesMeta? }).
+ |
+| `files` | no | file | Raw binary PDF or text files to append to the delivery. |
+
 ## Response `200`
 
 Updated delivery