Verbindung konfigurieren — Schritte und wichtigste Einstellungen

Der Konfigurationsbildschirm einer Verbindung gliedert die Einstellungen in Schritte, ungefähr in der Reihenfolge, in der Ware und Bestellung das System durchlaufen.

Geführter und Expertenmodus

Mit dem Schalter aus zwei Symbolen in der Verbindungsüberschrift wählst du die Arbeitsweise. Die Auswahl merkt sich dein Browser.

• Geführter Modus (Kompass). Über den Schritten werden drei Verbindungsschritte angezeigt: Konto, Zugangsdaten, Verbindung testen; darunter steht, was jetzt zu tun ist. Wenn die Verbindung läuft, ersetzen die Schritte eine Checkliste Inbetriebnahme: Zugangsdaten, Test, Statuszuordnung, Lagerzuweisung, erste Bestellungen und erste Angebotssynchronisierung (einige Schritte nur bei Marketplaces). Jeder Schritt hat eine Schaltfläche, die zum passenden Abschnitt führt. Über das Augensymbol kannst du die Checkliste ausblenden; über die Kachel Inbetriebnahme in der Kopfzeile kommst du zurück. Neben den Schritten gibt es außerdem den Link So richtest du es ein, der den Artikel zu diesem Schritt öffnet.
• Expertenmodus (Blitz). Ohne Schritte, Checkliste und Hilfelinks. Feldhinweise bleiben erhalten.

Im geführten Modus öffnet ein Klick auf eine Integration im Tab Verfügbare Integrationen den Assistenten in einem Fenster: Konto (Name und Schalter Sofort aktivieren), Zugangsdaten (dieselben Felder wie im Schritt Verbindung, Schaltfläche Speichern und testen) und Verbindung testen. Nach einem fehlgeschlagenen Test führt Daten korrigieren zurück zu den Feldern; nach Erfolg öffnet Zu den Einstellungen die Verbindungsseite mit Checkliste. Integrationen, die eine Anmeldung am Konto über Autorisierung durchführen (Allegro, Amazon, einige Buchhaltungsprogramme), leiten nach dem ersten Schritt zur Verbindungsseite weiter — dort wird die Anmeldung abgeschlossen. Assistent überspringen, ich richte es selbst ein legt die Verbindung an und öffnet sofort ihre Seite. Im Expertenmodus gibt es keinen Assistenten.

Ein fehlgeschlagener Verbindungstest blockiert bei einer Verbindung, die noch nie funktioniert hat, die weiteren Schritte — ebenso wie fehlende Pflichtangaben. Die Fehlermeldung steht oberhalb der Felder des Schritts Verbindung.

Ein Zuordnungsschritt mit gestricheltem Kreis und der Schaltfläche Prüfen bedeutet, dass das System den Status noch nicht kennt: Die Zuordnungstabelle wird erst geladen, wenn du den entsprechenden Schritt öffnest.

Schritt für Schritt — eine neu angelegte Verbindung konfigurieren

Die Schritte werden nacheinander bearbeitet. Jeder ist ein eigener Tab; ein abgeschlossener Schritt erhält die Markierung Schritt erledigt, und die Kopfzeile zeigt den Zähler Noch auszufüllen — ein Klick darauf führt zum ersten fehlenden Feld.

