Zum Inhalt springen
Bulutegra Entwickler
Entwickler

Integrationsreferenz

Bulutegra hat eine REST-API nur zum Lesen und Webhooks; die Dokumentation finden Sie unter developers.bulutegra.com. Diese Seite ist eine Übersicht über etwas anderes: die Verbindungen, die Bulutegra auf dem offiziellen Dienst jedes Systems aufbaut.

Worum es auf dieser Seite geht

Bulutegra ist eine Integrationsschicht: Sie liegt zwischen den Marktplätzen, Ihrer eigenen Website und Ihrem ERP. Wir bauen die Verbindung und übernehmen die Unterschiede auf Kanalseite, sodass Sie in einem Panel arbeiten, statt die technischen Eigenheiten jedes Kanals zu lernen.

Von den 47 auf dieser Website gelisteten Integrationen sind 22 gebaut und in Betrieb; 25 werden auf Anfrage eingerichtet. Das sagt, was das Produkt unterstützt. Es sagt nichts darüber, wer auf welchem Kanal verkauft.

Die Dienstadressen in den Tabellen sind die offiziellen Verkäuferdienste, die diese Systeme veröffentlichen. Bulutegra verbindet sich in Ihrem Namen und mit den Rechten Ihres Kontos damit. Dazwischen liegt kein Endpunkt von Bulutegra.

In diesen Tabellen steht kein Schlüssel, kein Passwort, keine Verkäufernummer und kein Beispiel für Zugangsdaten. Die Spalte „Was wir von Ihnen brauchen“ nennt nur, welche Angabe nötig ist.

Marktplätze

Jede Marktplatzverbindung läuft über den eigenen Verkäuferdienst des jeweiligen Kanals. Bestellungen werden aus dem Kanal gelesen; Bestand, Preise und Angebote werden geschrieben, soweit der Kanal das unterstützt.

Zum Lesen die Tabelle seitlich scrollen.

Marktplatz-Integrationen: Verbindungsart, gelesene und geschriebene Daten, benötigte Angaben, Einrichtungsstatus
SystemVerbindungGelesenGeschriebenWas wir von Ihnen brauchenEinrichtung
TrendyolREST · apigw.trendyol.comBestellungen, ProdukteBestand, Preise, Listing, InhalteAPI-Schlüssel, API-Geheimnis, VerkäufernummerVerbindung steht
HepsiburadaREST · oms-external.hepsiburada.com · listing-external.hepsiburada.comBestellungen, ProdukteBestand, Preise, Listing, InhalteBenutzername, Händlernummer, geheimer SchlüsselVerbindung steht
n11SOAP + REST · api.n11.comBestellungen, ProdukteBestand, Preise, Listing, InhalteAnwendungsschlüssel und AnwendungsgeheimnisVerbindung steht
PazaramaOAuth2 + REST · isortagimgiris.pazarama.com · isortagimapi.pazarama.comBestellungen, ProdukteBestand, Preise, Listing, InhalteClient-ID und Client-GeheimnisVerbindung steht
ePttAVMSOAP (WS-Security) · ws.pttavm.comBestellungen, ProdukteBestand, Preise, Listing, InhalteBenutzername und PasswortVerbindung steht
FLOREST · api.flo.com.trBestellungenBestand, PreiseAPI-KennungVerbindung steht
ÇiçeksepetiREST · apis.ciceksepeti.comBestellungen, ProdukteBestand, Preise, Listing, InhalteAPI-SchlüsselVerbindung steht
idefixREST · merchantapi.idefix.comBestellungen, ProdukteBestand, Preise, ListingVerkäufernummer und API-SchlüsselVerbindung steht
ModanisaRESTBestellungenBestand, PreiseAPI-Benutzername und PasswortVerbindung steht
AmazonAmazon Selling Partner API (SP-API)Bestellungen, ProdukteBestand, Preise, InhalteSP-API-Anwendungsautorisierung und Verkäufer-IDVerbindung steht
eBayRESTBestellungen, ProdukteBestand, Preise, Listing, InhalteOAuth-AnwendungsautorisierungVerbindung steht
Walmart (US)OAuth2 + REST · Walmart Marketplace API v3Bestellungen, ProdukteBestand, Preise, Listing, InhalteClient-ID und Client-GeheimnisVerbindung steht
EtsyOAuth2 + REST · Etsy Open API v3Bestellungen, ProdukteBestand, Preise, Listing, InhalteAnwendungsschlüssel und Shop-AutorisierungVerbindung steht
OzonREST · api-seller.ozon.ruBestellungen, ProdukteBestand, Preise, Listing, InhalteClient-Id · Api-KeyVerbindung steht
TemuREST · Temu Open APIBestellungen, ProdukteBestand, Preise, ListingApp-Schlüssel, App-Secret und ZugriffstokenVerbindung steht
SHEINREST · SHEIN Open Platform APIEinkaufsbestellungen, ProdukteBestandShop-Autorisierung über das Haupt-VerkäuferkontoVerbindung steht
JumiaRESTBestellungenWird bei der Einrichtung festgelegtVerkäufer-API-KennungVerbindung steht
noonREST · noon Partner API (JWT)ProdukteListingDienstkonto-SchlüsselVerbindung steht
NamshiWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtAuf Anfrage einrichtbar
AllegroWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtAuf Anfrage einrichtbar
WildberriesRESTBestellungenWird bei der Einrichtung festgelegtAPI-SchlüsselVerbindung steht
TakealotREST · seller-api.takealot.comBestellungenWird bei der Einrichtung festgelegtAPI-SchlüsselVerbindung steht
AnanasWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtAuf Anfrage einrichtbar
JustYolWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtAuf Anfrage einrichtbar

