Vai al contenuto

Funzionalità

Questa pagina elenca le principali funzionalità della Invoicetronic API.

Non dimenticare di controllare la nostra Roadmap.

Crittografia a riposo

La crittografia dei dati a riposo è una misura di sicurezza che cripta i dati quando non sono utilizzati (cioè, non vengono letti o modificati). Garantisce che i dati siano protetti da accessi non autorizzati, anche se il sistema di archiviazione sottostante viene compromesso.

Invoicetronic API rispetta gli standard e le normative per la protezione dei dati crittografando le fatture e altri dati sensibili a riposo, utilizzando moderni algoritmi di crittografia come AES-256. Solo il proprietario (tu) può recuperare il contenuto originale quando vi accede tramite una connessione sicura e richieste API autenticate.

Specifiche OpenAPI

Fornendoti una specifica OpenAPI completamente conforme, ci assicuriamo che tu abbia tutto il necessario per integrarti senza problemi con la nostra API, ridurre i tempi di sviluppo e concentrarti sulla creazione di valore per i tuoi utenti. Per saperne di più sulla specifica OpenAPI di Invoicetronic e i suoi vantaggi, consulta la nostra pagina OpenAPI.

Validazione preventiva delle fatture in uscita

Puoi convalidare le tue fatture prima di inviarle a SDI. La validazione preventiva applica le stesse rigide regole applicate da FatturaPA. L'API risponde con una risposta 422 Unprocessable Entity e un elenco di errori se il documento inviato non supera la convalida. La validazione può essere applicata in due modi:

Dopo una validazione riuscita, quest'ultimo salverà il documento e lo invierà a SDI. Se non convalidi i documenti in uscita, verranno inviati a SDI così come sono e saranno eventualmente respinti da SDI se non validi (ne verrai informato tramite un aggiornamento di stato).

Per impostazione predefinita, gli errori di convalida sono in italiano. Puoi utilizzare l'header Invoicetronic-Language per richiedere gli errori in altre lingue. Ad esempio, una richiesta con Invoicetronic-Language: en garantirà che qualsiasi errore di convalida venga restituito in Inglese. Le lingue attualmente supportate sono Italiano, Inglese, Tedesco.

La validazione preventiva è utile in scenari in cui la conformità della fattura è incerta. Un caso d'uso è quando un utente ha una bozza e desidera sapere se è pronta per l'invio. Inviare un documento non conforme a SDI non è la soluzione ideale perché l'utente saprà che il suo documento è stato respinto solo in un secondo momento, tramite un aggiornamento di stato.

Errori SDI codice 3xx

Tieni conto che alcune validazioni sono fuori dalla portata della API, come ad esempio una Partita IVA formalmente corretta ma inesistente. In generale, la validazione preventiva non può rilevare gli errori SDI codice 3xx. C'è quindi la possibilità che in casi rari una fattura convalidata dalla API venga comunque respinta da SDI.

Applicazione di firme digitali (p7m)

Su Invoicetronic API puoi archiviare fatture firmate digitalmente oppure non firmate. Opzionalente, l'API può applicare la firma digitale a una fattura appena caricata, evitandoti di firmarla localmente prima dell'invio (cosa che può essere complesso e costosa).

Per impostazione predefinita, una firma verrà applicata automaticamente alle fatture non firmate destinate alle pubbliche amministrazioni, poiché per questi ultimi la firma è obbligatoria. I documenti per aziende private non vengono modificati a meno che tu non richieda esplicitamente all'API di firmarli. Puoi disattivare questo comportamento in qualsiasi momento, così come puoi attivare o disattivare la funzione di firma per ogni singolo documento.

Formati multipli di upload

Invoicetronic API raccoglie le tue fatture in uscita e le inoltra a SDI per la consegna ai destinatari. Quando carichi le fatture hai diverse opzioni. Scegli quella che meglio si adatta al tuo caso d'uso.

  • Standard. Questo metodo offre maggiore controllo poiché puoi fornire più informazioni. L'header Content-Type della richiesta è application/json e il suo corpo è un oggetto JSON con proprietà come file_name, meta_data e payload, che contiene l'xml effettivo della fattura, codificato Base64 (consigliato) o come testo semplice.
  • File. Quando hai un file di fattura pronto, puoi caricarlo direttamente. Il nome del file verrà rilevato e il suo contenuto può essere codificato Base-64 o testo semplice. Il nostro strumento da riga di comando invoice utilizza questo metodo per inviare e ricevere rapidamente file di fattura singoli o in blocco dalla riga di comando.
  • XML. Questo metodo ti consente di sfruttare l'header Content-Type application/xml per inviare la fattura come stringa xml. Un nome file unico e conforme alle regole verrà generato e assegnato automaticamente al documento.
  • JSON. Consente alla tua integrazione di caricare una fattura JSON tramite l'header Content-Type application/json. Un nome file unico e conforme verrà generato e assegnato automaticamente al documento. Questa opzione è utile per generare in remoto i contenuti XML conformi a partire dai dati grezzi della tua integrazione.

Tutti i metodi di upload supportano la validazione preventiva e le firme digitali.

Aggiornamenti in tempo reale

Una volta che l'API inoltra una fattura, SDI cercherà di inviarla al destinatario. La tua integrazione può interrogare l'API in qualsiasi momento per conoscere lo stato di consegna di qualsiasi documento. Esempi di possibili aggiornamenti di stato sono:

Stato Descrizione
Inviato Inviato a SDI
Consegnato Consegnato al destinatario
Scartato Respinto da SDI, probabilmente a causa di un problema di convalida
ImpossibilitaDiRecapito Disponibile nel cassetto fiscale del destinatario, ma è stato impossibile consegnarlo al sistema di ricezione del destinatario

