Troubleshooting Sync Issues

Common Sync Issues

Quick solutions for the most common synchronization problems.

Authentication Errors

Problem: API credentials rejected or expired
Solution:
1. Verify credentials in supplier/destination settings
2. Check if API access has been revoked
3. Regenerate API keys if necessary
4. Ensure IP whitelist includes our servers

Data Mapping Errors

Problem: Products not importing or fields missing
Solution:
1. Review field mapping configuration
2. Check for required fields on destination
3. Verify data format compatibility
4. Test with a single product first

Rate Limiting

Problem: Sync slowing down or timing out
Solution:
1. Reduce batch sizes in sync settings
2. Increase delays between API calls
3. Schedule syncs during off-peak hours
4. Contact support for rate limit increases

Inventory Discrepancies

Problem: Stock levels not matching between systems
Solution:
1. Check sync frequency settings
2. Verify inventory mapping rules
3. Review overselling protection settings
4. Manually trigger inventory sync

Product Listing Failures

Problem: Products not appearing on sales channels
Solution:
1. Check channel-specific requirements
2. Verify category mappings
3. Ensure all required fields are populated
4. Review channel approval process