Anleitung zur Fehlerbehebung beim Import

❌ „Dateiformat wird nicht unterstützt“

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

Solutions:

• Als CSV- (UTF-8) oder Excel-Format (.xlsx) speichern
• Vermeiden Sie .xls (älteres Excel-Format) — verwenden Sie stattdessen .xlsx
• Verwende keine.txt-Dateien — konvertiere zu.csv
• Stellen Sie sicher, dass die Dateierweiterung dem tatsächlichen Format entspricht

❌ „Die Datei scheint beschädigt zu sein“

Problem: File is damaged or has encoding issues.

Solutions:

• Speichern Sie die Datei erneut in Excel oder Google Sheets
• Für CSV: Mit UTF-8-Kodierung speichern
• Entfernen Sie alle Sonderzeichen oder Symbole in Überschriften
• Suchen Sie nach versteckten Zeichen oder zusätzlichen Leerzeichen
• Versuchen Sie, die Datei in einem Texteditor zu öffnen, um nach Beschädigungen zu suchen

⚠️ „Pflichtfeld nicht zugeordnet“

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

Solutions:

• Stellen Sie sicher, dass Ihre Datei Spalten für alle erforderlichen Felder enthält (SKU, Name usw.)
• Ordnen Sie jedes erforderliche Feld einer Spalte in Ihrer Datei zu
• Wenn Sie keine Daten für ein erforderliches Feld haben, fügen Sie eine Spalte mit Platzhalterwerten hinzu.
• Laden Sie unsere Vorlage herunter, um die erforderliche Spaltenstruktur zu sehen

⚠️ „Spalte enthält gemischte Datentypen“

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

Solutions:

• Suchen Sie in den Preisspalten nach Text wie „N/A“ oder „25,00$“ — verwenden Sie nur Zahlen
• Währungssymbole ($, €, £) aus den Preisspalten entfernen
• Benutze Dezimalzahlen (25,50), keine Brüche (25 1/2)
• Ersetzen Sie leere Zellen durch 0 für numerische Felder

❌ „Doppelte SKU gefunden“

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

Solutions:

• Machen Sie jede SKU in Ihrer Datei einzigartig
• Wählen Sie die Option zur Behandlung von Duplikaten: Überspringen, Aktualisieren oder Neu erstellen
• Fügen Sie Suffixe hinzu, um SKUs eindeutig zu machen (z. B. WIDGET-001, WIDGET-002)
• Prüfen Sie vorhandene Materialien/Produkte, um Konflikte zu vermeiden

❌ „Ungültiger Einheitentyp“

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

❌ „Referenziertes Material wurde nicht gefunden“

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

Solutions:

• Importieren Sie Materialien, bevor Sie Komponenten importieren, die sie verwenden
• Material-SKUs auf Tippfehler oder zusätzliche Leerzeichen überprüfen
• Stellen Sie sicher, dass die Material-SKUs exakt übereinstimmen (Groß- und Kleinschreibung beachten)
• Erstellen Sie fehlende Materialien manuell oder fügen Sie sie Ihrer Importdatei hinzu

⚠️ „Import dauert zu lange“

Problem: Large files processing slowly or timing out.

Solutions:

• Dateien mit mehr als 1000 Zeilen werden automatisch im Hintergrund verarbeitet
• Teilen Sie große Dateien in kleinere Abschnitte auf (jeweils 500-1000 Zeilen)
• Entfernen Sie unnötige Spalten, um die Verarbeitungszeit zu reduzieren
• Überprüfe deine E-Mail auf eine Abschlussbenachrichtigung
• Überwachen Sie den Fortschritt auf der Seite Importstatus

⚠️ „Import mit Timeout fehlgeschlagen“

Problem: Import process exceeded time limits.

Solutions:

• Reduzieren Sie die Dateigröße, indem Sie sie in mehrere Importe aufteilen
• Entfernen Sie komplexe Formeln aus Excel-Dateien — verwenden Sie nur Werte
• Vereinfachen Sie die Bauteilstrukturen (weniger verschachtelte Materialien)
• Versuchen Sie, außerhalb der Spitzenzeiten zu importieren
• Kontaktieren Sie den Support für Dateien mit mehr als 10.000 Zeilen

❌ „Sonderzeichen werden nicht richtig angezeigt“

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

⚠️ „Kostenberechnung fehlgeschlagen“

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

Solutions:

• Stellen Sie sicher, dass alle referenzierten Materialien gültige Preise haben
• Prüfen Sie, ob es sich bei den Materialmengen um positive Zahlen handelt
• Stellen Sie sicher, dass der Prozentsatz der Verschwendung zwischen 0 und 100 liegt
• Importieren Sie Materialien mit Preisen, bevor Sie Komponenten importieren
• Verwenden Sie Override-Kosten, wenn die automatische Berechnung nicht funktioniert

⚠️ „Bestellung als Shopify statt als Amazon/eBay kategorisiert“

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

Solutions:

• Stellen Sie sicher, dass der Vertriebskanal „Amazon“ oder „eBay“ in Ihren Einstellungen aktiv ist
• Prüfen Sie, ob die Bestellung über eine Drittanbieter-App (z. B. Marketplace Connect) importiert wurde — jetzt unser System erkennt diese Quellen automatisch
• Deaktiviere bei bestehenden Bestellungen während eines manuellen Shopify-Imports das Häkchen bei „Bestehende überspringen“, um den Kanal zu aktualisieren Kategorisierung
• Verifizieren Sie Ihre Marketplace-Anmeldedaten in der Quell-App (z. B. Marketplace Connect-Einstellungen)

🔧 Lösung: Tool „Produkte erneut verknüpfen“

StockCraft enthält jetzt ein Tool zum Reparieren diese nicht verknüpften Elemente automatisch.

How to use it:

1. Öffnen Sie die Bestellung mit nicht verknüpften Artikeln
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. Wenn eine Übereinstimmung gefunden wird, wird das Produkt verknüpft und die Kosten werden automatisch neu berechnet

✓ Ressourcen zur Selbsthilfe

• 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

💡 Profi-Tipps für erfolgreiche Importe

• 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

Brauchen Sie immer noch Hilfe?

Wenn Sie immer noch Probleme mit Ihrem Import haben, sind wir Ich bin hier um zu helfen!

• Contact Support: Schicken Sie uns eine Botschaft 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