Changelog

Questa pagina documenta tutte le modifiche significative all'API Invoicetronic. Le versioni seguono il Semantic Versioning.

v1.0.25 - 3 Febbraio 2026

Correzioni

• Il campo is_read nelle fatture ricevute (receive) viene ora impostato solo quando include_payload=true, sia per GET singolo che per lista.
• La Dashboard ora consente la creazione e visualizzazione di webhook senza company_id, per ricevere notifiche da tutte le company su un unico URL.
• La Dashboard ora gestisce correttamente gli errori di validazione webhook (es. URL non valido) mostrando un messaggio all'utente invece di un'eccezione server.

Documentazione

• Aggiornate le descrizioni degli endpoint receive per documentare il nuovo comportamento di is_read.
• Corretti typo nelle descrizioni dei modelli.

v1.0.24 - 2 Febbraio 2026

Correzioni

• Migliorato il log degli eventi.

v1.0.23 - 2 Febbraio 2026

Correzioni

• Corretta la decodifica base64 nell'autenticazione Basic Auth che poteva causare il fallimento del login quando le credenziali venivano codificate senza il separatore colon (es. Base64(api_key) invece di Base64(api_key:)).

v1.0.22 - 18 Gennaio 2026

Miglioramenti

Documentazione API migliorata

Aggiunte descrizioni complete a tutti gli endpoint API con informazioni dettagliate su: - Descrizione di ogni entità (send, receive, update, company, log, webhook, status) - Periodi di retention dei dati - Filtri disponibili per le ricerche - Link alla Dashboard per la gestione delle risorse - Link alla documentazione Sandbox e Webhooks

v1.0.21 - 5 Gennaio 2026

Novità

Supporto per la lingua tedesca

Aggiunto il supporto completo per la lingua tedesca (de) nell'header Accept-Language. Tutti i messaggi di errore e validazione sono ora disponibili in tre lingue: - Accept-Language: it - Messaggi in italiano (predefinito) - Accept-Language: en - Messaggi in inglese - Accept-Language: de - Messaggi in tedesco

Le varianti regionali sono supportate e mappate automaticamente alla lingua base (es. de-DE, de-AT, de-CH → de). Per maggiori dettagli, consulta la documentazione sulla localizzazione.

v1.0.20 - 4 Gennaio 2026

Modifiche Breaking

Header di localizzazione - Migrazione a Accept-Language

L'header di localizzazione è stato migrato dall'header custom Invoicetronic-Language all'header HTTP standard Accept-Language (RFC 7231). Per maggiori dettagli, consulta la documentazione sulla localizzazione.

Azione richiesta: I client devono aggiornare le loro integrazioni per usare l'header Accept-Language invece di Invoicetronic-Language: - Prima: Invoicetronic-Language: it - Ora: Accept-Language: it

L'header custom Invoicetronic-Language non è più supportato. La lingua predefinita è ora italiano (in precedenza era inglese).

Novità

Supporto multi-lingua completo

Tutti i messaggi di errore di validazione sono ora disponibili in italiano e inglese. L'API risponde nella lingua specificata nell'header Accept-Language: - Accept-Language: it - Messaggi in italiano - Accept-Language: en - Messaggi in inglese

Se l'header è assente o contiene una lingua non supportata, l'API risponderà in italiano. Lingue attualmente supportate: italiano (it), inglese (en).

v1.0.19 - 2 Gennaio 2026

Correzioni

Log errori - Campo error più leggibile

Migliorato il campo error nei log per mostrare solo il messaggio di errore effettivo invece dell'intera risposta JSON. Il campo ora contiene il messaggio reale (es. "vat is required") invece del wrapper JSON completo, rendendo i log più leggibili. In caso di errori ProblemDetails, viene estratto il campo detail, altrimenti viene usato il campo title o, per risposte non-ProblemDetails, la risposta grezza (troncata a 500 caratteri).

v1.0.18 - 1 Gennaio 2026

Correzioni

Validazione campi obbligatori

Corretta la validazione dei campi obbligatori per restituire 400 Bad Request invece di 500 Internal Server Error quando i campi vat, fiscal_code, name (Company) o payload (Send/Receive) sono null. Questi campi erano già contrassegnati come obbligatori nel contratto API e nella specifica OpenAPI, ma la validazione non era correttamente applicata a runtime.

v1.0.16 - 9 Dicembre 2025

Modifiche

Invio fatture - Auto-compilazione DatiTrasmissione

Quando si invia una fattura senza specificare il campo file_name, il sistema ora aggiorna automaticamente i campi DatiTrasmissione nel XML se sono vuoti: - IdTrasmittente.IdPaese viene impostato a "IT" - IdTrasmittente.IdCodice viene impostato a "01180680397" (P.IVA Invoicetronic) - ProgressivoInvio viene impostato al contatore Base36 auto-generato

In precedenza, veniva generato solo il nome del file ma il contenuto XML rimaneva invariato. Questa modifica garantisce coerenza tra il nome del file e la struttura XML. I valori esistenti non vuoti vengono sempre preservati e mai sovrascritti.

v1.0.15 - 6 Dicembre 2025

Novità

Header Invoicetronic-Version

Aggiunto l'header Invoicetronic-Version a tutte le risposte API. I client possono ora verificare la versione dell'API e rilevare aggiornamenti leggendo questo header da qualsiasi risposta. Il numero di versione corrisponde alla versione di release dell'API (es. "1.0.15").

v1.0.14 - 6 Dicembre 2025

Correzioni

Webhook - Codifica payload

Corretta la codifica del payload webhook da UTF-16 a UTF-8 per la corretta verifica della firma HMAC. Il payload HTTP del webhook veniva inviato con Encoding.Unicode (UTF-16LE) mentre la firma HMAC veniva calcolata usando la codifica ASCII, rendendo difficile per i client verificare la firma. Ora sia il payload che il calcolo HMAC utilizzano la codifica UTF-8, che è lo standard per i payload JSON e garantisce una verifica coerente della firma.

v1.0.13 - 5 Dicembre 2025

Correzioni

Webhook - Supporto evento wildcard

Corretto il supporto per l'evento wildcard (*) nei webhook. I webhook configurati con l'evento * venivano accettati durante la creazione ma non venivano mai attivati. Ora i webhook con * nella lista degli eventi vengono correttamente attivati per tutti gli eventi.

SDK v1.1 / API v1.0.12 - 4 Dicembre 2025

Novità

Webhook - Campo resource_id

Aggiunto il campo resource_id alle notifiche webhook. I payload webhook ora includono l'ID della risorsa creata o modificata dalla richiesta.

Per esempio, per gli eventi update.add, il campo resource_id contiene l'ID dell'entità Update appena creata. Questo permette ai ricevitori webhook di recuperare direttamente i dettagli della risorsa senza dover fare matching basato su timestamp o altre euristiche.

v1.0.9 - 4 Dicembre 2025

Correzioni

Notifiche webhook per receive.add e update.add

Corretta un'anomalia che impediva l'invio corretto delle notifiche webhook per gli eventi receive.add e update.add. I webhook vengono ora attivati correttamente per il proprietario della risorsa.

v1.0.7 - 3 Dicembre 2025

Correzioni

Notifiche webhook con company_id null

Corretto un problema che impediva l'invio delle notifiche webhook quando la risposta API conteneva un valore company_id null. Ora i webhook vengono correttamente inviati anche in questi casi.

SDK v1.0 / API v1.0.0 - 14 Luglio 2025

Novità

Prima release ufficiale di Invoicetronic API con supporto completo per SDK in 8 linguaggi: C#, Python, PHP, Java, JavaScript, Ruby, Go, TypeScript.