Retrying Failed Invoice Syncs

When an invoice sync fails, you can retry it after fixing the underlying issue.

Finding Failed Syncs

  1. Go to Data in the sidebar
  2. Click Invoices
  3. Look for entries with a red Failed status badge
  4. Recent failures appear at the top of the list

Understanding the Failure

Before retrying, understand why the sync failed:

  1. Click on the failed sync entry
  2. Review the error message - this explains what went wrong
  3. Note any specific details (SKU names, customer info, etc.)

Common Error Types

Error Meaning Action Needed
SKU not found Product doesn't exist in destination Create the product with matching SKU
Customer email missing Contact has no email Add email to the contact
Unauthorized Connection issue Reconnect HubSpot or QuickBooks
Already synced Invoice exists in destination Check destination; may not need retry

Fixing the Issue

Resolve the underlying problem before retrying:

For SKU not found:

  1. Identify the missing SKU from the error
  2. Go to the destination system (HubSpot or QuickBooks)
  3. Create the product with the exact matching SKU
  4. Return to SimpleCommerceSync to retry

For customer issues:

  1. Find the contact in the source system
  2. Add or correct the email address
  3. Return to SimpleCommerceSync to retry

For connection issues:

  1. Go to Settings then Connections
  2. Reconnect the affected system
  3. Return to retry the sync

Performing the Retry

Once you've fixed the issue:

  1. Go to Data then Invoices
  2. Find the failed sync
  3. Click to view details
  4. Click the Retry Sync button

What Happens During Retry

After clicking retry:

  1. Status changes to Pending
  2. The sync is queued for processing
  3. Status changes to Processing when work begins
  4. Final status is Success or Failed

This typically takes just a few seconds.

Retry Limitations

Which syncs can be retried

  • Failed status - Can be retried
  • Pending status - Can be retried (re-queues the sync)
  • Success status - Cannot be retried (already completed)
  • Processing status - Wait for it to complete first

Retry count

Each sync tracks how many times it's been retried. Multiple failures on the same invoice may indicate a persistent issue that needs investigation.

Bulk Retries

If you have many failed syncs:

  1. Fix the common underlying issues first (e.g., create all missing products)
  2. Retry each failed sync individually
  3. For large numbers, consider using the bulk import feature to re-process historical data

Tips for Reducing Failures

  • Keep products synced - Enable product sync to maintain matching SKUs
  • Verify data quality - Ensure contacts have email addresses
  • Monitor regularly - Check sync logs daily to catch issues early
  • Test new products - After adding products, test with a single invoice

If Retry Keeps Failing

If the same invoice keeps failing after multiple retries:

  1. Review the error message carefully each time
  2. Verify the fix was applied correctly
  3. Check both source and destination systems
  4. Look for data issues (special characters, unusual values)
  5. Contact support if the issue persists