How Data Import Works
Descripción general
Una vez que conectas tu TikTok Shop, Dashboardly comienza a importar tus datos automáticamente. Este proceso trae tus productos, pedidos, estados financieros, reembolsos y más, de modo que tus paneles, informes de pérdidas y ganancias y todas las demás páginas de análisis se completen con cifras precisas.
No necesitas hacer nada manualmente: las importaciones se realizan en segundo plano. Puedes seguir usando Dashboardly mientras la importación está en curso; las páginas se van completando progresivamente a medida que cada tipo de dato está disponible.
Qué se importa
Dashboardly importa los siguientes tipos de datos desde TikTok Shop:
| Tipo de dato | Descripción |
|---|---|
| Productos | Tu catálogo completo de productos, incluidos SKU, precios e imágenes |
| Inventario de productos | Niveles de stock en todos los almacenes (FBS y FBT) |
| Pedidos | Historial completo de pedidos con datos del cliente y estado del pedido |
| Líneas de pedido | Artículos individuales dentro de cada pedido |
| Estados financieros | Estados de pago con desgloses de ingresos |
| Transacciones de estados | Detalles financieros a nivel de pedido (tarifas, impuestos, descuentos) |
| Reembolsos y devoluciones | Todos los pedidos reembolsados y devueltos con importes y motivos |
| Datos de almacén | Información de almacenes FBT y envíos entrantes |
Etapas de la importación
La importación se ejecuta a través de un proceso de múltiples etapas. Verás el progreso de cada etapa en tiempo real:
- Catálogo de productos -- obtiene todos tus productos y SKU
- Detalles e imágenes de productos -- descarga información ampliada de los productos
- Inventario de productos -- sincroniza los niveles de stock actuales por almacén
- Pedidos -- descarga tu historial completo de pedidos
- Estados financieros -- obtiene los datos de liquidación de pagos
- Transacciones de estados -- importa los desgloses financieros a nivel de pedido
- Reembolsos y devoluciones -- importa todos los registros de devoluciones y reembolsos
- Almacenes y FBT -- sincroniza los datos de almacén y cumplimiento (si corresponde)
- Análisis y métricas -- calcula las métricas de negocio a partir de todos los datos importados
Productos sintéticos para pedidos de subasta
Si vendes a través de la Subasta con cuenta regresiva (Countdown Bidding) de TikTok, Dashboardly crea automáticamente registros de productos para estos anuncios temporales. Los productos se agrupan por nombre: si vendes el mismo artículo a través de varias sesiones de Countdown Bidding, aparece como un solo producto en tus análisis. No es necesario que hagas nada por tu parte.
¿Cuánto tarda la primera importación?
El tiempo de importación depende del tamaño de tu tienda:
| Tamaño de la tienda | Tiempo estimado |
|---|---|
| Pequeña (menos de 100 pedidos) | 5 -- 15 minutos |
| Mediana (100 -- 10K pedidos) | 30 minutos -- 2 horas |
| Grande (10K -- 250K pedidos) | 2 -- 8 horas |
| Muy grande (más de 250K pedidos) | Más de 8 horas |
Durante la importación, verás una ventana de progreso con:
- Una barra de progreso general
- El estado de cada etapa de importación (pendiente, en curso, completada)
- El tiempo restante estimado
- Elementos procesados frente al total
Puedes cerrar la ventana y seguir usando Dashboardly: la importación se ejecuta en segundo plano.
Fiabilidad de la importación
Dashboardly está diseñado para gestionar importaciones de cualquier tamaño de forma fiable:
- Importaciones de larga duración. En tiendas grandes, las importaciones pueden tardar varias horas. Dashboardly mantiene activa tu sesión de API durante todo el proceso para que las importaciones se completen sin errores de autorización. Si un token caduca realmente, vuelve a conectar la tienda en Settings → Shops y la importación se reanudará.
- Reintentos automáticos para los datos de marketing. Si se produce un error de red temporal al importar tus datos de TikTok Ads, la importación se reintenta automáticamente. No necesitas hacer nada.
Sincronización automática de datos (después de la importación inicial)
Después de la importación inicial, Dashboardly mantiene tus datos actualizados automáticamente:
- La sincronización programada se ejecuta dos veces al día, a las 02:00 y 14:00 UTC
- Cada sincronización programada revisa los últimos 3 días de datos para captar cualquier actualización que TikTok haya emitido desde la ejecución anterior
- Los webhooks de TikTok proporcionan actualizaciones en tiempo real para nuevos pedidos, cambios de productos y devoluciones
No necesitas hacer nada: tus datos se mantienen actualizados automáticamente.
Notas importantes
Retraso de los estados financieros
Los estados financieros de TikTok tardan al menos 48 horas en estar disponibles después de que se realiza un pedido. Si ves pedidos sin datos financieros, esto es normal: los estados aparecen en la siguiente sincronización después de que TikTok los genera.
Integridad de los datos
Los desgloses de tarifas e impuestos de tus pedidos se recuperan automáticamente cuando los datos de TikTok llegan tarde o estaban incompletos inicialmente. Esto significa que tus cálculos de Profit & Loss se completan antes, sin que necesites activar una sincronización manual.
Precisión de los datos
Dashboardly importa los datos exactamente como los proporciona la API de TikTok. Si notas discrepancias, consulta My Numbers Don't Match TikTok y Understanding Your Data Quality.
Activar una importación manual
Si necesitas actualizar tus datos de inmediato:
- Ve a Settings → Import History
- Haz clic en Run Import
- La importación procesa todos los tipos de datos y muestra el progreso
Esto utiliza el mismo proceso que la sincronización automática. No elimina los datos existentes: los actualiza y añade nuevos.
Consejos
- No desconectes ni vuelvas a conectar tu tienda para "arreglar" problemas de datos. Una sincronización manual es el enfoque correcto.
- Revisa Settings → Import History si tus cifras parecen desactualizadas. Puedes ver el estado de la última sincronización y activar una sincronización manual si es necesario.
- En las tiendas grandes es posible que veas datos parciales en el Dashboard mientras la importación sigue en curso. Espera a que la importación se complete antes de evaluar tus cifras.
Problemas comunes
La importación se queda atascada en una etapa
Ocasionalmente, una importación puede detenerse debido a límites temporales de frecuencia de la API de TikTok. Dashboardly reintenta automáticamente con retrasos cada vez mayores. Si una importación no muestra progreso durante más de ~2 horas, ponte en contacto con el soporte.
La importación se completó, pero los datos parecen incompletos
Comprueba si TikTok Seller Center muestra datos para el mismo rango de fechas. Algunas métricas (como los estados financieros) solo están disponibles después de que TikTok las finaliza, lo que tarda al menos 48 horas, pero puede ser más en algunos pedidos.
Error "Import failed"
Esto normalmente significa que la API de TikTok devolvió un error. Causas comunes:
- Tu token de autorización caducó (vuelve a conectar la tienda en Settings → Shops)
- Los servidores de TikTok no estaban disponibles temporalmente (la importación se reintentará automáticamente)
- Tu tienda fue suspendida o restringida por parte de TikTok
Si el problema persiste después de volver a conectar, ponte en contacto con el soporte.