Collegare bexio ai vostri strumenti, ciò che la sua interfaccia documenta davvero

L'interfaccia REST 2.0 di bexio, letta prima di essere collegata

L'interfaccia si chiama da una radice unica, https://api.bexio.com/2.0/, e scambia JSON. L'autenticazione segue OAuth 2.0 con OpenID Connect, sul dominio di autorizzazione https://auth.bexio.com/realms/bexio, in flusso Authorization Code poi Refresh Token quando un'applicazione agisce a nome di un utente. Per una passerella che gira sola su un server, la documentazione del fornitore, consultata il 23 agosto 2026, descrive anche token di accesso personali. Le due vie non aprono lo stesso cammino, e la scelta si fa prima della prima riga di codice.

Questa scelta ha conseguenze concrete. Un token personale è collegato a un utente del conto bexio e conviene a un collegamento da server a server che riguarda una sola impresa. Il flusso Authorization Code conviene a un'applicazione chiamata a servire più conti bexio, ciascuno dando il suo accordo dal proprio lato. La documentazione pubblica descrive entrambi, così come la meccanica di rinnovo dei token, il che permette di stimare il lavoro prima di impegnarsi.

Dettaglio che ha la sua importanza nel tempo, il numero di versione figura nella radice stessa dell'interfaccia. Una passerella è dunque scritta contro una versione nominata, e non contro un indirizzo anonimo che si muoverebbe senza preavviso. È il genere di punto che si annota al momento della progettazione e che si rilegge tre anni dopo, quando nessuno nell'impresa ricorda chi ha costruito cosa.

Le portate descrivono, oggetto per oggetto, ciò che la passerella ha il diritto di vedere

bexio suddivide i diritti di un'applicazione in portate granulari, una per oggetto e per livello di azione. La documentazione nomina per esempio contact_show per la lettura dei contatti, kb_invoice_edit per la scrittura sulle fatture, project_show per i progetti. Una passerella ben concepita chiede solo ciò di cui ha bisogno, e questa richiesta si rilegge più tardi, in chiaro, il giorno in cui si pone una domanda su ciò che un automa ha potuto modificare nel dossier.

È anche il primo arbitrato di un progetto di integrazione. Un collegamento in sola lettura verso un cruscotto non richiede le stesse portate di un automa che crea fatture da un negozio online. Allargare il perimetro più tardi tocca l'autorizzazione stessa, dunque la convalida da parte della persona che detiene il conto. Tanto vale porre la lista fin dall'inquadramento, con la ragion d'essere di ogni riga.

Cinquecento elementi per richiesta, e una limitazione di flusso da misurare

La documentazione annuncia una paginazione limitata a 500 elementi per richiesta e una limitazione di flusso applicata alle chiamate. La prima cifra dimensiona ogni ripresa di dati. Una base di più migliaia di contatti, di articoli o di fatture si rilegge a fette, con un cursore tenuto dal lato dell'integratore, e questa suddivisione si ritrova in ogni risincronizzazione successiva, non solo il giorno dell'avvio.

La seconda cifra non si legge da nessuna parte sotto forma di soglia nelle pagine consultate il 23 agosto 2026. Si constata in condizioni reali, sul conto interessato, osservando il comportamento delle chiamate quando la cadenza sale. Un cantiere serio comincia dunque da una misura piuttosto che da un'ipotesi, e la cadenza scelta si scrive nel collaudo, con la condotta da tenere quando l'interfaccia rifiuta una chiamata.

Senza webhook documentato, la freschezza dei dati diventa una regolazione

La documentazione pubblica letta il 23 agosto 2026 non comporta alcuna sezione dedicata ai webhook né a un meccanismo di eventi. Ogni sincronizzazione con un altro strumento si costruisce dunque in interrogazione periodica. Il punto sensibile non è la ricchezza dell'interfaccia, è la cadenza alla quale si decide di interrogarla.

Questo vincolo si tratta. Si tiene dal lato dell'integratore la traccia di ciò che è già stato visto, si rigiocano le chiamate senza creare doppioni quando un'esecuzione si interrompe a metà percorso, e si sceglie una frequenza diversa secondo gli oggetti. Un catalogo di articoli non si muove allo stesso ritmo di un giornale di fatture. La progettazione di questa meccanica rappresenta una parte reale del lavoro, e merita di essere descritta nero su bianco prima dell'ordine.

C'è una conseguenza visibile per gli utenti. Una fattura creata nel negozio non appare in bexio al secondo, appare al ciclo successivo. Questo ritardo si sceglie, si documenta e si mostra alle persone interessate, invece di essere scoperto un lunedì mattina dal contabile che cerca una pezza. È una decisione di gestione tanto quanto un parametro tecnico.

Non tutto passa dall'interfaccia, e certi flussi hanno il proprio canale

Per la ripresa iniziale, bexio documenta importazioni tramite file Excel o CSV per i contatti, i prodotti e il piano contabile, descritte negli articoli di aiuto 000001781 e 000001598. Un limite di 15'000 righe è riportato per l'importazione di prodotti. Questo canale resta spesso il più corto per caricare un esistente, prendendo poi l'interfaccia il testimone per la vita corrente dei dati.

