Condizioni della Public API
Le presenti Condizioni integrano i Termini e Condizioni di FatturaSmart per le aziende per le quali sono generate chiavi della Public API e prevalgono su di essi per quanto riguarda la Public API. Per quanto non previsto si applicano i Termini e Condizioni e il DPA vigenti. Se l'Utente ha sottoscritto con Fraway S.r.l. un contratto specifico per l'uso delle API, per quanto da esso disciplinato prevale tale contratto.
1. Natura della Public API
La Public API è un'interfaccia di programmazione che consente a un software scelto dall'Utente (ad esempio il proprio gestionale, un e-commerce o un ERP) di usare alcune funzioni del Servizio per l'azienda a cui è associata la chiave: leggere le fatture emesse e ricevute dall'azienda e il loro stato, le numerazioni e le aliquote IVA disponibili, e creare fatture elettroniche verso clienti diversi dalle pubbliche amministrazioni, che il Servizio numera, trasmette allo SDI e registra nell'account come le fatture create nell'app. Le funzioni disponibili, i formati dei dati, i codici di errore e i limiti tecnici sono descritti nella documentazione tecnica pubblicata da Fraway S.r.l. e raggiungibile dalla pagina Profilo › Chiavi API (la «Documentazione»).
Il cliente della fattura è indicato con il riferimento a un'anagrafica esistente oppure con i suoi dati. Nel secondo caso la fattura riporta i dati indicati nella richiesta. Se in anagrafica esiste già un cliente con la stessa partita IVA o, in mancanza, con lo stesso codice fiscale, la fattura è collegata a quel cliente e ne riprende soltanto la partita IVA, il codice fiscale, il codice destinatario e la PEC che la richiesta omette (un dato che la richiesta indica come assente non compare in fattura); altrimenti il Servizio aggiunge il cliente in anagrafica. Le anagrafiche esistenti non sono modificate.
La Public API è una funzionalità opzionale del Servizio attivabile dall'Utente ai sensi della sezione 1.1 dei Termini e Condizioni: il suo funzionamento, come quello di ogni altra componente del Servizio, è regolato dai Termini e Condizioni.
2. Chiavi e ambienti
Le chiavi sono generate e revocate dal titolare dell'azienda in Profilo › Chiavi API. Su richiesta del titolare, l'assistenza di Fraway S.r.l. può revocare una chiave. Ogni chiave è associata a una sola azienda e consente di operare soltanto sui dati di quell'azienda.
Le chiavi live operano sui dati reali dell'account e trasmettono le fatture allo SDI; sono disponibili per le aziende con un piano che include la Public API. Le chiavi sandbox operano su un ambiente di prova che non registra dati nell'account e non trasmette nulla allo SDI.
La chiave è mostrata per intero una sola volta, al momento della creazione: Fraway S.r.l. ne conserva soltanto un'impronta crittografica e i primi caratteri, che servono a riconoscerla e non consentono di ricostruirla, e non può quindi recuperarla né mostrarla di nuovo. La revoca di una chiave ha effetto dalla richiesta successiva.
3. Custodia delle chiavi
La chiave è una credenziale di accesso al Servizio ai sensi della sezione 4.2 dei Termini e Condizioni: chi la possiede può leggere i dati dell'azienda e creare fatture e trasmetterle allo SDI a nome dell'azienda. Il Servizio non è in grado di distinguere chi invia una richiesta: ogni richiesta autenticata con una chiave attiva è eseguita per l'azienda a cui la chiave è associata, finché la chiave non è revocata.
L'Utente custodisce le chiavi in modo sicuro: non le inserisce in codice eseguito nel browser o in app distribuite a terzi, né in archivi accessibili a terzi, e le comunica soltanto a chi ne ha bisogno per l'integrazione. Se sospetta che una chiave sia stata esposta o usata da altri, l'Utente la revoca subito in Profilo › Chiavi API e ne informa Fraway S.r.l. all'indirizzo info@fatturasmart.com, che lo assiste nel ricostruirne l'uso con il registro delle richieste (clausola 10).
4. Emissione e trasmissione allo SDI
Con una chiave live, la richiesta di creazione di una fattura accolta dal Servizio comporta l'assegnazione del numero, l'emissione della fattura e la sua trasmissione allo SDI, senza ulteriore conferma nell'app. Una fattura trasmessa e non scartata dallo SDI non può essere cancellata né modificata: le correzioni si effettuano con nota di credito o con le altre procedure previste dalla normativa (sezione 10.2 dei Termini e Condizioni).
Prima di ogni richiesta l'Utente verifica nel proprio software i dati della fattura (cliente, righe, importi, aliquote e natura IVA, date, numerazione e modalità di pagamento). I controlli del Servizio riguardano il formato e la coerenza tecnica dei dati, non il loro merito fiscale o contabile. Per sviluppare e collaudare l'integrazione l'Utente usa le chiavi sandbox.
La risposta della Public API riporta l'esito noto al momento della richiesta: un esito positivo indica che la fattura è stata trasmessa allo SDI, non che è stata consegnata al cliente. Se la trasmissione è rifiutata al momento della richiesta, dai controlli del Servizio o in fase di invio, la fattura non viene registrata e la risposta ne indica il motivo. Se la trasmissione non si completa per un problema temporaneo, la fattura resta nell'account in attesa di invio e il Servizio ritenta la trasmissione. Se la trasmissione è rifiutata in un momento successivo, o lo SDI scarta la fattura con una notifica di scarto, la fattura resta nell'account con il relativo stato e l'Utente la corregge e la ritrasmette nell'app nei termini previsti dalla normativa. L'esito definitivo è quello comunicato dallo SDI, che l'Utente può consultare con la Public API o nell'app. Ogni richiesta di creazione indica una chiave di idempotenza, che evita fatture duplicate quando la stessa richiesta viene ripetuta, come descritto nella Documentazione.
5. Software e fornitori dell'Utente
Il software che chiama la Public API, sviluppato dall'Utente o fornito da terzi (ad esempio il produttore del gestionale o un integratore), non fa parte del Servizio. Se l'Utente affida l'integrazione o una chiave a un fornitore, questi opera per conto e sotto la responsabilità dell'Utente, come i collaboratori della sezione 8-ter dei Termini e Condizioni. Fraway S.r.l. non è parte del rapporto tra l'Utente e il fornitore. Il software dell'Utente e il fornitore che lo gestisce ricevono i dati restituiti dalla Public API per conto dell'Utente, che resta titolare del trattamento e regola il rapporto con il fornitore; non sono sub-responsabili di Fraway S.r.l. ai sensi del DPA.
6. Uso per i documenti della propria azienda
Ogni chiave serve a emettere e gestire i documenti dell'azienda a cui è associata, che ne è il soggetto emittente. Rientra nel Servizio regolato dalle presenti Condizioni anche l'integrazione affidata dall'azienda a un proprio fornitore (clausola 5), pure se lo stesso fornitore assiste più aziende, ciascuna con il proprio account e le proprie chiavi. Non rientra invece nel Servizio regolato dalle presenti Condizioni l'offerta a terzi, da parte dell'Utente, di un servizio di emissione o trasmissione di documenti fiscali basato sulla Public API, ad esempio come software house, rivenditore o fornitore di servizi di fatturazione che apre o gestisce gli account dei propri clienti: tale servizio è disciplinato da un contratto specifico con Fraway S.r.l.
7. Limiti d'uso
Le richieste sono soggette ai limiti di frequenza e di dimensione indicati nella Documentazione; le richieste oltre i limiti sono rifiutate con il relativo codice di errore e possono essere ripetute dopo l'intervallo indicato. Fraway S.r.l. può aumentare i limiti in qualsiasi momento; una loro riduzione segue la clausola 8. È vietato usare la Public API per accedere a dati di aziende diverse da quella della chiave, per aggirare i limiti o le misure di sicurezza del Servizio, per eseguire test di carico o di sicurezza non concordati con Fraway S.r.l. o per emettere documenti che non corrispondono a operazioni effettive (sezioni 8.2, 8.3 e 8.4 dei Termini e Condizioni).
8. Versioni della Public API
La Public API è versionata: la versione è indicata nell'indirizzo delle
richieste (ad esempio /api/public/v1). Nella versione in
uso Fraway S.r.l. può aggiungere funzioni, campi facoltativi e codici di
errore; per questo l'integrazione dell'Utente deve ignorare i campi che
non riconosce, come indicato nella Documentazione.
Le modifiche che richiedono un adeguamento dell'integrazione (ad esempio la rimozione di una funzione o di un campo, un cambiamento di formato o la riduzione dei limiti della clausola 7) sono introdotte soltanto con una nuova versione, annunciata all'indirizzo email del titolare dell'azienda e nella Documentazione. La versione precedente resta disponibile almeno fino alla scadenza del periodo di licenza in corso alla data dell'annuncio e comunque per almeno 6 mesi dall'annuncio.
Gli adeguamenti imposti da norme di legge, da provvedimenti dell'autorità o da modifiche delle specifiche tecniche della fatturazione elettronica e dello SDI, e quelli necessari a correggere una vulnerabilità di sicurezza, si applicano anche alla versione in uso dalla data in cui sono dovuti e sono comunicati appena possibile.
9. Sospensione, revoca e cessazione
Se una chiave risulta esposta pubblicamente o è usata in modo anomalo, tale da mettere a rischio l'azienda, il Servizio o gli altri Utenti, Fraway S.r.l. può disattivarla per proteggere l'Utente, informandolo senza ritardo; l'Utente può generare subito una nuova chiave. Fraway S.r.l. sospende l'accesso alla Public API quando lo impongono norme di legge o provvedimenti dell'autorità, informandone l'Utente ove consentito. Resta ferma la sezione 14 dei Termini e Condizioni.
Le chiavi live funzionano finché l'azienda ha una licenza attiva con un piano che include la Public API, o una concessione di Fraway S.r.l. ancora in corso: alla scadenza o alla cessazione della licenza o della concessione le chiavi live non danno più accesso, mentre le fatture già emesse restano nell'account. L'Utente può revocare le proprie chiavi in qualsiasi momento.
10. Registro delle richieste
Per la sicurezza del Servizio, l'assistenza e la prevenzione degli abusi, il Servizio registra per ogni richiesta l'identificativo della chiave e l'azienda, il metodo e il percorso, l'esito e l'eventuale codice di errore, la durata, la data, l'identificativo della richiesta, l'eventuale chiave di idempotenza, l'indirizzo IP e lo user agent del chiamante; le richieste non autenticate sono registrate senza chiave né azienda. Il registro non contiene il contenuto delle richieste e delle risposte e le registrazioni sono cancellate automaticamente dopo 90 giorni. Su richiesta scritta del titolare dell'azienda, Fraway S.r.l. fornisce l'estratto del registro relativo all'azienda. Per le richieste di creazione con chiave live, il Servizio conserva un'impronta della richiesta e la risposta per almeno 24 ore e non oltre 48 ore, per restituire la stessa risposta se la richiesta viene ripetuta con la stessa chiave di idempotenza.
Le fatture e le anagrafiche create o lette tramite la Public API sono trattate come ogni altro dato dell'account, secondo i Termini e Condizioni e il DPA; le richieste inviate con una chiave dell'azienda costituiscono istruzioni documentate dell'Utente ai sensi della sezione 4.1 del DPA.
11. Modifiche alle presenti Condizioni
Fraway S.r.l. comunica le modifiche alle presenti Condizioni all'indirizzo email del titolare dell'azienda almeno 15 giorni prima della data da cui le propone e le sottopone all'accettazione nella pagina Chiavi API. La nuova versione si applica dall'accettazione: fino ad allora le chiavi esistenti continuano a operare alle condizioni già accettate, mentre la creazione di nuove chiavi richiede l'accettazione della nuova versione. Restano salvi gli adeguamenti imposti da norme di legge o da provvedimenti dell'autorità, che si applicano dalla loro entrata in vigore.
12. Lingua
Le presenti Condizioni sono redatte in lingua italiana e in lingua inglese; in caso di difformità prevale la versione italiana.
Accettazione
Le presenti Condizioni sono accettate dal titolare dell'azienda, per conto dell'azienda, prima della creazione della prima chiave, con un'unica casella di accettazione, non preselezionata, in una sessione autenticata del Servizio; con l'accettazione il titolare dichiara di essere autorizzato a vincolare l'azienda. Il Servizio registra l'identità dell'Utente, l'azienda, la data e la versione del testo accettato. Dopo ogni modifica, le versioni precedenti restano pubblicate in un archivio raggiungibile da questa pagina. Per le aziende che hanno già chiavi alla data di pubblicazione, le presenti Condizioni sono proposte nella pagina Chiavi API e si applicano dall'accettazione: fino ad allora l'uso delle chiavi esistenti resta regolato dai Termini e Condizioni e, se sottoscritto, dal contratto specifico per l'uso delle API, e la creazione di nuove chiavi richiede l'accettazione. Il trattamento dei dati è descritto nell'Informativa sulla Privacy (sezione 7-quater) e nel DPA.
Versione: 2026-11
Data di Ultimo Aggiornamento: 05/11/2026