1. Öffne Integrationen → Integrationen → Meine Integrationen und klicke auf die Verbindung.
2. Schritt Verbindung. Trage Schlüssel, Login und Adressen des Kanalbetreibers ein. Die Felder hängen vom jeweiligen Konnektor ab.
3. Speichere. Unten erscheint die Leiste Nicht gespeicherte Änderungen mit Zähler sowie den Schaltflächen Verwerfen und Änderungen speichern — klicke auf Änderungen speichern. Das System fragt im Fenster 2FA-Verifizierung erforderlich nach dem Code: Gib den Verifizierungscode ein und klicke auf Bestätigen (2FA-Bestätigung bei Berechtigungsänderungen).
4. Klicke in der Kopfzeile auf Test oder im Schritt Verbindung auf Verbindung testen und warte auf das Ergebnis. Gehe erst weiter, wenn Verbindung OK erscheint. Wenn du Zugangsdaten änderst, bietet die Speicherleiste auch Speichern und testen, wodurch beide Schritte zusammen ausgeführt werden.
5. Schritt Bestellungen. Richte den Bestellimport, den Standardstatus für neue Bestellungen und die automatische Bestätigung ein. Klappe hier auch den Abschnitt Statuszuordnung auf und ordne die Kanalstatus zu (Marketplace-Bestellstatuswerte – Zuordnung in beide Richtungen).
6. Schritt Bestände und Produkte. Lege Mindestbestand und zugehöriges Lager fest. Füge in der Karte zur Lagerzuordnung mindestens eine Zuordnung hinzu, bei der die Bestandsübertragung aktiviert ist (Zuordnungen – Lager, Versanddienstleister, Preislisten, Kategorien). Ohne diese Zuordnung werden keine Bestände übertragen — und es erscheint kein Hinweis darauf.
7. Schritt Preise. Wähle die Preisgruppe, aus der der an den Kanal übermittelte Preis berechnet wird.
8. Schritt Versand. Weise im Abschnitt Kurierzuordnung, der bereits aufgeklappt ist, die Versandarten des Kanals deinen Zustellern zu (Versandmethoden zuordnen und Sendungen validieren). Ohne diese Zuordnung kommt die Bestellung zwar an, lässt sich aber nicht verpacken.
9. Prüfe zum Schluss Schritt Retouren und Schritt Erweitert, sofern der Kanal diese anzeigt.
10. Aktiviere den Schalter neben der Schaltfläche Test in der Kopfzeile, wenn die Verbindung arbeiten soll.

Wenn du eine bestimmte Einstellung suchst, musst du die Schritte nicht einzeln durchgehen — nutze das Feld Einstellung suchen… über den Schritten. Bei einer Suche werden die Zuordnungsabschnitte ausgeblendet; öffne sie wieder über den jeweiligen Schritt.

Einstellungen, die am häufigsten geändert werden

Der vollständige Umfang hängt vom jeweiligen Marketplace ab — jeder hat zusätzliche eigene Parameter.

Drei Einstellungen, die du genauer kennen solltest

„Bestände mit Marketplace synchronisieren“ deaktiviert beide Richtungen zugleich

Der Name spricht von der Übertragung, aber das Feld steuert auch das Abrufen von Angeboten aus dem Kanal. Wenn es deaktiviert ist, werden beide Vorgänge gestoppt. Ein Feld, zwei Richtungen (Schalter, die den gesamten Kanal anhalten).

Mindestbestand ist ein Schwellenwert, kein Puffer

Der Wert wird nicht abgezogen. Solange der Bestand über dem Schwellenwert liegt, wird die volle Menge an den Kanal gesendet; fällt er auf den Schwellenwert oder darunter, erhält der Kanal null. Bei einem Schwellenwert von 2 sieht der Marketplace bei tatsächlich 5 Stück 5, bei 2 Stück dagegen 0. So verkaufst du nicht die letzten Stücke, die gerade aus dem Regal genommen werden.

Das zugehörige Lager reicht ohne Zuordnung nicht aus

Die Auswahl eines Lagers genügt nicht — es muss auch eine aktive Lagerzuordnung mit aktivierter Bestandssynchronisierung geben (Zuordnungen – Lager, Versanddienstleister, Preislisten, Kategorien). Ohne sie werden Bestände einfach nicht übertragen, ohne irgendeine Meldung.

PrestaShop: Bestände werden auch an im Shop deaktivierte Produkte übertragen

