FeatureTutti gli abb.

API e integrazioni

Con l’API REST colleghi scango.ch a gestionale merci, ERP, contabilità o negozio online. Un programma si autentica con una chiave API, recupera gli acquisti e gestisce prodotti, fornitori, categorie e negozi.

Perché conta

La tua cassa non diventa un silo di dati

  • Catalogo sempre aggiornato

    Riprendere i prodotti dal gestionale e tenere aggiornati i prezzi, invece di inserire tutto due volte.

  • Recuperare gli acquisti

    Ottenere le vendite di un periodo – per la contabilità o un tuo reporting.

  • Diritti per chiave

    Ogni integrazione riceve la propria chiave, solo lettura o anche scrittura. Una chiave eliminata non vale più da subito.

Come funziona

Collegato in quattro passi

L’API è un’interfaccia REST: richieste HTTPS in entrata, JSON in uscita.

  1. 1

    Creare una chiave

    In Impostazioni › Organizzazione › Chiavi API, con una descrizione e il tipo «Lettura» o «Scrittura».

  2. 2

    Inserirla nel programma

    Inviare la chiave a ogni richiesta nell’header Authorization come token Bearer. L’URL di base è https://dashboard.scango.ch/api/v1.

  3. 3

    Recuperare i dati

    Gli elenchi arrivano come data e meta, fino a 5000 voci per pagina, con paginazione a cursore. Gli importi sono in centesimi.

  4. 4

    Interrogare regolarmente

    L’API non segnala da sola i nuovi acquisti; non ci sono webhook. Il tuo programma interroga a intervalli.

Nella dashboard

Gestire le chiavi

Le immagini vengono direttamente dal Cloud Dashboard. Amministratori e proprietari creano e gestiscono le chiavi.

  1. 1

    Creare una chiave

    Una descrizione come «Contabilità» o «Negozio online» aiuta a fare ordine più tardi. «Lettura» permette solo di leggere, «Scrittura» anche di creare, modificare ed eliminare.

    app.scango.ch
    Finestra «Crea chiave API» con descrizione e tipo
  2. 2

    Panoramica delle chiavi

    L’elenco mostra descrizione, tipo e data di creazione. Con l’occhio rivedi una chiave, con la croce la elimini – le integrazioni che la usano smettono di funzionare.

    app.scango.ch
    Elenco delle chiavi API con descrizione, tipo e data di creazione
  3. Leggi la guida completa
Buono a sapersi

Cosa copre l’API

L’API è pensata per sviluppatrici e sviluppatori o per il tuo partner informatico. Il riferimento completo con tutti gli endpoint e i campi è su developers.scango.ch, dove si può anche scaricare la descrizione OpenAPI. Se usi il controllo dell’età Stellard Age, anche log identità e lista di blocco sono accessibili via API.

Risorse
Prodotti
leggere, creare, modificare, eliminare, caricare immagine
Acquisti
leggere per periodo
Fornitori, categorie, negozi
leggere, creare, modificare, eliminare
Log identità
leggere le scansioni, gestire la lista di blocco
Tecnica
Formato
REST, JSON via HTTPS
Autenticazione
chiave API come token Bearer
Dimensione pagina
predefinita 100, massimo 5000
Costi
Accesso API
in ogni abbonamento, da Basis CHF 99.–/mese
scango.ch

Altre funzioni

Tutti gli abb.

Collegamento IA (MCP)

Colleghi il suo assistente IA, ad esempio Claude, ChatGPT o Grok, in modo sicuro ai suoi dati scango.ch.

Tutti gli abb.

Gestione prodotti

Prezzi, barcode, IVA, deposito, età e visibilità – gestisci l’assortimento da solo.

Abb. Retail

Gestione multi-filiale

Un catalogo, più sedi – visibilità, scorte e vendite per filiale.

Domande frequenti

Quanto costa l’API?

Niente in più. L’accesso API è incluso in ogni abbonamento, già nel Basis a CHF 99.– al mese.

Dove trovo la documentazione tecnica?

Su developers.scango.ch, con tutti gli endpoint, parametri, campi ed esempi. La guida all’API ti fa partire con un primo esempio.

Posso modificare gli acquisti via API?

No. Gli acquisti si possono elencare per periodo e leggere singolarmente, ma non creare né modificare.

Ci sono webhook?

No. L’API non segnala da sola i nuovi acquisti. Interrogala a intervalli regolari.

Come proteggo la chiave?

Usala solo su un server, mai nel codice di un sito o di un’app. Crea una chiave per integrazione e scegli «Lettura» se non devi modificare dati.

Chi può creare le chiavi?

Amministratori e proprietari della tua organizzazione.

Tobias Kobelt

Ciao, sono Tobias.

Volentieri ti aiuto. Registrati gratuitamente per un primo assaggio – o richiedi un’offerta senza impegno. Sono qui per le tue domande.

Tobias Kobelt · scango.ch