Hepsiburada Marketplace Sync - Automatische Bestands- und Preispflege per API oder CSV

Ihr Shop ist die maßgebliche Quelle. Der Marktplatz sollte ihm folgen.

Wer auf Hepsiburada verkauft, muss bei jedem Angebot drei Dinge aktuell halten: Preis, verfügbaren Bestand und Versandzeit. Von Hand bedeutet das, jeden Morgen erneut eine Tabelle zu exportieren; einen Tag vergessen und Sie verkaufen entweder Bestand, den Sie längst nicht mehr haben, oder stehen zu einem Preis da, den Sie nie anbieten wollten. Dieses Modul macht Ihren PrestaShop-Katalog zur einzigen Quelle und überträgt die Änderungen.

Zwei Wege der Übermittlung, ein gemeinsamer Zeilengenerator

• CSV-Export — laden Sie eine Datei mit exakt den Spalten in exakt der Reihenfolge herunter, die der Massen-Upload von Hepsiburada erwartet, und spielen Sie sie selbst im Händlerportal ein.
• Listing-API — hinterlegen Sie Ihre Zugangsdaten und das Modul spricht direkt mit Hepsiburada. Richten Sie einen Cron auf die angegebene Adresse und Bestands- sowie Preisänderungen gehen von allein raus.

Beide Wege laufen durch denselben Zeilengenerator, deshalb stimmen die Datei, die Sie herunterladen, und die Daten, die die API sendet, immer überein. Wenn Sie einmal prüfen möchten, was die API tut, laden Sie die Datei herunter.

Was gesendet wird — und was unberührt bleibt

Das Katalogteam von Hepsiburada verantwortet das Angebot selbst, deshalb rührt dieses Modul niemals Ihre Produktnamen, Beschreibungen, Bilder, Kategorien oder Attribute an. Es sendet die Felder, die dem Händler gehören: Nettopreis, verfügbaren Bestand, Versandzeit, Bezeichnungen für Versanddienstleister und Adresse, maximale Bestellmenge sowie Typ und Länge der Personalisierung. Nichts, was zu deren Katalog gehört, wird überschrieben.

Schutzgrenzen, weil ein falscher Preis teuer wird

• "Hold back" (Bestandspuffer) — ziehen Sie vor dem Senden von jeder Menge eine Reserve ab. Stellen Sie 2 ein, wird ein Produkt mit 5 Stück auf Lager als 3 angeboten, sodass eine Marktplatzbestellung nicht überverkaufen kann, was Ihr Shop gerade abgesetzt hat.
• Preismultiplikator — senden Sie den Shop-Preis unverändert oder schlagen Sie eine Marge auf, die die Marktplatzprovision deckt. Werte über 10 werden als Tippfehler abgelehnt statt veröffentlicht.
• "Never send a price below" (nie einen Preis darunter senden) — eine Sicherheitsuntergrenze. Zeilen darunter werden zurückgehalten und gemeldet, statt zum falschen Betrag online zu gehen.
• "Never offer more than" (nie mehr anbieten als) — deckeln Sie die auf dem Marktplatz angezeigte Menge, unabhängig davon, was im Lager liegt.

Produkte, die deaktiviert oder nicht bestellbar sind, werden mit Bestand null gesendet statt weggelassen, damit sie auf dem Marktplatz nicht mehr verkauft werden, anstatt dort still zu veralten.

Es sagt Ihnen, was nicht gesendet werden kann — und warum

Die Statusübersicht im Reiter Getting started (Erste Schritte) benennt die betroffenen Produkte, statt Sie raten zu lassen: keine SKU und kein Lagercode, ein Preis, der rechnerisch null ergibt, ein Preis unter Ihrer Untergrenze, ein fehlender Name in der Exportsprache. Doppelte SKUs werden vor dem Senden erkannt — Hepsiburada weist einen ganzen Stapel zurück, wenn eine zweimal vorkommt, deshalb erspart Ihnen die frühe Erkennung einen kompletten neuen Upload. Das Feld für den Versanddienstleister wird gegen die von Hepsiburada veröffentlichten Dienstleister geprüft und warnt bei einem unbekannten Namen, den deren Seite sonst stillschweigend ignoriert.

Geplante Synchronisation, die ehrlich Bericht erstattet

Der Reiter Send (Senden) zeigt eine mit Token geschützte Cron-Adresse. Richten Sie den Cron Ihres Hosters darauf — alle dreißig Minuten ist üblich — und standardmäßig wird nur das Geänderte seit dem letzten erfolgreichen Lauf gesendet; Produktspeicherungen und Bestandsbewegungen markieren Angebote automatisch als geändert. Ergänzen Sie &mode=full, um alles erneut zu senden, nachdem Hepsiburada einen Stapel abgelehnt oder verloren hat. Der Endpunkt antwortet mit JSON, sodass ein Überwachungswerkzeug einen echten Fehler von einem Lauf ohne Änderungen unterscheiden kann; gleichzeitige Läufe werden abgewiesen, damit sich ein langsamer Lauf nicht aufstaut, und ein Neuerzeugen der Adresse macht die alte sofort ungültig, falls die URL je nach außen gelangt.

