Files
wanderbooks/crates/ledger-mcp/handbook/revenue-and-payouts.md
T
swaitsandClaude Opus 5.5 07f213c9e5
check / check (push) Canceled after 0s
feat(mcp): void, control check, payment method and reference (P4b S1, part B)
books.void_document voids an invoice or bill that should never have
existed by reversing its own entry with the reason (refused while a
payment stands on it, naming that payment). books.control_check ties
receivables and payables to their documents (B-23, B-38 INVARIANT 1):
balance, documents' total, lines that are no document's, the documents
needing attention; books.verify checks the identity and books.digest
lists its problems (control_problems). books.receive_payment and
books.pay_bill take instrument (tagged in the same call) and reference
(in the description), and answer the document's derived remaining and
status. The books record payments; they never collect or make them
(D-45). Docs, handbook and STATUS; the over-the-wire test
documents_void_and_tie_out_over_the_wire; the happy-path journey covers
both tools' output schemas. The processor fee waits for S6.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01T3gXMVt7XJPi6ens1or9Dj
2026-10-24 12:22:53 -06:00

1.1 KiB

Revenue and payouts

  • Platform payouts (app stores, payment processors, marketplaces): never book the net deposit as revenue. books.record_payout grosses it up (gross revenue, fees, adjustments) into a draft and refuses unless it reconciles to the cent; attach the payout statement, then preview and post.
  • Invoices and bills: books.create_invoice, books.receive_payment, books.create_bill and books.pay_bill post to the control accounts (the control-roles section).
  • An invoice's or bill's figures come from its ledger lines that still stand: reversing a payment un-pays it, and nothing is ever typed into Accounts Receivable or Accounts Payable by hand (refused). Record each payment with its instrument and the processor's or bank's reference; the books record payments, they never collect or make them (the human or a delegate does). A document that should never have existed is voided (books.void_document, with the reason), not deleted: reverse any payment on it first. books.control_check ties receivables and payables to their documents; anything it lists goes to the human.