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

❌ «Formato de archivo no compatible»

Problem: Your file format isn't recognized by StockCraft.

Solutions:

• 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»

Problem: File is damaged or has encoding issues.

Solutions:

• 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»

Problem: Required fields (marked with *) aren't mapped to columns.

Solutions:

• 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»

Problem: A column has both numbers and text where only numbers are expected.

Solutions:

• 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»

Problem: Multiple rows have the same SKU, or SKU already exists in StockCraft.

Solutions:

• 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»

Problem: Unit type not recognized by StockCraft.

Valid Unit Types:

• Weight: kg, g, lb, oz
• Volume: L, mL, gal, qt, pt
• Length: m, cm, mm, ft, in
• Count: piece, each, item
• Area: sqm, sqft, sqin

❌ «No se encontró material referenciado»

Problem: Component references a material that doesn't exist in StockCraft.

Solutions:

• 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»

Problem: Large files processing slowly or timing out.

Solutions:

• 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»

Problem: Import process exceeded time limits.

Solutions:

• 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»

Problem: Accented characters, symbols, or non-English text appears as question marks or boxes.

Solutions:

• Excel: Save as "CSV UTF-8 (Comma delimited)" not regular CSV
• Google Sheets: Download as CSV automatically uses UTF-8
• Text Editor: Save with UTF-8 encoding explicitly
• Notepad++: Encoding → Convert to UTF-8

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

Problem: System couldn't calculate component or product costs during import.

Solutions:

• 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»

Problem: A marketplace order (e.g., from Amazon) is showing up under the general "Shopify" channel.

Solutions:

• 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 el canal categorización
• 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 estos elementos se desvinculan automáticamente.

How to use it:

1. Abrir el pedido con artículos desvinculados
2. Click the "Re-link Products" button (next to 'Recalculate Costs')
3. The system will attempt to find matching products by:
   • SKU: Exact match on Stock Keeping Unit
   • Name: Exact match on Product Name
   • Alternative Titles: Checks aliases defined in your product settings
4. Si se encuentra una coincidencia, el producto se vincula y los costos se recalculan automáticamente

✓ Recursos de autoayuda

• Download Templates: Use our pre-formatted templates for best results
• Error Reports: Download detailed error reports with row numbers
• Preview Mode: Test with first 10 rows before full import
• Import History: Review past imports and their results

💡 Consejos profesionales para una importación exitosa

• Start Small: Test with 5-10 rows first
• Clean Data: Remove empty rows and extra spaces
• Consistent Format: Use the same date format throughout
• Backup First: Export existing data before large imports
• Document Changes: Keep notes on what you imported when

¿Aún necesitas ayuda?

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

• Contact Support: Envíanos un mensaje with your error details
• Include Details: Attach your file and error report if possible
• Response Time: We typically respond within 24 hours
• Screen Sharing: We can schedule a call to help with complex imports