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.
| System | Verbindung | Gelesen | Geschrieben | Was wir von Ihnen brauchen | Einrichtung |
|---|---|---|---|---|---|
| Trendyol | REST · apigw.trendyol.com | Bestellungen, Produkte | Bestand, Preise, Listing, Inhalte | API-Schlüssel, API-Geheimnis, Verkäufernummer | Verbindung steht |
| Hepsiburada | REST · oms-external.hepsiburada.com · listing-external.hepsiburada.com | Bestellungen, Produkte | Bestand, Preise, Listing, Inhalte | Benutzername, Händlernummer, geheimer Schlüssel | Verbindung steht |
| n11 | SOAP + REST · api.n11.com | Bestellungen, Produkte | Bestand, Preise, Listing, Inhalte | Anwendungsschlüssel und Anwendungsgeheimnis | Verbindung steht |
| Pazarama | OAuth2 + REST · isortagimgiris.pazarama.com · isortagimapi.pazarama.com | Bestellungen, Produkte | Bestand, Preise, Listing, Inhalte | Client-ID und Client-Geheimnis | Verbindung steht |
| ePttAVM | SOAP (WS-Security) · ws.pttavm.com | Bestellungen, Produkte | Bestand, Preise, Listing, Inhalte | Benutzername und Passwort | Verbindung steht |
| FLO | REST · api.flo.com.tr | Bestellungen | Bestand, Preise | API-Kennung | Verbindung steht |
| Çiçeksepeti | REST · apis.ciceksepeti.com | Bestellungen, Produkte | Bestand, Preise, Listing, Inhalte | API-Schlüssel | Verbindung steht |
| idefix | REST · merchantapi.idefix.com | Bestellungen, Produkte | Bestand, Preise, Listing | Verkäufernummer und API-Schlüssel | Verbindung steht |
| Modanisa | REST | Bestellungen | Bestand, Preise | API-Benutzername und Passwort | Verbindung steht |
| Amazon | Amazon Selling Partner API (SP-API) | Bestellungen, Produkte | Bestand, Preise, Inhalte | SP-API-Anwendungsautorisierung und Verkäufer-ID | Verbindung steht |
| eBay | REST | Bestellungen, Produkte | Bestand, Preise, Listing, Inhalte | OAuth-Anwendungsautorisierung | Verbindung steht |
| Walmart (US) | OAuth2 + REST · Walmart Marketplace API v3 | Bestellungen, Produkte | Bestand, Preise, Listing, Inhalte | Client-ID und Client-Geheimnis | Verbindung steht |
| Etsy | OAuth2 + REST · Etsy Open API v3 | Bestellungen, Produkte | Bestand, Preise, Listing, Inhalte | Anwendungsschlüssel und Shop-Autorisierung | Verbindung steht |
| Ozon | REST · api-seller.ozon.ru | Bestellungen, Produkte | Bestand, Preise, Listing, Inhalte | Client-Id · Api-Key | Verbindung steht |
| Temu | REST · Temu Open API | Bestellungen, Produkte | Bestand, Preise, Listing | App-Schlüssel, App-Secret und Zugriffstoken | Verbindung steht |
| SHEIN | REST · SHEIN Open Platform API | Einkaufsbestellungen, Produkte | Bestand | Shop-Autorisierung über das Haupt-Verkäuferkonto | Verbindung steht |
| Jumia | REST | Bestellungen | Wird bei der Einrichtung festgelegt | Verkäufer-API-Kennung | Verbindung steht |
| noon | REST · noon Partner API (JWT) | Produkte | Listing | Dienstkonto-Schlüssel | Verbindung steht |
| Namshi | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Auf Anfrage einrichtbar |
| Allegro | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Auf Anfrage einrichtbar |
| Wildberries | REST | Bestellungen | Wird bei der Einrichtung festgelegt | API-Schlüssel | Verbindung steht |
| Takealot | REST · seller-api.takealot.com | Bestellungen | Wird bei der Einrichtung festgelegt | API-Schlüssel | Verbindung steht |
| Ananas | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Auf Anfrage einrichtbar |
| JustYol | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Auf 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.
| System | Verbindung | Gelesen | Geschrieben | Was wir von Ihnen brauchen | Einrichtung |
|---|---|---|---|---|---|
| ikas | GraphQL · api.myikas.com · adminapi.myikas.com | Produkte, Varianten, Bestand, Preise | Wird bei der Einrichtung festgelegt | Admin-API-Schlüssel | Verbindung steht |
| Shopify | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Auf Anfrage einrichtbar |
| WooCommerce | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Auf Anfrage einrichtbar |
| Ticimax | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Auf Anfrage einrichtbar |
| IdeaSoft | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Auf Anfrage einrichtbar |
| T-Soft | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Auf 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.
| System | Verbindung | Gelesen | Geschrieben | Was wir von Ihnen brauchen | Einrichtung |
|---|---|---|---|---|---|
| Nebim V3 | Nebim V3 Integrator | Bestellungen, Kunden, Bestand (nur lesende Prozeduren) | Getrennt und überwacht | Dienstadresse, Dienstbenutzer und Passwort | Verbindung steht |
| Logo | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Auf Anfrage einrichtbar |
| Mikro | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Auf Anfrage einrichtbar |
| SAP | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Auf 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.
| System | Verbindung | Gelesen | Geschrieben | Was wir von Ihnen brauchen | Einrichtung |
|---|---|---|---|---|---|
| Lieferanten-XML-Feed | XML | Produktcode, Barcode, Name, Preis, Bestand, Bild | Es wird nichts geschrieben | Feed-Adresse und Spaltenaufbau | Verbindung 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.
| System | Verbindung | Gelesen | Geschrieben | Was wir von Ihnen brauchen | Einrichtung |
|---|---|---|---|---|---|
| Aras Kargo | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Auf Anfrage einrichtbar |
| Yurtiçi Kargo | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Auf Anfrage einrichtbar |
| MNG Kargo | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Auf Anfrage einrichtbar |
| PTT Kargo | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Auf Anfrage einrichtbar |
| Sürat Kargo | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Auf Anfrage einrichtbar |
| Hepsijet | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Auf Anfrage einrichtbar |
| Trendyol Express | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Auf Anfrage einrichtbar |
| DHL | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Auf Anfrage einrichtbar |
| FedEx | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Auf Anfrage einrichtbar |
| UPS | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Auf 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.
| System | Verbindung | Gelesen | Geschrieben | Was wir von Ihnen brauchen | Einrichtung |
|---|---|---|---|---|---|
| WhatsApp Business | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Auf Anfrage einrichtbar |
| Meta | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Auf Anfrage einrichtbar |
| Google Ads | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Wird bei der Einrichtung festgelegt | Auf 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.
- Umfang: welche Systeme, welche Richtung (Lesen, Schreiben) und welche Daten.
- Zugangsdaten: Die Angaben, die Sie im eigenen Panel jedes Systems erzeugen, werden auf dem bei der Einrichtung vereinbarten Weg übergeben.
- Schattenmodus: Das System liest nur, zeigt, was es tun würde, und schreibt in keinen Kanal.
- Ü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.