In PrestaShop wird der Bestand an jedes Produkt übertragen, dessen importiertes Angebot mit einem Produkt in Noxti verknüpft ist — auch wenn das Produkt im Shop deaktiviert ist (inaktives Angebot). So zeigt das Produkt nach erneuter Aktivierung den aktuellen Bestand und nicht den Stand vor der Deaktivierung. Dafür musst du Bestände für inaktive Angebote senden nicht aktivieren. Ein Produkt ohne importiertes Angebot oder mit einem Angebot ohne Verknüpfung zu einem Noxti-Produkt erhält keinen Bestand — importiere zuerst die Angebote und prüfe die Verknüpfungen.

PrestaShop: Änderungen an Bestellungen, die der Shop nicht kennzeichnet

Einige PrestaShop-Shops ändern eine Bestellung (Position hinzugefügt, anderer Versandpreis), ohne das Datum der letzten Änderung zu aktualisieren. Der normale Bestellabruf erkennt diese Änderung nicht. Wenn Offene Bestellungen erneut anhand der Nummer lesen aktiviert ist (Standard: aktiviert), liest Noxti daher alle 15 Minuten jede Bestellung dieser Verbindung der letzten 14 Tage erneut ein, die das Lager noch nicht verpackt hat und die nicht storniert ist. Beide Zeiträume kannst du in Offene Bestellungen erneut lesen alle (Minuten) und … der letzten (Tage) ändern. Unveränderte Bestellungen werden weder gespeichert noch in der Historie angezeigt. Auf diese Weise werden bereits verpackte Bestellungen nicht erneut geprüft — eine Änderung der Position nach dem Verpacken ändert die Bestellung ohnehin nicht, sondern meldet ein Problem, das geklärt werden muss.

Schritt Erweitert

Zwei Punkte sind erwähnenswert:

• Datenspeicherung — wie lange der Kanal Kundendaten und Bestelldateien aufbewahrt, legst du unter Einstellungen → System → Datenspeicherung fest, zusammen mit dem Speicherplatzbedarf der einzelnen Dateitypen dieses Kanals (Speicherplatz und Datenspeicherung — Dateiverbrauch, Downloads, Löschung und Aufbewahrungsfristen). Im Schritt bleibt der Abschnitt mit der Schaltfläche Zu Datenspeicherung wechseln — sie öffnet diesen Tab direkt bei der Zeile dieses Kanals. Den Abschnitt gibt es bei Kanälen, von denen Bestellungen eingehen (Marketplaces, manuelle Bestellungen, SubConnect), und nur für Unternehmensadministratoren.
• Synchronisierungsdaten — ein Verwaltungstool, mit dem sich der Zeitstempel der letzten Synchronisierung um eine Stunde, einen Tag oder eine Woche zurücksetzen lässt. So holst du nach, was verloren ging. Eine Woche bei einem großen Kanal nachzuholen bedeutet viel Datenverkehr — verwende die Funktion bewusst.

Felder, deren Auswahl aus dem Shop stammt

Einige Einstellungen speichern die ID eines Datensatzes auf der Shopseite — welcher Bestellstatus „storniert“ bedeutet, welche Kuriere an Paketfächer liefern, mit welchem Mitarbeiter eine Statusänderung gekennzeichnet wird. Das sind keine Textfelder: Das System fragt die Liste direkt beim Shop ab und zeigt die Namen an, speichert aber die ID. In PrestaShop betrifft das sechs Einstellungen: als storniert geltende Status, abzurufende Status, Kuriere mit Abholpunkten, Labelsprachen, Mitarbeiter für Statusänderungen und Shop im Multistore-Modus. Ein siebtes Feld — Zeitzone des Shops — ist ebenfalls eine Liste, stammt aber aus der Zeitzonendatenbank und nicht aus dem Shop: PrestaShop liefert seine Zeitzone nicht über die API, daher gibt es diese Einstellung. Eine unbekannte Zeitzone verhindert den Import nicht — in diesem Fall verwendet das System still Europe/Warsaw. Das eigentliche Risiko ist ein anderes: Ein Shop in einer anderen Zeitzone (etwa ein deutscher unter Europe/Berlin oder ein britischer unter Europe/London) mit dem Standardwert erhält Bestelldaten mit einer Zeitverschiebung entsprechend dem Zeitzonenunterschied, ohne irgendeinen Hinweis. Prüfe dieses Feld bei einem Shop außerhalb Polens.