Produkte verknüpfen, und Kombinationen

Jedes Hepsiburada-Angebot hat eine HepsiburadaSku. Fügen Sie sie im Reiter Hepsiburada auf der Produktseite ein oder nutzen Sie "Link products automatically" (Produkte automatisch verknüpfen), wenn Ihre PrestaShop-Referenzen bereits zu Ihren Hepsiburada-Händlerlagercodes passen. Kombinationen werden vollständig unterstützt — jede wird einzeln verknüpft und bepreist, denn Hepsiburada behandelt jede Variante als eigenes Angebot.

Was Version 2.0 behoben hat

Version 1.x bepreiste immer aus wholesale_price, das die meisten Shops leer lassen, sodass jeder exportierte Preis 0,00 betrug. Version 2.0 nutzt standardmäßig den Verkaufspreis, verweigert den Export eines Nullpreises grundsätzlich und warnt, wenn der Einkaufspreis als Quelle gewählt ist, obwohl der Katalog keine Einkaufspreise führt. Version 1.x schrieb die SKU außerdem bei jedem actionProductUpdate, sodass jeder andere Speicherweg — eine Bestandsänderung, der Webservice, ein anderes Modul — sie stillschweigend leerte; 2.0 schreibt nur, wenn das Produktformular die Felder tatsächlich mitgebracht hat. Verknüpfungen werden nun pro Shop gespeichert statt einer SKU pro Produkt für alle Shops, und da 1.x zwar API-Zugangsdaten speicherte, aber nie eine Anfrage sendete, bleibt die API nach dem Upgrade aus, bis Sie sie bewusst einschalten.

Kompatibilität

PrestaShop 1.7, 8 und 9, ohne Overrides, in acht Sprachen: Deutsch, Englisch, Französisch, Italienisch, Niederländisch, Polnisch, Spanisch und Türkisch. Multistore-fähig — Verknüpfungen werden pro Shop gespeichert, sodass dasselbe Produkt in verschiedenen Shops unterschiedliche Hepsiburada-SKUs tragen kann, und die Konfigurationsseite zeigt immer an, für welchen Shop sie gerade gilt. Beim Deinstallieren werden Tabellen und Einstellungen des Moduls entfernt; Ihre Hepsiburada-Angebote behalten die zuletzt empfangenen Werte und werden einfach nicht mehr aktualisiert.

Häufig gestellte Fragen

Brauche ich die API oder genügt eine Datei?

Beides geht. Laden Sie die CSV herunter und spielen Sie sie im Händlerportal ein, oder schalten Sie die API ein und lassen Sie einen Cron die Änderungen liefern. Beide erzeugen identische Daten.

Ändert es meine Produkttitel oder Bilder auf Hepsiburada?

Nein. Die verantwortet deren Katalogteam. Das Modul sendet nur Preis, Bestand, Versandzeit, Bezeichnungen für Versanddienstleister und Adresse, Höchstmenge und Personalisierungseinstellungen.

Wie verhindere ich Überverkäufe?

Legen Sie eine Rückhaltemenge fest. Jeder Bestandswert wird vor dem Senden um sie verringert, sodass der Marktplatz Ihre letzten Einheiten nie zu sehen bekommt.

Welche Zugangsdaten benötigt die API?

Die Zugangsdaten der Listing-API von Hepsiburada, die nicht Ihrem Händlerportal-Login entsprechen — fordern Sie sie bei Hepsiburada an. Ein 401 bedeutet, dass Benutzername oder Passwort falsch sind, 403 bedeutet, dass keine Berechtigung für die Listing-API vorliegt, und 404 bedeutet, dass die Händler-ID falsch ist. Eine Schaltfläche "Test connection" (Verbindung testen) zeigt deren genaue Meldung an.

Kommt es mit Kombinationen zurecht?

Ja. Jede Kombination wird einzeln verknüpft und bepreist, denn Hepsiburada behandelt jede Variante als eigenständiges Angebot.

Warum wurde mein ganzer Upload abgelehnt?

Fast immer wegen einer doppelten SKU — Hepsiburada weist den gesamten Stapel zurück, wenn eine zweimal vorkommt. Die Statusübersicht findet Dubletten vor dem Senden.

Meine 1.x-Preise wurden alle als null exportiert. Ist das behoben?

Ja. Das lag daran, dass 1.x aus dem Einkaufspreisfeld bepreiste, das die meisten Shops leer lassen. Version 2.0 nutzt standardmäßig den Verkaufspreis und verweigert den Export eines Nullpreises grundsätzlich.