> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yourhomie.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Importe und Schutzmechanismen

> Wie Märkte und ergänzende Daten aktuell bleiben, was der Importbericht zeigt und wie homie deine Produkte vor unvollständigen oder nicht erreichbaren Dateien schützt.

homie importiert jeden Markt automatisch so oft, wie du es unter **Automatischer Import** festgelegt hast, zusammen mit den ergänzenden Daten, die für ihn gelten. Bringt ein Import neue oder geänderte Produkte, gelten die Übersetzungen des Markts direkt danach auch für sie. So bleiben Empfehlungen mit deinem Shop auf dem gleichen Stand. Bis ein Import abgeschlossen ist, bleibt der letzte Stand deiner Produkte aktiv.

## Einen Markt aktualisieren

* **Automatisch:** Die **Häufigkeit** wählst du beim Anlegen des Markts in der Karte **Automatischer Import**: **Täglich** zu einer **Uhrzeit** in deiner Zeitzone, **Stündlich** (in einem höheren Plan) oder **Nur manuell**. Später änderst du sie im Tab **Einstellungen** des Markts in derselben Karte.
* **Sofort:** Wähle im Tab **Importe** oder oben auf der Seite des Markts **Import starten**. Du kannst einen Import alle 5 Minuten starten.
* **Nach Änderungen:** Speicherst du eine geänderte Feldzuordnung, eine neue Produktfeed-URL, eine geänderte Sprache oder Währung oder eine ergänzende Datenquelle, startet automatisch ein neuer Import. Eine gespeicherte Übersetzung gilt für sich, ohne Import, außer sie ändert, welche Spalten des Produktfeeds eine Übersetzung mit **Dieser Feed** liest (siehe [Übersetzungen](https://docs.yourhomie.ai/de/user-guide/knowledge/catalog/markets.md#translations)).

Während eines Imports zeigt die Übersicht des Markts den Fortschritt. Bis zum Abschluss nutzt der Assistent die bisherigen Produktdaten.

## Importe prüfen

**1. Bericht öffnen**

Öffne den Tab **Importe** des Markts und wähle **Bericht** beim gewünschten Import. **Importverlauf** listet die Importe des Markts, die neuesten zuerst; mit **Mehr laden** siehst du ältere. Auch die Übersicht zeigt unter **Letzte Importe** die letzten Durchläufe.

**2. Ergebnis prüfen**

Prüfe den Status und die Zahlen unter **Neu**, **Geändert**, **Entfernt** und **Abgelehnt**. Folge unter **Was zu tun ist** den Links zu den Einstellungen, die du korrigieren musst. **Alles in Ordnung** bedeutet, dass der Bericht keinen Handlungsbedarf gefunden hat.

**3. Abgelehnte Zeilen korrigieren**

Prüfe unter **Abgelehnt** die betroffenen Produkt-IDs und die jeweilige Ursache. Ergänze fehlende Produktangaben oder korrigiere ungültige Werte oder die Feldzuordnung. Wähle danach **Import starten**, um es erneut zu versuchen.

Ein abgelehntes Produkt, das zuvor erfolgreich importiert wurde, behält seine letzten gültigen Daten. Ein neues Produkt wird erst hinzugefügt, wenn seine Zeile gültig ist.

**4. Produkte prüfen**

Öffne **Produkte** im Katalog, wähle den Markt und prüfe die betroffenen Produkte. Teste eine Kundenfrage im [Playground](https://docs.yourhomie.ai/de/user-guide/assistants/playground.md), wenn die Änderung Empfehlungen betrifft.

Der **Status** des Markts zeigt dir, was als Nächstes zu tun ist:

| Status | Nächster Schritt |
| - | - |
| **Wartet** oder **Import läuft** | Warte, bis der Import abgeschlossen ist. |
| **Aktuell** | Der letzte Import war erfolgreich. Prüfe die Produkte, wenn du den Feed kürzlich geändert hast. |
| **Noch kein Import** | Starte den ersten Import. |
| **Fehler** | Öffne den Bericht und folge der Fehlermeldung. Unter dem Markt steht, von welchem Tag die Produktdaten stammen, die der Assistent weiter nutzt. |
| **Feldzuordnung prüfen** | Ordne die fehlenden Pflichtfelder zu. |
| **Pausiert** | Prüfe die Importeinstellungen des Markts. |

Klappe **Details** im Bericht auf, um ergänzende Daten, Produktzuordnung, Dokumente und Hinweise zu prüfen. Die Ergebnisse der Übersetzungen zeigt der Tab **Übersetzungen** des Markts. Konnten Varianten nicht wie erwartet gruppiert werden, führt dich zum Beispiel **Variantenoptionen zuordnen** zur passenden Feldzuordnung.

> [!NOTE]
>
> **Nicht übernommen** bedeutet, dass ein neuerer Import den Markt bereits aktualisiert hat. Die neueren Produktdaten bleiben aktiv.

> [!NOTE]
>
> **Gestoppt** bedeutet, dass ein automatischer Import nicht übernommen wurde, weil seine Datei weniger als die Hälfte der Zeilen des zuletzt übernommenen Imports enthielt oder mehr als die Hälfte dieser Zeilen darin fehlte. Die bisherigen Produkte bleiben aktiv, damit ein fehlerhafter Export den Markt nicht leert. Ist die kleinere Datei richtig, übernimmst du sie mit **Import starten**.

## Unveränderte Dateien

**Unverändert** bedeutet, dass die Datei keine Änderungen enthält. Deine Produkte bleiben wie sie sind. Die Übersicht zeigt, wann die Datei zuletzt geprüft wurde.

## Kleinere Dateien

Jede Aktualisierung muss das vollständige Sortiment enthalten, auch wenn du nur wenige Produkte geändert hast. Nach einem erfolgreichen Import werden Produkte, die in der Datei fehlen, aus dem Markt entfernt und nicht mehr empfohlen. Der Bericht zählt sie unter **Entfernt**. Taucht ein Produkt später wieder in der Datei auf, wird es mit dem nächsten Import wieder aufgenommen.

Auch eine Datei, die außer den Spaltenüberschriften keine Zeilen enthält, wird übernommen. Bei der Produktdatei eines Markts bedeutet das: Der Markt hat danach keine Produkte mehr. Hat der Markt bereits einen übernommenen Import, wird ein automatischer Import einer solchen Datei jedoch **Gestoppt** und die Produkte bleiben; mit **Import starten** übernimmst du sie. Bei einer Datei ergänzender Daten gelten danach keine Daten aus dieser Quelle mehr. Eine leere Antwort ohne jeden Inhalt gilt als Fehler (siehe unten); ein automatischer Import der Produktdatei eines Markts mit einem früher übernommenen Import wird stattdessen **Gestoppt**.

## Schutz vor unvollständigen Dateien

Kann eine Datei nicht geladen oder gelesen werden, schlägt der Import fehl. Mögliche Ursachen sind:

* der Download abgebrochen ist,
* die Datei abgeschnitten ist und etwa mitten in einer Zeile endet,
* die Datei beschädigt ist und nicht gelesen werden kann,
* die Antwort leer ist (ein automatischer Import der Produktdatei eines Markts mit einem früher übernommenen Import wird stattdessen **Gestoppt**),
* statt der Datei eine Webseite ankommt, zum Beispiel eine Fehler- oder Anmeldeseite.

Der Import erhält dann den Status **Fehlgeschlagen**, der Markt steht auf **Fehler**, und der bisherige Stand bleibt aktiv; der Assistent zeigt weiter die Produkte und Daten des letzten vollständigen Imports. Die Übersicht nennt den Grund. Ist nur eine Datei ergänzender Daten betroffen, wird der Markt trotzdem aktualisiert; die betroffene Quelle behält ihren bisherigen Stand, steht auf **Fehler** und nennt den Grund.

## Wenn eine Datei nicht geladen werden kann

Kann eine Datei nicht geladen werden, bleibt der letzte erfolgreich geladene Stand aktiv, bis die Datei wieder geladen werden kann, egal wie lange das dauert. Die Übersicht nennt den Fehler und das Datum des letzten erfolgreichen Ladens.

In der Liste der Märkte steht unter der Fehlermeldung zum Beispiel **Der Assistent nutzt die Produktdaten vom 6. Oktober 2026.** In der Katalogliste steht neben dem Status **Fehler** das Datum der ältesten betroffenen Produktdaten, zum Beispiel **Daten vom 06.10.26**. Prüfe in diesem Fall die Feed-URL und den Produktexport in deinem Shopsystem. Sobald die Datei wieder geladen werden kann, übernimmt der nächste geplante Import den aktuellen Stand.

> [!TIP]
>
> Prüfe bei einem Ladefehler die Quell-URL. Sie muss weiterhin ohne Anmeldung die Produktdatei öffnen. Starte anschließend einen neuen Import. Die Übersicht zeigt, ob bereits ein erneuter Versuch geplant ist.

## Einen Markt löschen

Einen Markt löschst du im Tab **Einstellungen** des Markts mit **Markt löschen**. Der Bestätigungsdialog nennt die Folgen: Der Markt wird mit seinen Produkten, Übersetzungen, Importen und Dokumenten gelöscht. Seine Produkte werden danach aus den Empfehlungen aller Assistenten entfernt, die den Katalog nutzen.

Den Standardmarkt des Katalogs kannst du nicht löschen, solange der Katalog weitere Märkte hat. Wähle zuerst in den Katalog-Einstellungen einen anderen Standardmarkt.

> [!WARNING]
>
> Das Löschen eines Markts kann nicht rückgängig gemacht werden. Besucher aus seinen Ländern nutzen einen anderen passenden Markt, sofern vorhanden. Andernfalls bekommen sie den Standardmarkt des Katalogs oder, bei **Sehen keine Produkte**, keine Produkte.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.