How long does it take for a newly connected channel to pull in / sync historical data?

When you connect a new marketplace channel to MerchantSpring, the platform begins an initial historical data sync to populate your dashboards, reports, and analytics.

During this process, MerchantSpring retrieves historical data from the marketplace APIs (such as Amazon) and processes it into the platform’s reporting structure. Because multiple datasets are retrieved—including orders, financial events, advertising metrics, and product information—the full sync can take some time depending on the size and complexity of your account.

For most accounts, initial data begins appearing within minutes, while the full historical sync typically completes within 24 hours*.

Trial Accounts

For trial accounts, once you connect your marketplace account to MerchantSpring, the system will typically sync up to 90 days of historical data for most reports.

This process usually completes within 24 hours.

While your data is syncing, you can explore the platform using demo store data, which is automatically removed once your real marketplace data has finished syncing.

Paid Accounts

Once you subscribe to a MerchantSpring plan, the platform will begin syncing additional historical data according to your plan’s inclusions.

If your plan includes extended historical reporting, the platform will continue retrieving older marketplace data after the initial sync completes.

What Data Is Synced During Initial Setup

During the initial connection, MerchantSpring typically retrieves several types of marketplace data:

• Orders and sales data

• Financial event data (fees, refunds, reimbursements, adjustments)

• Product catalog and SKU information

• Advertising metrics (if advertising permissions are granted)

• Inventory information (where available)

Some datasets may appear before others because they are retrieved through different marketplace APIs.

What You May Notice During the Sync Process

While the sync is running, you may notice some temporary discrepencies in your reports, such as:

• Reports initially showing partial data

• Some products appearing before others

• Advertising metrics appearing later than sales data

• Profit reports changing as financial events are processed

This behaviour is normal while MerchantSpring processes the full historical dataset.

Factors That Affect Sync Speed

The total sync time depends on several factors, including:

• Number of orders in your account

• Size of your product catalog

• Number of months or years of historical data

• Marketplace API limits (for example, Amazon API rate limits)

For very large stores with significant order volume or long historical reporting periods, the full sync may take several days or longer. *In some cases, large accounts may require 10+ days to complete the full historical data import due to marketplace API limitations.

Tips

• Initial data usually appears within minutes, but a full historical sync may take approximatily 24 hours for most connections.

• Advertising data may appear later than sales data due to separate API retrieval processes.

• Financial events such as refunds or adjustments may appear gradually as they are retrieved from Amazon’s financial APIs.

• Large accounts with extensive historical data may take longer to fully populate. It is not uncommon for these to take 10+ days to complete.

Troubleshooting

If your data has not appeared after the expected timeframe, we recommend checking the connection status and sync status banner for the specific channel.

1. To check the connection status:

   1. Navigate to Settings → Channels

   2. Confirm the channel shows as Connected

   3. Verify the correct permissions were granted during authentication 

2. To check the sync banner status:

   1. Navigating to My Channels

   2. Selecting the relevant channel from the dropdown list

   3. Reviewing the sync status banner displayed at the top of the screen

   This banner shows the current progress of the historical data sync for that channel and will indicate whether the sync is still in progress, completed, or has encountered an issue.

If you continue to experience issues after following these steps, please contact our support team at support@merchantspring.com.au and we will investigate the sync status and provide an estimated completion timeframe.