COMMERCIO E GESTIONE
Collegare il vostro negozio online alla vostra fatturazione senza reinserire gli ordini
Tra il carrello del cliente e la scrittura contabile mancano sempre campi che nessuno ha modellato.
Un negozio online produce ordini, un software di gestione produce fatture e scritture. Lo scarto si gioca sull'IVA, sulle spese di spedizione, sugli acconti, sulle note di credito e sulle quantità disponibili. Questa pagina stabilisce cosa un connettore già pronto riprende realmente, cosa lascia al cliente, e perché l'assenza di webhook cambia il modo di concepire la sincronizzazione.
Un ordine di negozio e una fattura svizzera non portano gli stessi campi
Un ordine registrato in WooCommerce, Shopify o PrestaShop descrive un carrello, un indirizzo di consegna, un modo di spedizione e un pagamento incassato o in attesa. Una fattura svizzera chiede altro, un debitore identificato, posizioni collegate a un conto e a un codice IVA, un riferimento di pagamento strutturato e, nella maggior parte dei casi, una sezione QR conforme. I due oggetti si assomigliano sullo schermo e divergono nel dettaglio. È in questo scarto che si annidano i reinserimenti del lunedì mattina.
In realtà circolano tre flussi, e non hanno né lo stesso ritmo né lo stesso senso. Il primo scende dal negozio verso il software di gestione, porta gli ordini e i clienti. Il secondo risale dal software verso il negozio, porta gli articoli, i prezzi e le quantità disponibili. Il terzo collega l'incasso alla contabilità, tramite il conto bancario, tramite il prestatore di pagamento o tramite entrambi. Una catena che tratta solo il primo flusso lascia il catalogo, le quantità e l'incasso alla mano.
Prima di ogni tecnica si impone una decisione di gestione, quella di sapere dove vive il riferimento di ogni dato. Il catalogo è tenuto nel negozio o nel software, il prezzo di vendita fa fede sul versante commercio o sul versante gestione, il numero di cliente viene dal sito o dalla base esistente. Finché questa domanda resta aperta, due sistemi scrivono lo stesso dato e nessuno sa quale abbia ragione il giorno in cui differiscono.
Cosa riprende davvero un connettore già pronto, e cosa resta sulla banchina
Più fornitori pubblicano connettori di negozio. Abacus annuncia Shopify, WooCommerce tramite pingWoo, Magento e PepperShop. SelectLine annuncia Shopware, Shopify e Venabo. WinBIZ pubblica un connettore WooCommerce, un collegamento di ordini PrestaShop e un connettore Sempio. Infoniqa censisce un annuario di 175 collegamenti terzi, di cui 159 dichiarati compatibili con ONE 50. Odoo occupa una posizione diversa, poiché il negozio e la gestione vivono nello stesso sistema, il che sposta la questione dall'interfaccia al perimetro funzionale.
Ciò che questi connettori coprono è reale e utile, la ripresa degli ordini, la creazione o l'aggiornamento del cliente, la creazione di un documento commerciale, spesso il ritorno delle quantità. Ciò che coprono raramente sta nei dettagli che fanno il fatturato esatto. Il connettore generico tratta il caso nominale, un ordine semplice, pagato, consegnato in una volta. Sono gli ordini che si scostano da questo caso nominale a prendere tempo ogni settimana.
PAGINE DEI FORNITORI E DOCUMENTAZIONI DI API, CONSULTATE IL 23.08.2026
Prima di firmare occorre dunque leggere la scheda del connettore riga per riga e confrontare ogni campo con i vostri ordini degli ultimi dodici mesi. Un connettore che riprende l'essenziale degli ordini senza intervento lascia comunque una coda quotidiana di casi particolari, e questa coda costa più in attenzione che in minuti.
- Le varianti di articolo, taglia, colore, confezione, e la loro corrispondenza con un codice articolo unico
- Gli sconti per riga, i buoni di riduzione e i prezzi per gruppo di clienti
- Le spese di spedizione e di trattamento, con la loro propria aliquota IVA
- Gli acconti, i pagamenti parziali e gli abbonamenti rinnovati
- I resi, le note di credito e i rimborsi parziali del prestatore di pagamento
- Gli ordini in più valute e le spese di cambio
Le spese di spedizione, gli acconti e i resi fanno divergere il totale prima della contabilità
L'IVA è il primo punto di attrito. Le aliquote in vigore dal 1° gennaio 2024 sono dell'8,1 % per l'aliquota normale, del 2,6 % per l'aliquota ridotta e del 3,8 % per l'alloggio, e i fornitori svizzeri documentano la loro presa in carico, WinBIZ per esempio sui moduli ufficiali dell'Amministrazione federale delle contribuzioni. La domanda non è lì. È sapere quale aliquota il negozio applica alle spese di spedizione, come tratta un ordine fuori dalla Svizzera, e se i prezzi esposti sono inseriti IVA inclusa da un lato e IVA esclusa dall'altro.
Il secondo punto di attrito è l'incasso. Un prestatore di pagamento versa raramente l'importo dell'ordine, versa un saldo netto, a lotti, dopo trattenuta delle sue commissioni e deduzione dei rimborsi del periodo. La contabilità attende l'inverso, una fattura, un incasso, una scrittura di spesa. Senza regola di riconciliazione stabilita in anticipo, il conto bancario e il libro mastro si scostano un poco ogni settimana, e la chiusura si occupa di ritrovare il perché.
Il terzo punto è il reso di merce. Un cliente rimborsato produce tre eventi distinti, un movimento di magazzino, una nota di credito, e un rimborso finanziario. Un negozio gestisce questo nel proprio vocabolario, un software di gestione nel suo. Decidere come l'uno si traduce nell'altro è un lavoro di progettazione, e questo lavoro si fa una volta, con calma, invece che a ogni caso.
Due magazzini per un solo articolo, e la questione di sapere quale fa fede
Una PMI che vende in negozio e online detiene due contatori per lo stesso articolo. Il problema non è renderli uguali in un dato istante, è definire chi descrive la verità tra due sincronizzazioni e cosa succede quando entrambi calano nello stesso momento. La risposta dipende dal vostro commercio, dal termine di preparazione, dal volume e dall'accettazione o meno di una rottura occasionale.
Il perimetro del software conta qui più del connettore. Da bexio, la gestione dei lotti, dei numeri di serie e di più depositi non è documentata nella guida del fornitore al giorno della consultazione, e l'importazione di prodotti è riportata come limitata a 15'000 righe. SelectLine annuncia la produzione e la gestione commerciale, Infoniqa ONE 200 la logistica e il controlling, Odoo il magazzino e la produzione nello stesso sistema. SelectLine si installa su server Windows con Microsoft SQL Server, le suite Infoniqa si installano presso il cliente, e la messa in opera di Odoo passa di regola da un partner. Scegliere la profondità di magazzino è una decisione anteriore alla scelta del connettore, non posteriore.
Infine la prenotazione merita di essere posta nero su bianco. Una quantità deve uscire dal disponibile al momento dell'ordine, del pagamento o della spedizione. La scelta incide direttamente sul numero di ordini che non potrete onorare, e si scrive nei due sistemi allo stesso modo, altrimenti non vuol dire nulla.
Senza webhook, la sincronizzazione diventa una regolazione di frequenza
Un webhook è una chiamata che il fornitore invia al vostro sistema nel momento in cui qualcosa cambia. Senza di esso, l'unica via resta l'interrogazione periodica, il vostro programma chiede regolarmente cosa si è mosso. La documentazione pubblica di bexio letta il 23 agosto 2026 non contiene alcuna sezione webhook, quella di smallinvoice non espone alcun percorso di richiamo, e la ricerca del termine nel centro assistenza di WinBIZ resta senza risultato. Odoo annuncia webhook, e AbaNinja li annuncia fin dal suo piano Basic.
Il sondaggio periodico non è un ripiego, è un'architettura che si dimensiona. Occorre scegliere una frequenza, tenere la paginazione imposta dal fornitore, fino a 500 elementi per richiesta da bexio, un mezzo per individuare ciò che è cambiato, una memoria di ciò che è già stato trattato, e una condotta da tenere quando una chiamata fallisce. La documentazione di KLARA indica che esiste un limite di flusso, con una risposta 429, senza pubblicare né la soglia né la finestra, il che rende il calcolo teorico impossibile e impone una misura.
DOCUMENTAZIONI DI API PUBBLICHE, LETTE IL 23.08.2026
Un ultimo dettaglio pesa molto in esercizio. La documentazione di KLARA indica anche che non esiste un ambiente di prova separato e che ogni chiamata lavora sui dati di produzione. Questo cambia il modo di costruire, si scrivono prima delle letture, si registra, si rigioca a vuoto, e solo dopo si scrive.
Ciò che stabiliamo prima di scrivere la prima riga di codice
Non vendiamo alcuna licenza. Cominciamo dunque dai vostri ordini reali, non dalla scheda del connettore. Un campione degli ordini degli ultimi dodici mesi mostra la quota dei carrelli semplici, quella degli ordini con spese di spedizione particolari, quella dei resi e quella dei casi che nessuno aveva menzionato. Questo conteggio orienta il resto, dice se un connettore standard basta, se occorre completarlo, o se conviene scrivere direttamente contro l'API.
Verifichiamo poi le condizioni di accesso tecniche, nella documentazione del fornitore consultata il 23 agosto 2026 e non nel suo opuscolo. L'API di SelectLine è inclusa a partire dall'edizione Premium e presuppone l'installazione del Mobile Manager e della Toolbox. Quella di Odoo Online è aperta solo sulla formula Custom. Da WinBIZ, la documentazione indica che la chiave API si ottiene essendo partner secondo le condizioni generali di partenariato. Da Crésus, gli scambi passano da maschere di importazione e di esportazione in testo e in CSV.
Poi scriviamo il collaudo prima della meccanica. Un ordine di prova con variante, uno con spese di spedizione, uno con acconto, uno con reso parziale, uno fuori dalla Svizzera, ciascuno con il risultato atteso nel software di gestione e nella contabilità. Il giorno in cui la catena gira, questo insieme di prove diventa il controllo che rilanciate dopo ogni aggiornamento del negozio o del software, e vi appartiene.
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.
- Documentazione API bexio, REST e JSON, OAuth 2.0 e OpenID Connect, paginazione fino a 500 elementi, nessuna sezione webhook al 23.08.2026Condizioni di accesso all'API di bexio e assenza di webhook nella documentazione letta
- Documentazione sviluppatore KLARA, assenza di ambiente di prova separato, risposta 429 senza soglia pubblicataVincoli di esercizio di una sincronizzazione per interrogazione periodica
- Tariffe smallinvoice, piano FREE, STARTER a CHF 15 al mese con accesso API inclusoCosto d'ingresso di un accesso API su una soluzione di fatturazione svizzera
- API esterna Odoo, accesso ai dati riservato alle formule Custom su Odoo OnlineCondizione di apertura dell'API secondo la formula di abbonamento
- Guida in linea dell'API SelectLine, perimetro ERP, prerequisiti Mobile Manager e Toolbox, nessun webhook documentatoPrerequisiti tecnici di un'integrazione SelectLine
- Abbonamenti SelectLine in Svizzera, API inclusa a partire dall'edizione Premium a CHF 119.- per utente e al meseEdizione minima che dà accesso all'API
- Centro assistenza WinBIZ, ottenimento di una chiave API condizionato allo statuto di partner secondo le condizioni generali di partenariatoCondizione di accesso all'API di WinBIZ
- Pagina prodotto WinBIZ, rendiconti IVA su moduli dell'Amministrazione federale delle contribuzioni con le aliquote 2024, normale 8,1 %, ridotta 2,6 %, speciale 3,8 %Aliquote IVA svizzere prese in carico e perimetro funzionale
- AbaNinja, piani Starter, Basic e Pro, API e webhook annunciati fin dal piano BasicCaso di un fornitore svizzero che documenta webhook
- Specifiche di Crésus Fatturazione, scambi tramite maschere di importazione e di esportazione in testo e in CSVNatura degli scambi di dati in assenza di API pubblica documentata
- Connettori annunciati da Abacus, tra cui Shopify, WooCommerce tramite pingWoo, Magento e PepperShopPerimetro dei connettori di commercio online annunciati dal fornitore
- Annuario ufficiale Infoniqa dei collegamenti terzi, 175 soluzioni di cui 159 dichiarate compatibili ONE 50Ecosistema di ponti nominati attorno a ONE 50
RILEVAZIONE DEL 23.08.2026
Domande frequenti
Si può collegare WooCommerce a bexio?
Tramite l'API REST pubblica di bexio sì, OAuth 2.0 o un token di accesso personale permettono di scrivere un collegamento su misura. Il Marketplace di bexio annuncia peraltro più di cento applicazioni, il cui contenuto esatto è da verificare al giorno della decisione, nessun ponte WooCommerce essendo nominato nelle fonti che abbiamo letto. La documentazione letta il 23 agosto 2026 non descrive alcun webhook, il che significa che il collegamento interroga bexio a intervalli regolari invece di essere avvisato.
Come fatturare in Svizzera gli ordini Shopify?
L'ordine scende nel vostro software di gestione, che produce la fattura con il codice IVA, il riferimento strutturato e la sezione QR. Due elementi meritano di essere regolati presto. Prima l'impostazione della QR-fattura, KLARA la documenta per esempio in tre varianti, senza QR, con riferimento Creditor, o QR-IBAN con riferimento QRR, e la scelta impegna i vostri riferimenti di pagamento. Poi la riconciliazione, bexio genera la QR-fattura nativamente con abbinamento automatico dei pagamenti, il che non dispensa dal decidere come il versamento netto del prestatore di pagamento si ripartisce tra le vostre fatture.
Come sincronizzare il magazzino del negozio e quello del negozio online?
Verificando prima che il vostro software gestisca la profondità di cui avete bisogno, lotti, numeri di serie, depositi multipli, poiché nessun connettore crea una funzione assente dal software. La questione del sistema che fa fede e del momento in cui una quantità esce dal disponibile è trattata più in alto in questa pagina. Viene poi la meccanica, un ritorno periodico delle quantità dal software verso il negozio e una discesa dei movimenti di vendita.
Bisogna comprare un connettore o passare dall'API?
Il conteggio dei vostri ordini reali decide. Se la quasi totalità dei vostri carrelli è semplice e il connettore copre i vostri campi, costa meno di uno sviluppo. Se le vostre varianti, i vostri acconti o i vostri resi escono dal caso nominale, il connettore lascerà una coda quotidiana di riprese manuali. Guardate anche il costo di accesso all'API, che varia secondo l'edizione o la formula di abbonamento e può spostare il budget.
Il mio software non ha webhook documentati, è bloccante?
No, ma questo cambia l'architettura. Senza notifica in uscita, il collegamento interroga il software a intervalli regolari e confronta con ciò che ha già trattato. Occorre allora fissare una frequenza, rispettare la paginazione imposta dal fornitore e prevedere la condotta da tenere in caso di fallimento. I valori esatti, paginazione e limite di flusso, sono da rilevare nella documentazione del software scelto.
Che cosa ne è di un ordine rimborsato nella contabilità?
La regola di corrispondenza tra il vocabolario del negozio e quello del software di gestione si decide una volta, si scrive nel collegamento e si controlla con un insieme di prove contenente almeno un rimborso parziale. Il punto più spesso dimenticato è il legame tra la nota di credito e il versamento netto del prestatore di pagamento, che arriva a lotti e non ordine per ordine.
La QR-fattura serve ancora se l'ordine è già pagato online?
Il documento di fattura resta utile anche quando non c'è più nulla da incassare, e la maggior parte dei software svizzeri lo produce con la sua sezione di pagamento. Ciò che conta allora è la riconciliazione, la fattura deve essere marcata come saldata dal flusso di incasso e non da un inserimento manuale, altrimenti i vostri debitori mostrano crediti già incassati.
Quanto tempo prende un collegamento di questo tipo?
Non annunciamo un termine prima di aver contato i vostri ordini reali e letto le condizioni di accesso del vostro software, poiché i due variano molto. Ciò che annunciamo è l'ordine delle tappe, conteggio dei casi, verifica degli accessi tecnici, scrittura dell'insieme di prove con i risultati attesi, poi costruzione. Una cifra data prima di questa lettura sarebbe una stima comoda da annunciare e difficile da tenere.
Per approfondire
Fate contare i vostri ordini prima di scegliere un connettore
Inviateci un'esportazione dei vostri ordini degli ultimi dodici mesi e il nome del vostro software di gestione. Contiamo i vostri casi, confrontiamo ciascuno con i campi annunciati dalla scheda del connettore, elenchiamo quelli che resteranno manuali, e vi restituiamo questa constatazione in occasione di una diagnosi offerta, senza impegno.