Steht in der Spalte „Geschrieben“ der Eintrag „Wird bei der Einrichtung festgelegt“, wird die Schreibrichtung für diesen Kanal nach den Rechten Ihres Kontos und den Ergebnissen im Schattenmodus freigeschaltet. Schreibrechte werden nie für alle Kanäle auf einmal aktiviert, sondern Kanal für Kanal.

Der Bestand wird über alle Kanäle hinweg aus einem einzigen Pool verwaltet: Ein Verkauf auf einem Kanal senkt die Menge auf den anderen. Es gibt kein eigenes Bestandsbuch je Kanal.

E-Commerce-Plattformen

Läuft Ihre eigene Website auf einer E-Commerce-Plattform, kommen deren Produkte, Bestände und Preise in denselben Pool, und die Website verhält sich wie ein weiterer Kanal.

Zum Lesen die Tabelle seitlich scrollen.

E-Commerce-Plattformen: Verbindungsart, gelesene und geschriebene Daten, benötigte Angaben, Einrichtungsstatus
SystemVerbindungGelesenGeschriebenWas wir von Ihnen brauchenEinrichtung
ikasGraphQL · api.myikas.com · adminapi.myikas.comProdukte, Varianten, Bestand, PreiseWird bei der Einrichtung festgelegtAdmin-API-SchlüsselVerbindung steht
ShopifyWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtAuf Anfrage einrichtbar
WooCommerceWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtAuf Anfrage einrichtbar
TicimaxWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtAuf Anfrage einrichtbar
IdeaSoftWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtAuf Anfrage einrichtbar
T-SoftWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtAuf Anfrage einrichtbar

Wo es keinen fertigen Konnektor gibt, führen zwei Wege hin: die eigene offizielle API der Plattform oder ein regelmäßiger XML/CSV-Feed. Welcher greift, hängt davon ab, was in Ihrer Edition verfügbar ist, und wird bei der Einrichtung festgelegt.

