Skip to main content

Preview Purchase Order Cash Forecast

POST 

/api/purchase-orders/:purchaseOrder/cash-forecast/preview

Project a set of forecast inputs without saving them — the same response as Get Purchase Order Cash Forecast, with inputs echoing the body and is_saved describing what is stored.

Required scope: purchase-orders:write

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

What the forecast is. The purchase order's actual cash to date (payments made, payouts and sales received; never remaining stock at cost or estimated payments) plus a projection for the units still to sell: the expected cost outflows at their dates, then sales at sales_per_day from the day the stock is sellable (start_date + production_days + transit_days + inbound_days, never before tomorrow), grouped into weekly blocks each paid out at net_payout_per_unit after payout_lag_days.

Cash SKU Return. projection.cash_return_multiple is cash back ÷ cash out; projection.days_to_cash_return counts from the first cash out to projection.payback_date, the day the running position (cash back − cash out) reaches zero and stays there — null when the forecast never gets there, with cash_returned_pct saying how much comes back. projection.irr is the annualized money-weighted return (MIRR at the tenant's hurdle rate); projection.xirr the exact XIRR when it solves.

Basis. Purchase orders received into Amazon (FBA or AWD) are projected on the Amazon payout basis, others on sales revenue.

Body. variant (optional: product or fully_loaded, default product); outflows (array, may be empty; up to 100): each date (YYYY-MM-DD), label (optional, ≤120 chars), category (supplier_deposit, balance_payment, freight_duty, amazon_inbound_fees, amazon_storage or cost_entries) and amount (positive number paid out); start_date (YYYY-MM-DD, required); production_days, transit_days, inbound_days (integers ≥ 0, required); units_to_sell (≥ 0, required); sales_per_day (≥ 0, required); net_payout_per_unit (required); payout_lag_days (0–365, required).

Needs permission to view the purchase order. Requires a Bearer token.

Request​

Responses​

OK

Response Headers
    Content-Type