Enums

P2Lab Mirakl verwendet Zeichenketten-Statuswerte in seinen Entitäten — Verbindungen, Angeboten, Exporten, Synchronisationsprotokollen und so weiter. Diese Seite listet jeden Wert auf, der vorkommen kann, mit einer kurzen Erklärung in einfacher Sprache.

Die Werte unterscheiden Groß- und Kleinschreibung: einige sind kleingeschrieben, andere GROSSGESCHRIEBEN (dort, wo der Wert wortwörtlich der API des Marktplatzes entspricht). Die UI-Beschriftungen für diese Werte stammen aus Snippets — zum Beispiel wird der Status error im Adminbereich als Fehler angezeigt.

Sync-Status eines Angebots

Wird auf der Angebotszuordnungs-Zeile verwendet (sichtbar auf der Seite Angebotszuordnungen).

Wert	Bedeutung
`pending`	Die Zuordnung existiert, wurde aber noch nicht für die Synchronisation in die Warteschlange gestellt.
`queued`	Wartet in der Warteschlange auf den nächsten Synchronisationslauf.
`processing`	Ein Synchronisationslauf bearbeitet diese Zeile gerade.
`retry`	Der vorherige Versuch ist vorübergehend fehlgeschlagen und der Lauf wird es erneut versuchen.
`synced`	Erfolgreich an den Marktplatz gesendet; seitdem keine Änderungen festgestellt.
`error`	Der letzte Versuch ist aus einem Grund fehlgeschlagen, der Ihre Aufmerksamkeit erfordert. Die Zeile enthält die Fehlermeldung.

Status des Produktexports

Wird auf der Produktexport-Zeile verwendet (sichtbar in der Liste Produktkatalog, Spalte Exportstatus).

Wert	Bedeutung
`pending`	Für den Export vorgesehen, aber noch nicht in der Warteschlange.
`queued`	Wartet in der Warteschlange auf den nächsten Exportlauf.
`uploaded`	Die CSV wurde an den Marktplatz übertragen; wartet auf Verarbeitung durch den Marktplatz.
`processing`	Der Marktplatz verarbeitet die Zeile gerade.
`retry`	Der vorherige Versuch ist vorübergehend fehlgeschlagen und der Lauf wird es erneut versuchen.
`exported`	Der Marktplatz hat die Zeile akzeptiert; das Produkt ist jetzt im Marktplatz-Katalog.
`error`	Der Marktplatz hat die Zeile abgewiesen. Die Zeile enthält die Fehlermeldung.

Verbindungsstatus

Wird in der Liste Verbindungen verwendet (Spalte Status). Dieselben drei Werte erscheinen auf dem Dashboard-Widget Connection Status.

Wert	Bedeutung
`connected`	Der letzte Test war erfolgreich; geplante Synchronisationen laufen für diese Verbindung. Angezeigt als `connected`.
`disconnected`	Die Verbindung wurde noch nicht verifiziert oder bewusst pausiert; geplante Synchronisationen überspringen sie. Angezeigt als `disconnected`. Neue Verbindungen starten in diesem Zustand.
`error`	Der letzte Test oder die letzte Synchronisation ist fehlgeschlagen; geplante Synchronisationen überspringen sie. Angezeigt als `error`. Fahren Sie mit dem Mauszeiger über den Status oder öffnen Sie Verbindung bearbeiten, um die Nachricht des Marktplatzes zu sehen.

Im Lebenszyklus der Verbindung gibt es keinen Zustand pending.

Aufgabenfortschritt

Wird in der Tasks-Liste verwendet (Dashboard → Quick Start → Tasks) sowie im Fortschrittsdialog für admin-getriebene Aktionen.

