# Create or Update CIUS Additional Fields Creates the document's CIUS/EDI additional fields, or updates them if they already exist — the same endpoint serves both cases. Returns 201 when the record is created and 200 when an existing record is updated. Fields omitted from the payload keep their stored value, so this is a partial update rather than a replace. Endpoint: POST /api/v1/edi/{id}/additional_fields Version: 3.1.0 Security: apiKeyAuth ## Path parameters: - `id` (integer, required) The document ID. Example: 541674 ## Query parameters: - `api_key` (string, required) Your API Key. Example: "YOUR_API_KEY" ## Request fields (application/json): - `additional_fields` (object, required) All fields are optional, but the additional_fields wrapper itself is required. Fields omitted from the payload keep their stored value — this is a partial update, not a replace. - `additional_fields.order_reference` (string) Example: "PO-2026-0042" - `additional_fields.accounting_cost` (string) Example: "Cost centre 4711" - `additional_fields.contract_document_reference` (string) Example: "CT-2026-118" - `additional_fields.despatch_document_reference` (string) Example: "DES-2026-0091" - `additional_fields.originator_document_reference` (string) Example: "ORIG-2026-0007" - `additional_fields.actual_delivery_date` (string) Delivery date in YYYY-MM-DD format. Any value that cannot be parsed as a date returns 422. Example: "2026-06-01" ## Response 200 fields (application/json): - `additional_fields` (object) - `additional_fields.order_reference` (string,null) Example: "PO-2026-0042" - `additional_fields.accounting_cost` (string,null) Example: "Cost centre 4711" - `additional_fields.contract_document_reference` (string,null) Example: "CT-2026-118" - `additional_fields.despatch_document_reference` (string,null) Example: "DES-2026-0091" - `additional_fields.originator_document_reference` (string,null) Example: "ORIG-2026-0007" - `additional_fields.actual_delivery_date` (string,null) Example: "2026-06-01" ## Response 201 fields (application/json): - `additional_fields` (object) - `additional_fields.order_reference` (string,null) Example: "PO-2026-0042" - `additional_fields.accounting_cost` (string,null) Example: "Cost centre 4711" - `additional_fields.contract_document_reference` (string,null) Example: "CT-2026-118" - `additional_fields.despatch_document_reference` (string,null) Example: "DES-2026-0091" - `additional_fields.originator_document_reference` (string,null) Example: "ORIG-2026-0007" - `additional_fields.actual_delivery_date` (string,null) Example: "2026-06-01" ## Response 401 fields (application/json): - `errors` (array) Example: [{"error":"Authentication Error"}] - `errors.error` (string) ## Response 404 fields (application/json): - `errors` (array) Example: [{"error":"Resource not found"}] - `errors.error` (string) ## Response 422 fields (application/json): - `errors` (array) Returned when actual_delivery_date cannot be parsed as a date. Example: [{"error":"invalid date"}] - `errors.error` (string) ## Response 500 fields (application/json): - `errors` (array) Example: [{"error":"An unexpected error occurred"}] - `errors.error` (string)