Sync Error Recovery

About This Article

Network issues and API rate limits mean sync failures are unavoidable. Therefore, we need to design recovery methods for errors. This article explains error patterns and their solutions.

Types of Sync Failures

Error Pattern Classification

Error Patterns and Solutions

Pattern 1: POS API Connection Error

Connection Error Response Policy

Keep Shopify registration successful

Maintain main registration process

Skip POS sync

Log error, notify admin

Re-sync later

Execute re-sync manually or automatically

Customer impact: Normal use online. Guide store use with "Please wait a moment"

Pattern 2: Data Format Error

Data Error Response Policy

Log error details

Identify which field has the problem

Attempt auto-fix

If possible, fix and retry / If not, notify admin

Pattern 3: Duplicate Error

Duplicate Error Response Policy

Attempt to link with existing customer

Search existing customer by email address

Linking result

Success -> Update existing customer's member number / Failure -> Record potential duplicate

Admin reviews and merges

Combine point balances, integrate purchase history, invalidate old record

Recovery Mechanism

Automatic Retry

Exponential backoff: Doubling wait time reduces server load

Managing Unsynced Data

Admin panel verification method:

Filter by "POS sync failed"
Check error content
Retry with "Re-sync" button

Admin Tools

Sync Status Check

Operation: "Batch re-sync unsynced" button processes all targets at once

Re-sync Function

Select targets

Select unsynced customers from list (individual or batch)

Execute re-sync

Run sync process again with "Re-sync" button

Check results

Verify success/failure results

Continue response

If still failing, check error details and respond

Error Log Design

Information to Record

Log Example

Monitoring and Alerts

Alert Conditions

Dashboard

Error trend: Graph error occurrence count over time to understand trends

Recent errors: 10:30 Connection error 1 case -> Resolved by auto-retry

Benefits of This Design

Availability

Overall service continues despite some errors
Auto-retry recovers from temporary failures
Quick awareness when manual response needed

Operational Efficiency

Automatic error detection and notification
Easy re-sync from admin panel
Rich logs for cause investigation

Customer Experience

Basic service continues despite errors
Minimized time to problem resolution
Transparent status reporting possible