Wert	Verständlicher Name	Bedeutung
`pending`	Warten…	Gerade erstellt, noch nicht von einem Hintergrundprozess aufgenommen.
`in_queue`	In der Warteschlange…	Wartet in der Warteschlange auf einen Hintergrundprozess.
`processing`	Verarbeitung…	Ein Hintergrundprozess führt die Aufgabe aktiv aus.
`running`	—	Alternativname für processing, von einigen Abläufen verwendet.
`completed`	Abgeschlossen!	Erfolgreich beendet.
`error`	Fehler	Fehlgeschlagen; die Aufgabe enthält die letzte Nachricht.
`cancelled`	—	Vor dem Abschluss abgebrochen.

Sync-Log-Status

Wird in der Liste Sync Logs verwendet (Spalte Status).

Wert	UI-Beschriftung	Bedeutung
`started`	Gestartet	Ein langlaufender Lauf ist in Bearbeitung.
`completed`	Abgeschlossen	Der Lauf wurde erfolgreich beendet.
`error`	Fehler	Der Lauf ist fehlgeschlagen; die Zeile enthält die Fehlermeldung des Marktplatzes.

Ein Lauf, der stundenlang in started steht, bedeutet üblicherweise, dass der Hintergrundprozess mitten im Lauf gestorben ist — siehe Fehlerbehebung.

Sync-Log-Stufe

Wird in der Liste Sync Logs verwendet (Spalte Stufe). Steuert, welche Zeilen die Einstellung Sync-Protokollstufen unter Mirakl → Einstellungen → Optionen überstehen.

Wert	UI-Beschriftung	Bedeutung
`debug`	Debug	Sehr feingranulares Nachverfolgen. Standardmäßig aus.
`info`	Info	Informationelle Zeilen (ein Lauf wurde gestartet, ein bemerkenswertes Ereignis).
`success`	Erfolg	Ein Lauf wurde erfolgreich beendet.
`warning`	Warnung	Etwas Bemerkenswertes ist passiert, hat den Lauf aber nicht gestoppt.
`error`	Fehler	Ein Versuch ist fehlgeschlagen.

Sync-Typ

Wird in der Liste Sync Logs verwendet (Spalte Type). Jeder Wert kennzeichnet eine Klasse von Läufen. Das UI übersetzt die gängigen Typen über Snippets in verständliche Namen (zum Beispiel wird offer_sync als Angebot-Synchronisation angezeigt); seltenere Typen zeigen den Wert direkt.

Wert	Was er abdeckt
`offer_sync`	Eine Charge von Angeboten an den Marktplatz hochladen. Angezeigt als Angebot-Synchronisation.
`offer_delete`	Ein Angebot vom Marktplatz zurückziehen. Angezeigt als Angebot-Löschung.
`offer_delete_status_check`	Den Marktplatz auf das Ergebnis einer Angebots-Löschanfrage abfragen.
`stock_sync`	Eine Charge von Bestandsaktualisierungen hochladen. Angezeigt als Bestand-Synchronisation.
`order_import`	Neue und aktualisierte Bestellungen holen. Angezeigt als Bestellungs-Import.
`order_state_sync`	Bestellstatus-Änderungen zurück an den Marktplatz senden (akzeptieren, versenden, ablehnen, erstatten). Angezeigt als Bestellstatus-Synchronisation.
`product_export`	Ein Katalogexport-Lauf, je Verbindung zusammengefasst. Angezeigt als Produkt-Export.
`product_export_batch`	Eine Charge eines Katalogexports. Angezeigt als Produkt-Export-Charge.
`product_import_status_check`	Den Marktplatz auf das Ergebnis eines Produktimports abfragen. Angezeigt als Produkt-Import-Statusprüfung.
`product_import_item_error`	Den Zeilenfehlerbericht zu einem fehlgeschlagenen Produktimport holen. Angezeigt als Produkt-Import-Fehler.
`add_products` / `add_to_catalog`	Produkte aus dem Adminbereich zur Angebotsliste oder zum Katalog hinzufügen.
`auto_map_attributes`	Die Hintergrundaktion Auto Map auf der Seite Attributzuordnungen.
`catalog_export`	Manueller CSV-Export von der Seite Katalog-Export.
`refresh_categories`	Kategorien vom Marktplatz neu laden.
`refresh_product_attributes`	Produktattribute vom Marktplatz neu laden.
`refresh_offer_states`	Angebotsstatus vom Marktplatz neu laden.
`refresh_offer_fields`	Angebotsfelder vom Marktplatz neu laden.
`refresh_reason_codes`	Grund-Codes vom Marktplatz neu laden.
`initial_message_import`	Erstmaliges Nachholen eingehender Nachrichten nach dem Einschalten der Nachrichten-Synchronisation.
`order_document_sync`	Neue eingehende Bestelldokumente holen.
`document_request_sync`	Neue Dokumentanforderungen vom Marktplatz holen.
`initial_order_document_import`	Erstmaliges Nachholen eingehender Bestelldokumente.
`upload_order_document`	Ein Dokument an den Marktplatz senden.
`fulfill_document_request`	Auf eine Dokumentanforderung des Marktplatzes antworten.
`invoice_sync`	Neue Rechnungen vom Marktplatz holen.
`transaction_log_sync`	Neue Transaktionsprotokoll-Einträge vom Marktplatz holen.
`initial_invoice_import`	Erstmaliges Nachholen der Rechnungen.
`initial_transaction_log_import`	Erstmaliges Nachholen des Transaktionsprotokolls.
`transaction_log_export`	Massen-Transaktionsprotokoll-Export, aus dem Adminbereich angestoßen.

