FeatureAlle Abos

API & Integrationen

Über die REST-API verbindest du scango.ch mit Warenwirtschaft, ERP, Buchhaltung oder Webshop. Ein Programm meldet sich mit einem API-Schlüssel an, holt Einkäufe ab und pflegt Produkte, Lieferanten, Kategorien und Filialen.

Warum es zählt

Deine Kasse bleibt kein Datensilo

  • Katalog aktuell halten

    Produkte aus der Warenwirtschaft übernehmen und Preise aktuell halten, statt alles doppelt zu erfassen.

  • Einkäufe abholen

    Verkäufe für einen Zeitraum abrufen – für die Buchhaltung oder ein eigenes Reporting.

  • Rechte pro Schlüssel

    Jede Integration erhält einen eigenen Schlüssel, nur lesend oder auch schreibend. Ein gelöschter Schlüssel ist sofort ungültig.

So funktioniert’s

In vier Schritten angebunden

Die API ist eine REST-Schnittstelle: HTTPS-Anfragen hin, JSON zurück.

  1. 1

    Schlüssel erstellen

    Unter Einstellungen › Organisation › API-Schlüssel mit einer Beschreibung und dem Typ «Lesen» oder «Schreiben».

  2. 2

    Im Programm hinterlegen

    Den Schlüssel bei jeder Anfrage im Header Authorization als Bearer-Token mitsenden. Die Basis-URL ist https://dashboard.scango.ch/api/v1.

  3. 3

    Daten abrufen

    Listen kommen als data und meta, mit bis zu 5000 Einträgen pro Seite und Blättern per Cursor. Beträge sind in Rappen.

  4. 4

    Regelmässig abfragen

    Die API meldet neue Einkäufe nicht von sich aus; es gibt keine Webhooks. Dein Programm fragt in Abständen nach.

Im Dashboard

Schlüssel verwalten

Die Bilder stammen direkt aus dem Cloud Dashboard. Admins und Eigentümer erstellen und verwalten die Schlüssel.

  1. 1

    Schlüssel erstellen

    Eine Beschreibung wie «Buchhaltung» oder «Webshop» hilft später beim Aufräumen. «Lesen» erlaubt nur das Abrufen, «Schreiben» auch Anlegen, Ändern und Löschen.

    app.scango.ch
    Dialog «API-Schlüssel erstellen» mit Beschreibung und Typ
  2. 2

    Übersicht der Schlüssel

    Die Liste zeigt Beschreibung, Typ und Erstelldatum. Mit dem Auge zeigst du einen Schlüssel erneut an, mit dem Kreuz löschst du ihn – Integrationen damit funktionieren danach nicht mehr.

    app.scango.ch
    Liste der API-Schlüssel mit Beschreibung, Typ und Erstelldatum
  3. Ganze Anleitung lesen
Gut zu wissen

Was die API abdeckt

Die API richtet sich an Entwicklerinnen und Entwickler oder an deinen IT-Partner. Die vollständige Referenz mit allen Endpunkten und Feldern steht auf developers.scango.ch, die OpenAPI-Beschreibung gibt es dort zum Download. Nutzt du die Alterskontrolle Stellard Age, lassen sich auch Ausweis-Logs und Sperrliste über die API abrufen und verwalten.

Ressourcen
Produkte
lesen, anlegen, ändern, löschen, Bild hochladen
Einkäufe
pro Zeitraum lesen
Lieferanten, Kategorien, Filialen
lesen, anlegen, ändern, löschen
Ausweis-Logs
Scans lesen, Sperrliste verwalten
Technik
Format
REST, JSON über HTTPS
Anmeldung
API-Schlüssel als Bearer-Token
Seitengrösse
Standard 100, höchstens 5000
Kosten
API-Zugang
in jedem Abo, ab Basis CHF 99.–/Monat
scango.ch

Weitere Funktionen

Alle Abos

KI-Anbindung (MCP)

Verbinde deinen KI-Assistenten, etwa Claude, ChatGPT oder Grok, sicher mit deinen scango.ch-Daten.

Alle Abos

Produkteverwaltung

Preise, Barcodes, MwSt., Depot, Alter und Sichtbarkeit – Sortiment selbst pflegen.

Retail-Abo

Filialmanagement

Ein Katalog, mehrere Standorte – Sichtbarkeit, Bestände und Umsätze pro Filiale.

Häufige Fragen

Was kostet die API?

Nichts extra. Der API-Zugang ist in jedem Abo enthalten, schon im Basis-Abo für CHF 99.– pro Monat.

Wo finde ich die technische Dokumentation?

Auf developers.scango.ch, mit allen Endpunkten, Parametern, Feldern und Beispielen. Die Anleitung zur API führt mit einem ersten Beispiel ein.

Kann ich Einkäufe über die API ändern?

Nein. Einkäufe lassen sich für einen Zeitraum auflisten und einzeln abrufen, aber nicht anlegen oder ändern.

Gibt es Webhooks?

Nein. Die API meldet neue Einkäufe nicht von sich aus. Frag sie in regelmässigen Abständen ab.

Wie schütze ich den Schlüssel?

Verwende ihn nur auf einem Server, nie im Code einer Webseite oder App. Erstell pro Integration einen eigenen Schlüssel und wähl «Lesen», wenn keine Daten geändert werden müssen.

Wer darf Schlüssel erstellen?

Admins und Eigentümer deiner Organisation.

Tobias Kobelt

Hallo, ich bin Tobias.

Gerne helfe ich dir weiter. Registriere dich kostenlos für einen ersten Eindruck – oder fordere ein unverbindliches Angebot an. Bei Fragen bin ich für dich da.

Tobias Kobelt · scango.ch