Was bedeutet es, Salla oder Zid mit Ihren internen Systemen zu integrieren?

Ihren Salla- oder Zid-Shop per API mit Ihren internen Systemen zu verbinden bedeutet, dass der Shop automatisch Daten mit Ihren anderen Systemen austauscht – Lagerverwaltung, Buchhaltung, ERP, CRM und Versanddienstleister – ganz ohne manuelle Eingabe. Statt dass ein Mitarbeiter jede Bestellung aus dem Shop-Dashboard ins Buchhaltungssystem abtippt, gelangt die Bestellung im Moment ihres Eingangs ins richtige System, der Bestand wird in beide Richtungen aktualisiert, die Rechnung wird ausgestellt und die Sendung vorbereitet – alles in Sekunden und ohne Übertragungsfehler.

Dieser Artikel erklärt für Unternehmer, was die APIs von Salla und Zid bieten, welches die wichtigsten Integrationsszenarien sind und wie eine solide Integration aufgebaut wird, die dem täglichen Betrieb standhält.

Warum brauchen Sie diese Integration überhaupt?

Mit wachsendem Umsatz wird die manuelle Eingabe zum gefährlichsten Engpass: von Hand übertragene Bestellungen, die zu spät oder fehlerhaft ankommen, Bestände, die im Shop als verfügbar angezeigt werden, obwohl sie im Lager längst ausverkauft sind, und Umsatzzahlen, die am Monatsende zwischen Shop und Buchhaltung nicht übereinstimmen. All diese Probleme haben dieselbe Ursache: isolierte Systeme, die nicht miteinander kommunizieren. Die API-Integration verwandelt diese getrennten Inseln in ein einziges System, sodass doppelte Arbeit entfällt und die Zahlen automatisch abgeglichen werden.

  • Zeitersparnis: tägliche Stunden an Dateneingabe werden zu einer sofortigen Synchronisierung ohne manuelles Eingreifen.
  • Genauer Lagerbestand: ein einziger korrekter Bestand erscheint im Shop und im Lager – kein Verkauf ausverkaufter Artikel und kein Sperren verfügbarer Ware.
  • Saubere Buchhaltung: jede Bestellung kommt mit Betrag, Steuer und Rechnungsdaten fertig in der Buchhaltung an.
  • Besseres Kundenerlebnis: schnellere Bestätigungen und Versand-Updates, weil der Prozess durchgängig automatisiert ist.

Was bieten die APIs von Salla und Zid Entwicklern?

Sowohl Salla als auch Zid bieten moderne REST-APIs mit einer eigenen Plattform für Entwickler und Partner. Die wichtigsten Angebote:

  • REST-APIs: programmatischer Zugriff auf Produkte, Bestellungen, Kunden, Lagerbestände und Kategorien – lesend und schreibend.
  • OAuth-Authentifizierung: eine sichere Verbindung, die die App ohne Weitergabe eines Passworts autorisiert, mit festgelegten Berechtigungen (Scopes).
  • Webhooks: Echtzeit-Benachrichtigungen, die die Plattform an Ihr System sendet, wenn ein Ereignis eintritt – eine neue Bestellung, eine Statusänderung, eine Kundenregistrierung – statt dass Ihr System ständig beim Shop nachfragt.
  • App-Marktplatz: die Möglichkeit, Ihre App für andere Händler zu veröffentlichen, falls Sie Ihre Integration zu einem Produkt machen möchten.

Diese Werkzeuge reichen aus, um nahezu jedes Integrationsszenario umzusetzen – vorausgesetzt, es wird sorgfältig konzipiert.

Die praxisrelevantesten Integrationsszenarien

In der Praxis benötigen die meisten Händler eine oder mehrere dieser Integrationen:

  • Bestellungen mit Buchhaltung oder ERP synchronisieren: jede neue Bestellung erzeugt automatisch eine Buchung und eine Rechnung in Ihrem Finanzsystem.
  • Bidirektionale Bestandssynchronisierung: ein Verkauf im Shop verringert den Lagerbestand, und der Eingang neuer Ware aktualisiert die Verfügbarkeit im Shop sofort.
  • Produkte aus Ihrem System in den Shop übertragen: Produkte und Preise in einem zentralen System pflegen und dann automatisch auf Salla oder Zid veröffentlichen.
  • Kunden mit einem CRM synchronisieren: jeder neue Kunde landet in Ihrem Kundenbeziehungssystem, um Marketing und Nachverfolgung anzustoßen.
  • Versand und Logistik anbinden: das Versandetikett automatisch erstellen und die Sendungsnummer an den Kunden schicken.
  • E-Rechnung: für jede Transaktion eine Rechnung erzeugen, die den Anforderungen der Behörde für Zakat, Steuern und Zoll (ZATCA) entspricht.