Status des Bestellimports

Wird auf der Zeile verwendet, die den Shopware-seitigen Zustand einer Mirakl-Bestellung verfolgt.

Wert	Bedeutung
`pending`	Vom Marktplatz übernommen, aber in Shopware noch nicht angelegt.
`imported`	Eine Shopware-Bestellung wurde für diese Mirakl-Bestellung angelegt.
`error`	Das Anlegen der Shopware-Bestellung ist fehlgeschlagen. Die Zeile enthält die Fehlermeldung.
`deleted`	Die Shopware-Bestellung wurde gelöscht; die Verknüpfung bleibt für Auditzwecke bestehen.

Status des Produktimports

Wird auf der lokalen Produktimport-Zeile verwendet (sichtbar auf den Imports-Detailseiten).

Wert	Bedeutung
`pending`	Der Import ist eingereiht, vom Marktplatz aber noch nicht gestartet.
`running`	Der Marktplatz verarbeitet den Import gerade.
`complete`	Der Marktplatz hat den Import abgeschlossen. Es können trotzdem Zeilenfehler vorhanden sein.
`error`	Der Marktplatz hat den Import als Ganzes abgewiesen.

Bestelldokument — Richtung

Wird auf Bestelldokument-Zeilen verwendet. GROSSGESCHRIEBEN.

Wert	Bedeutung
`INBOUND`	Das Dokument ist vom Marktplatz nach Shopware gekommen.
`OUTBOUND`	Das Dokument wurde von Shopware an den Marktplatz gesendet.

Bestelldokument — Quelle

Wird auf Bestelldokument-Zeilen verwendet. GROSSGESCHRIEBEN.

Wert	Bedeutung
`AUTO_SHOPWARE`	Von Shopware automatisch erzeugt (z. B. durch den Dokument-Auto-Upload).
`MANUAL_SHOPWARE`	Manuell aus dem Shopware-Adminbereich erstellt oder hochgeladen.
`MANUAL`	Außerhalb von Shopware manuell hochgeladen.
`MIRAKL_SYNC`	Über die Dokument-Synchronisation vom Marktplatz gezogen.

Bestelldokument — Status

Wird auf Bestelldokument-Zeilen verwendet.

Wert	Bedeutung
`pending`	Erstellt, aber noch nicht verarbeitet.
`uploading`	Wird gerade an den Marktplatz übertragen.
`uploaded`	Erfolgreich an den Marktplatz übertragen.
`synced`	Vom Marktplatz bestätigt.
`error`	Die Übertragung oder Synchronisation ist fehlgeschlagen. Die Zeile enthält die Fehlermeldung.
`downloaded`	(Bei eingehenden Dokumenten) Erfolgreich vom Marktplatz heruntergeladen.

