ark_queue_quickbooks_sync_job

ark.queue_quickbooks_sync_job

Queue an ARK QuickBooks sync workflow for customer invoices, customer payments, carrier bills, carrier payments, carrier settlements, or update syncs after validating visibility and skipping unsupported zero-dollar payment receipts.

Availability: Expanded preview
Scopes: loads:readbilling:write
ARK permissions: canViewLoadscanViewBillingcanMakeAdjustments
Team visibility: Required and enforced
Approval policy: ask_before_write
ARK approval request: Required before execution
Idempotency: Required for external execution
Read-only: No
Destructive: No
External side effect: Yes
Rate limit: OAuth MCP credential and organization budgets

Input

operationstringrequired

QuickBooks sync workflow to queue. Required fields depend on the selected operation.

one of: customer_invoice_create, customer_invoice_mark_paid, customer_payment_create, carrier_bill_create, carrier_bill_mark_paid, carrier_settlement_create, customer_invoice_update, carrier_bill_update

paymentIdsarray<string>

Visible ARK customer or carrier payment IDs for the selected sync operation.

min items: 1; max items: 50

depositToAccountIdstring

QuickBooks deposit account ID for customer_invoice_mark_paid.

min length: 1; max length: 100

settlementNumbersarray<integer>

Carrier settlement numbers for carrier_settlement_create.

min items: 1; max items: 10

referenceNumberstring

Optional carrier settlement payment reference number.

min length: 1; max length: 100

paidDatestring

Optional carrier settlement paid date as YYYY-MM-DD.

loadIdstring

Visible ARK load ID for customer_invoice_update or carrier_bill_update.

format: uuid

paymentIdstring

Optional customer payment ID for customer_invoice_update. When omitted, ARK uses the latest customer payment for the load.

format: uuid

dispatchIdstring

Visible ARK dispatch ID for carrier_bill_update.

format: uuid

Result

The tool returns the canonical ark.queue_quickbooks_sync_job 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.