Anleitung zur Fehlerbehebung beim Import

❌ „Dateiformat wird nicht unterstützt“

Problem: Ihr Dateiformat wird von StockCraft nicht erkannt.

Lösungen:

• 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: Die Datei ist beschädigt oder weist Kodierungsprobleme auf.

Lösungen:

• 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: Pflichtfelder (mit * markiert) sind keinen Spalten zugeordnet.

Lösungen:

• 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: Eine Spalte enthält sowohl Zahlen als auch Text, in dem nur Zahlen erwartet werden.

Lösungen:

• 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: Mehrere Zeilen haben dieselbe SKU, oder die SKU ist bereits in StockCraft vorhanden.

Lösungen:

• 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: Der Einheitentyp wurde von StockCraft nicht erkannt.

Gültige Einheitentypen:

• Gewicht: kg, g, lb, oz
• Volumen: L, ml, gal, qt, pt
• Länge: mm, cm, mm, Fuß, Zoll
• Anzahl: Stück, Stück, Stück
• Gebiet: qm, Quadratfuß, Größe

❌ „Referenziertes Material wurde nicht gefunden“

Problem: Die Komponente verweist auf ein Material, das in StockCraft nicht existiert.

Lösungen:

• 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: Große Dateien werden langsam verarbeitet oder es kommt zu einem Timeout.

Lösungen:

• 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: Der Importvorgang hat die Zeitlimits überschritten.

Lösungen:

• 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: Zeichen mit Akzenten, Symbole oder Text in anderen Sprachen als Englisch werden als Fragezeichen oder Felder angezeigt.

Lösungen:

• Excel: Als „CSV UTF-8 (kommagetrennt)“ speichern, keine reguläre CSV-Datei
• Google Tabellen: Als CSV herunterladen, verwendet automatisch UTF-8
• Texteditor: Explizit mit UTF-8-Kodierung speichern
• Notizblock++: Kodierung → In UTF-8 konvertieren

⚠️ „Kostenberechnung fehlgeschlagen“

Problem: Das System konnte die Komponenten- oder Produktkosten während des Imports nicht berechnen.

Lösungen:

• 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: Eine Marketplace-Bestellung (z. B. von Amazon) wird unter dem allgemeinen Kanal „Shopify“ angezeigt.

Lösungen:

• 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 — unser System erkennt diese Quellen jetzt automatisch
• Deaktiviere bei bestehenden Bestellungen während eines manuellen Shopify-Imports das Häkchen bei „Bestehende überspringen“, um die Kanal-Kategorisierung zu aktualisieren
• 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, mit dem diese nicht verknüpften Elemente automatisch repariert werden können.

Wie benutzt man es:

1. Öffnen Sie die Bestellung mit nicht verknüpften Artikeln
2. Klicken Sie auf „Produkte erneut verknüpfen“ Schaltfläche (neben 'Kosten neu berechnen')
3. Das System versucht, passende Produkte zu finden, indem es:
   • ARTIKELNUMMER: Exakte Übereinstimmung auf der Stock Keeping Unit
   • Nome: Exakte Übereinstimmung mit dem Produktnamen
   • Alternative Titel: Prüft die in Ihren Produkteinstellungen definierten Aliase
4. Wenn eine Übereinstimmung gefunden wird, wird das Produkt verknüpft und die Kosten werden automatisch neu berechnet

✓ Ressourcen zur Selbsthilfe

• Vorlagen herunterladen: Verwenden Sie unsere vorformatierten Vorlagen für beste Ergebnisse
• Fehlerberichte: Laden Sie detaillierte Fehlerberichte mit Zeilennummern herunter
• Vorschaumodus: Testen Sie mit den ersten 10 Zeilen vor dem vollständigen Import
• Historie importieren: Überprüfen Sie vergangene Importe und deren Ergebnisse

💡 Profi-Tipps für erfolgreiche Importe

• Fangen Sie klein an: Testen Sie zuerst mit 5-10 Reihen
• Daten bereinigen: Leere Zeilen und zusätzliche Leerzeichen entfernen
• Konsistentes Format: Verwenden Sie durchgehend dasselbe Datumsformat
• Zuerst sichern: Exportiere bestehende Daten vor großen Importen
• Änderungen am Dokument: Machen Sie sich Notizen darüber, was Sie wann importiert haben

Brauchen Sie immer noch Hilfe?

Wenn Sie immer noch Probleme mit Ihrem Import haben, helfen wir Ihnen gerne weiter!

• Wenden Sie sich an den Support: Schicken Sie uns eine Nachricht mit deinen Fehlerdetails
• Einzelheiten einschließen: Hängen Sie Ihre Datei und den Fehlerbericht an, wenn möglich
• Reaktionszeit: Wir antworten in der Regel innerhalb von 24 Stunden
• Bildschirmübertragung: Wir können einen Anruf vereinbaren, um Ihnen bei komplexen Importen zu helfen