Skip to main content

Record Supplier Response

POST 
/api/purchase-orders/:purchase_order/supplier-responses

Record a supplier's response to a sent purchase order revision. Use it to log that the supplier accepted the order, requested changes, or rejected it, optionally capturing the quantities, costs and dates the supplier confirmed for individual lines.

Recording an accepted response stamps the order's last supplier confirmation time. Recording a changes_requested response moves the order into a supplier-change state so the confirmed quantities can be reviewed and applied.

Path params:

  • purchase_order (required): id of the purchase order.

Body:

  • response_type (required): one of accepted, changes_requested, rejected.
  • source (optional): one of internal, supplier_portal, email.
  • responder (nullable string): name of the person on the supplier side.
  • note (nullable string, max 5000).
  • snapshot_id (nullable integer): id of the revision snapshot the response applies to.
  • lines (optional array). For each line:
    • purchase_order_line_id (required with lines, integer).
    • ordered_quantity (nullable numeric).
    • confirmed_quantity (nullable numeric).
    • confirmed_unit_cost (nullable numeric).
    • confirmed_date (nullable date).
    • exception_code (nullable): one of CAP, MAT, LOG, PRI, UOM, SUB, MIN, DOC.
    • status (required with lines): one of accepted, changed, rejected.
    • note (nullable string).

Returns the recorded response and the refreshed purchase order under data.

Authentication: Requires Bearer token.

Requires permission: purchase_orders.update

Request​

Responses​

OK

Response Headers
    Content-Type