QuickBooks

Manage QuickBooks Online customers, invoices, and accounting data

使用说明

Connect to QuickBooks Online to read and write customers, invoices, and chart-of-accounts entries, or run arbitrary QuickBooks queries. Uses Intuit OAuth 2.0; the company (realmId) is captured from the OAuth callback at sign-in time.

工具

`quickbooks_create_bill`

Create a new bill (vendor expense) in QuickBooks Online

输入

参数	类型	必填	描述
`realmId`	string	是	QuickBooks company ID (realmId) — captured at OAuth time
`vendorId`	string	是	Vendor ID for the bill
`lines`	json	是	Bill line items (JSON array). Each entry: { amount, accountId, description? }
`txnDate`	string	否	Transaction date (YYYY-MM-DD)
`dueDate`	string	否	Due date (YYYY-MM-DD)

输出

参数	类型	描述
`bill`	object	Created bill
↳ `Id`	string	QuickBooks bill ID
↳ `VendorRef`	object	Vendor reference
↳ `TxnDate`	string	Transaction date (YYYY-MM-DD)
↳ `DueDate`	string	Due date (YYYY-MM-DD)
↳ `TotalAmt`	number	Total bill amount
↳ `Balance`	number	Outstanding balance
↳ `Line`	array	Bill line items
↳ `CurrencyRef`	object	Currency reference
↳ `MetaData`	object	Create/update timestamps
↳ `SyncToken`	string	Optimistic concurrency token; required for sparse updates
`billId`	string	New bill ID

`quickbooks_create_customer`

Create a new customer in QuickBooks Online

输入

参数	类型	必填	描述
`realmId`	string	是	QuickBooks company ID (realmId) — captured at OAuth time
`displayName`	string	是	Display name (must be unique within the company)
`companyName`	string	否	Company name
`givenName`	string	否	First name
`familyName`	string	否	Last name
`primaryEmail`	string	否	Primary email address
`primaryPhone`	string	否	Primary phone number
`notes`	string	否	Free-form notes

输出

参数	类型	描述
`customer`	object	Created customer
↳ `Id`	string	QuickBooks customer ID
↳ `DisplayName`	string	Display name shown in lists and forms
↳ `CompanyName`	string	Company name
↳ `GivenName`	string	First name
↳ `FamilyName`	string	Last name
↳ `PrimaryEmailAddr`	object	Primary email object with `Address`
↳ `PrimaryPhone`	object	Primary phone object with `FreeFormNumber`
↳ `Active`	boolean	Whether the customer is active
↳ `Balance`	number	Open balance owed by the customer
↳ `CurrencyRef`	object	Currency reference (`value`, `name`)
↳ `Notes`	string	Free-form notes
↳ `MetaData`	object	Create/update timestamps
↳ `SyncToken`	string	Optimistic concurrency token; required for sparse updates
`customerId`	string	New customer ID

`quickbooks_create_invoice`

Create a new invoice in QuickBooks Online

输入

参数	类型	必填	描述
`realmId`	string	是	QuickBooks company ID (realmId) — captured at OAuth time
`customerId`	string	是	Customer ID to bill
`lines`	json	是	Invoice line items (JSON array). Each entry: { itemId, amount, quantity?, description?, itemName? }. itemId is required (use list_items to look up valid IDs).
`txnDate`	string	否	Transaction date (YYYY-MM-DD)
`dueDate`	string	否	Due date (YYYY-MM-DD)
`customerMemo`	string	否	Memo shown to the customer on the invoice
`billEmail`	string	否	Email address to bill (used by Send Invoice flows)

输出