Die Besitzmarkierung gilt auch hier: Für ein Produkt und einen Kanal ist klar, ob Bulutegra oder ein fremdes System zuständig ist, sodass zwei Systeme dasselbe Feld nie gegenläufig aktualisieren.

ERP

Eine ERP-Verbindung folgt immer derselben Reihenfolge: zuerst lesen, dann vergleichen, zuletzt schreiben. Auf ERP-Seite bleibt das Schreiben getrennt und überwacht, denn ein falscher Datensatz wandert bis in die Buchhaltung.

Zum Lesen die Tabelle seitlich scrollen.

ERP-Integrationen: Verbindungsart, gelesene und geschriebene Daten, benötigte Angaben, Einrichtungsstatus
SystemVerbindungGelesenGeschriebenWas wir von Ihnen brauchenEinrichtung
Nebim V3Nebim V3 IntegratorBestellungen, Kunden, Bestand (nur lesende Prozeduren)Getrennt und überwachtDienstadresse, Dienstbenutzer und PasswortVerbindung steht
LogoWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtAuf Anfrage einrichtbar
MikroWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtAuf Anfrage einrichtbar
SAPWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtAuf Anfrage einrichtbar

Bei Logo, Mikro und SAP hängt die Verbindung von der Edition des Kunden und den lizenzierten Modulen ab; deshalb nennen wir sie auf Anfrage einrichtbar und nicht fertig. Nennen Sie uns Edition und Module, dann sagen wir vorab, was möglich ist.

Lieferanten-Feed

Wenn Sie die Produkte nicht selbst herstellen, sondern von einem Lieferanten beziehen, wird der Katalog aus einer Feed-Datei gelesen.

Zum Lesen die Tabelle seitlich scrollen.

Lieferanten-Feed: gelesene Felder und benötigte Angaben
SystemVerbindungGelesenGeschriebenWas wir von Ihnen brauchenEinrichtung
Lieferanten-XML-FeedXMLProduktcode, Barcode, Name, Preis, Bestand, BildEs wird nichts geschriebenFeed-Adresse und SpaltenaufbauVerbindung steht

Die Felder werden aus festen Spalten gelesen. Preise werden je Lieferant mit einem Faktor berechnet, und Bestand unterhalb der festgelegten Schwelle geht nicht in den Verkauf.

Hier greift die Nullstellungsbremse: Würden in einem Durchlauf ungewöhnlich viele Produktcodes auf null gesetzt, stoppt der Versand und eine Warnung geht heraus. Ein defekter oder halb geladener Feed kann nicht alle Kanäle leeren.

Versanddienstleister

Eine Marktplatzbestellung kommt zusammen mit Versanddienstleister und Lieferart an. Diese Angabe wird je Kanal definiert und zusammen mit der Bestellung ins ERP geschrieben.

Zum Lesen die Tabelle seitlich scrollen.

Versanddienstleister: Einrichtungsstatus
SystemVerbindungGelesenGeschriebenWas wir von Ihnen brauchenEinrichtung
Aras KargoWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtAuf Anfrage einrichtbar
Yurtiçi KargoWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtAuf Anfrage einrichtbar
MNG KargoWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtAuf Anfrage einrichtbar
PTT KargoWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtAuf Anfrage einrichtbar
Sürat KargoWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtAuf Anfrage einrichtbar
HepsijetWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtAuf Anfrage einrichtbar
Trendyol ExpressWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtAuf Anfrage einrichtbar
DHLWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtAuf Anfrage einrichtbar
FedExWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtAuf Anfrage einrichtbar
UPSWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtAuf Anfrage einrichtbar

Eine direkte Verbindung zum eigenen Dienst eines Versanddienstleisters wird auf Anfrage eingerichtet, und ihr Umfang wird bei der Einrichtung festgelegt. Deshalb steht in jeder Zeile hier „auf Anfrage einrichtbar“: Wir stellen keine Verbindung als fertig dar, die nicht gebaut wurde.

