MCP documentation | MCP docs for agents

ark_preview_billing_financial_action

ark.preview_billing_financial_action

Preview exactly one reconciliation or correction action without writing. Use the matching action-specific write tool only after reviewing this result.

Availability
Expanded preview
Scopes
loads:readbilling:read
ARK permissions
canViewLoadscanViewBilling
Team visibility
Required and enforced
Approval policy
none
ARK approval request
Not required
Idempotency
Not required
Read-only
Yes
Destructive
No
External side effect
No
Rate limit
OAuth MCP credential and organization budgets

Input

reasonstring

default: "Billing workbench action"; min length: 1; max length: 1000

queueQuickBooksSyncboolean

default: false

correctionSidestringrequired

one of: ap, ar

effectiveDatestring
accountingDatestring
evidenceReferencestring | null
reviewItemIdstring

format: uuid

reviewItemVersioninteger

max: 9007199254740991

reconciliationIdstring

format: uuid

reconciliationVersioninteger

max: 9007199254740991

correctionEvidenceIdstring

format: uuid

correctionPaymentIdstring

format: uuid

correctionPaymentVersioninteger

max: 9007199254740991

actionstringrequired
reconciliationResolutionKindstring

one of: stopped_or_superseded, recovered, reclassified, dismissed

correctionAmountMinorstring
correctionDestinationReferencestring

min length: 1; max length: 255

correctionApprovalReferencestring

min length: 1; max length: 255

Result

The tool returns the canonical ark.preview_billing_financial_action operation result in structuredContent and mirrors the same JSON as text. Errors set isError: true and return a stable error code, message, and optional details.