参数	类型	描述
`invoice`	object	Created invoice
↳ `Id`	string	QuickBooks invoice ID
↳ `DocNumber`	string	Invoice document number
↳ `TxnDate`	string	Invoice transaction date (YYYY-MM-DD)
↳ `DueDate`	string	Invoice due date (YYYY-MM-DD)
↳ `CustomerRef`	object	Reference to the customer (`value`, `name`)
↳ `Line`	array	Invoice line items
↳ `TotalAmt`	number	Total amount of the invoice
↳ `Balance`	number	Outstanding balance on the invoice
↳ `CurrencyRef`	object	Currency reference
↳ `CustomerMemo`	object	Customer-facing memo
↳ `BillEmail`	object	Billing email object
↳ `EmailStatus`	string	Email send status (NotSet, NeedToSend, EmailSent)
↳ `MetaData`	object	Create/update timestamps
↳ `SyncToken`	string	Optimistic concurrency token; required for sparse updates
`invoiceId`	string	New invoice ID

`quickbooks_create_item`

Create a new item (product or service) in QuickBooks Online

输入

参数	类型	必填	描述
`realmId`	string	是	QuickBooks company ID (realmId) — captured at OAuth time
`name`	string	是	Item name (must be unique within the company)
`type`	string	是	Item type — Service or NonInventory (Inventory not supported in MVP)
`incomeAccountId`	string	是	Income account ID to associate with the item
`description`	string	否	Item description
`unitPrice`	number	否	Unit price for the item

输出

参数	类型	描述
`item`	object	Created item
↳ `Id`	string	QuickBooks item ID
↳ `Name`	string	Item name
↳ `Description`	string	Item description
↳ `Type`	string	Item type (Service, Inventory, NonInventory)
↳ `Active`	boolean	Whether the item is active
↳ `UnitPrice`	number	Unit price
↳ `IncomeAccountRef`	object	Income account reference
↳ `ExpenseAccountRef`	object	Expense account reference
↳ `AssetAccountRef`	object	Asset account reference
↳ `QtyOnHand`	number	Quantity on hand (Inventory only)
↳ `MetaData`	object	Create/update timestamps
↳ `SyncToken`	string	Optimistic concurrency token; required for sparse updates
`itemId`	string	New item ID

`quickbooks_create_payment`

Record a customer payment in QuickBooks Online

输入

参数	类型	必填	描述
`realmId`	string	是	QuickBooks company ID (realmId) — captured at OAuth time
`customerId`	string	是	Customer ID making the payment
`amount`	number	是	Total payment amount
`invoiceId`	string	否	Optional invoice ID to apply the payment to
`paymentMethodId`	string	否	Payment method ID
`txnDate`	string	否	Transaction date (YYYY-MM-DD)
`paymentRefNum`	string	否	Payment reference number (e.g., check number)

输出

参数	类型	描述
`payment`	object	Created payment
↳ `Id`	string	QuickBooks payment ID
↳ `TxnDate`	string	Transaction date (YYYY-MM-DD)
↳ `CustomerRef`	object	Customer reference
↳ `TotalAmt`	number	Total payment amount
↳ `UnappliedAmt`	number	Unapplied amount
↳ `PaymentMethodRef`	object	Payment method reference
↳ `PaymentRefNum`	string	Payment reference number
↳ `Line`	array	Payment line items / linked transactions
↳ `CurrencyRef`	object	Currency reference
↳ `MetaData`	object	Create/update timestamps
↳ `SyncToken`	string	Optimistic concurrency token; required for sparse updates
`paymentId`	string	New payment ID

`quickbooks_create_vendor`

Create a new vendor in QuickBooks Online

输入

参数	类型	必填	描述
`realmId`	string	是	QuickBooks company ID (realmId) — captured at OAuth time
`displayName`	string	是	Display name (must be unique within the company)
`companyName`	string	否	Company name
`givenName`	string	否	First name
`familyName`	string	否	Last name
`primaryEmail`	string	否	Primary email address
`primaryPhone`	string	否	Primary phone number

输出

