When a document can't sync from Dockwa to your accounting system, it shows as Failed on the Sync Details tab with a sync error code. Most codes tell you exactly what to fix; after you fix it, click Retry. Some codes clear on their own, and a few need Dockwa Support.
Who can do this: Admin, Finance
Where: Marketplace → your accounting integration → Sync Details
Before you start: Your integration status must be on. Retry is unavailable while the integration is inactive.
How do I find failed syncs?
Sync Details is part of Dockwa's newer accounting integration. If your integration shows an Export tab instead, contact Dockwa Support.
Go to Marketplace and click Go to integration → on your accounting system.
Open Sync Details.
Click Status and select Failed (and Excluded, if you want to review those too).
Hover over the code in the Sync Error Code column to read the message. When a row has both kinds of error, messages are grouped under Action required and No action needed.
Fix the cause, then click Retry on the row.
You can also search by customer, Dockwa ID, or your accounting system's reference number, and filter by Error Code or by Type:
Invoice
Credit note
Payment
Refund
Journal entry
What do the sync statuses mean?
Status | Meaning |
Pending | Waiting to sync, or being retried automatically |
Success | Synced to your accounting system |
Failed | Could not sync. Check the error code. |
Excluded | Not sent, for example because it is dated before your Exclude Syncing Before date |
Destroyed | Removed from your accounting system by Dockwa |
What does each error code mean, and how do I fix it?
Code | System | Cause | Fix |
item-001 | All | A product, the discount item, or the sales tax item is not mapped | Map products on Item Mapping. Link the discount or sales tax item on Setup. Then click Retry. |
customer-001 | QuickBooks Online | The QuickBooks customer being used has been deleted (made inactive) | Reactivate the customer in QuickBooks, then retry. If the customer was merged into another one, contact Support. |
customer-002 | QuickBooks Online | The customer on an existing QuickBooks transaction was deleted, so the transaction can't be updated | In QuickBooks, assign an active customer to the transaction (or reactivate the customer), then retry. |
sync-002 | QuickBooks Online | QuickBooks rejected how a payment or credit was applied to an invoice | Contact Dockwa Support. |
sync-003 | All | Your accounting system is temporarily limiting requests | No action needed. Dockwa retries automatically. If it ends as Failed, click Retry. |
sync-004 | All | Your accounting system timed out | No action needed. Dockwa retries automatically. If it ends as Failed, click Retry. |
sync-005 | NetSuite | NetSuite won't remove a line because other transactions are linked to it | Contact Dockwa Support. |
sync-006 | All | The payment, credit note, or refund applies to a document dated before your Exclude Syncing Before date | Record it manually in your accounting system, or move the Exclude Syncing Before date to on or before the referenced document's date and retry. |
sync-007 | All | The document applies to another document that isn't in your accounting system yet | Click the linked document under the code, fix its sync error, then retry. Both sync together. |
sync-001 | All | Unclassified sync error | Click Retry once. If it fails again, contact Support and give them the Dockwa ID. |
Are there errors specific to Sage Intacct, Xero, or MRI?
Those systems use these shared codes:
item-001
item-005
sync-001
sync-003
sync-004
sync-006 through sync-012
Errors Dockwa doesn't recognize appear as sync-001. All of these errors appear on the same Sync Details tab as QuickBooks Online and NetSuite.
Can I keep my books current while an error is being fixed?
Yes. For QuickBooks Online, you can enter the invoice, payment, refund, or credit memo yourself using the values on the Sync Details row. Enter them exactly as shown so the records match.
What doesn't sync back from my accounting system?
The sync runs one way, from Dockwa to your accounting system. Edits made in your accounting system don't change Dockwa, and they can cause later updates to fail (for example, customer-002).