Sul versante banca, la ripresa dei dati di conti e di transazioni passa da bLink, la piattaforma di SIX. I pagamenti da bexio rientrano in bexio Pay, fatturato CHF 14.00 al mese e incluso nel forfait Ultimate. I salari escono tramite Swissdec verso le assicurazioni e le autorità, figurando il prodotto bexio Lohnbuchhaltung al registro ufficiale in ELM 5.0, 5.1 e 5.3 sotto il certificato n. 1142.24. La QR-fattura, invece, è generata nativamente.

Due flussi meritano una verifica a monte. L'invio di fatture nell'e-banking del destinatario tramite eBill passa da un'applicazione terza del Marketplace, eBill di iomarket AG, fatturata in aggiunta. E bexio non figura nella lista OpenPeppol dei Certified Service Providers, aggiornata il 21 agosto 2026. Un'impresa che deve fatturare a un committente che esige Peppol guarda altrove per questo canale preciso, e lo sa prima di firmare.

Il Marketplace copre un caso noto, una passerella copre il vostro

Il Marketplace di bexio annuncia più di cento applicazioni, dal commercio online alla gestione documentale. Quando un'applicazione pubblicata corrisponde esattamente al bisogno, è il cammino più corto, e si prova prima di ogni sviluppo. Il su misura comincia altrove, là dove occorre appaiare identificativi clienti tra due sistemi, applicare una regola propria della casa, o collegare uno strumento di mestiere interno che nessun altro usa.

Una passerella ha bisogno di un accesso al conto, e questo accesso si conta. I forfait pubblicati al 23 agosto 2026 includono un numero di utenti fisso, e il prezzo di un accesso supplementare è pubblicato per una parte di essi. L'arbitrato si pone al momento di decidere se l'automa lavora sotto un conto tecnico dedicato, il che rende le tracce leggibili, o sotto il conto di una persona, il che le mescola con il suo lavoro quotidiano.

Tra le due opzioni, il criterio utile è la durata di vita. Un'applicazione del Marketplace è un contratto con un terzo, con il proprio ritmo di aggiornamenti e il proprio supporto. Una passerella scritta per l'impresa segue le portate e la cadenza che le sono state fissate, e il suo codice appartiene al dossier. Entrambe si giustificano, e la scelta si pone flusso per flusso, non una volta per tutte.

L'uscita dei dati si prepara il giorno in cui si entra

L'aiuto del fornitore documenta esportazioni in PDF e in Excel così come una funzione di salvataggio. Nessuna esportazione completa della base sotto forma di file unico è documentata nelle pagine consultate il 23 agosto 2026. In questo contesto, l'interfaccia stessa diventa un mezzo di rilettura, e le portate accordate alla passerella determinano ciò che può effettivamente riprendere. La domanda si pone all'avvio di un progetto, non il giorno in cui si desidera partire.

Un ultimo riferimento utile. Il programma partner ufficiale di bexio si rivolge alle fiduciarie, annunciando l'annuario pubblico più di 1'000 società fiduciarie e statuti che vanno da Argento a Platino. Per la parte tecnica, l'impresa si appoggia sulla documentazione pubblica e su chi la sa leggere. Non vendiamo alcuna licenza.

• Gli oggetti da sincronizzare, e il senso di circolazione di ciascuno
• Le portate strettamente necessarie, lettura e scrittura separate
• La via d'accesso scelta, token personale o flusso OAuth completo
• La cadenza di sondaggio, misurata sul conto reale prima di essere fissata
• Il conto sotto il quale la passerella lavora, e ciò che costa
• Ciò che deve poter riuscire un giorno, e per quale canale

Da dove vengono queste risposte

Ogni fatto di questa pagina si verifica alla fonte. I link aprono direttamente il sito del fornitore o dell'organismo in questione.

• bexio, pacchetti e prezziNomi e prezzi dei quattro forfait, utenti inclusi e prezzo di un accesso supplementare, consultati il 23.08.2026
• Documentazione dell'interfaccia bexioRadice api.bexio.com/2.0, OAuth 2.0 e OpenID Connect, token di accesso personali, portate, paginazione a 500, limitazione di flusso, nessuna sezione webhook
• bexio, la QR-fatturaGenerazione nativa della QR-fattura svizzera e riconciliazione dei pagamenti
• bexio, la fattura elettronicaeBill tramite l'applicazione terza iomarket AG del Marketplace, fatturata in aggiunta
• Registro Swissdec dei software certificatibexio Lohnbuchhaltung certificato ELM 5.0, 5.1 e 5.3, certificato n. 1142.24
• Lista OpenPeppol dei Certified Service ProvidersLista aggiornata il 21.08.2026, senza voce bexio
• Politica di riservatezza di bexioDati personali dei clienti conservati e trattati esclusivamente in Svizzera, server situati in Svizzera
• Comunicato di bexio del 18 febbraio 2026100'000 clienti, filiale al 100 % della Mobiliare, nuovi forfait da marzo 2026
• inside-it, bexio annuncia 100'000 clientiMessa in prospettiva dalla stampa informatica svizzera, Swiss21 più di 80'000 e KLARA 50'000
• Annuario delle fiduciarie partner di bexioProgramma partner riservato alle fiduciarie, più di 1'000 società elencate, statuti da Argento a Platino
• inside-it, la Mobiliare rileva bexioAnnuncio dell'acquisto il 05.07.2018, 100 % delle azioni

RILEVAZIONE DEL 23.08.2026

Domande frequenti