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). Pass null to 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_id isn'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.