Warenwirtschaft mit API

eBay und WooCommerce verbindest du in Storest mit wenigen Klicks. Aber vielleicht läuft dein Shop auf einem anderen System, du hast eine eigene Kasse, oder du willst deine Zahlen in einer eigenen Auswertung sehen. Dafür gibt es die Storest-API: Dein Bestand liegt mit Einkaufspreis in Storest, und jedes Programm, das HTTP spricht, kann ihn lesen, reservieren und verkaufen.

1. Wofür Händler die API nutzen

• Eigener Shop auf einem anderen System: Bestand anzeigen, bei der Bestellung reservieren, nach der Zahlung verkaufen
• Kasse oder Ankaufs-Terminal: Artikel mit Einkaufspreis anlegen und Bilder hochladen, direkt aus deinem Programm
• Eigene Auswertungen: Artikel, Mengen und Verkäufe abrufen oder als CSV- und Excel-Datei exportieren
• Automatisierungen: Webhooks melden jede Änderung sofort, etwa an ein Tool wie n8n oder Make

2. Was die API kann

Alle Endpunkte mit Beispielen zum Ausprobieren stehen in der API-Dokumentation.

3. Eine Bestellung aus deinem Shop, Schritt für Schritt

Der typische Ablauf für einen eigenen Shop: Bei der Bestellung reservierst du die Ware, bei der Zahlung wird daraus ein Verkauf. Bleibt die Zahlung aus, hebst du die Reservierung auf oder lässt sie ablaufen.

# 1. Bestand für die Bestellung festhalten
POST /v1/reservations

# 2. Bezahlt: Verkauf aus der Reservierung anlegen
POST /v1/sales   { "reservationId": … }

# oder: nicht bezahlt, Reservierung aufheben
DELETE /v1/reservations/{id}

• Alles oder nichts: Reicht der Bestand für eine Position nicht, wird nichts reserviert — kein halber Auftrag
• Älteste Ware zuerst: Reservierung und Verkauf nehmen den ältesten passenden Bestand
• Sofort auf allen Kanälen: Reservierte Ware ist weder in Storest noch auf eBay oder in WooCommerce verkaufbar
• Im Blick: Reservierungen aus der API siehst du in Storest im Lager und unter Einstellungen → Betrieb → API

4. Verkäufe mit §25a und Rechnung

Ein Verkauf über die API ist ein Verkauf wie in Storest: nächste Verkauf-Nr., Abgang aus dem Bestand, die Steuerart aus der Bestandszeile und die Rechnung automatisch, wenn du das in den Einstellungen aktiviert hast. Differenzbesteuerte Ware wird nach §25a auf die Marge versteuert, regelbesteuerte Ware normal. Bundles verkaufst du wie Artikel, Storest teilt den Preis auf die Teile auf (mehr dazu). Die Grundlagen erklärt der Ratgeber Differenzbesteuerung.

5. Webhooks und Ereignisse

Storest hält fest, was sich ändert — neue, geänderte und gelöschte Artikel, Bestandsänderungen, Reservierungen und Verkäufe. Du entscheidest, wie du davon erfährst:

• Webhooks stellen jedes Ereignis sofort an deine Adresse zu, signiert, damit du prüfen kannst, dass es von Storest kommt
• Automatische Wiederholung: Ist dein Server nicht erreichbar, versucht Storest es erneut — nach 1 Minute, dann gestaffelt bis 24 Stunden
• Nachholen nach einem Ausfall: Über die Ereignisliste holst du genau das nach, was du verpasst hast, auch ganz ohne Webhooks

6. Sicher ausprobieren, sicher betreiben

• Test-Schlüssel arbeiten mit einem eigenen Test-Betrieb voller Beispieldaten — deine echten Artikel, Nummernkreise und Belege bleiben unberührt
• Nur lesen oder lesen & schreiben: Für eine Auswertung reicht ein Schlüssel, der nichts ändern kann
• Keine Doppelbuchungen: Mit einem Idempotency-Key kannst du eine Anfrage nach einem Verbindungsabbruch gefahrlos wiederholen
• Nur der Inhaber des Kontos legt Schlüssel an und widerruft sie unter Einstellungen → Betrieb → API
• Stabile Version: Innerhalb von v1 kommen nur neue Felder und Endpunkte dazu, bestehende werden nicht umbenannt oder entfernt

Was es kostet

• Test-Schlüssel: kostenlos, für alle Konten
• Live-Schlüssel: in Storest Premium für 19,90 € pro Monat enthalten, ohne Aufpreis
• eBay oder WooCommerce dazu: je 9,90 € pro Monat, jeder weitere Shop 4,90 €

Alle Preise zzgl. MwSt., monatlich kündbar.

Häufige Fragen