Craft Commerce 5 · Svizzera
La metà che viene dopo l’invio
Portare un ordine in bexio è la parte facile. Bexy fa il resto: registra il pagamento perché la fattura non resti aperta, riporta lo stato di bexio in Commerce, verifica il totale prima di inviare e mantiene un collegamento che non scade silenziosamente dopo 60 giorni.
Guarda prima di inviare
L’anteprima usa lo stesso builder dell’invio reale, quindi ciò che stampa è byte per byte quello che riceve bexio. Nel codice c’è un solo punto in cui un ordine Commerce diventa un documento bexio, ed è questo a rendere la garanzia reale anziché velleitaria.
$ php craft bexy/sync/preview 1042
contact Bühler AG · #4471 (matched on email)
positions 3 × KbPositionCustom, 1 × KbPositionArticle
shipping CHF 12.00 MWST 8.1% → 3400
discount CHF 25.00 magnitude, is_percentual: false
mwst_type 0 (prices include tax, read from Commerce)
document CHF 486.35
order CHF 486.35
✓ totals agree — nothing to round
Nothing was sent. Run bexy/sync/order 1042 to send it.Cosa fa davvero
Sei cose che l’alternativa non fa.
Un collegamento che resta collegato
OAuth 2.0 con PKCE e refresh token rotanti, non un token di accesso personale che bexio fa scadere 60 giorni dopo la creazione, senza avvisare.
- Anche i PAT sono supportati, per un’azienda di prova
- Il refresh token ruotato viene salvato ogni volta, altrimenti il rinnovo successivo fallisce
- I token sono cifrati con la security key di Craft
Pagamenti, non solo fatture
Ogni addebito Commerce riuscito viene registrato sulla fattura bexio, così gli ordini pagati non restano aperti nei libri in attesa che qualcuno li spunti.
- Univoco per transazione Commerce, così un addebito non viene mai registrato due volte
- Ricade sul conto bancario predefinito
- Solo fatture — gli ordini bexio non accettano pagamenti
I totali vengono verificati prima
Bexy calcola a quanto arriverà il documento in bexio, lo confronta con Commerce e intercetta la discrepanza qui invece che al rendiconto IVA.
- Uno scarto di pochi centesimi riceve una posizione di arrotondamento esente
- Uno scarto maggiore viene rifiutato e spiegato
- Il limite superiore è il punto: un’IVA al 7,7% mappata male non deve essere colmata da una riga chiamata «Arrotondamento»
Il verdetto di bexio torna indietro
La riconciliazione recupera lo stato del documento da bexio e allinea l’ordine Commerce, così una fattura contrassegnata come pagata dal contabile non è una novità per il negozio.
- Bexy cambia lo stato dell’ordine e nient’altro
- Non inventa mai una transazione Commerce per far sembrare pagato un ordine
- I documenti pagati e annullati escono automaticamente dalla finestra
IVA svizzera, mappata come si deve
Ogni categoria IVA di Commerce è mappata a un’aliquota bexio e a un conto ricavi. `mwst_type` viene letto dall’ordine: un’aliquota contrassegnata «inclusa nel prezzo» rende lordi i prezzi senza doverlo dire due volte.
- Vengono offerte solo le aliquote IVA sulle vendite attive di bexio — tutto il resto viene rifiutato
- La spedizione ha aliquota e conto propri
- Una categoria non mappata produce un avviso sul documento, non un valore predefinito silenzioso
Non può inviare due volte
`api_reference` viene scritto su ogni documento e cercato prima di creare qualsiasi cosa, oltre a una tabella locale univoca per ordine.
- Invia due volte lo stesso ordine: il secondo invio riprende il primo documento
- Anche un documento creato in bexio prima che Bexy ne sapesse nulla viene ripreso
- I rimborsi annullano dove bexio lo consente e vengono segnalati dove non lo consente — mai un finto pagamento negativo
Bexy in the control panel
The settings screen from a Craft 5 install — the connection to bexio, what a paid order becomes, and when it gets sent.
Screenshot from a live install, not a mockup.
Domande
99 $, una volta sola. Un’unica edizione, nessun rinnovo, nessuna funzione bloccata. Gli aggiornamenti per Craft 5 sono inclusi.
No. Bexy è un plugin indipendente realizzato da Justin Holt e non è affiliato a bexio AG, né approvato o sponsorizzato da essa. Dialoga con l’API pubblica di bexio come qualsiasi altra integrazione di terze parti. «bexio» e il logo bexio sono marchi di bexio AG.
No. L’invio è sempre un job in coda e tutto ciò che sta sul percorso di checkout fallisce in modo aperto. Un cliente può pagare mentre bexio è offline; l’ordine si sincronizza quando torna.
I token di accesso personali di bexio scadono 60 giorni dopo la creazione, senza avvisare. Un negozio collegato con uno di essi smette di sincronizzare due mesi dopo e nulla lo segnala. I refresh token OAuth ruotano e continuano a funzionare. Bexy supporta entrambi; per questo OAuth è il valore predefinito.
Entrambi. Le fatture possono essere emesse, inviate e pagate: è la scelta abituale. Gli ordini bexio sono la fase precedente e non accettano pagamenti.
Un rimborso totale annulla la fattura dove bexio lo consente, cioè solo se non è ancora stato pagato nulla. Tutto il resto viene segnalato per una nota di credito. L’API di bexio non ha un endpoint per creare note di credito, e Bexy non simula un pagamento negativo per aggirarlo: i vostri libri direbbero qualcosa che non è mai accaduto.
No. La riconciliazione cambia lo stato dell’ordine Commerce e nient’altro. Bexy non inventa mai una transazione Commerce per far sembrare pagato un ordine.
Il pannello di controllo e questo sito sono in inglese, tedesco, francese e italiano.
Craft CMS 5.3 o successivo, Craft Commerce 5.0 o successivo, PHP 8.2 o successivo e un piano bexio che includa l’accesso API.
Basta riconciliare a mano
99 $, una volta sola. Installalo, collega un’azienda di prova bexio e invia un ordine per vedere il tutto in funzione.