Wissensdatenbank / Onlineshop

API-Abfrage des Produktlagerbestands

Ihre Bestandsdaten lassen sich auch programmatisch abfragen – Ihre externen Systeme können jederzeit mit Echtzeitwerten arbeiten.

Sellvio ermöglicht es Shop-Inhabern, über API-Zugriffs-URLs personalisierte Produktbestände auf verschiedenen Listungsseiten wie Facebook Shop, Olcsobbat.hu, Argep.hu usw. anzuzeigen.

Die Verwaltungsseite der Produkt-API erreichen Sie über die Seitenleiste der Verwaltungsoberfläche im Menü Onlineshop → API.

Für jeden Dienst, der im Verwaltungsbildschirm der API aufgeführt ist, müssen Shop-Betreiber über ein Konto beim jeweiligen Dienst verfügen. Sobald ein Konto bei einem bestimmten Dienst angelegt wurde, kann der Shop-Betreiber den passenden API-Link aus Sellvio kopieren und auf seiner Profilseite beim Dienstanbieter einfügen.

Produktlistungsdienste erfordern, dass Shop-Inhaber ihre Konten auf eine bestimmte Weise konfigurieren. Weitere Einzelheiten dazu, wie die API-Links in das jeweilige System eingebunden werden, entnehmen Sie bitte der Dokumentation auf der Website des Dienstanbieters.

Die aufgeführten Produkte müssen ebenfalls in ihrer spezifischen Struktur bereitgestellt werden. Sellvio verwaltet die Produktstruktur im Hintergrund, sodass sich Shopbetreiber nicht darum kümmern müssen.

Registerkarte „Allgemein“

Die Einstellungen auf der Registerkarte Allgemein sind für alle Dienste identisch. Daher werden die Einzelheiten in dieser Dokumentation nur für einen Dienst beschrieben, da der Konfigurationsablauf für alle Dienste gleich ist.

  • Die meisten Produktlistungsdienste sind einem bestimmten Land zugeordnet. Administratoren können die Liste über die Dropdown-Liste oben auf der Seite nach Land filtern.
    Screenshot zu diesem Schritt
  • Der Name des Produktlisten-Dienstes.
  • Kategorien - Über das Feld zur Kategorieauswahl können Shop-Betreiber festlegen, welche Onlineshop-Kategorien sie in den Produktlistendienst aufnehmen möchten. Die Anzahl der auswählbaren Kategorien ist unbegrenzt.
  • Marken - Über das Feld zur Herstellerauswahl können Shop-Betreiber festlegen, die Produkte welcher Hersteller sie in den Produktlistendienst aufnehmen möchten. Die Anzahl der auswählbaren Hersteller ist unbegrenzt.
    Screenshot zu diesem Schritt
  • Preiskategorie – Wählen Sie aus, ob im Produktlistendienst Einzelhandels- oder Großhandelsprodukte angezeigt werden sollen.
  • Nur markierte Produkte – bei Aktivierung werden nur Produkte in den Produktfeed aufgenommen, die in der Verwaltungsoberfläche des Onlineshops eigens dafür markiert wurden.
  • URL - In diesem Feld wird die automatisch erzeugte URL angezeigt. Jede Änderung an den obigen Einstellungen aktualisiert die erzeugte URL automatisch. Die in der erzeugten URL verwendete Sprache (/en, /hu, /sr) richtet sich nach der aktuellen Sprache der Verwaltungsoberfläche. Sie bestimmt zugleich, in welcher Sprache die Produkte im Produktlistendienst erscheinen. Sobald alle Einstellungen konfiguriert sind, können Sie die API-URL bequem in die Zwischenablage kopieren, indem Sie auf die Schaltfläche „Kopieren“ am Ende des URL-Feldes klicken.
    Screenshot zu diesem Schritt
  • Über die Dropdown-Liste Format können Benutzer das Format auswählen, in dem die Produkte über die URL bereitgestellt werden.

Das Land, in dem der Dienst verfügbar ist, wird in der oberen rechten Ecke des Dienstes angezeigt. Ist der Dienst keinem bestimmten Land zugeordnet, ist er weltweit verfügbar.