参数	类型	描述
`vendor`	object	Created vendor
↳ `Id`	string	QuickBooks vendor ID
↳ `DisplayName`	string	Display name
↳ `CompanyName`	string	Company name
↳ `GivenName`	string	First name
↳ `FamilyName`	string	Last name
↳ `PrimaryEmailAddr`	object	Primary email object with `Address`
↳ `PrimaryPhone`	object	Primary phone object with `FreeFormNumber`
↳ `Active`	boolean	Whether the vendor is active
↳ `Balance`	number	Open balance owed to the vendor
↳ `CurrencyRef`	object	Currency reference
↳ `MetaData`	object	Create/update timestamps
↳ `SyncToken`	string	Optimistic concurrency token; required for sparse updates
`vendorId`	string	New vendor ID

`quickbooks_get_company_info`

Retrieve company information for the connected QuickBooks Online company

输入

参数	类型	必填	描述
`realmId`	string	是	QuickBooks company ID (realmId) — captured at OAuth time

输出

参数	类型	描述
`companyInfo`	object	Company information record
↳ `Id`	string	QuickBooks company ID (realmId)
↳ `CompanyName`	string	Company name
↳ `LegalName`	string	Legal name
↳ `CompanyAddr`	object	Company address
↳ `CompanyStartDate`	string	Company start date
↳ `FiscalYearStartMonth`	string	Fiscal year start month
↳ `Country`	string	Country code
↳ `Email`	object	Primary email object
↳ `WebAddr`	object	Web address
↳ `SupportedLanguages`	string	Supported languages
↳ `NameValue`	array	Custom name/value pairs
↳ `MetaData`	object	Create/update timestamps

`quickbooks_get_customer`

Retrieve a single QuickBooks customer by ID

输入

参数	类型	必填	描述
`realmId`	string	是	QuickBooks company ID (realmId) — captured at OAuth time
`customerId`	string	是	QuickBooks customer ID

输出

参数	类型	描述
`customer`	object	Customer record
↳ `Id`	string	QuickBooks customer ID
↳ `DisplayName`	string	Display name shown in lists and forms
↳ `CompanyName`	string	Company name
↳ `GivenName`	string	First name
↳ `FamilyName`	string	Last name
↳ `PrimaryEmailAddr`	object	Primary email object with `Address`
↳ `PrimaryPhone`	object	Primary phone object with `FreeFormNumber`
↳ `Active`	boolean	Whether the customer is active
↳ `Balance`	number	Open balance owed by the customer
↳ `CurrencyRef`	object	Currency reference (`value`, `name`)
↳ `Notes`	string	Free-form notes
↳ `MetaData`	object	Create/update timestamps
↳ `SyncToken`	string	Optimistic concurrency token; required for sparse updates
`customerId`	string	Customer ID

`quickbooks_get_invoice`

Retrieve a single QuickBooks invoice by ID

输入

参数	类型	必填	描述
`realmId`	string	是	QuickBooks company ID (realmId) — captured at OAuth time
`invoiceId`	string	是	QuickBooks invoice ID

输出

参数	类型	描述
`invoice`	object	Invoice record
↳ `Id`	string	QuickBooks invoice ID
↳ `DocNumber`	string	Invoice document number
↳ `TxnDate`	string	Invoice transaction date (YYYY-MM-DD)
↳ `DueDate`	string	Invoice due date (YYYY-MM-DD)
↳ `CustomerRef`	object	Reference to the customer (`value`, `name`)
↳ `Line`	array	Invoice line items
↳ `TotalAmt`	number	Total amount of the invoice
↳ `Balance`	number	Outstanding balance on the invoice
↳ `CurrencyRef`	object	Currency reference
↳ `CustomerMemo`	object	Customer-facing memo
↳ `BillEmail`	object	Billing email object
↳ `EmailStatus`	string	Email send status (NotSet, NeedToSend, EmailSent)
↳ `MetaData`	object	Create/update timestamps
↳ `SyncToken`	string	Optimistic concurrency token; required for sparse updates
`invoiceId`	string	Invoice ID