Im Schritt Preise hat PrestaShop noch zwei Felder mit einer Liste aus dem Shop:

• Standardland des Shops (PrestaShop-ID) — Liste der Shopländer (Name, ISO-Code und ID). Normalerweise bleibt das Feld leer — das System liest das Land aus der Shopkonfiguration (PS_COUNTRY_DEFAULT). Wähle es nur, wenn der Webservice-Schlüssel keine Berechtigung für /configurations hat. Anhand dieses Landes wird der Mehrwertsteuersatz des Produkts bestimmt, mit dem der Nettopreis des Shops in den Bruttopreis der Preisgruppe umgerechnet wird (Angebotsabruf und Preissynchronisierung).
• Standardwährung des Shops — nur Währungen, die der Shop führt und die zugleich in Noxti aktiv sind. Eine Währung außerhalb dieser Schnittmenge würde ohnehin dazu führen, dass jeder Preis abgelehnt wird.

Shoplisten werden einige Minuten zwischengespeichert, damit der Bildschirm den Shop nicht bei jedem Öffnen abfragt. Ein neuer Kurier oder Status, den du im Shop-Panel anlegst, erscheint spätestens nach etwa fünf Minuten in der Liste.

Die ID bleibt in Klammern sichtbar — Storniert (ID: 6) —, denn im Shop-Panel, in Protokollen und im Gespräch mit dem technischen Support verwenden alle die Nummern.

Drei Dinge solltest du wissen:

• Eine leere Liste bedeutet nicht „Der Shop hat keine Einträge“. Wenn der Shop nicht geantwortet hat, zeigt das Feld eine rote Meldung — etwa Der Shop hat den Webservice-Schlüssel abgelehnt…, wenn der Schlüssel ungültig ist oder Berechtigungen für diese Liste fehlen, oder Der Shop hat die Liste nicht zurückgegeben… bei einem anderen Fehler. Die gespeicherte Konfiguration bleibt dabei unverändert. Speichere das Formular nicht „mit Gewalt“, sondern prüfe die Verbindung mit der Schaltfläche Test.
• Ein Wert außerhalb der Liste bleibt erhalten. Wenn das Feld eine ID enthält, die der Shop nicht mehr zurückgibt (gelöschter Kurier, neu nummerierter Status), bleibt sie mit dem Zusatz nicht in der Liste auswählbar. Das ist ein Zeichen, die Änderung bewusst vorzunehmen, und kein Hinweis zum Ignorieren — eine solche ID kommt in keiner Bestellung mehr vor.
• Gelöschte Kuriere fehlen in der Liste. PrestaShop löscht einen Kurier „weich“, damit alte Bestellungen weiterhin geöffnet werden können. Eine neue Bestellung darf ihn nicht erhalten, deshalb wird er in der Liste nicht angeboten. Ein deaktivierter Kurier dagegen schon, denn er kann nach der Saison zurückkehren.

Der Synchronisierungstakt wird hier nicht eingestellt

Im Schritt Bestände findest du keine Felder für die Häufigkeit der Marketplace-Synchronisierung — dieser Mechanismus ist ausschließlich für Lagerintegrationen angebunden. Die Zeitpläne der Marketplaces stellst du anderswo ein (Was synchronisiert wird und in welche Richtung).

Speichern erfordert 2FA

Jedes Speichern der Verbindungseinstellungen fragt nach einem Code (2FA-Bestätigung bei Berechtigungsänderungen).

Eine Änderung der PrestaShop-Shopadresse löscht den Schlüssel

