Patch Supplier
Override supplier identity for this DDS only. The registry row
at /parties/suppliers/:supplierId is not touched โ the
override writes to per-shed snapshot columns scoped to the
record's current version.
โถEditable fields
| Body key | Maps to | Notes |
|---|---|---|
name | supplier_name | Required if present; cannot be cleared. |
address_line1 | address_line1 | null to clear. |
address_line2 | address_line2 | null to clear. |
city | city | null to clear. |
region | region | null to clear. |
postcode | postcode | null to clear. |
country | country | ISO 3166-1 alpha-2; null to clear. |
statement | statement | null to clear. |
external_supplier_id | external_supplier_id | null to clear. |
Fields you omit keep their current value (snapshot column or live
registry value via the COALESCE cascade). An empty attributes: {}
body is accepted and is a no-op โ no event is logged.
โถAudit
A non-empty override appends one supplier.overridden event with
before, after, and changed_keys (camelCase field names โ e.g.
addressLine1, externalSupplierId).
โถRejected when frozen
Once the current version is frozen โ by POST /regulations/eudr/audit-trail/:id/submit
or by being superseded via a version cut โ this endpoint returns
409 CONFLICT. To make further changes, cut a new version
(POST /regulations/eudr/audit-trail/:id/tasks with operation: create_version)
and override on the new version.
โถErrors
400โ invalid country code, oversize field, unknown key.404โ record not visible, or the named supplier is not in the current version's shed set.409โ version is frozen.
Required scope:
ingestions:write