`quickbooks_get_vendor`

Retrieve a single QuickBooks vendor by ID

输入

参数	类型	必填	描述
`realmId`	string	是	QuickBooks company ID (realmId) — captured at OAuth time
`vendorId`	string	是	QuickBooks vendor ID

输出

参数	类型	描述
`vendor`	object	Vendor record
↳ `Id`	string	QuickBooks vendor ID
↳ `DisplayName`	string	Display name
↳ `CompanyName`	string	Company name
↳ `GivenName`	string	First name
↳ `FamilyName`	string	Last name
↳ `PrimaryEmailAddr`	object	Primary email object with `Address`
↳ `PrimaryPhone`	object	Primary phone object with `FreeFormNumber`
↳ `Active`	boolean	Whether the vendor is active
↳ `Balance`	number	Open balance owed to the vendor
↳ `CurrencyRef`	object	Currency reference
↳ `MetaData`	object	Create/update timestamps
↳ `SyncToken`	string	Optimistic concurrency token; required for sparse updates
`vendorId`	string	Vendor ID

`quickbooks_list_accounts`

List chart-of-accounts entries from QuickBooks Online

输入

参数	类型	必填	描述
`realmId`	string	是	QuickBooks company ID (realmId) — captured at OAuth time
`maxResults`	number	否	Maximum number of accounts to return (default 100, max 1000)
`startPosition`	number	否	Pagination start position (1-indexed)
`where`	string	否	Optional WHERE clause (e.g., "AccountType = 'Income'")

输出

参数	类型	描述
`accounts`	array	Array of accounts
↳ `Id`	string	QuickBooks account ID
↳ `Name`	string	Account name
↳ `AccountType`	string	High-level account type (Income, Expense, etc.)
↳ `AccountSubType`	string	Account sub-type
↳ `Classification`	string	Asset, Liability, Equity, Revenue, or Expense
↳ `CurrentBalance`	number	Current account balance
↳ `Active`	boolean	Whether the account is active
↳ `CurrencyRef`	object	Currency reference
↳ `SyncToken`	string	Optimistic concurrency token; required for sparse updates
`totalCount`	number	Number of accounts returned

`quickbooks_list_bills`

List bills from QuickBooks Online

输入

参数	类型	必填	描述
`realmId`	string	是	QuickBooks company ID (realmId) — captured at OAuth time
`maxResults`	number	否	Maximum number of bills to return (default 100, max 1000)
`startPosition`	number	否	Pagination start position (1-indexed)
`where`	string	否	Optional WHERE clause

输出

参数	类型	描述
`bills`	array	Array of bills
↳ `Id`	string	QuickBooks bill ID
↳ `VendorRef`	object	Vendor reference
↳ `TxnDate`	string	Transaction date (YYYY-MM-DD)
↳ `DueDate`	string	Due date (YYYY-MM-DD)
↳ `TotalAmt`	number	Total bill amount
↳ `Balance`	number	Outstanding balance
↳ `Line`	array	Bill line items
↳ `CurrencyRef`	object	Currency reference
↳ `MetaData`	object	Create/update timestamps
↳ `SyncToken`	string	Optimistic concurrency token; required for sparse updates
`totalCount`	number	Number of bills returned

`quickbooks_list_customers`

List customers from QuickBooks Online

输入

参数	类型	必填	描述
`realmId`	string	是	QuickBooks company ID (realmId) — captured at OAuth time
`maxResults`	number	否	Maximum number of customers to return (default 100, max 1000)
`startPosition`	number	否	Pagination start position (1-indexed)
`where`	string	否	Optional WHERE clause (e.g., "Active = true AND DisplayName LIKE 'A%'")

输出