WICHTIG: Produkte, die nicht sichtbar oder nicht verfügbar sind, erscheinen nicht in der über die API-URL geteilten Produktliste.

Registerkarte „B2B API“

Die Funktion Benutzer-API-Token ermöglicht es, einen API-Endpunkt zu erstellen, der eine individuelle Produktliste für einen bestimmten registrierten Benutzer enthält.

Durch die Auswahl von Onlineshop-Kategorien und Herstellern können Administratoren eingrenzen, welche Produkte des Shops in den API-Endpunkt aufgenommen werden sollen. Wird keine Kategorie und kein Hersteller ausgewählt, umfasst der Endpunkt alle verfügbaren Produkte des Onlineshops. Der API-Endpunkt liefert außerdem zusätzliche Produktdaten wie Nettopreis, MwSt.-Betrag, Parameter und Angaben zur Deklaration, darunter Nettogewicht, Bruttogewicht und Energieklasse.

Die Endpunkte der erstellten Benutzer-API-Token wurden um detailliertere Daten zu den Produktbildern erweitert. Der Datensatz enthält nun sowohl das Hauptbild des Produkts als auch die weiteren dem Produkt zugeordneten Bilder.

Da der Endpunkt für einen bestimmten Benutzer erstellt wird, enthalten die über die API-URL bereitgestellten Produkte die systemseitigen Benutzerrabatte, die für jeden registrierten Benutzer individuell im Menü Benutzerverwaltung → Benutzer auf der Registerkarte Rabatte konfiguriert werden können. Eine kurze Auffrischung zu benutzerspezifischen Rabatten finden Sie in diesem Artikel.

  • Kategorien: Über das Eingabefeld zur Kategorieauswahl können Shopbetreiber festlegen, aus welchen Onlineshop-Kategorien die Produkte stammen sollen. Die Anzahl der auswählbaren Kategorien ist unbegrenzt.
  • Hersteller: Über das Eingabefeld zur Herstellerauswahl können Shopbetreiber festlegen, welche Herstellerprodukte einbezogen werden sollen. Die Anzahl der auswählbaren Hersteller ist unbegrenzt.
    Screenshot zu diesem Schritt
  • Lager – Durch die Auswahl von Lagern können Sie filtern, welche Produkte aus bestimmten Lagerstandorten über den API-Endpunkt verfügbar sind. Wird kein Lager ausgewählt, schränkt das System die Produktliste nicht nach Lager ein.
  • Benutzer: Der registrierte Benutzer, für den der API-Endpunkt erstellt werden soll. In diesem Feld können Sie nach Benutzernamen oder E-Mail-Adresse suchen.

Durch Klicken auf die Schaltfläche „Speichern“ wird der API-Endpunkt des ausgewählten Benutzers mit der angegebenen Konfiguration erstellt.

Alle zuvor erstellten API-Endpunkte werden auf der Registerkarte „Benutzer-API-Token“ im Anschluss an den Bereich „Benutzer-API-Token erstellen“ aufgelistet.

Name und E-Mail-Adresse des registrierten Benutzers sowie die Anzahl der vom Kunden genutzten Endpunkte.

Benutzername und E-Mail: Name und E-Mail-Adresse des registrierten Benutzers sowie die Anzahl der Endpunkte, die der Kunde genutzt hat.

Der Bereich mit der Liste der Endpunkte des Benutzers lässt sich über die Pfeilschaltfläche in der oberen rechten Ecke des Bereichs ein- und ausklappen. Administratoren können das Format des Endpunkts auswählen und den erstellten Endpunkt über die Dropdown-Liste für das Format durch Klicken auf die Schaltfläche Kopieren in die Zwischenablage übernehmen.

Wird ein API-Endpunkt nicht mehr benötigt, lässt er sich einfach durch Klicken auf das rote Papierkorb-Symbol am Ende des Eintrags der API-URL löschen.

Ein Klick auf die blaue Schaltfläche „Einstellungen“ am Ende des API-URL-Eintrags zeigt die Konfiguration an, mit der der Endpunkt erstellt wurde.

WICHTIG: Bestehende Einstellungen der API-URL können nur angezeigt, nicht bearbeitet werden.