Vai al contenuto
Torna al blog
FormatiPubblicato il 9 luglio 20266 min di lettura

Un’unica API per convertire i formati di fattura: qualsiasi formato in ingresso, una e-fattura conforme in uscita

Ogni paese vuole un formato di fattura elettronica diverso, ma il tuo ERP esporta sempre lo stesso CSV. Ecco come un’unica API di conversione dei formati di fattura risolve il problema.

Hai costruito l’export del tuo ERP una volta. Produce un CSV, o forse un file UBL, e per anni è andato bene. Poi la Francia ha imposto Factur-X. La Germania vuole XRechnung. L’Italia ha FatturaPA e il suo transito tramite SdI. La Polonia sta introducendo KSeF con il suo schema FA(3). La Spagna si aspetta Facturae. La Norvegia funziona con EHF su Peppol. Emirati Arabi Uniti, Oman e Singapore si stanno standardizzando su PINT.

Il tuo ERP non è cambiato. Il mondo intorno sì. E ora ogni nuovo cliente o paese con cui la tua azienda entra in contatto porta con sé una richiesta tecnica diversa, mentre il tuo team finanziario resta bloccato a esportare esattamente lo stesso file di sempre.

Perché i formati di fattura si sono frammentati in origine

Esiste uno standard europeo, EN 16931, che definisce un modello semantico comune per una fattura elettronica. In teoria, tutti concordano su cosa significhi un « importo netto » o un « identificativo IVA dell’acquirente ». In pratica, ogni paese avvolge quel modello nella propria sintassi, nei propri campi obbligatori e nelle proprie regole di validazione.

XRechnung e Factur-X si basano entrambi su EN 16931, ma non sono file intercambiabili. FatturaPA è precedente allo standard e usa interamente il proprio schema italiano. KSeF FA(3) è specifico della Polonia. Quindi « supportiamo la fatturazione elettronica » non è mai un solo lavoro. Sono una dozzina di lavori che partono tutti dagli stessi dati di origine e finiscono in file incompatibili. È proprio questa la lacuna che un’API di conversione dei formati di fattura è fatta per colmare: tu continui a esportare ciò che già esporti, e qualcos’altro si occupa della traduzione in ciò che ogni destinazione richiede.

Cosa significa davvero « qualsiasi formato in ingresso »

La parte complicata è di solito l’ingresso, non l’uscita. I veri sistemi contabili esportano dati datati e disomogenei: un CSV piatto con 40 colonne, un foglio Excel che un controller aggiorna a mano, EDIFACT da un vecchio impianto EDI, oppure UBL e CII strutturati da uno stack più recente. Alcuni inviano un PDF ZUGFeRD o Factur-X con l’XML incorporato all’interno.

Un’API di conversione che valga la pena legge tutto questo. MyInvoice accetta in ingresso CSV, Excel, EDIFACT, UBL, CII e PDF ZUGFeRD/Factur-X — e quando un fornitore ti invia un PDF ibrido, estrae l’XML dal file e lo normalizza nello stesso modello pulito. Quest’ultimo punto conta più di quanto sembri: una fattura elettronica che ricevi diventa un input valido, non solo qualcosa da archiviare. Puoi prendere un documento Factur-X o ZUGFeRD in ingresso e riemetterlo come Peppol BIS o XRechnung senza ricostruire la tua pipeline.

Un’API, ogni uscita conforme

Una volta che i tuoi dati sono analizzati nel modello comune, l’uscita è una scelta, non una ricostruzione. La stessa fattura di origine può uscire come:

  • Peppol BIS 3.0 per la rete Peppol
  • XRechnung per gli acquirenti della pubblica amministrazione tedesca
  • Factur-X / ZUGFeRD per Francia e Germania
  • FatturaPA per l’Italia
  • KSeF FA(3) per la Polonia
  • EHF per la Norvegia
  • PINT per Emirati Arabi Uniti, Oman e Singapore

Invii i dati una volta e scegli il formato alla fine. Quando un nuovo paese entra in vigore, cambi un parametro, non il tuo ERP.

Tieni il tuo sistema, risolvi l’ultimo miglio

Il punto non è sostituire il tuo software. È smettere di cablare un progetto di formato una tantum ogni volta che arriva un obbligo. Il tuo ERP continua a esportare il suo CSV. L’API si occupa dell’ultimo miglio, trasformando quell’export nel file esatto che un paese o la rete Peppol accetterà, e valida il risultato prima che tu lo invii.

Se il tuo team ha davanti un nuovo obbligo con lo stesso vecchio file di export, è esattamente questa la lacuna che si colma. Dai un’occhiata a MyInvoice e prova a convertire uno dei tuoi export reali nel formato che ti serve davvero.

Converti uno dei tuoi export nel browserLeggi la documentazione dell’API