📡 Willkommen zur HEGA API
Diese REST API ermöglicht die vollständige Integration von Dropshipping-Prozessen in Ihre E-Commerce-Plattform. Von der Artikelverwaltung über Bestellabwicklung bis hin zu Lieferscheinen und Rechnungen - alle Funktionen sind über sichere JWT-authentifizierte Endpunkte verfügbar.
✨ Hauptfunktionen
Sie übergeben eine Bestellung als JSON — mit der Adresse Ihres Endkunden oder wahlweise an die Adresse, die zu Ihrer Kundennummer hinterlegt ist. HEGA kommissioniert, verpackt und versendet; zurück kommen Lieferschein und Sendungsnummer.
Führende Referenz bleibt dabei Ihre eigene Bestellnummer — über sie fragen Sie später jederzeit den Stand ab. Geht dieselbe Bestellnummer innerhalb von 24 Stunden erneut ein, erkennen wir das als Doublette und weisen sie ab, damit nichts doppelt herausgeht.
Über Ihre eigene Bestellnummer fragen Sie den aktuellen Stand ab: Bearbeitungsstatus, Lieferscheinnummer und die Sendungsnummer des Versenders. Bei einer Teillieferung erhalten Sie mehrere Einträge — einen je Teilsendung.
Die Schnittstelle arbeitet nach dem Abruf-Prinzip: Sie fragen ab, wenn Sie etwas brauchen. Für die Sendungsverfolgung gegenüber Ihrem Endkunden genügt ein Abruf pro Tag. Automatische Benachrichtigungen sind in Planung, aber noch nicht verfügbar.
Sie melden sich mit Benutzerkennung, Kennwort und Kundennummer an und erhalten ein Zugangs-Token, das 30 Minuten gilt, sowie ein Token zum Erneuern.
Häufigste Stolperfalle bei der Erstanbindung: Der Ablaufwert in der Anmelde-Antwort gehört zum Erneuerungs-Token, nicht zum Zugangs-Token. Wer sich danach richtet, arbeitet eine halbe Stunde lang mit einem bereits abgelaufenen Token. Unsere Referenzclients erledigen den gesamten Ablauf für Sie.
JSON über HTTPS, vollständig als OpenAPI beschrieben. Sie können sich daraus einen Client erzeugen lassen oder mit der Postman-Sammlung sofort loslegen — Umgebungsdateien für Test und Live liegen bereit.
Ein Anfragelimit schützt die Schnittstelle vor Überlast. Wird es erreicht, antworten wir mit einem Hinweis samt Wartezeit; kurz warten und erneut senden genügt. Die Referenzclients tun das von sich aus.
Lieferscheine und Rechnungen rufen Sie direkt als PDF ab — ohne Umweg über E-Mail oder FTP. Bereitgestellt werden die Belege der letzten zwölf Monate.
Eine Besonderheit sollten Sie kennen: Diese beiden Abrufe sind die einzigen, die die Versionsnummer im Pfad tragen. Alle übrigen laufen ohne. Wer das übersieht, bekommt eine Fehlermeldung „nicht gefunden", obwohl der Beleg existiert.
Sortiment, Preise, Bestände und Verpackungseinheiten sind jederzeit abrufbar — komplett oder nur die Änderungen seit einem Stichtag. Nur Artikel, die in diesen Daten enthalten und aktiv sind, können bestellt werden; ein täglicher Abgleich hält Ihr System sauber.
Wichtig für die Mengenrechnung: Eine Verpackungseinheit wird nicht aufgetrennt, geliefert werden immer ganze Gebinde. Sie rechnen entweder selbst zwischen Stück und Verpackungseinheit um oder übergeben die Menge in Stück und überlassen die Umrechnung uns. Große Sortimente holen Sie seitenweise ab.
Für PHP, Python und Node.js/TypeScript liegen lauffähige Clients bereit. Zugangsdaten eintragen, starten — mehr braucht es nicht. Sie kommen ohne Fremdbibliotheken aus und laufen deshalb auch in abgeschotteten Umgebungen sofort.
Sie lösen genau die Punkte, an denen Erstanbindungen erfahrungsgemäß hängen bleiben: rechtzeitige Token-Erneuerung, saubere Auswertung beider Fehlerformate, keine Doppelbestellung nach einem Verbindungsabbruch und das korrekte Durchblättern großer Artikellisten. Sie dürfen die Dateien frei anpassen — sie sind als Startpunkt gedacht, nicht als fertige Integration.
Vor dem eigentlichen Anlegen können Sie eine Bestellung prüfen lassen: Adresse, Artikel und Mengen werden genauso geprüft wie im Ernstfall — angelegt wird dabei nichts.
Der Vorteil liegt im Detail: Sie bekommen alle Probleme auf einmal gemeldet statt eines nach dem anderen. Und die Prüfung funktioniert bereits, bevor die Bestellfunktion für Ihr Konto endgültig freigeschaltet ist — ideal, um Ihre Feldzuordnung früh zu testen.
Unter test.api.hega.net steht dieselbe Schnittstelle als Testumgebung bereit: gleiche Endpunkte, gleiche Datenformate, lediglich eine andere Basis-Adresse. Nach der Abnahme stellen Sie einfach um.
Kennzeichnen Sie Testbestellungen mit einem erkennbaren Präfix in Ihrer Bestellnummer. Wenn Ihre Anbindung steht, gehen wir gemeinsam eine kurze Abnahme-Checkliste durch — erfahrungsgemäß ist die Umrechnung der Verpackungseinheiten dabei der Punkt, der am häufigsten auffällt.