Webhooks vs. Polling

Es gibt zwei Wege, zu erfahren, dass im Shop ein neues Ereignis eingetreten ist. Der erste ist Polling: Ihr System fragt den Shop alle paar Minuten: „Gibt es eine neue Bestellung?“ – einfach, aber langsam und ressourcenverschwendend. Der zweite und bessere sind Webhooks: Sie teilen der Plattform einmalig die Adresse Ihres Systems mit, und sie schickt Ihnen jedes Ereignis in dem Moment, in dem es eintritt. Webhooks sind schneller und schlanker, setzen aber voraus, dass Ihr System stets erreichbar ist, um die Benachrichtigungen zu empfangen, und einen Wiederholungsmechanismus hat, falls eine Zustellung vorübergehend fehlschlägt.

Wie baut man eine solide, langlebige Integration auf?

Eine erfolgreiche Integration ist nicht einfach ein API-Aufruf; sie ist eine sorgfältig konzipierte Middleware-Schicht. Das Wichtigste, was sie leisten muss:

  • Präzises Feld-Mapping: die Produkte und Codes des Shops ihren Gegenstücken in Ihrem internen System zuordnen, damit Daten nie durcheinandergeraten.
  • Idempotenz: sicherstellen, dass eine Bestellung niemals doppelt erfasst wird, wenn die Benachrichtigung mehr als einmal eintrifft.
  • Intelligente Wiederholungen: schlägt eine Verbindung vorübergehend fehl, versucht es das System automatisch erneut, statt das Ereignis zu verlieren.
  • Einhaltung von Rate Limits: Plattformen begrenzen die Anzahl der Anfragen pro Minute, und die Integration muss diese Grenzen respektieren, ohne auszufallen.
  • Protokollierung und Abgleich: ein Dashboard, das zeigt, was synchronisiert wurde und was fehlgeschlagen ist, mit einem täglichen Bericht, der sicherstellt, dass keine Bestellung unbemerkt verloren geht.

Wer diese Details vernachlässigt, macht den Unterschied zwischen einer Integration, die in der Demo funktioniert und nach einer Woche zusammenbricht, und einer, die jahrelang geräuschlos läuft.

Häufige Fehler, die Sie vermeiden sollten

Was Integrationsprojekte am häufigsten scheitern lässt: sich mit einer Synchronisierung in nur eine Richtung zufriedenzugeben und die Gegenrichtung zu vergessen, Fehlerfälle zu ignorieren, sodass Bestellungen verschwinden, ohne dass es jemand merkt, oder keine Testumgebung zu haben, sodass Änderungen in einem Live-Shop mit echten Bestellungen getestet werden. Die goldene Regel: Bauen Sie die Integration so, dass sie mit Fehlern genauso umgehen kann wie mit Erfolgen, und testen Sie sie in einer separaten Umgebung, bevor sie live geht.

Die Rolle von Origami

Wir bei Origami sind ein Technologieunternehmen, das zuverlässige Integrationen auf Basis von Salla und Zid entwickelt: Wir verbinden Ihren Shop mit Ihrer Buchhaltung, Ihrem ERP, CRM oder Ihren Versanddienstleistern und konzipieren die Middleware-Schicht mit Wiederholungen, Abgleich und vollständiger Protokollierung. Und falls Sie sich noch nicht zwischen einer fertigen Plattform und einem individuellen Shop entschieden haben, hilft Ihnen unser Artikel Individueller Shop vs. Salla/Zid bei der Entscheidung, bevor wir mit der Integration beginnen.

Eine gute Integration ist unsichtbar – sichtbar ist nur ihr Ergebnis: stimmige Zahlen, genaue Bestände und ein Team, das frei ist für das Wesentliche.

Quellen

  • Entwicklerplattform von Salla: salla.dev
  • Zid – Plattform für Onlineshops: zid.sa
  • Behörde für Zakat, Steuern und Zoll (ZATCA) – E-Rechnung: zatca.gov.sa