Dokumentanforderung — Zustand

Wird auf Dokumentanforderungs-Zeilen verwendet, die vom Marktplatz gezogen wurden. GROSSGESCHRIEBEN.

Wert	Bedeutung
`STAGING`	Der Marktplatz bereitet die Anforderung vor.
`TO_PROCESS`	Wartet darauf, dass Sie das Dokument bereitstellen.
`ISSUED`	Das Dokument wurde bereitgestellt.
`CANCELED`	Der Marktplatz hat die Anforderung abgebrochen.

Dokumentanforderung — Typ

Wird auf Dokumentanforderungs-Zeilen verwendet. GROSSGESCHRIEBEN.

Wert	Bedeutung
`INVOICE`	Der Marktplatz fragt nach einer Rechnung.
`CREDIT_NOTE`	Der Marktplatz fragt nach einer Gutschrift.

Rechnung — Typ

Wird auf Rechnungs-Zeilen verwendet. GROSSGESCHRIEBEN.

Wert	Bedeutung
`AUTO_INVOICE`	Vom Marktplatz automatisch erzeugte Rechnung.
`MANUAL_INVOICE`	Auf Seite des Marktplatzes manuell erfasste Rechnung.
`MANUAL_CREDIT`	Manuelle Gutschrift.

Rechnung — Zahlungsstatus

Wird auf Rechnungs-Zeilen verwendet. GROSSGESCHRIEBEN.

Wert	Bedeutung
`PENDING`	Noch nicht bezahlt.
`PAID`	Als bezahlt markiert.
`FAILED`	Der Zahlungsversuch ist fehlgeschlagen.

Angebotsentfernung

Wird während des Angebot-Zurückziehens auf der Angebotszuordnungs-Zeile verwendet.

Wert	Bedeutung
`deleting`	Zurückziehen-Anfrage an den Marktplatz gesendet; wartet auf Bestätigung.
`delete_failed`	Die Zurückziehen-Anfrage ist fehlgeschlagen. Die Zeile bleibt erhalten, damit Sie es erneut versuchen können.

Sobald der Marktplatz das Zurückziehen bestätigt, wird die Zuordnungs-Zeile vollständig entfernt — es gibt keinen Wert deleted.

Attribut-Quelltyp

Wird auf Attributzuordnungs- und Angebotsfeld-Zuordnungszeilen verwendet. Jeder Wert öffnet eine andere Quellenauswahl im Zuordnungsdialog.

Wert	Bedeutung
`product_field`	Ein Standard-Shopware-Produktfeld (Name, Beschreibung, EAN usw.).
`custom_field`	Ein Shopware-Zusatzfeld.
`property_group`	Eine Shopware-Eigenschaftsgruppe (verwendet für Varianten-Achsen usw.).
`category`	Smarte Kategorie — verwendet die Mirakl-Kategoriezuordnung, falls vorhanden, ansonsten Rückfall auf den Shopware-Kategorienamen.
`mirakl_category`	Strikte Mirakl-Kategorie — nur aus der Mirakl-Kategoriezuordnung (mit Eltern-Vererbung).
`shopware_category`	Roher Shopware-Kategoriename oder -Pfad, niemals die Zuordnung.
`product_image`	Ein Produktbild.
`tax`	Der Steuerwert des Produkts.
`static`	Ein statischer Wert, den Sie eingeben.
`ean_or_sku`	Entweder EAN oder SKU, je nachdem, was verfügbar ist.
`ean_or_sku_type`	Eine Markierung, welche der beiden Werte verwendet wurde.
`shop_sku`	Die Shopware-Produktnummer.
`shop_sku_type`	Eine Markierung, die den SKU-Typ kennzeichnet.
`ean`	Die EAN des Produkts.
`ean_type`	Eine Markierung, die den EAN-Typ kennzeichnet.
`effective_stock`	Der effektive Bestandswert des Produkts.
`mirakl_offer_state`	Die je Verbindung gesetzte Angebotsstatus-Überschreibung des Produkts (oder der Verbindungs-Standardwert).
`delivery_time`	Die Lieferzeit des Produkts.

