FeatureTous les abos

API & intégrations

L’API REST relie scango.ch à votre gestion des marchandises, ERP, comptabilité ou boutique en ligne. Un programme s’identifie avec une clé API, récupère les commandes et gère produits, fournisseurs, catégories et magasins.

Pourquoi c’est utile

Votre caisse ne devient pas un silo de données

  • Un catalogue à jour

    Reprendre les produits de votre gestion des marchandises et tenir les prix à jour, au lieu de tout saisir deux fois.

  • Récupérer les commandes

    Obtenir les ventes d’une période – pour la comptabilité ou votre propre reporting.

  • Des droits par clé

    Chaque intégration reçoit sa propre clé, en lecture seule ou aussi en écriture. Une clé supprimée est aussitôt invalide.

Comment ça marche

Connecté en quatre étapes

L’API est une interface REST : des requêtes HTTPS en entrée, du JSON en retour.

  1. 1

    Créer une clé

    Sous Paramètres › Organisation › Clés API, avec une description et le type «Lecture» ou «Écriture».

  2. 2

    L’enregistrer dans le programme

    Envoyer la clé à chaque requête dans l’en-tête Authorization comme jeton Bearer. L’URL de base est https://dashboard.scango.ch/api/v1.

  3. 3

    Récupérer les données

    Les listes arrivent sous forme de data et meta, jusqu’à 5000 entrées par page, avec pagination par curseur. Les montants sont en centimes.

  4. 4

    Interroger régulièrement

    L’API ne signale pas d’elle-même les nouvelles commandes ; il n’y a pas de webhooks. Votre programme interroge à intervalles réguliers.

Dans le tableau de bord

Gérer les clés

Ces images proviennent directement du Cloud Dashboard. Les admins et propriétaires créent et gèrent les clés.

  1. 1

    Créer une clé

    Une description comme «Comptabilité» ou «Boutique en ligne» aide à faire le tri plus tard. «Lecture» permet seulement de lire, «Écriture» aussi de créer, modifier et supprimer.

    app.scango.ch
    Dialogue «Créer une clé API» avec description et type
  2. 2

    Aperçu des clés

    La liste indique description, type et date de création. L’œil réaffiche une clé, la croix la supprime – les intégrations qui l’utilisent cessent alors de fonctionner.

    app.scango.ch
    Liste des clés API avec description, type et date de création
  3. Lire le guide complet
Bon à savoir

Ce que couvre l’API

L’API s’adresse aux développeuses et développeurs ou à votre partenaire informatique. La référence complète avec tous les endpoints et champs se trouve sur developers.scango.ch, où la description OpenAPI peut aussi être téléchargée. Si vous utilisez le contrôle de l’âge Stellard Age, les journaux d’identité et la liste de blocage sont également accessibles via l’API.

Ressources
Produits
lire, créer, modifier, supprimer, charger une image
Commandes
lire par période
Fournisseurs, catégories, magasins
lire, créer, modifier, supprimer
Journaux d’identité
lire les scans, gérer la liste de blocage
Technique
Format
REST, JSON via HTTPS
Authentification
clé API comme jeton Bearer
Taille de page
100 par défaut, 5000 au maximum
Coût
Accès API
dans chaque abo, dès Basis CHF 99.–/mois
scango.ch

Autres fonctionnalités

Tous les abos

Connexion IA (MCP)

Connectez votre assistant IA, par exemple Claude, ChatGPT ou Grok, en toute sécurité à vos données scango.ch.

Tous les abos

Gestion des produits

Prix, codes-barres, TVA, consigne, âge et visibilité – gérez l’assortiment vous-même.

Abo Retail

Gestion multi-magasins

Un catalogue, plusieurs sites – visibilité, stocks et ventes par magasin.

Questions fréquentes

Combien coûte l’API ?

Rien de plus. L’accès API est inclus dans chaque abonnement, dès l’abo Basis à CHF 99.– par mois.

Où trouver la documentation technique ?

Sur developers.scango.ch, avec tous les endpoints, paramètres, champs et exemples. Le guide de l’API vous lance avec un premier exemple.

Puis-je modifier des commandes via l’API ?

Non. Les commandes peuvent être listées par période et lues une à une, mais pas créées ni modifiées.

Y a-t-il des webhooks ?

Non. L’API ne signale pas les nouvelles commandes d’elle-même. Interrogez-la à intervalles réguliers.

Comment protéger la clé ?

Utilisez-la uniquement sur un serveur, jamais dans le code d’un site web ou d’une app. Créez une clé par intégration et choisissez «Lecture» si aucune donnée ne doit être modifiée.

Qui peut créer des clés ?

Les admins et propriétaires de votre organisation.

Tobias Kobelt

Bonjour, je suis Tobias.

Avec plaisir. Inscrivez-vous gratuitement pour un premier aperçu – ou demandez une offre sans engagement. Je suis là pour vos questions.

Tobias Kobelt · scango.ch