QuickBooks

Manage QuickBooks Online customers, invoices, and accounting data

Nutzungsanweisungen

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.

Tools

`quickbooks_create_bill`

Create a new bill (vendor expense) in QuickBooks Online

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`realmId`	string	Ja	QuickBooks company ID (realmId) — captured at OAuth time
`vendorId`	string	Ja	Vendor ID for the bill
`lines`	json	Ja	Bill line items (JSON array). Each entry: { amount, accountId, description? }
`txnDate`	string	Nein	Transaction date (YYYY-MM-DD)
`dueDate`	string	Nein	Due date (YYYY-MM-DD)

Ausgabe

Parameter	Typ	Beschreibung
`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

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`realmId`	string	Ja	QuickBooks company ID (realmId) — captured at OAuth time
`displayName`	string	Ja	Display name (must be unique within the company)
`companyName`	string	Nein	Company name
`givenName`	string	Nein	First name
`familyName`	string	Nein	Last name
`primaryEmail`	string	Nein	Primary email address
`primaryPhone`	string	Nein	Primary phone number
`notes`	string	Nein	Free-form notes

Ausgabe

Parameter	Typ	Beschreibung
`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

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`realmId`	string	Ja	QuickBooks company ID (realmId) — captured at OAuth time
`customerId`	string	Ja	Customer ID to bill
`lines`	json	Ja	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	Nein	Transaction date (YYYY-MM-DD)
`dueDate`	string	Nein	Due date (YYYY-MM-DD)
`customerMemo`	string	Nein	Memo shown to the customer on the invoice
`billEmail`	string	Nein	Email address to bill (used by Send Invoice flows)

Ausgabe

Parameter	Typ	Beschreibung
`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

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`realmId`	string	Ja	QuickBooks company ID (realmId) — captured at OAuth time
`name`	string	Ja	Item name (must be unique within the company)
`type`	string	Ja	Item type — Service or NonInventory (Inventory not supported in MVP)
`incomeAccountId`	string	Ja	Income account ID to associate with the item
`description`	string	Nein	Item description
`unitPrice`	number	Nein	Unit price for the item

Ausgabe

Parameter	Typ	Beschreibung
`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

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`realmId`	string	Ja	QuickBooks company ID (realmId) — captured at OAuth time
`customerId`	string	Ja	Customer ID making the payment
`amount`	number	Ja	Total payment amount
`invoiceId`	string	Nein	Optional invoice ID to apply the payment to
`paymentMethodId`	string	Nein	Payment method ID
`txnDate`	string	Nein	Transaction date (YYYY-MM-DD)
`paymentRefNum`	string	Nein	Payment reference number (e.g., check number)

Ausgabe

Parameter	Typ	Beschreibung
`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

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`realmId`	string	Ja	QuickBooks company ID (realmId) — captured at OAuth time
`displayName`	string	Ja	Display name (must be unique within the company)
`companyName`	string	Nein	Company name
`givenName`	string	Nein	First name
`familyName`	string	Nein	Last name
`primaryEmail`	string	Nein	Primary email address
`primaryPhone`	string	Nein	Primary phone number

Ausgabe

Parameter	Typ	Beschreibung
`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

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`realmId`	string	Ja	QuickBooks company ID (realmId) — captured at OAuth time

Ausgabe

Parameter	Typ	Beschreibung
`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

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`realmId`	string	Ja	QuickBooks company ID (realmId) — captured at OAuth time
`customerId`	string	Ja	QuickBooks customer ID

Ausgabe

Parameter	Typ	Beschreibung
`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

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`realmId`	string	Ja	QuickBooks company ID (realmId) — captured at OAuth time
`invoiceId`	string	Ja	QuickBooks invoice ID

Ausgabe

Parameter	Typ	Beschreibung
`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

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`realmId`	string	Ja	QuickBooks company ID (realmId) — captured at OAuth time
`vendorId`	string	Ja	QuickBooks vendor ID

Ausgabe

Parameter	Typ	Beschreibung
`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

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`realmId`	string	Ja	QuickBooks company ID (realmId) — captured at OAuth time
`maxResults`	number	Nein	Maximum number of accounts to return (default 100, max 1000)
`startPosition`	number	Nein	Pagination start position (1-indexed)
`where`	string	Nein	Optional WHERE clause (e.g., "AccountType = 'Income'")

Ausgabe

Parameter	Typ	Beschreibung
`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

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`realmId`	string	Ja	QuickBooks company ID (realmId) — captured at OAuth time
`maxResults`	number	Nein	Maximum number of bills to return (default 100, max 1000)
`startPosition`	number	Nein	Pagination start position (1-indexed)
`where`	string	Nein	Optional WHERE clause

Ausgabe

Parameter	Typ	Beschreibung
`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

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`realmId`	string	Ja	QuickBooks company ID (realmId) — captured at OAuth time
`maxResults`	number	Nein	Maximum number of customers to return (default 100, max 1000)
`startPosition`	number	Nein	Pagination start position (1-indexed)
`where`	string	Nein	Optional WHERE clause (e.g., "Active = true AND DisplayName LIKE 'A%'")