Tip

Oltre al meccanismo pull descritto qui, dove la tua applicazione interroga regolarmente l'API per aggiornamenti, puoi anche optare per un workflow push. Vedi Webhook per ulteriori informazioni.

Fatture in entrata

Le fatture in entrata (documenti fornitori) sono disponibili nell'endpoint API dedicato, receive. Lì la tua integrazione troverà i documenti destinati alle tue aziende (la tua API key supporta più aziende.) Come la maggior parte degli endpoint, anche questo supporta interrogazioni avanzate ed eliminazione di documenti (a seconda del tuo flusso di lavoro, potresti voler rimuovere una fattura una volta che è stata scaricata nella tua integrazione.) Per abilitare la ricezione delle fatture, tutto ciò che devi fare è condividere il tuo Codice Destinatario, in modo che gli emettitori possano utilizzarlo nei loro documenti.

Tip

Oltre al meccanismo pull descritto sopra, dove la tua integrazione verifica regolarmente la presenza di fatture in entrata, puoi optare per un workflow di tipo push, dove la tua integrazione viene avvisata della presenza di nuovi documenti in entrata. Vedi Webhook per ulteriori informazioni.

Impostazione del Codice Destinatario

Affinchè le fatture fornitori vengano instradate attraverso la API è necessario configurare correttamente il portale della Agenzia delle Entrate.

Notifica webhook

I webhook consentono un flusso di lavoro di tipo push per la tua integrazione, dove quest'ultima viene avvisata non appena succede qualcosa di interessante sull'API. Il caso d'uso tipico è essere informati su un aggiornamento di stato, o nuove fatture in entrata. La tua integrazione deve esporre un endpoint dedicato che verrà invocato dall'API quando si verifica l'evento configurato. I webhook sono una funzionalità potente, disponibile senza costi aggiuntivi.

Registro degli eventi

Tutto ciò che accade ai tuoi dati viene registrato. Puoi recuperare e interrogare la cronologia eventi in qualsiasi momento presso un endpoint dedicato log, ottenendo audit completi e sicuri. Per ogni evento hai molte informazioni a disposizione, molte delle quali interrogabili: endpoint, metodo usato nella richiesta, versione API, azienda coinvolta, successo o meno della richiesta. Gli eventi sono anche alla base dei webhook. Puoi collegare un webhook a qualsiasi evento e la tua integrazione verrà avvisata quando l'evento desiderato si verifica.

Supporto multi-azienda

Ogni API key supporta la gestione di una o più aziende per l'invio e la ricezione dei documenti. Un endpoint dedicato consente la gestione delle entità aziendali. Quando invii una fattura, un'azienda viene automaticamente aggiunta per te se mancante, così puoi inviare documenti non appena hai una API key, anche senza creare aziende preventivamente.

Sandbox gratuita

Quando ti registri ricevi una API key di test e una di produzione. La chiave di test ti consente di accedere immediatamente e gratuitamente all'ambiente Sandbox. Non è necessario pagare in anticipo per iniziare a utilizzare Invoicetronic API. La Sandbox è sempre disponibile per valutazione, implementazione e test. Una volta che sei sicuro che Invoicetronic API soddisfa le tue esigenze, puoi acquistare i crediti necessari per l'ambiente di produzione. Per saperne di più, consulta la sezione Sandbox.

Client SDK

Per aiutarti a interagire con le nostre API abbiamo creato un set di SDK (Software Developer Kit) open source per i linguaggi di programmazione più comuni. Gli SDK accelereranno il processo di integrazione. Questi SDK forniscono modelli e metodi aggiornati per contattare le nostre API con una configurazione minima, rendendo possibile interagire con Invoicetronic API in pochi minuti. Hai solo bisogno di una API key e sei pronto a partire. Per saperne di più, consulta la sezione SDKs.

Comando invoice

Non è necessario conoscere l'API o un linguaggio di programmazione per inviare e ricevere fatture. Abbiamo creato il comando invoice per scambiare rapidamente e intuitivamente file fattura dalla riga di comando. In alternativa, puoi utilizzare strumenti generici e ben noti, come curl. Per saperne di più, consulta la sezione Command-line tools.

Dashboard Web

La Dashboard di Invoicetronic consente eseguire alcune attività tramite un'interfaccia web. Crea e configura webhook, monitora il tuo registro eventi, carica fatture con un semplice clic, crea nuove chiavi API personali e limitate, controlla lo stato del tuo account, acquista crediti e altro ancora.

Roadmap

Le seguenti funzionalità sono sulla nostra roadmap e contiamo di rilasciarle in futuro.

White labelling

La opzione White Labelling offre un Codice Destinatario unico e personalizzato che ti identifica e distingue. Con il codice personalizzato, le tue integrazioni usano Invoicetronic API al massimo mentre mantieni un profilo unico e autonomo verso i tuoi clienti e corrispondenti.

API Key limitate

La registrazione con Invoicetronic API ti garantirà una coppia di API Key primarie, una per i test e una per l'ambiente di produzione. Queste due chiavi hanno pieno accesso alle risorse API. Puoi aggiungere nuove chiavi e assegnare loro i diritti che ritieni adatti, a seconda del tuo caso d'uso. Ad esempio, potresti creare una chiave per un'integrazione che abbia solo accesso in lettura. Un altro scenario è la creazione di una chiave temporanea e limitata che desideri prestare a un nuovo collaboratore per consentirgli di sperimentare con l'API. Le tue chiavi limitate sono collegate al tuo account e puoi gestirle dalla dashboard.