Guide de résolution des problèmes d'importation

❌ « Format de fichier non pris en charge »

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

Solutions:

• Enregistrer au format CSV (UTF-8) ou Excel (.xlsx)
• Évitez .xls (ancien format Excel) et utilisez plutôt .xlsx
• N'utilisez pas de fichiers .txt, convertissez-les en .csv
• Assurez-vous que l'extension du fichier correspond au format réel

❌ « Le fichier semble endommagé »

Problem: File is damaged or has encoding issues.

Solutions:

• Enregistrez à nouveau le fichier dans Excel ou Google Sheets
• Pour CSV : Enregistrer avec l'encodage UTF-8
• Supprimer tous les caractères ou symboles spéciaux dans les en-têtes
• Vérifiez la présence de caractères cachés ou d'espaces supplémentaires
• Essayez d'ouvrir le fichier dans un éditeur de texte pour vérifier s'il est corrompu

⚠️ « Le champ obligatoire n'est pas mappé »

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

Solutions:

• Assurez-vous que votre fichier comporte des colonnes pour tous les champs obligatoires (SKU, nom, etc.)
• Associez chaque champ obligatoire à une colonne de votre fichier
• Si vous ne disposez pas de données pour un champ obligatoire, ajoutez une colonne contenant des valeurs d'espace réservé
• Téléchargez notre modèle pour voir la structure de colonne requise

⚠️ « La colonne contient des types de données mixtes »

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

Solutions:

• Vérifiez les colonnes de prix pour le texte « N/A » ou « 25,00{{CONTENT}}nbsp;» - utilisez uniquement des chiffres
• Supprimer les symboles monétaires ($, €, £) des colonnes de prix
• Utilisez des nombres décimaux (25,50) et non des fractions (25 1/2)
• Remplacez les cellules vides par 0 pour les champs numériques

❌ « Un double SKU a été trouvé »

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

Solutions:

• Faites en sorte que chaque SKU soit unique dans votre fichier
• Choisissez l'option de gestion des doublons : Ignorer, Mettre à jour ou Créer un nouveau
• Ajoutez des suffixes pour rendre les SKU uniques (par exemple, WIDGET-001, WIDGET-002)
• Vérifiez les matériaux/produits existants pour éviter les conflits

❌ « Type d'unité non valide »

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

❌ « Matériel référencé introuvable »

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

Solutions:

• Importez des matériaux avant d'importer des composants qui les utilisent
• Vérifiez que les références des matériaux ne contiennent pas de fautes de frappe ou d'espaces supplémentaires
• Assurez-vous que les SKU des matériaux correspondent exactement (distinction majuscules/minuscules)
• Créez les matériaux manquants manuellement ou ajoutez-les à votre fichier d'importation

⚠️ « L'importation prend trop de temps »

Problem: Large files processing slowly or timing out.

Solutions:

• Les fichiers de plus de 1 000 lignes sont traités automatiquement en arrière-plan
• Divisez les gros fichiers en petits morceaux (500 à 1 000 lignes chacun)
• Supprimez les colonnes inutiles pour réduire le temps de traitement
• Vérifiez votre e-mail pour la notification d'achèvement
• Suivez la progression sur la page État de l'importation

⚠️ « L'importation a échoué avec un délai d'attente »

Problem: Import process exceeded time limits.

Solutions:

• Réduisez la taille des fichiers en les divisant en plusieurs importations
• Supprimer les formules complexes des fichiers Excel - utiliser uniquement des valeurs
• Simplifier les structures des composants (moins de matériaux imbriqués)
• Essayez d'importer en dehors des heures de pointe
• Contactez l'assistance pour les fichiers de plus de 10 000 lignes

❌ « Les caractères spéciaux ne s'affichent pas correctement »

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

⚠️ « Le calcul des coûts a échoué »

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

Solutions:

• Assurez-vous que tous les matériaux référencés ont des prix valides
• Vérifiez que les quantités de matériaux sont des nombres positifs
• Vérifiez que les pourcentages de gaspillage se situent entre 0 et 100
• Importez des matériaux avec des prix avant d'importer des composants
• Utiliser les coûts de remplacement si le calcul automatique ne fonctionne pas

⚠️ « Commande classée dans la catégorie Shopify au lieu d'Amazon/eBay »

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

Solutions:

• Assurez-vous que le canal de vente « Amazon » ou « eBay » est actif dans vos paramètres
• Vérifiez si la commande a été importée via une application tierce (par exemple, Marketplace Connect) - notre système est maintenant détecte automatiquement ces sources
• Pour les commandes existantes, décochez « Ignorer les commandes existantes » lors d'une importation manuelle de Shopify pour actualiser la chaîne catégorisation
• Vérifiez les informations d'identification de votre place de marché dans l'application source (par exemple, les paramètres de Marketplace Connect)

🔧 Solution : outil Re-Link Products

StockCraft inclut désormais un outil pour corriger ces éléments dissociés automatiquement.

How to use it:

1. Ouvrez la commande contenant des articles non liés
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 une correspondance est trouvée, le produit est lié et les coûts sont recalculés automatiquement

✓ Ressources d'auto-assistance

• 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

💡 Conseils de pro pour des importations réussies

• 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

Vous avez toujours besoin d'aide ?

Si vous rencontrez toujours des problèmes lors de votre importation, nous là pour vous aider !

• Contact Support: Envoyez-nous un message 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