Skip to main content

Recut Forecast Run Cash Plan

POST 

/api/forecast-runs/:run/cash-plan/recut

Re-cut a saved forecast run's cash plan against today's headroom and ranking weights, using the ranking inputs already stored on its lines. The forecast is not rebuilt. Each line is re-dated to the later of today and its order-by date (payment milestones move with it), existing pins and supplier minimums carry over, and the stored plan is replaced so the run reopens with the new cut.

Required scope: purchase-orders:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Use it after cash, credit, reserve, payables or weights change, so the saved plan matches what Rank Forecast Builds would return today.

Balance inputs (cash_on_hand, credit_line_limit, credit_line_drawn, available_credit, reserve_floor, snapshot_id, reserve_periods, and each week's reserve / reserve_label, capacity, spendable and spendable_after) are only present for users holding cash_buying.view_balances; without it these keys are omitted entirely (not null).

Permission: cash_buying.override. Token scope: purchase-orders:write.

No request body.

sized_unit_cost (on each line): the unit cost, in the line's pricing currency (as the purchase order carries it), that the line's cash was sized at. Compare it with the product's current cost to tell a plan ranked at old costs from the current ones; null on plans saved before it was recorded.

Request​

Responses​

OK

Response Headers
    Content-Type