Probleme lösen ┅ KRAKE

Datei oder Spalten werden nicht erkannt

Hilfe bei CSV-Problemen
Symptom	Prüfen und beheben
Die Datei wird abgelehnt.	Als CSV statt XLSX speichern. Höchstens 10 MiB und 50.000 Datenzeilen; leere Zeilen entfernen.
Eine ganze Zeile erscheint als eine Spalte.	Trennzeichen kontrollieren. Der direkte API-Upload benötigt Kommas. Die Konsole erkennt zusätzlich Semikolon und Tabulator.
Keine geeigneten Eingabefelder gefunden.	Eine vollständige Suchkombination zuordnen: Domain, Name + Stadt oder Registernummer + Gericht. Bei der E-Mail-Prüfung muss `email` vorliegen.
Umlaute werden falsch angezeigt.	Als UTF-8 exportieren und erneut hochladen. Bereits beschädigte Zeichen werden durch spätere Verarbeitung nicht repariert.
Postleitzahlen verlieren führende Nullen.	Spalte im Quellsystem und beim Import als Text behandeln. Einen Wert wie `01067` nicht als Zahl speichern.
Die Werkzeugseite zeigt weniger Werte als die Datei.	Die Werkzeugseiten entfernen leere Werte, Dubletten und offensichtliche Formatfehler. Die Vorschau vor dem Start kontrollieren.

Formatbeispiele und Vorlagen finden Sie unter CSV-Dateien hochladen.

Keine oder unerwartete Ergebnisse

Prüfen Sie zuerst den einzelnen Datensatz. Ein Auftrag kann teilweise erfolgreich sein, während bestimmte Zeilen fehlschlagen. Bei einer API-Abfrage liefern status, result und error Hinweise. Die API nennt keine einzelnen Quellen oder deren technische Fehlermeldungen. Das Ergebnisformat steht unter Ergebnisse & Export.

Leere Pflichtwerte: Eine passende Kopfzeile reicht nicht, wenn die konkrete Zeile keine Domain oder keine vollständige Suchkombination enthält.
Falsche Zuordnung: Firmenname, Domain und Stadt müssen zum gleichen Unternehmen gehören. Prüfen Sie die Schreibweise und die Rechtsform.
Quelle nicht erreichbar: Website, Domainauflösung, Zugriffsschutz oder Zeitüberschreitung können die Verarbeitung verhindern.
Vorhandener Wert bleibt erhalten: Eingabewerte haben Vorrang. Entfernen Sie einen veralteten Eingabewert in einem neuen Auftrag, wenn er neu ermittelt werden soll.
Keine Registerangaben: Nicht jedes Unternehmen ist über den gewählten Registersuchweg auffindbar. Andere Quellen können dennoch verwertbare Kontaktdaten liefern.

Für korrigierte Eingaben benötigen Sie einen neuen Auftrag. Ein Neustart wiederholt nur fehlgeschlagene Datensätze mit den bisherigen Eingaben.

Der Auftrag dauert länger als erwartet

Prüfen Sie status, die Zähler und die Restzeitschätzung. Warteschlangen, nicht erreichbare Websites und begrenzte Kapazitäten einzelner Quellen können die Dauer erhöhen. Besonders Register- und Browserabfragen können längere Wartezeiten verursachen.

Wenn sich der Fortschritt über längere Zeit nicht verändert, notieren Sie Auftragskennung und Zeitraum und kontaktieren Sie den Support. Reichen Sie denselben Auftrag nicht wiederholt ein. Sie können einen aktiven Auftrag bei Bedarf stoppen; bereits abgeschlossene Ergebnisse bleiben erhalten.

Abgeschlossen, aber Ergebnis gesperrt

Prüfen Sie payment_pending beim Datensatz und billing_paused beim Auftrag. Laden Sie Guthaben auf und warten Sie auf die Abrechnung. Rufen Sie danach das Ergebnis erneut ab. Der Export enthält bis zur Bezahlung leere Ergebnisfelder und den Hinweis Zahlung ausstehend.

Ein Neustart löst dieses Problem nicht. Den Ablauf zur Freigabe beschreibt Guthaben & Abrechnung.

Export fehlt oder enthält weniger Daten

Noch in Verarbeitung: Ein CSV-Export ist vor dem Endzustand nicht verfügbar.
Alle Datensätze fehlgeschlagen: Es gibt keine Datei mit Ergebnissen. Prüfen Sie die Datensatzliste oder laden Sie bei der Anreicherung ?layout=without_result herunter.
Weniger Zeilen: Der Anreicherungsexport enthält nur Datensätze mit Ergebnis. Zeilen ohne Ergebnis stehen separat unter ?layout=without_result.
Spalten fehlen: Prüfen Sie eine mögliche Auswahl unter export_columns. Die Standarddatei enthält je Zeile bis zu drei E-Mail-Adressen und Vertretungsberechtigte; laden Sie für alle Werte Alle Felder herunter (in der Konsole bei Anreicherungsaufträgen, per API mit ?layout=full).
HTTP 410: Die Ergebnisdaten wurden nach Ablauf der Aufbewahrungsfrist gelöscht. Nutzen Sie eine eigene Sicherung oder reichen Sie einen neuen Auftrag ein.
Excel zeigt die Datei falsch: Als Text/CSV mit UTF-8 und Komma importieren, Kennungen und Telefonnummern als Text behandeln.

E-Mail-Prüfung wird missverstanden

accepts_mail bedeutet, dass die Domain eine passende Mailkonfiguration hat. Eine einzelne Mailbox kann trotzdem nicht existieren. unknown ist kein positives Prüfergebnis. Funktionsadressen wie info@ werden durch role_account gekennzeichnet und sind dadurch nicht automatisch ungültig.

Ein negatives Prüfergebnis kann als abgeschlossener Datensatz berechnet werden. Details stehen unter E-Mail-Prüfung.

API-Aufrufe funktionieren nicht

Basis-URL und Pfad prüfen: https://api.krake.run/api/v1/, einschließlich abschließender Schrägstriche. Jeder Produktauftrag hat seinen eigenen Präfix.
X-API-Key statt eines Bearer-Headers senden; aktiven Schlüssel und bestätigte Konto-E-Mail verwenden.
Bei JSON ein Objekt unter input_data senden. Für Listen den CSV-Endpunkt mit Multipart verwenden.
HTTP-Status und Fehlertext lesen. Bei 402 Guthaben prüfen, bei 429 Retry-After beachten.
Bei Listen allen next-Links folgen; die erste Antwort ist möglicherweise nur eine Seite.

Ein funktionierender Ablauf steht im API-Schnellstart. Die vollständige Fehlerübersicht finden Sie unter Limits & Fehler.