Ausgabe

Parameter	Typ	Beschreibung
`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

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`realmId`	string	Ja	QuickBooks company ID (realmId) — captured at OAuth time
`maxResults`	number	Nein	Maximum number of estimates to return (default 100, max 1000)
`startPosition`	number	Nein	Pagination start position (1-indexed)
`where`	string	Nein	Optional WHERE clause

Ausgabe

Parameter	Typ	Beschreibung
`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

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`realmId`	string	Ja	QuickBooks company ID (realmId) — captured at OAuth time
`maxResults`	number	Nein	Maximum number of invoices to return (default 100, max 1000)
`startPosition`	number	Nein	Pagination start position (1-indexed)
`where`	string	Nein	Optional WHERE clause (e.g., "Balance > '0'")

Ausgabe

Parameter	Typ	Beschreibung
`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

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`realmId`	string	Ja	QuickBooks company ID (realmId) — captured at OAuth time
`maxResults`	number	Nein	Maximum number of items to return (default 100, max 1000)
`startPosition`	number	Nein	Pagination start position (1-indexed)
`where`	string	Nein	Optional WHERE clause (e.g., "Type = 'Service'")

Ausgabe

Parameter	Typ	Beschreibung
`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

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`realmId`	string	Ja	QuickBooks company ID (realmId) — captured at OAuth time
`maxResults`	number	Nein	Maximum number of payments to return (default 100, max 1000)
`startPosition`	number	Nein	Pagination start position (1-indexed)
`where`	string	Nein	Optional WHERE clause

Ausgabe

Parameter	Typ	Beschreibung
`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

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`realmId`	string	Ja	QuickBooks company ID (realmId) — captured at OAuth time
`maxResults`	number	Nein	Maximum number of vendors to return (default 100, max 1000)
`startPosition`	number	Nein	Pagination start position (1-indexed)
`where`	string	Nein	Optional WHERE clause (e.g., "Active = true")

Ausgabe

Parameter	Typ	Beschreibung
`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)

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`realmId`	string	Ja	QuickBooks company ID (realmId) — captured at OAuth time
`query`	string	Ja	QuickBooks Query Language statement (e.g., "SELECT * FROM Vendor WHERE Active = true MAXRESULTS 50")

Ausgabe

Parameter	Typ	Beschreibung
`results`	json	Raw QueryResponse object from QuickBooks
`totalCount`	number	Reported total count

`quickbooks_send_invoice`

Email a QuickBooks invoice to a recipient

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`realmId`	string	Ja	QuickBooks company ID (realmId) — captured at OAuth time
`invoiceId`	string	Ja	Invoice ID to send
`sendTo`	string	Nein	Email address override; defaults to BillEmail on the invoice

Ausgabe

Parameter	Typ	Beschreibung
`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

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`realmId`	string	Ja	QuickBooks company ID (realmId) — captured at OAuth time
`customerId`	string	Ja	Customer ID to update
`syncToken`	string	Ja	Current SyncToken from the customer record (required for updates)
`displayName`	string	Nein	Display name
`companyName`	string	Nein	Company name
`givenName`	string	Nein	First name
`familyName`	string	Nein	Last name
`primaryEmail`	string	Nein	Primary email address
`primaryPhone`	string	Nein	Primary phone number
`notes`	string	Nein	Free-form notes

Ausgabe

Parameter	Typ	Beschreibung
`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)

Eingabe

Parameter	Typ	Erforderlich	Beschreibung
`realmId`	string	Ja	QuickBooks company ID (realmId) — captured at OAuth time
`invoiceId`	string	Ja	Invoice ID to update
`syncToken`	string	Ja	Current SyncToken from the invoice record (required for updates)
`dueDate`	string	Nein	Due date (YYYY-MM-DD)
`customerMemo`	string	Nein	Customer-facing memo
`billEmail`	string	Nein	Billing email address

Ausgabe

Parameter	Typ	Beschreibung
`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

On this page

Nutzungsanweisungen

quickbooks_create_bill

quickbooks_create_customer

quickbooks_create_invoice

quickbooks_create_item

quickbooks_create_payment

quickbooks_create_vendor

quickbooks_get_company_info

quickbooks_get_customer

quickbooks_get_invoice

quickbooks_get_vendor

quickbooks_list_accounts

quickbooks_list_bills

quickbooks_list_customers

quickbooks_list_estimates

quickbooks_list_invoices

quickbooks_list_items

quickbooks_list_payments

quickbooks_list_vendors

quickbooks_query

quickbooks_send_invoice

quickbooks_update_customer

quickbooks_update_invoice