Die Shopadresse muss eine öffentliche http(s)-Adresse sein — lokale Adressen und private Netzwerke werden beim Speichern abgelehnt. Änderst du die Adresse auf einen anderen Server (andere Domain oder anderer Port), wird der gespeicherte Webservice-Schlüssel entfernt: Der Schlüssel authentifiziert für sich allein, ohne Passwort, daher darf er nicht an einen anderen Server gehen als den, für den er erstellt wurde. Trage nach dem Adresswechsel den Schlüssel des neuen Shops ein. Der Wechsel von http:// zu https://, das Hinzufügen oder Entfernen von www. sowie das erneute Speichern derselben Adresse (etwa mit abschließendem Schrägstrich oder /api) berühren den Schlüssel nicht — es ist derselbe Shop. Ein Schlüssel, der zusammen mit der neuen Adresse in einem Speichervorgang eingetragen wird, bleibt erhalten. Schlägt das Speichern der Adresse fehl, bleibt auch der Schlüssel bestehen.

Wenn der Shop von http:// zu https:// oder zwischen einer Adresse mit und ohne www weiterleitet, funktioniert der Datenabruf weiterhin, aber in den Protokollen erscheint eine Warnung. Korrigiere die Shopadresse auf die Zieladresse der Weiterleitung. Status-, Bestands- und Preisübertragung an den Shop funktioniert erst nach dieser Korrektur. Eine Weiterleitung zu einem anderen Server oder Pfad endet immer mit einem Fehler, der die einzutragende Adresse nennt.

Ein Shop im lokalen Netzwerk (etwa ein Testshop in Docker) lässt sich nur in der Entwicklungsumgebung verbinden; in Produktion muss die Adresse öffentlich sein.

Aus der Shopadresse entsteht außerdem der Link zur Produktseite, der bei jedem importierten Angebot gespeichert wird: <Shopadresse>/index.php?controller=product&id_product=…&id_lang=… (für eine Variante zusätzlich id_product_attribute, das diese Variante auf der Seite auswählt). Die Sprache ist dieselbe, in der der Produktname abgerufen wird. Die Adresse öffnet das Produkt in jeder PrestaShop-Version, unabhängig von den Einstellungen für benutzerfreundliche URLs — bei aktivierter Option leitet der Shop selbst auf seine lesbare Adresse weiter. Bereits importierte Angebote erhalten den Link beim nächsten Angebotsabruf.

Kann der Shop eine einzelne Bestellung oder deren Positionen, Kunden oder Adresse nicht zurückgeben, werden die übrigen Bestellungen normal importiert. Dieser eine Datensatz wird nicht angelegt; stattdessen erscheint das Problem „order data unreadable“. Das System versucht es bei jedem Abruf 24 Stunden ab der letzten Änderung der Bestellung im Shop erneut und danach erst wieder, wenn die Bestellung im Shop erneut geändert wird. War die Bestellung bereits importiert, bleibt sie unverändert — übersprungen wurde nur ihre Aktualisierung, wie auch die Problembeschreibung angibt. Das Problem wird automatisch geschlossen, wenn der Import gelingt. Öffne die Bestellung im PrestaShop-Panel und prüfe ihre Produkte und Adressen.

Der Bestellabruf reicht höchstens 14 Tage zurück. Wenn die Verbindung länger nicht funktionierte, importiere ältere Bestellungen manuell anhand ihrer Nummern.

Der Schlüssel braucht GET-Zugriff auf: orders, order_details, order_histories, order_carriers, customers, addresses, carriers, countries, states, currencies, order_states, products, combinations, stock_availables, tax_rules, taxes, languages, employees, shops und configurations; POST auf order_histories; PUT auf orders, order_carriers, stock_availables und products. Eine fehlende Berechtigung deaktiviert nur die Funktion, die sie benötigt — ohne employees wird etwa die Mitarbeiterliste nicht geladen. Ausnahme ist order_details: Ohne diese Berechtigung werden Bestellungen nicht importiert (anstatt ohne Positionen anzulegen), und unter Probleme erscheint ein Eintrag zu nicht lesbaren Bestelldaten.

