file meta

src/api/openapi.js

@@ -422,12 +422,97 @@
  *       allOf:
  *         - $ref: '#/components/schemas/DeliverySummary'
  *         - type: object
- *           required: [lines]
+ *           required: [lines, files]
  *           properties:
  *             lines:
  *               type: array
  *               items:
  *                 $ref: '#/components/schemas/DeliveryLine'
+ *             files:
+ *               type: array
+ *               description: Attached documents (pdf/txt) for the delivery
+ *               items:
+ *                 $ref: '#/components/schemas/DeliveryFile'
+ *     DeliveryFile:
+ *       type: object
+ *       description: Attachment metadata (binary content is served via the attachment content endpoints)
+ *       required: [id, manifestId, fileId, sort, hash, mimetype, name, size]
+ *       properties:
+ *         id:
+ *           type: integer
+ *           description: manifestattachment id
+ *         manifestId:
+ *           type: integer
+ *         fileId:
+ *           type: integer
+ *         sort:
+ *           type: integer
+ *         hash:
+ *           type: string
+ *           description: SHA-256 of the file content
+ *         mimetype:
+ *           type: string
+ *           description: application/pdf or text/plain
+ *         name:
+ *           type: string
+ *         size:
+ *           type: integer
+ *         created:
+ *           type: string
+ *           format: date-time
+ *         modified:
+ *           type: string
+ *           format: date-time
+ *         thumbavif:
+ *           type: string
+ *           format: byte
+ *           nullable: true
+ *         thumbx:
+ *           type: integer
+ *           nullable: true
+ *         thumby:
+ *           type: integer
+ *           nullable: true
+ *         meta:
+ *           type: object
+ *           nullable: true
+ *           description: String key/value metadata from the file row
+ *           additionalProperties:
+ *             type: string
+ *     DeliveryFileInput:
+ *       type: object
+ *       required: [mimetype, name, content]
+ *       description: Attachment input. Only application/pdf and text/plain are accepted.
+ *       properties:
+ *         mimetype:
+ *           type: string
+ *           enum: [application/pdf, text/plain]
+ *         name:
+ *           type: string
+ *         content:
+ *           type: string
+ *           format: byte
+ *           description: File content (base64-encoded in JSON)
+ *         sort:
+ *           type: integer
+ *           description: Optional sort order (defaults to appending after existing files)
+ *         size:
+ *           type: integer
+ *           description: Optional size in bytes (defaults to content length)
+ *         hash:
+ *           type: string
+ *           description: Optional SHA-256 (auto-computed if omitted)
+ *         created:
+ *           type: string
+ *           format: date-time
+ *         modified:
+ *           type: string
+ *           format: date-time
+ *         meta:
+ *           type: object
+ *           description: Optional string key/value metadata stored with the file
+ *           additionalProperties:
+ *             type: string
  *     ManifestLine:
  *       type: object
  *       required: [id, sku, name, pu, amount, net, rebate, taxrate, comment]