Search QuickBooks sync history | Distru Documentation

Inputs

Every tool also takes the common inputs.

Field	Type	Required	Description
limit	integer	No	Default: `10`
cursor	string	No	nextCursor of the previous call; keep the other arguments unchanged.
ids	string[]	No
statuses	enum[] `ERRORPENDINGSYNCED`	No
search	string	No	Case-insensitive substring of the title (the record's number or name) or of the description, which holds the error on a failed one.
createdDateAfter	string	No	Inclusive. YYYY-MM-DD (start of day, company timezone) or ISO 8601 with a UTC offset.
createdDateBefore	string	No	Inclusive. YYYY-MM-DD (end of day, company timezone) or ISO 8601 with a UTC offset.
includeDismissed	boolean	No	Also return activities dismissed from the QuickBooks activity page (dismissedAt set). They still count toward the record's qbSyncStatus.
invoiceIds	string[]	No	Also matches bulk syncs that synced these invoices. Resolve via distru-search-invoices.
paymentIds	string[]	No	Invoice or purchase payments. Also matches bulk syncs that synced these invoice payments. A bill payment synced through its purchase order's activity is found with purchaseOrderIds instead. Resolve via distru-search-invoice-payments or distru-search-purchase-payments.
creditIds	string[]	No	Also matches bulk syncs that synced these credits. Resolve via distru-search-credits.
purchaseOrderIds	string[]	No	Also matches the syncs of their bill payments. Resolve via distru-search-purchase-orders.
returnIds	string[]	No	Resolve via distru-search-returns.
taxIds	string[]	No	Resolve via distru-search-lookups (type TAX).
paymentMethodIds	string[]	No	Resolve via distru-search-lookups (type PAYMENT_METHOD).
quickbooksItemIds	string[]	No	Resolve via distru-search-quickbooks-items.
sortBy	object	No	Default UPDATED_AT DESC.
sortBy.direction	enum `ASCDESC`	Yes
sortBy.field	enum `INSERTED_ATUPDATED_AT`	Yes	UPDATED_AT: when the outcome was last written.

Output

Presence on a nested field assumes its parent exists.

Field	Type	Presence
hasMore	boolean	Always
nextCursor	string	Can be absent
totalCount	integer	Can be absent
items	object[]	Always
items[].id	string	Always
items[].type	enum `BULK_SYNCSYNC`	Always
items[].action	enum `CREATEDELETEINACTIVATEUPDATEVOID`	Can be null
items[].status	enum `ERRORPENDINGSYNCED`	Always
items[].title	string	Always
items[].error	string	Can be null
items[].failureReason	enum `DEPENDENCY_GRAPH_CHANGEDDEPRECATEDDUPLICATE_DOCUMENT_NUMBEROTHERQBO_CUSTOMER_EXISTS`	Can be null
items[].dismissedAt	string	Can be null
items[].insertedAt	string	Always
items[].updatedAt	string	Always
items[].creator	object	Can be null
items[].creator.id	string	Always
items[].creator.profile	object	Always
items[].creator.profile.fullName	string	Always
items[].invoice	object	Can be null
items[].invoice.id	string	Always
items[].invoice.invoiceNumber	string	Always
items[].invoicePayment	object	Can be null
items[].invoicePayment.id	string	Always
items[].invoicePayment.paymentNumber	string	Always
items[].credit	object	Can be null
items[].credit.id	string	Always
items[].credit.creditNumber	string	Always
items[].purchaseOrder	object	Can be null
items[].purchaseOrder.id	string	Always
items[].purchaseOrder.purchaseNumber	string	Always
items[].purchasePayment	object	Can be null
items[].purchasePayment.id	string	Always
items[].purchasePayment.paymentNumber	string	Always
items[].purchasePayment.purchaseOrder	object	Can be null
items[].purchasePayment.purchaseOrder.id	string	Always
items[].purchasePayment.purchaseOrder.purchaseNumber	string	Always
items[].return	object	Can be null
items[].return.id	string	Always
items[].return.returnNumber	string	Always
items[].tax	object	Can be null
items[].tax.id	string	Always
items[].tax.name	string	Always
items[].paymentMethod	object	Can be null
items[].paymentMethod.id	string	Always
items[].paymentMethod.name	string	Always
items[].quickbooksItem	object	Can be null
items[].quickbooksItem.id	string	Always
items[].quickbooksItem.name	string	Always
items[].entities	object[]	Always
items[].entities[].entityType	enum `CREDITINVOICEINVOICE_PAYMENT`	Always
items[].entities[].status	enum `ERRORPENDINGSKIPPEDSYNCED`	Always
items[].entities[].invoice	object	Can be null
items[].entities[].invoice.id	string	Always
items[].entities[].invoice.invoiceNumber	string	Always
items[].entities[].invoicePayment	object	Can be null
items[].entities[].invoicePayment.id	string	Always
items[].entities[].invoicePayment.paymentNumber	string	Always
items[].entities[].credit	object	Can be null
items[].entities[].credit.id	string	Always
items[].entities[].credit.creditNumber	string	Always

What the AI reads

Searches QuickBooks activities — each is one attempt to write a Distru change to QuickBooks Online (an invoice, payment, credit, purchase order, bill payment, return, tax, payment method or QuickBooks item), as on the QuickBooks activity page. Use it to find why a record hasn't reached QuickBooks, or what is failing or still queued; to push a record again use distru-sync-to-quickbooks with the activity's record (a bulk sync's first entity is its root). It is the full history, not the current state: an old ERROR stays after a later activity for the same record succeeds, so the record's own qbSyncStatus says where it stands now. Activities sync independently; a failed one holds back no other. A BULK_SYNC syncs an invoice, payment or credit together with the records it depends on and lists them in entities, where one still PENDING under an ERROR activity did not sync; action is null on bulk syncs, purchase order and bill payment syncs, bill deletes and old activities. The record fields are null on a bulk sync, when the record was deleted, or when the caller's team can't see it. error is the error text, only while status is ERROR. failureReason: DUPLICATE_DOCUMENT_NUMBER = QuickBooks already has a document with that number (rename it in QuickBooks, then sync the record, or overwrite it from the QuickBooks activity page); QBO_CUSTOMER_EXISTS = map the customer from the QuickBooks activity page, then sync the record; DEPENDENCY_GRAPH_CHANGED and DEPRECATED = sync the record again.