get_billing_run
get_billing_run
Live server: available on mcp.solvimon.com as well as on the test server.
The health of a month’s billing run in one call: what is done, what is at risk, and what needs a look before you finalize. It never changes anything.
Status returns an overall verdict (ON_TRACK, ATTENTION or ACTION), timeliness, revenue at risk, the next run, a trend of the last six runs, and one row per check:
- Run progress: invoices not yet final, empty drafts, stale drafts from earlier runs, failed finalizes, reprocessing.
- Completeness: active subscriptions with no invoice this period, usage events that matched no subscription, customers billed for usage who sent none, accepted quotes not yet converted.
- Correctness: changes per customer and per product against the previous month, split into volume and price for usage, with customers whose contract changed marked as explained; new and dropped items; credit notes; manual invoices.
- Data quality: missing invoice emails, bad addresses, reverse charge without a tax id.
- Delivery: failed invoice emails, e-invoices in error or stuck, ERP and export errors, failed webhooks.
- Collections and prepaid: overdue invoices, failed payment requests, credit grants expiring with an open balance.
A check that couldn’t be read is UNAVAILABLE with the reason, and never counts as fine. A check that hit a page limit is marked partial. Amounts in different currencies are never added together.
Preflight checks a run before a bulk finalize in Desk and returns a verdict: HOLD, GO_WITH_WARNINGS or GO. Blockers are a pending reprocess, the grace period not yet passed (with the time it is ready), and tax data. The result lists which drafts are in scope and which are on hold, and why.