Marktplatzseitige Importstatus

Vom Marktplatz bei der Importstatus-Abfrage zurückgegeben. Diese sind marktplatzseitige Zustände, getrennt von den lokalen Sync-Zuständen oben. Alle Werte sind GROSSGESCHRIEBEN, wie der Marktplatz sie zurückgibt.

Angebots-Importe

WAITING, RUNNING, COMPLETE, FAILED

Produkt-Importe

WAITING, RUNNING, COMPLETE, FAILED, TRANSFORMATION_FAILED

Bestands-Importe

WAITING, RUNNING, COMPLETE, FAILED

Transaktionsprotokoll-Export — lokaler Zustand

Wird auf der Zeile verwendet, die einen manuellen Transaktionsprotokoll-Exportauftrag verfolgt.

Wert	Bedeutung
`pending`	Erstellt, aber der Marktplatz-Auftrag hat noch nicht gestartet.
`running`	Der Marktplatz generiert die Datei.
`completed`	Die Datei wurde heruntergeladen.
`error`	Der Auftrag ist fehlgeschlagen.

Transaktionsprotokoll-Export — marktplatzseitiger Zustand

Der Marktplatz gibt am Status-Endpunkt einen dieser Werte zurück. Sie sind in „bereit” und „fehlgeschlagen” gruppiert.

Bereit (Datei herunterladen): AVAILABLE, COMPLETED, SUCCESS.
Fehlgeschlagen (terminal): FAILED, ERROR, CANCELLED.

Sync-Fehlercodes

Stabile Codes, die an Sync Logs-Zeilen angehängt werden, wenn ein Fehler eine bekannte Ursache hat. Das Admin zeigt sie über Snippets als verständliche Meldung; die zugrundeliegende technische Meldung bleibt als Rückfall verfügbar. Format: <flow>.<reason>.

Produktexport (productExport.*):

productNotVisible — Produkt ist im Verkaufskanal der Verbindung nicht sichtbar (inaktiv, fehlende Sichtbarkeit oder gelöscht).
requiredAttributeEmpty — Produkt übersprungen, weil ein erforderliches Attribut leer ist.
missingRequiredAttributes — Produkt fehlen erforderliche Attribute (Liste wird mitgegeben).
noAttributeMappings — Für diese Verbindung sind keine Attributzuordnungen konfiguriert.
noImportId — Der Marktplatz hat keine Import-ID zurückgegeben.
miraklApiError — Allgemeiner Marktplatz-API-Fehler.
rateLimitExhausted — Rate Limit überschritten; alle Wiederholungsversuche aufgebraucht.
rateLimited — Rate-limitiert; die Charge versucht es nach der Wartezeit des Marktplatzes erneut.
unexpected — Unerwarteter Fehler (nicht kategorisiert).

Angebots-Synchronisation (offerSync.*):

productNotVisible — Produkt ist im Verkaufskanal der Verbindung nicht sichtbar.
missingRequiredAttributes — Produkt fehlen erforderliche Attribute (Liste wird mitgegeben).
missingOfferFields — Produkt fehlen erforderliche Angebotsfelder (Liste wird mitgegeben).
noCategoryMapping — Für die Kategorien dieses Produkts wurde keine Mirakl-Kategoriezuordnung gefunden.
catalogPrerequisiteMissing — Produkt wurde noch nicht in den Marktplatz-Katalog exportiert. Exportieren Sie es zuerst von der Seite Produkte.
requiredFieldEmpty — Angebot übersprungen, weil ein erforderliches Feld leer ist.
miraklApiError — Allgemeiner Marktplatz-API-Fehler.
rateLimitExhausted — Rate Limit überschritten; alle Wiederholungsversuche aufgebraucht.
rateLimited — Rate-limitiert; die Charge versucht es nach der Wartezeit des Marktplatzes erneut.