Sync a record to QuickBooks
distru-sync-to-quickbooksWriteQuickBooksPushes one record to QuickBooks again, with anything it depends on.
Inputs
Every tool also takes the common inputs.
| Field | Type | Required | Description |
|---|---|---|---|
| invoiceId | string | No | Resolve via distru-search-invoices. |
| paymentId | string | No | Invoice or purchase payment. Resolve via distru-search-invoice-payments or distru-search-purchase-payments. |
| creditId | string | No | Resolve via distru-search-credits. |
| purchaseOrderId | string | No | Resolve via distru-search-purchase-orders. |
| quickbooksItemId | string | No | Resolve via distru-search-quickbooks-items. |
Output
Presence on a nested field assumes its parent exists.
| Field | Type | Presence |
|---|---|---|
| quickbooksActivity | object | Always |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | enumBULK_SYNCSYNC | Always |
| quickbooksActivity. | enumCREATEDELETEINACTIVATEUPDATEVOID | Can be null |
| quickbooksActivity. | enumERRORPENDINGSYNCED | Always |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | string | Can be null |
| quickbooksActivity. | enumDEPENDENCY_GRAPH_CHANGEDDEPRECATEDDUPLICATE_DOCUMENT_NUMBEROTHERQBO_CUSTOMER_EXISTS | Can be null |
| quickbooksActivity. | string | Can be null |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | object | Can be null |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | object | Always |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | object | Can be null |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | object | Can be null |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | object | Can be null |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | object | Can be null |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | object | Can be null |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | object | Can be null |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | object | Can be null |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | object | Can be null |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | object | Can be null |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | object | Can be null |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | object[] | Always |
| quickbooksActivity. | enumCREDITINVOICEINVOICE_PAYMENT | Always |
| quickbooksActivity. | enumERRORPENDINGSKIPPEDSYNCED | Always |
| quickbooksActivity. | object | Can be null |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | object | Can be null |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | object | Can be null |
| quickbooksActivity. | string | Always |
| quickbooksActivity. | string | Always |
What the AI reads
Pushes one record's current Distru data to QuickBooks Online, with the records it depends on that aren't in QuickBooks yet, and returns the activity that tracks the push, as distru-search-quickbooks-activities returns it. Takes exactly one record id. Use it to fix a failed activity or a record whose qbSyncStatus isn't SYNCED; the record is pushed even when already SYNCED. An invoice, invoice payment or credit syncs as one BULK_SYNC whose entities list every record it includes. Dependencies are transitive: an invoice brings its unsynced payments; a payment its invoice, the credits it spends and the overpayment credit it created; a credit the payment that created it and the payments that spend it; and each record brought along brings its own, stopping at records already synced. A voided invoice or invoice payment is voided in QuickBooks instead. A purchase order brings its bill payments that aren't synced; they get their own activities once the bill has synced. A bill payment whose purchase order isn't synced goes through the purchase order, so the returned activity is the purchase order's. It never overwrites a QuickBooks record that has the same document number. The returned activity is PENDING: the push runs in the background, so check it later with distru-search-quickbooks-activities by its id. Rejected with the reason when QuickBooks isn't connected and set up (distru-get-quickbooks-integration), when the QuickBooks settings don't sync that kind of record, when the record can't sync (a draft purchase order, for one), or when a sync of it is already queued.