Guía de solución de problemas de importación

❌ «Formato de archivo no compatible»

Problema: StockCraft no reconoce tu formato de archivo.

Soluciones:

• Guardar en formato CSV (UTF-8) o Excel (.xlsx)
• Evite .xls (formato Excel anterior); utilice .xlsx en su lugar
• No utilices archivos.txt: conviértelos a .csv
• Asegúrese de que la extensión del archivo coincide con el formato real

❌ «El archivo parece estar dañado»

Problema: El archivo está dañado o tiene problemas de codificación.

Soluciones:

• Vuelva a guardar el archivo en Excel o Google Sheets
• Para CSV: guardar con codificación UTF-8
• Eliminar los caracteres o símbolos especiales de los encabezados
• Comprueba si hay caracteres ocultos o espacios adicionales
• Intente abrir el archivo en un editor de texto para comprobar si está dañado

⚠️ «El campo obligatorio no está mapeado»

Problema: Los campos obligatorios (marcados con *) no se asignan a las columnas.

Soluciones:

• Asegúrate de que tu archivo tenga columnas para todos los campos obligatorios (SKU, nombre, etc.)
• Asigne cada campo obligatorio a una columna de su archivo
• Si no tienes datos para un campo obligatorio, agrega una columna con valores de marcador de posición
• Descarga nuestra plantilla para ver la estructura de columnas requerida

⚠️ «La columna contiene tipos de datos mixtos»

Problema: Una columna contiene números y texto en los que solo se esperan números.

Soluciones:

• Revisa las columnas de precios para ver texto como «N/A» o «25,00$»; usa solo números
• Eliminar los símbolos monetarios ($, €, £) de las columnas de precios
• Usa números decimales (25,50) y no fracciones (25 1/2)
• Reemplace las celdas vacías por 0 para los campos numéricos

❌ «Se encontró un SKU duplicado»

Problema: Varias filas tienen el mismo SKU o el SKU ya existe en StockCraft.

Soluciones:

• Haz que cada SKU sea único en tu archivo
• Elija la opción de manejo de duplicados: omitir, actualizar o crear nuevo
• Añade sufijos para que los SKU sean únicos (p. ej., WIDGET-001, WIDGET-002)
• Compruebe los materiales/productos existentes para evitar conflictos

❌ «Tipo de unidad no válido»

Problema: StockCraft no reconoce el tipo de unidad.

Tipos de unidades válidos:

• Peso: kilogramo, libra, onza
• Volumen: L, ml, galón, cuarto de galón, pt
• Longitud: m, cm, mm, pies, pulgadas
• Contar: pieza, cada artículo
• Zona: metros cuadrados, pies cuadrados

❌ «No se encontró material referenciado»

Problema: El componente hace referencia a un material que no existe en StockCraft.

Soluciones:

• Importe los materiales antes de importar los componentes que los utilizan
• Comprueba si hay errores tipográficos o espacios adicionales en los SKU de los materiales
• Asegúrese de que los SKU de los materiales coincidan exactamente (distingue entre mayúsculas y minúsculas)
• Crea los materiales que faltan manualmente o agrégalos a tu archivo de importación

⚠️ «La importación tarda demasiado»

Problema: Los archivos grandes se procesan con lentitud o se agota el tiempo de espera.

Soluciones:

• Los archivos de más de 1000 filas se procesan automáticamente en segundo plano
• Divida los archivos grandes en trozos más pequeños (de 500 a 1000 filas cada uno)
• Elimine las columnas innecesarias para reducir el tiempo de procesamiento
• Revisa tu correo electrónico para ver la notificación de finalización
• Supervise el progreso en la página Estado de importación

⚠️ «La importación falló y se agotó el tiempo de espera»

Problema: El proceso de importación superó los límites de tiempo.

Soluciones:

• Reduzca el tamaño del archivo dividiéndolo en varias importaciones
• Elimine fórmulas complejas de los archivos de Excel; utilice solo valores
• Simplifique las estructuras de los componentes (menos materiales anidados)
• Intente importar fuera de las horas pico
• Póngase en contacto con el soporte técnico para archivos de más de 10 000 filas

❌ «Los caracteres especiales no se muestran correctamente»

Problema: Los caracteres acentuados, los símbolos o el texto que no esté en inglés aparecen como signos de interrogación o cuadros.

Soluciones:

• Excel: Guardar como «CSV UTF-8 (delimitado por comas)», no como CSV normal
• Hojas de cálculo de Google: Descargar como CSV automáticamente usa UTF-8
• Editor de texto: Guardar con codificación UTF-8 de forma explícita
• Bloc de notas ++: Codificación → Convertir a UTF-8

⚠️ «Fallo en el cálculo del coste»

Problema: El sistema no pudo calcular los costos de los componentes o productos durante la importación.

Soluciones:

• Asegúrese de que todos los materiales referenciados tengan precios válidos
• Compruebe que las cantidades de material sean números positivos
• Verifique que los porcentajes de desperdicio estén entre 0 y 100
• Importe materiales con precios antes de importar componentes
• Utilice los costos de anulación si el cálculo automático no funciona

⚠️ «Pedido clasificado como Shopify en lugar de Amazon/eBay»

Problema: Aparece un pedido de Marketplace (por ejemplo, de Amazon) en el canal general «Shopify».

Soluciones:

• Asegúrate de que el canal de ventas «Amazon» o «eBay» esté activo en tu Configuración
• Comprueba si el pedido se importó a través de una aplicación de terceros (por ejemplo, Marketplace Connect); nuestro sistema ahora detecta automáticamente estas fuentes
• Para los pedidos existentes, desmarca «Omitir los existentes» durante una importación manual de Shopify para actualizar la categorización del canal
• Verifica tus credenciales de marketplace en la aplicación de origen (por ejemplo, la configuración de Marketplace Connect)

🔧 Solución: herramienta Re-link Products

StockCraft ahora incluye una herramienta para corregir automáticamente estos elementos desvinculados.

Cómo usarlo:

1. Abrir el pedido con artículos desvinculados
2. Haga clic en el «Productos Re-link» botón (junto a «Recalcular costos»)
3. El sistema intentará encontrar los productos que coincidan de la siguiente manera:
   • SKU: Coincidencia exacta en la unidad de mantenimiento de existencias
   • Nombre: Coincidencia exacta en el nombre del producto
   • Títulos alternativos: Comprueba los alias definidos en la configuración de tu producto
4. Si se encuentra una coincidencia, el producto se vincula y los costos se recalculan automáticamente

✓ Recursos de autoayuda

• Descargar plantillas: Utilice nuestras plantillas preformateadas para obtener los mejores resultados
• Informes de errores: Descargar informes de errores detallados con números de fila
• Modo de vista previa: Prueba con las 10 primeras filas antes de la importación completa
• Historial de importación: Revise las importaciones anteriores y sus resultados

💡 Consejos profesionales para una importación exitosa

• Comience con algo pequeño: Pruebe primero con 5-10 filas
• Datos limpios: Eliminar las filas vacías y los espacios adicionales
• Formato uniforme: Utilice el mismo formato de fecha en todas partes
• Haga primero la copia de seguridad: Exporte los datos existentes antes de realizar grandes importaciones
• Cambios en el documento: Toma nota de lo que has importado y cuándo

¿Aún necesitas ayuda?

Si sigues teniendo problemas con la importación, ¡estamos aquí para ayudarte!

• Póngase en contacto con el soporte: Envíanos un mensaje con los detalles del error
• Incluya detalles: Adjunta el archivo y el informe de errores si es posible
• Tiempo de respuesta: Normalmente respondemos en un plazo de 24 horas
• Uso compartido de pantalla: Podemos programar una llamada para ayudarlo con las importaciones complejas