Per il consulente informatico¶
Questa appendice è rivolta al responsabile IT o al system integrator che deve collegare EXOfattura ad altri sistemi aziendali (ERP, e-commerce, BI).
Attenzione
Il manuale principale è pensato per l'utilizzo quotidiano di imprenditori e commercialisti. Le informazioni tecniche di integrazione restano separate e non sono necessarie per l'uso ordinario della piattaforma.
Documentazione API¶
Le integrazioni machine-to-machine utilizzano le API REST del gestionale:
- Documentazione interattiva: fattura.exobyte.it/swagger/
- Autenticazione: chiave API (
X-API-Key) o token Bearer dopo login - Gestione chiavi: Sistema → Impostazioni (sezione API Key), riservata agli amministratori
Ambiti tipici di integrazione¶
| Ambito | Esempio |
|---|---|
| Anagrafiche | Sincronizzazione clienti e prodotti |
| Vendite | Creazione fatture da ordini e-commerce |
| Pagamenti Mollie | POST /api/v1/quotes/{id}/mollie-payment o …/invoices/{id}/mollie-payment → checkout_url; da preventivo → fattura + stato completed; notify può includere invoice_pdf_url |
| Link pubblico PDF fattura | POST /api/v1/invoices/{id}/share-link → data.share.url (https://fattura.exobyte.it/share/{token}); PDF inline senza login |
| Logistica | Aggiornamento tracking da piattaforme corriere |
| Magazzino | Aggiornamento giacenze da WMS |
| Inventory (P13) | Costi, BOM, produzione, ricevimenti merce, mapping fornitori |
| Collaborazione | Notifiche su salvataggio documenti condivisi |
| Notifiche | Webhook su eventi documento |
Per Mollie: header obbligatorio X-Company-Id, feature payments.mollie, dettaglio in Swagger (tag Mollie) e docs/mollie.md.
Per il link PDF pubblico: header X-Company-Id, permesso invoice.read, dettaglio in Swagger (POST …/share-link) e docs/document_share.md.
Webhook¶
Gli amministratori possono configurare endpoint webhook in Sistema → Webhook per ricevere notifiche su eventi selezionati (es. fattura inviata, scarto SDI).
Supporto tecnico¶
Per richieste di integrazione, contatti il supporto EXOBYTE indicando:
- ambiente (produzione o test);
- moduli coinvolti;
- volumi stimati e frequenza di sincronizzazione.
Torna al manuale d'utilizzo per le procedure operative.