Accounting developer access

Provider-neutral financial counterparties, invoice drafts, approval proposals, and staged accounting-data migrations.

Owner: Vision Accounting
Lifecycle: preview
Runtime: not-public
App entitlement: accounting
Audience: Vision Accounting App profile
Workspace: AWS-… Accounting workspace required

Authority boundary

Accounting owns financial records, exact arithmetic, approvals, audit evidence, workspace grants, and ledger invariants.

Complete preview contract: Every operation and MCP capability in the approved definitions below is documented. The lifecycle and runtime labels describe stability and availability, not partial catalog coverage.

Accounting API

Owning App: Accounting
Contract version: 0.32.0
Audience: Vision Accounting App profile
Workspace binding: AWS-… Accounting workspace required

Download the authoritative OpenAPI 3.1 definition

90 operations

Generated from Vision Accounting API 0.32.0

GET/apps/accounting/v2/people/access-contract
getAccountingPeopleAccessContract
No bearer scope declared
Full operation reference →
POST/apps/accounting/v1/people/offboarding/prepare
prepareAccountingPeopleOffboarding
accounting.people:offboarding
Full operation reference →
POST/apps/accounting/v1/people/offboarding/commit
commitAccountingPeopleOffboarding
accounting.people:offboarding
Full operation reference →
POST/apps/accounting/v1/people/offboarding/abort
abortAccountingPeopleOffboarding
accounting.people:offboarding
Full operation reference →
GET/apps/accounting/v1/meta
getAccountingMetadata
No bearer scope declared
Full operation reference →
GET/apps/accounting/v1/ready
getAccountingReadiness
accounting:health:read
Full operation reference →
GET/apps/accounting/v1/actor
getAccountingActor
accounting:actor:read
Full operation reference →
GET/apps/accounting/v1/overview
getAccountingOverview
accounting:overview:read
Full operation reference →
GET/apps/accounting/v1/counterparties
listFinancialCounterparties
accounting:counterparties:read
Full operation reference →
POST/apps/accounting/v1/counterparties
createFinancialCounterparty
accounting:counterparties:write
Full operation reference →
GET/apps/accounting/v1/counterparties/{reference}
getFinancialCounterparty
accounting:counterparties:read
Full operation reference →
GET/apps/accounting/v1/invoices
listInvoices
accounting:invoices:read
Full operation reference →
GET/apps/accounting/v1/invoices/{reference}
getInvoice
accounting:invoices:read
Full operation reference →
POST/apps/accounting/v1/invoice-drafts
createInvoiceDraft
accounting:invoices:draft
Full operation reference →
PUT/apps/accounting/v1/invoice-drafts/{reference}
updateInvoiceDraft
accounting:invoices:draft
Full operation reference →
POST/apps/accounting/v1/approval-intents
prepareInvoiceApprovalIntent
accounting:approvals:prepare
Full operation reference →
GET/apps/accounting/v1/settings
getAccountingSettings
accounting:settings:read
Full operation reference →
PUT/apps/accounting/v1/settings
updateAccountingSettings
accounting:settings:write
Full operation reference →
GET/apps/accounting/v1/provider-connections
listProviderConnections
accounting:providers:read
Full operation reference →
POST/apps/accounting/v1/provider-connections/stripe
connectStripeRestrictedKey
accounting:providers:connect
Full operation reference →
GET/apps/accounting/v1/import-runs
listImportRuns
accounting:imports:read
Full operation reference →
POST/apps/accounting/v1/import-runs
createImportRun
accounting:imports:create
Full operation reference →
GET/apps/accounting/v1/import-runs/{reference}
getImportRun
accounting:imports:read
Full operation reference →
POST/apps/accounting/v1/import-runs/{reference}/artifacts
registerImportArtifact
accounting:imports:upload
Full operation reference →
PUT/apps/accounting/v1/import-runs/{reference}/mapping-set
setImportMapping
accounting:imports:map
Full operation reference →
POST/apps/accounting/v1/import-runs/{reference}/candidate-revisions
createImportCandidateRevision
accounting:imports:validate
Full operation reference →
GET/apps/accounting/v1/mcp-capabilities
getAccountingMcpCapabilities
accounting:imports:read
Full operation reference →
GET/apps/accounting/v1/payments
listPayments
accounting:payments:read
Full operation reference →
POST/apps/accounting/v1/payments
recordPayment
accounting:payments:write
Full operation reference →
GET/apps/accounting/v1/payments/{reference}
getPayment
accounting:payments:read
Full operation reference →
POST/apps/accounting/v1/payments/{reference}/allocations
allocatePayment
accounting:payments:write
Full operation reference →
GET/apps/accounting/v1/payments/{reference}/refunds
listRefunds
accounting:payments:read
Full operation reference →
POST/apps/accounting/v1/payments/{reference}/refunds
recordRefund
accounting:payments:write
Full operation reference →
GET/apps/accounting/v1/billing-agreements
listBillingAgreements
accounting:billing:read
Full operation reference →
POST/apps/accounting/v1/billing-agreements
createBillingAgreement
accounting:billing:write
Full operation reference →
GET/apps/accounting/v1/billing-agreements/{reference}
getBillingAgreement
accounting:billing:read
Full operation reference →
POST/apps/accounting/v1/billing-agreements/{reference}/cancel
cancelBillingAgreement
accounting:billing:write
Full operation reference →
POST/apps/accounting/v1/billing-agreements/{reference}/process
processBillingAgreement
accounting:billing:process
Full operation reference →
GET/apps/accounting/v1/credit-notes
listCreditNotes
accounting:payments:read
Full operation reference →
POST/apps/accounting/v1/credit-notes
createCreditNote
accounting:payments:write
Full operation reference →
POST/apps/accounting/v1/credit-notes/{reference}/issue
issueCreditNote
accounting:payments:write
Full operation reference →
POST/apps/accounting/v1/credit-notes/{reference}/applications
applyCredit
accounting:payments:write
Full operation reference →
GET/apps/accounting/v1/credit-notes/{reference}
getCreditNote
accounting:payments:read
Full operation reference →
GET/apps/accounting/v1/counterparties/{reference}/credit
getCustomerCredit
accounting:payments:read
Full operation reference →
POST/apps/accounting/v1/invoices/{reference}/approve
approveInvoice
accounting:invoices:approve
Full operation reference →
POST/apps/accounting/v1/invoices/{reference}/issue
issueInvoice
accounting:invoices:issue
Full operation reference →
GET/apps/accounting/v1/payment-pickers/customers
listPaymentCustomerPicker
accounting:payments:read
Full operation reference →
GET/apps/accounting/v1/payment-pickers/open-invoices
listPaymentOpenInvoicePicker
accounting:payments:read
Full operation reference →
POST/apps/accounting/v1/payments/{reference}/applications
applyPayment
accounting:payments:write
Full operation reference →
POST/apps/accounting/v1/credit-notes/{reference}/refunds
refundCredit
accounting:payments:write
Full operation reference →
POST/apps/accounting/v1/credit-notes/{reference}/invoice-applications
applyCreditToInvoices
accounting:payments:write
Full operation reference →
GET/apps/accounting/v1/payment-pickers/creditable-invoices
listCreditableInvoicePicker
accounting:payments:read
Full operation reference →
POST/apps/accounting/v1/credit-notes/{reference}/send
sendCreditNote
accounting:payments:write
Full operation reference →
GET/apps/accounting/v1/credit-notes/{reference}/pdf
getCreditNotePdf
accounting:payments:read
Full operation reference →
POST/apps/accounting/v1/invoices/{reference}/send-now
sendInvoiceNow
accounting:invoices:issue
Full operation reference →
GET/apps/accounting/v1/stripe-connect
The workspace's Stripe Connect status and Vision's fee. With `confirm`, first finishes a Connect started by this same signed-in person.
accounting:providers:read
Full operation reference →
POST/apps/accounting/v1/stripe-connect/authorize
Start linking the workspace's own Stripe account (Connect, Standard). People only; needs the connect grant.
accounting:providers:connect
Full operation reference →
POST/apps/accounting/v1/stripe-connect/disconnect
Deauthorise Vision from the workspace's Stripe account. Recorded payments stay.
accounting:providers:connect
Full operation reference →
POST/apps/accounting/v1/stripe-connect/branding
Show or hide "Powered by Vision" on the client pay page.
accounting:settings:write
Full operation reference →
GET/apps/accounting/v1/invoices/{reference}/pay-link
The issued invoice's current pay link, if it has one.
accounting:invoices:read
Full operation reference →
POST/apps/accounting/v1/invoices/{reference}/pay-link
Make (or return, or with rotate replace) the pay link of an issued invoice.
accounting:invoices:issue
Full operation reference →
GET/stripe/connect/callback
Stripe's OAuth return (browser). Consumes the single-use state and keeps the code, encrypted, for confirmation; links nothing itself. Sends the browser back to Vision.
No bearer scope declared
Full operation reference →
POST/stripe/webhook
Stripe Connect webhook. Signature-checked and deduplicated; a succeeded payment is recorded against its invoice (or kept as customer credit when the invoice is no longer payable), and a Stripe refund is recorded once against its payment.
No bearer scope declared
Full operation reference →
GET/pay/{token}
The client's pay page for one issued invoice (HTML, outside the Vision shell).
No bearer scope declared
Full operation reference →
POST/pay/{token}/checkout
Start Stripe Checkout for the amount still owed: us_bank_account (ACH) or card.
No bearer scope declared
Full operation reference →
GET/pay/{token}/done
Where Stripe Checkout returns the client after paying.
No bearer scope declared
Full operation reference →
GET/apps/accounting/v1/contributions/widgets
listTodayWidgets
accounting:overview:read
Full operation reference →
POST/apps/accounting/v1/cash-sales
recordCashSale
accounting:invoices:issue
Full operation reference →
POST/apps/accounting/v1/payments/{reference}/send-receipt
sendPaymentReceipt
accounting:payments:write
Full operation reference →
POST/apps/accounting/v1/payments/{reference}/undo
undoPayment
accounting:payments:write
Full operation reference →
GET/apps/accounting/v1/payments/{reference}/receipt.pdf
getPaymentReceiptPdf
accounting:payments:read
Full operation reference →
GET/apps/accounting/v1/settings/invoicing
getInvoicingSettings
accounting:settings:read
Full operation reference →
PUT/apps/accounting/v1/settings/invoicing
updateInvoicingDetails
accounting:settings:write
Full operation reference →
POST/apps/accounting/v1/settings/invoicing/switch
setInvoicingSwitch
accounting:settings:write
Full operation reference →
POST/apps/accounting/v1/invoices/{reference}/remind
sendInvoiceReminder
accounting:invoices:issue
Full operation reference →
GET/apps/accounting/v1/record-links
The customer and invoices linked to a record in another app.
accounting:invoices:read
Full operation reference →
POST/apps/accounting/v1/record-links/customer
Find or create the one customer for a record in another app, or link an existing customer to it.
accounting:counterparties:write
Full operation reference →
POST/apps/accounting/v1/record-links/deal-invoice
Create a draft invoice from a deal in one transaction, or answer with the existing draft.
accounting:invoices:draft
Full operation reference →
GET/apps/accounting/v1/contributions/record-related
Invoices on another app's record
accounting:invoices:read
Full operation reference →
GET/apps/accounting/v1/invoice-drafts/paper
getInvoicePaperPreview
accounting:invoices:read
Full operation reference →
POST/apps/accounting/v1/invoices/{reference}/duplicate
Make a new draft with the same customer, notes, and lines. Nothing goes to the client.
accounting:invoices:draft
Full operation reference →
POST/apps/accounting/v1/invoices/{reference}/connected-history
Keep a lasting History line on the invoice for each item another app holds for it (To-Do follow-ups). Core calls this after that app's form saves here; a line already kept stays as it was.
accounting:invoices:draft
Full operation reference →
GET/apps/accounting/v1/record-links/invoiced-deals
The references of deals that already have an invoice.
accounting:invoices:read
Full operation reference →
POST/apps/accounting/v1/repeating-invoices
createRepeatingInvoice
accounting:billing:write
Full operation reference →
POST/apps/accounting/v1/repeating-invoices/{reference}/edit
updateRepeatingInvoice
accounting:billing:write
Full operation reference →
POST/apps/accounting/v1/repeating-invoices/{reference}/switch
switchRepeatingInvoice
accounting:billing:write
Full operation reference →
GET/apps/accounting/v1/command-outcomes/{key}
getCommandOutcome
accounting:payments:read
Full operation reference →
GET/apps/accounting/v1/payment-repeat-check
getPaymentRepeatCheck
accounting:payments:read
Full operation reference →
GET/apps/accounting/v1/refund-repeat-check
getRefundRepeatCheck
accounting:payments:read
Full operation reference →
GET/apps/accounting/v1/cash-sale-repeat-check
getCashSaleRepeatCheck
accounting:payments:read
Full operation reference →

Vision Accounting MCP

MCPpreview

Read-only tools served by Vision Core's MCP endpoint through the machine-read broker (development and preview tiers). No write, approval, issuing, posting or money movement is reachable through MCP; planned proposal capabilities are not yet served.

Version: 0.2.0
Authority: read_only
Transport: live-preview
Required scope

Approved capabilities

explain_receivables
list_invoices
find_payments
list_credit_notes
list_customers

Explicitly prohibited

approve_import
promote_import
issue_invoice
post_journal
move_money
connect_provider
read_raw_artifact
run_sql

Download the authoritative MCP access definition

Publication evidence

This page is generated from the approval registry. Contract checksums, source drift, security declarations, scopes, references, and operation identifiers are verified before publication. A production documentation deployment remains a separate approval and rollback gate.