Social-Media- und Werbekanäle

Diese drei Systeme gehören zum Kanaluniversum, das auf dieser Website gezeigt wird.

Zum Lesen die Tabelle seitlich scrollen.

Social-Media- und Werbekanäle: Einrichtungsstatus
SystemVerbindungGelesenGeschriebenWas wir von Ihnen brauchenEinrichtung
WhatsApp BusinessWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtAuf Anfrage einrichtbar
MetaWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtAuf Anfrage einrichtbar
Google AdsWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtWird bei der Einrichtung festgelegtAuf Anfrage einrichtbar

Bei allen dreien wird die Verbindung auf Anfrage eingerichtet; Umfang und benötigte Angaben werden bei der Einrichtung festgelegt.

Vier Regeln, die für jede Verbindung gelten

Schattenmodus. Die Einrichtung liest zunächst nur. Daten werden von beiden Seiten geholt und verglichen, geschrieben wird nirgends. Sie sehen, was passieren würde, bevor Sie etwas übergeben.

Übergabe Kanal für Kanal. Schreibrechte werden nicht auf einmal freigeschaltet. Jeder Kanal geht einzeln live, und vor dem ersten Schreiben werden Zuordnung und Daten dieses Kanals geprüft.

Ein einziger Bestandspool. Der Bestand wird an einer Stelle verwaltet. Ein Verkauf auf einem Kanal senkt die Menge auf den anderen.

Die Nullstellungsbremse. Würden in einem Durchlauf ungewöhnlich viele Produktcodes auf null gesetzt, stoppt der Versand und eine Warnung geht heraus. Es gibt keinen stillen Durchlauf, der alle Kanäle leert.

Was wir für die Anbindung von Ihnen brauchen

Die Spalte „Was wir von Ihnen brauchen“ listet die Zugangsdaten auf, die Sie im eigenen Panel des jeweiligen Systems erzeugen. Sie gehören zu Ihrem Konto, und Bulutegra nutzt sie nur in Ihrem Namen.

Geben Sie Zugangsdaten nicht im Klartext in das Kontaktformular oder in eine E-Mail ein. Bei der Einrichtung vereinbaren wir, wie jede Angabe übergeben wird, und halten fest, wofür sie gebraucht wird.

Schlüssel liegen auf dem Server in Dateien, die nur der Benutzer lesen kann, unter dem der Dienst läuft, und sie werden im Panel nie in lesbarer Form angezeigt. Bei Etsy und eBay entsteht die Verbindung über eine Autorisierung mit einem Klick; ziehen Sie diese Autorisierung in Ihrem eigenen Konto zurück, endet die Verbindung in diesem Moment.

Was wir bei Speicherung, Sicherungen und Festplattenverschlüsselung tun — und was nicht — steht klar auf der Sicherheitsseite: Sicherheit, Zugriff und Datenschutz.

Ein System, das nicht auf der Liste steht

Fehlt ein Marktplatz, eine Plattform, ein ERP oder ein Versanddienstleister in diesen Tabellen, wird die Verbindung auf Anfrage eingerichtet.

Die erste Frage ist immer dieselbe: Veröffentlicht dieses System einen offiziellen Verkäuferdienst oder einen regelmäßigen XML/CSV-Feed, und ist er in Ihrem Konto verfügbar? Wenn ja, folgt die Verbindung derselben Reihenfolge: zuerst lesen, dann Schattenmodus, dann Schreiben Kanal für Kanal. Wenn nein, sagen wir vorab, was nicht geht.

Auf dieser Seite machen wir keine Zeitzusagen. Sobald der Umfang klar ist, teilen wir den Zeitplan schriftlich mit.

Für wen diese Seite ist

Ein Unternehmen, das auf Marktplätzen verkauft

Ihre Kanalkonten bleiben Ihre. Bulutegra verbindet sich über den eigenen offiziellen Dienst des Kanals damit, und die Schlüssel werden auf Ihren Namen erzeugt.