参数	类型	描述
`customers`	array	Array of QuickBooks customers
↳ `Id`	string	QuickBooks customer ID
↳ `DisplayName`	string	Display name shown in lists and forms
↳ `CompanyName`	string	Company name
↳ `GivenName`	string	First name
↳ `FamilyName`	string	Last name
↳ `PrimaryEmailAddr`	object	Primary email object with `Address`
↳ `PrimaryPhone`	object	Primary phone object with `FreeFormNumber`
↳ `Active`	boolean	Whether the customer is active
↳ `Balance`	number	Open balance owed by the customer
↳ `CurrencyRef`	object	Currency reference (`value`, `name`)
↳ `Notes`	string	Free-form notes
↳ `MetaData`	object	Create/update timestamps
↳ `SyncToken`	string	Optimistic concurrency token; required for sparse updates
`totalCount`	number	Number of customers returned

`quickbooks_list_estimates`

List estimates from QuickBooks Online

输入

参数	类型	必填	描述
`realmId`	string	是	QuickBooks company ID (realmId) — captured at OAuth time
`maxResults`	number	否	Maximum number of estimates to return (default 100, max 1000)
`startPosition`	number	否	Pagination start position (1-indexed)
`where`	string	否	Optional WHERE clause

输出

参数	类型	描述
`estimates`	array	Array of estimates
↳ `Id`	string	QuickBooks estimate ID
↳ `DocNumber`	string	Estimate document number
↳ `TxnDate`	string	Transaction date (YYYY-MM-DD)
↳ `ExpirationDate`	string	Expiration date (YYYY-MM-DD)
↳ `CustomerRef`	object	Customer reference
↳ `Line`	array	Estimate line items
↳ `TotalAmt`	number	Total estimate amount
↳ `TxnStatus`	string	Estimate status (Pending, Accepted, etc.)
↳ `EmailStatus`	string	Email send status
↳ `MetaData`	object	Create/update timestamps
↳ `SyncToken`	string	Optimistic concurrency token; required for sparse updates
`totalCount`	number	Number of estimates returned

`quickbooks_list_invoices`

List invoices from QuickBooks Online

输入

参数	类型	必填	描述
`realmId`	string	是	QuickBooks company ID (realmId) — captured at OAuth time
`maxResults`	number	否	Maximum number of invoices to return (default 100, max 1000)
`startPosition`	number	否	Pagination start position (1-indexed)
`where`	string	否	Optional WHERE clause (e.g., "Balance > '0'")

输出

参数	类型	描述
`invoices`	array	Array of invoices
↳ `Id`	string	QuickBooks invoice ID
↳ `DocNumber`	string	Invoice document number
↳ `TxnDate`	string	Invoice transaction date (YYYY-MM-DD)
↳ `DueDate`	string	Invoice due date (YYYY-MM-DD)
↳ `CustomerRef`	object	Reference to the customer (`value`, `name`)
↳ `Line`	array	Invoice line items
↳ `TotalAmt`	number	Total amount of the invoice
↳ `Balance`	number	Outstanding balance on the invoice
↳ `CurrencyRef`	object	Currency reference
↳ `CustomerMemo`	object	Customer-facing memo
↳ `BillEmail`	object	Billing email object
↳ `EmailStatus`	string	Email send status (NotSet, NeedToSend, EmailSent)
↳ `MetaData`	object	Create/update timestamps
↳ `SyncToken`	string	Optimistic concurrency token; required for sparse updates
`totalCount`	number	Number of invoices returned

`quickbooks_list_items`

List items (products and services) from QuickBooks Online

输入

参数	类型	必填	描述
`realmId`	string	是	QuickBooks company ID (realmId) — captured at OAuth time
`maxResults`	number	否	Maximum number of items to return (default 100, max 1000)
`startPosition`	number	否	Pagination start position (1-indexed)
`where`	string	否	Optional WHERE clause (e.g., "Type = 'Service'")

输出

