Set Record Supplier
Set, replace, or clear the record's own scope supplier
(dds_record.supplier_id) โ the surface for attributing a
supplier to a record created without one (a null-supplier record), or
correcting it.
header.supplier in the audit-trail report reads this scope supplier
first (ahead of the pinned-shed rollup), so a supplier set here
surfaces in the report header even when the record has no pinned shed.
โถBody
supplier_idโ the id of a supplier already in the record's owning-org registry (create/link it first via the supplier endpoints). Passnullto clear the record's supplier scope.
Single-supplier by design: a DDS record's scope holds exactly one supplier. To split plots across multiple suppliers, the per-supplier fan-out happens at create time.
โถStatus codes
- 200 โ scope supplier updated (idempotent; a no-op set returns 200).
- 404 โ record not visible to the caller.
- 409 โ the current version is already submitted; cut a new version to change its supplier.
- 422 โ
supplier_idisn't in the record's owning-org registry.
Distinct from PATCH .../suppliers/:supplierId, which edits the display
snapshot of a supplier already pinned to a shed on the current version.