Skip to main content

Fix Accounting Sync Errors

Find failed accounting syncs, what each sync error code means, and how to fix it.

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.

  1. Go to Marketplace and click Go to integration → on your accounting system.

  2. Open Sync Details.

  3. Click Status and select Failed (and Excluded, if you want to review those too).

  4. 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.

  5. 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).

Related articles

Did this answer your question?