参数	类型	描述
`items`	array	Array of items
↳ `Id`	string	QuickBooks item ID
↳ `Name`	string	Item name
↳ `Description`	string	Item description
↳ `Type`	string	Item type (Service, Inventory, NonInventory)
↳ `Active`	boolean	Whether the item is active
↳ `UnitPrice`	number	Unit price
↳ `IncomeAccountRef`	object	Income account reference
↳ `ExpenseAccountRef`	object	Expense account reference
↳ `AssetAccountRef`	object	Asset account reference
↳ `QtyOnHand`	number	Quantity on hand (Inventory only)
↳ `MetaData`	object	Create/update timestamps
↳ `SyncToken`	string	Optimistic concurrency token; required for sparse updates
`totalCount`	number	Number of items returned

`quickbooks_list_payments`

List payments from QuickBooks Online

输入

参数	类型	必填	描述
`realmId`	string	是	QuickBooks company ID (realmId) — captured at OAuth time
`maxResults`	number	否	Maximum number of payments to return (default 100, max 1000)
`startPosition`	number	否	Pagination start position (1-indexed)
`where`	string	否	Optional WHERE clause

输出

参数	类型	描述
`payments`	array	Array of payments
↳ `Id`	string	QuickBooks payment ID
↳ `TxnDate`	string	Transaction date (YYYY-MM-DD)
↳ `CustomerRef`	object	Customer reference
↳ `TotalAmt`	number	Total payment amount
↳ `UnappliedAmt`	number	Unapplied amount
↳ `PaymentMethodRef`	object	Payment method reference
↳ `PaymentRefNum`	string	Payment reference number
↳ `Line`	array	Payment line items / linked transactions
↳ `CurrencyRef`	object	Currency reference
↳ `MetaData`	object	Create/update timestamps
↳ `SyncToken`	string	Optimistic concurrency token; required for sparse updates
`totalCount`	number	Number of payments returned

`quickbooks_list_vendors`

List vendors from QuickBooks Online

输入

参数	类型	必填	描述
`realmId`	string	是	QuickBooks company ID (realmId) — captured at OAuth time
`maxResults`	number	否	Maximum number of vendors to return (default 100, max 1000)
`startPosition`	number	否	Pagination start position (1-indexed)
`where`	string	否	Optional WHERE clause (e.g., "Active = true")

输出

参数	类型	描述
`vendors`	array	Array of vendors
↳ `Id`	string	QuickBooks vendor ID
↳ `DisplayName`	string	Display name
↳ `CompanyName`	string	Company name
↳ `GivenName`	string	First name
↳ `FamilyName`	string	Last name
↳ `PrimaryEmailAddr`	object	Primary email object with `Address`
↳ `PrimaryPhone`	object	Primary phone object with `FreeFormNumber`
↳ `Active`	boolean	Whether the vendor is active
↳ `Balance`	number	Open balance owed to the vendor
↳ `CurrencyRef`	object	Currency reference
↳ `MetaData`	object	Create/update timestamps
↳ `SyncToken`	string	Optimistic concurrency token; required for sparse updates
`totalCount`	number	Number of vendors returned

`quickbooks_query`

Run a QuickBooks Online query using SQL-like syntax (example: SELECT * FROM Item WHERE Active = true)

输入

参数	类型	必填	描述
`realmId`	string	是	QuickBooks company ID (realmId) — captured at OAuth time
`query`	string	是	QuickBooks Query Language statement (e.g., "SELECT * FROM Vendor WHERE Active = true MAXRESULTS 50")

输出

参数	类型	描述
`results`	json	Raw QueryResponse object from QuickBooks
`totalCount`	number	Reported total count

`quickbooks_send_invoice`

Email a QuickBooks invoice to a recipient

输入

参数	类型	必填	描述
`realmId`	string	是	QuickBooks company ID (realmId) — captured at OAuth time
`invoiceId`	string	是	Invoice ID to send
`sendTo`	string	否	Email address override; defaults to BillEmail on the invoice

输出

