Overview
After connecting your TikTok Shop, Dashboardly automatically imports your complete sales history. This page explains what gets imported, how long it takes, and how data stays up to date.
What Data Is Imported?
Dashboardly imports the following data types from TikTok Shop:
| Data Type | Description |
|---|---|
| Products | Your full product catalog including SKUs, pricing, and images |
| Product Inventory | Stock levels across all warehouses (FBS and FBT) |
| Orders | Complete order history with customer data and order status |
| Order Line Items | Individual items within each order |
| Financial Statements | Payment statements with revenue breakdowns |
| Statement Transactions | Order-level financial details (fees, taxes, discounts) |
| Refunds & Returns | All refunded and returned orders with amounts and reasons |
| Warehouse Data | FBT warehouse information and inbound shipments |
Import Stages
The import runs through a multi-stage pipeline. You'll see progress for each stage in real-time:
- Products Catalog — Fetches all your products and SKUs
- Product Details & Images — Downloads extended product information
- Product Inventory — Syncs current stock levels per warehouse
- Orders — Downloads your complete order history
- Financial Statements — Fetches payment settlement data
- Statement Transactions — Imports order-level financial breakdowns
- Refunds & Returns — Imports all return and refund records
- Warehouses & FBT — Syncs warehouse and fulfillment data (if applicable)
- Analytics & Metrics — Computes business metrics from all imported data
How Long Does the Initial Import Take?
Import time depends on your shop size:
| Shop Size | Estimated Time |
|---|---|
| Small (< 100 orders) | 5–15 minutes |
| Medium (100–10K orders) | 30 min – 2 hours |
| Large (10K–250K orders) | 2–8 hours |
| Very large (250K+ orders) | 8+ hours |
During import, you'll see a progress modal with:
- Overall progress bar
- Status for each import stage (pending, in progress, completed)
- Estimated time remaining
- Items processed vs. total
You can close the modal and continue using Dashboardly — the import runs in the background.
Automatic Data Sync
After the initial import, Dashboardly keeps your data fresh automatically:
- Scheduled sync runs twice daily at 02:00 and 14:00 UTC
- Each sync looks back at the last 3 days of data to catch any updates
- Webhooks from TikTok provide real-time updates for new orders, product changes, and returns
You don't need to do anything — your data stays current automatically.
Important Notes
Financial Statement Delay
TikTok financial statements take at least 48 hours to become available after an order is placed. If you see orders without financial data, this is normal — statements will appear on the next sync after they're generated by TikTok.
Data Accuracy
Dashboardly imports data exactly as provided by TikTok's API. If you notice discrepancies, check the My Numbers Don't Match TikTok troubleshooting guide.
Triggering a Manual Import
If you need to refresh your data immediately:
- Go to Settings → Import History
- Click Run Import
- The import will process all data types and show progress
This uses the same pipeline as the automatic sync.