Retrying Failed Import Items

How to retry items that failed during a bulk import.

Finding Failed Items

Access Your Import Job

  1. Go to Import in the sidebar
  2. Click Jobs to see all import jobs
  3. Find the job with failures
  4. Click to view job details

Viewing Failed Items

In the job details:

  • See total count of failed items
  • Filter to show only failed items
  • View error message for each failure

Understanding Failures

Review Error Messages

Each failed item shows:

  • Item type - Invoice or Payment
  • HubSpot ID - The source record
  • Error message - What went wrong
  • Timestamp - When the failure occurred

Common Error Types

Error Meaning
SKU not found Product doesn't exist in QuickBooks
Customer email missing Contact needs email address
Invoice not synced Payment's invoice must sync first
Already exists Record was previously synced
Unauthorized Connection issue

Fixing Issues Before Retry

Step 1: Identify Patterns

Look for common issues:

  • Same SKU missing across multiple items?
  • Same customer causing failures?
  • All failures have similar errors?

Step 2: Fix Root Causes

For SKU issues:

  1. List all missing SKUs
  2. Create products in QuickBooks with matching SKUs
  3. Then retry

For customer issues:

  1. Find contacts in HubSpot
  2. Add/fix email addresses
  3. Then retry

For connection issues:

  1. Go to Settings then Connections
  2. Reconnect affected system
  3. Then retry

Retrying Failed Items

Retry All Failed

To retry all failed items in a job:

  1. Open the import job
  2. Click Retry Failed Items
  3. Confirm the action
  4. Failed items are re-queued for processing

Retry Individual Items

To retry specific items:

  1. Find the item in the failed list
  2. Click the retry button for that item
  3. The single item is re-queued

What Happens During Retry

  1. Item status changes to Pending
  2. Item is added to processing queue
  3. Sync is attempted again
  4. Result is Success or Failed

Retry Count

Each item tracks how many times it's been retried:

  • First attempt is not a retry
  • Multiple failures on same item may indicate persistent issue

After Retrying

Monitor Results

  1. Watch the job progress update
  2. Check if retried items succeed
  3. Review any that fail again

For Repeated Failures

If an item keeps failing:

  1. Review the error message carefully
  2. Verify the fix was applied correctly
  3. Check both source and destination systems
  4. Consider whether the record has issues

When All Items Succeed

Once all items succeed:

  • Job shows "Completed" status
  • Verify data in QuickBooks
  • You're done with this import

Best Practices

Fix Before Retry

Don't retry immediately hoping it works:

  • Identify the cause
  • Fix the underlying issue
  • Then retry

Batch Your Fixes

If many items have the same issue:

  1. Fix all instances of that issue
  2. Then retry all affected items
  3. More efficient than one at a time

Don't Over-Retry

If an item fails repeatedly:

  • There may be a data quality issue
  • Consider whether it should sync at all
  • Some records may need manual handling

Checking Final Results

In SimpleCommerceSync

  1. View the completed job
  2. Confirm all items show Success
  3. Check sync logs for any remaining issues

In QuickBooks

  1. Verify imported invoices appear
  2. Check amounts and customers
  3. Confirm payments are applied