参数	类型	描述
`invoice`	object	Invoice after send
↳ `Id`	string	QuickBooks invoice ID
↳ `DocNumber`	string	Invoice document number
↳ `TxnDate`	string	Invoice transaction date (YYYY-MM-DD)
↳ `DueDate`	string	Invoice due date (YYYY-MM-DD)
↳ `CustomerRef`	object	Reference to the customer (`value`, `name`)
↳ `Line`	array	Invoice line items
↳ `TotalAmt`	number	Total amount of the invoice
↳ `Balance`	number	Outstanding balance on the invoice
↳ `CurrencyRef`	object	Currency reference
↳ `CustomerMemo`	object	Customer-facing memo
↳ `BillEmail`	object	Billing email object
↳ `EmailStatus`	string	Email send status (NotSet, NeedToSend, EmailSent)
↳ `MetaData`	object	Create/update timestamps
↳ `SyncToken`	string	Optimistic concurrency token; required for sparse updates
`invoiceId`	string	Invoice ID

`quickbooks_update_customer`

Sparse-update an existing QuickBooks customer

输入

参数	类型	必填	描述
`realmId`	string	是	QuickBooks company ID (realmId) — captured at OAuth time
`customerId`	string	是	Customer ID to update
`syncToken`	string	是	Current SyncToken from the customer record (required for updates)
`displayName`	string	否	Display name
`companyName`	string	否	Company name
`givenName`	string	否	First name
`familyName`	string	否	Last name
`primaryEmail`	string	否	Primary email address
`primaryPhone`	string	否	Primary phone number
`notes`	string	否	Free-form notes

输出

参数	类型	描述
`customer`	object	Updated customer
↳ `Id`	string	QuickBooks customer ID
↳ `DisplayName`	string	Display name shown in lists and forms
↳ `CompanyName`	string	Company name
↳ `GivenName`	string	First name
↳ `FamilyName`	string	Last name
↳ `PrimaryEmailAddr`	object	Primary email object with `Address`
↳ `PrimaryPhone`	object	Primary phone object with `FreeFormNumber`
↳ `Active`	boolean	Whether the customer is active
↳ `Balance`	number	Open balance owed by the customer
↳ `CurrencyRef`	object	Currency reference (`value`, `name`)
↳ `Notes`	string	Free-form notes
↳ `MetaData`	object	Create/update timestamps
↳ `SyncToken`	string	Optimistic concurrency token; required for sparse updates
`customerId`	string	Customer ID

`quickbooks_update_invoice`

Update an existing QuickBooks invoice (sparse update — date/memo/email only; line items cannot be modified)

输入

参数	类型	必填	描述
`realmId`	string	是	QuickBooks company ID (realmId) — captured at OAuth time
`invoiceId`	string	是	Invoice ID to update
`syncToken`	string	是	Current SyncToken from the invoice record (required for updates)
`dueDate`	string	否	Due date (YYYY-MM-DD)
`customerMemo`	string	否	Customer-facing memo
`billEmail`	string	否	Billing email address

输出

参数	类型	描述
`invoice`	object	Updated invoice
↳ `Id`	string	QuickBooks invoice ID
↳ `DocNumber`	string	Invoice document number
↳ `TxnDate`	string	Invoice transaction date (YYYY-MM-DD)
↳ `DueDate`	string	Invoice due date (YYYY-MM-DD)
↳ `CustomerRef`	object	Reference to the customer (`value`, `name`)
↳ `Line`	array	Invoice line items
↳ `TotalAmt`	number	Total amount of the invoice
↳ `Balance`	number	Outstanding balance on the invoice
↳ `CurrencyRef`	object	Currency reference
↳ `CustomerMemo`	object	Customer-facing memo
↳ `BillEmail`	object	Billing email object
↳ `EmailStatus`	string	Email send status (NotSet, NeedToSend, EmailSent)
↳ `MetaData`	object	Create/update timestamps
↳ `SyncToken`	string	Optimistic concurrency token; required for sparse updates
`invoiceId`	string	Invoice ID