Ein ERP-Team

Bei Nebim V3 steht die Verbindung. Bei anderen ERP-Systemen hängt der Umfang von Edition und lizenzierten Modulen ab und wird bei der Einrichtung festgelegt.

Agenturen und Partner

Teams, die mehrere Kunden einrichten, folgen jedes Mal derselben Reihenfolge: lesen, Schattenmodus, dann Schreiben Kanal für Kanal.

Wie eine Verbindung entsteht
  1. Umfang: welche Systeme, welche Richtung (Lesen, Schreiben) und welche Daten.
  2. Zugangsdaten: Die Angaben, die Sie im eigenen Panel jedes Systems erzeugen, werden auf dem bei der Einrichtung vereinbarten Weg übergeben.
  3. Schattenmodus: Das System liest nur, zeigt, was es tun würde, und schreibt in keinen Kanal.
  4. Übergabe: Sobald Sie das Ergebnis gesehen haben, werden Schreibrechte Kanal für Kanal freigeschaltet.

Häufig gestellte Fragen

Hat Bulutegra eine eigene API?

Ja. Es gibt eine REST-API nur zum Lesen und Webhooks: Ihre eigene Software kann Bestellungen, Produkte, Bestände und den Kanalstatus lesen; neue Bestellungen, Statusänderungen und ERP-Übertragungen kommen per Webhook. Die API kann nichts ändern — das Schreiben in Ihre Kanäle und Ihr ERP übernimmt Bulutegra. Den Schlüssel erstellen Sie im Panel unter Einstellungen › Bulutegra API und Webhooks; die Dokumentation finden Sie unter developers.bulutegra.com.

Was bedeutet „Verbindung steht“ in der Tabelle?

Es bedeutet, dass der Code für die Verbindung zu diesem System geschrieben ist und läuft. Für die Freischaltung in Ihrem Konto braucht es weiterhin Zugangsdaten, Produktzuordnung und eine Phase im Schattenmodus. „Auf Anfrage einrichtbar“ heißt, dass die Verbindung für Ihren Fall gebaut würde; wir stellen sie nicht als bereits vorhanden dar.

Ist der API-Zugang kostenpflichtig?

In der Pakettabelle auf der Preisseite gibt es keine eigene Zeile „API“. Integrationsverbindungen werden nicht als separates Produkt verkauft; sie werden zusammen mit Ihrem Tarif und dem gewünschten Umfang bewertet. Verursacht die Einrichtung eines Systems, das nicht auf der Liste steht, Kosten, sehen Sie diese im schriftlichen Angebot einzeln aufgeführt. Die Pakete finden Sie hier: Preise.

Wie übergebe ich meine Zugangsdaten?

Nicht im Klartext in einem Formular oder einer E-Mail. Wie jede Angabe übergeben wird, vereinbaren wir bei der Einrichtung. Wie diese Angaben auf dem Server gespeichert werden — und was wir nicht tun, etwa Festplattenverschlüsselung — steht auf der Sicherheitsseite: Sicherheit.

Gibt es eine separate Testumgebung?

Eine separate Sandbox bieten wir nicht. Getestet wird über den Schattenmodus während der Einrichtung und, wo sinnvoll, ein Demokonto: Das System liest zunächst nur, Sie prüfen das Ergebnis, und der Schreibzugriff wird nach Ihrer Freigabe Kanal für Kanal geöffnet.

Sagen Sie uns, welches System angebunden werden soll und in welche Richtung die Daten fließen sollen, dann erarbeiten wir den Umfang gemeinsam. Nutzen Sie das Formular unten oder schreiben Sie an destek@bulutegra.com.

Integrationsanfrage

Mit dem Absenden stimmen Sie zu, dass Ihre Kontaktdaten zur Bearbeitung Ihrer Anfrage verarbeitet werden.