Als storniert eingestellte Status verhindern das Anlegen einer neuen Bestellung. Eine bereits importierte Bestellung wird im WMS nur durch den Status Storniert (ID 6) storniert — „Retoure“ (7) und „Zahlungsfehler“ (8) wirken sich nicht aus, denn nach einem Zahlungsfehler bezahlt der Kunde häufig erneut und der Shop stellt die Bestellung auf bezahlt.

Link zur Produktseite bei anderen Shops

Jedes importierte Shopangebot speichert den Link zur Produktseite — unter anderem verwendet ihn die Produktdatei für Google Shopping. Gespeichert wird nur eine vollständige Adresse mit http:// oder https://; bei einer relativen, leeren Adresse oder einem anderen Protokoll bleibt das Angebot ohne Link.

• IdoSell — die API liefert keine Produktseitenadresse zurück, deshalb wird der Link erstellt: <Shopadresse>/product-<Sprache>-<Produkt-ID>.html. IdoSell öffnet diese Adresse und leitet selbst auf die vollständige Adresse mit Produktname weiter.
  • Shopadresse ist die Einstellung Öffentliche Shopadresse (Schritt Verbindung) — die Adresse, die deine Kunden sehen, zum Beispiel https://sklep.example.com. Trage sie in jeder IdoSell-Verbindung ein, die für Google Shopping verwendet werden soll: Google akzeptiert nur Links aus einer in Merchant Center eingetragenen Domain. Bei mehreren Shops in einem Panel erhält jede Verbindung die Adresse ihres Shops (zum Beispiel https://mojsklep.cz für den tschechischen Shop).
  • Ist das Feld leer oder enthält es keine vollständige Adresse mit http(s)://, wird der Link aus dem Feld Domain gebildet (ohne den Zusatz /api/…). Das ist gewöhnlich die Paneladresse (etwa …iai-shop.com) — sie öffnet den Standardshop des Panels, aber Google akzeptiert den Link nicht.
  • Die Shopsprache (Einstellung Shopsprache, IdoSell-Code wie pol, cze, eng; Standard pol) bestimmt, in welcher Sprache Angebotsnamen und -beschreibungen abgerufen werden und in welcher Sprache der Link geöffnet wird.
  • Hat das Produkt im Panel eine individuelle URL für den Shop und die Sprache dieser Verbindung, wird diese Adresse gespeichert.
  • Nach einer Änderung der Adresse oder Sprache erhalten Angebote ihre neuen Links beim nächsten vollständigen Angebotsabruf.
• Shoper — Link aus dem Shop (permalink des Produkts); eine relative Adresse wird mit der Shopadresse ergänzt.
• WooCommerce — Link aus dem Shop (permalink der Variante oder des Produkts).
• Shopify — Produktadresse im Onlineshop; ein Produkt, das nicht im Vertriebskanal Online Store veröffentlicht wurde, hat keine Produktseite und somit keinen Link.
• GoShop — die API liefert keine Produktseitenadresse; GoShop-Angebote haben keinen Link.

Bereits früher importierte Angebote erhalten den Link beim nächsten vollständigen Angebotsabruf.

Speichern und Einstellungshinweise

Wähle Namen aus den Listen, sofern das Formular fertige Optionen anbietet. Felder mit Mehrfachauswahl behalten alle ausgewählten Werte. Technische Einstellungen findest du im Abschnitt Erweitert; ändere sie entsprechend der jeweiligen Feldbeschreibung.

Beim Speichern werden unter anderem Zahlenformate, Ports und verfügbare Optionen geprüft. Bei einem Fehler korrigiere die markierten Felder und speichere erneut — nicht gespeicherte Werte bleiben sichtbar. Ein leeres Passwortfeld lässt das bisherige Passwort bestehen.

In PrestaShop können Statuslisten die für dieses Konto in Noxti gespeicherten Namen verwenden. Das Formular weist unter der Liste darauf hin. Nachdem du Status im Shop geändert hast, klicke im Abschnitt Statuszuordnung auf Status aktualisieren. Wenn noch keine gespeicherte Liste vorliegt, versucht das System, sie direkt aus dem Shop abzurufen.