Termini di business — l'intero modello EN 16931, e cosa ne fa la Francia

Una fattura elettronica non è l'immagine di una fattura. È un elenco di valori con un nome che il software del destinatario legge, e la norma europea EN 16931 assegna un numero a ciascuno: BT-1 è il numero della fattura, BT-9 la data di scadenza, BT-121 il codice che spiega perché una riga non porta IVA. Il vostro commercialista li conosce come le mentions obligatoires; il sistema del vostro cliente li conosce come i campi su cui paga; un validatore ve li cita quando rifiuta un documento.

Tutte le altre pagine li nominano uno alla volta — questo caso d'uso ruota attorno a BT-25, questo campo API è BT-9. Questa pagina è l'elenco completo: tutti i 30 gruppi e tutti i 164 termini di business, ciascuno con il percorso UBL in cui si trova, se la Francia lo rende obbligatorio e in base a quale regola, e il campo di POST /v1/documents/send che lo porta.

Come leggere una riga

Due colonne portano il giudizio, ed entrambe dicono qualcosa di più stretto di quanto sembri.

Obbligatorio non significa che dovete digitarlo. Diversi termini che la Francia richiede sono completati da Flowie: i totali del documento, la numerazione delle righe, la ripartizione IVA. La colonna Flowie vi dice quali dovete davvero dichiarare — tutto ciò che è marcato sent spetta a voi, e tutto ciò che è xml-only è oggi una lacuna che dovete colmare da soli.

La colonna cardinalità è quella di EN 16931, non quella francese. Le due divergono di proposito: la norma lascia facoltativa la via del venditore, la Francia ne fa una mention obligatoire. Leggete la cardinalità per la forma della sintassi e la colonna Francia per l'obbligo.

Tutti i termini di business

Raggruppati come li raggruppa la norma — prima l'intestazione della fattura, poi ogni BG, poi la riga. La ricerca copre l'identificativo, entrambe le denominazioni, il percorso UBL, la nota francese e il campo API: autoliquidation, TaxSubtotal e BT-121 trovano quindi la stessa riga.

Le quattro menzioni aggiunte dalla riforma

La Francia richiedeva già 24 mentions obligatoires su una fattura cartacea, e EN 16931 le porta tutte. La riforma ne ha aggiunte quattro, e sono le quattro che un ERP progettato per la fatturazione elettronica altrove rischia di più di omettere:

1. Il SIREN del venditore — BT-30, schema 0002. BR-FR-09 richiede poi che le prime nove cifre del SIRET in BT-29 gli siano uguali.
2. Il SIREN dell'acquirente — BT-47. BR-FR-11 lo vuole presente e attivo nell'annuaire.
3. L'indirizzo di consegna quando differisce da quello di fatturazione — BG-15, obbligatorio su una fattura di beni ai sensi di BR-FR-14.
4. La natura dell'operazione — beni, servizi o entrambi. È il cadre de facturation di BT-23 (BR-FR-08): B1 beni, S1 servizi, M1 misto, e le varianti numerate per acconti, fatture già pagate e subappalto.

Altre due vengono dimenticate quasi altrettanto spesso, e nessuna è nuova — solo verificata da poco. BR-FR-05 rende tre menzioni legali obbligatorie su ogni fattura (l'indennità forfettaria di recupero di 40 €, gli interessi di mora, e lo sconto per pagamento anticipato o la dichiarazione che non ce n'è), portate da note BT-21/BT-22. E BR-FR-20 impone una nota BAR che dichiara a quale regime appartiene il documento. Vedere le tre menzioni legali per la formulazione esatta.

Cosa non è questo elenco

• È la fattura, non i flussi attorno. La colonna Francia è l'obbligo sul flux 1 — la fattura che un venditore deposita. L'e-reporting (flux 10) e gli stati del ciclo di vita 200–213 portano dati propri con regole proprie.
• Le estensioni francesi non sono BT. AFNOR aggiunge campi oltre EN 16931 — il sotto-tipo di riga multi-venditore EXT-FR-FE-163 e la sua famiglia — numerati in uno spazio proprio. Sono nominati nei casi d'uso che ne hanno bisogno.
• Un BT viene reso solo se il vostro template dichiara uno spazio per lui. Il mapping riempie gli spazi che il vostro template possiede; non ne crea di nuovi. Se un valore che inviate non compare, chiedete quali campi BT-* il vostro template dichiara.
• Non esiste BT-4. Il modello pubblicato non lo assegna. L'elenco è completo senza di esso — non avete perso una riga.

Usarlo dall'API

Lo stesso referenziale, dalla stessa fonte, senza chiave API — è un catalogo, non i vostri dati:

# tutto il modello
curl https://api.get-flowie.com/v1/tools/fr/ubl/business-terms

# solo ciò che la Francia rende obbligatorio, a livello di riga
curl "https://api.get-flowie.com/v1/tools/fr/ubl/business-terms?fr=mandatory&scope=line"

# un singolo termine
curl https://api.get-flowie.com/v1/tools/fr/ubl/business-terms/BT-121

Ogni voce porta id, name, nameFr, group, scope, cardinality, ubl, fr + frNote, e api + apiState. Filtri: group, scope, fr, mapped, q.

La tabella qui sopra legge lo stesso elenco come asset statico — assets/fr-business-terms.json — da recuperare se volete il referenziale senza chiamare nulla.

Riferimenti

• EN 16931-1:2017/A1:2019 — il modello semantico dei dati da cui provengono questi identificativi.
• Schematron FNFE v1.3.0 (XP Z12-012) — le regole BR-FR-* che la colonna Francia nomina. Il generatore UBL valida ogni esempio contro di esse.
• AFNOR XP Z12-014 v1.4 — i 45 casi d'uso, che decidono quali di questi termini una data fattura deve portare.
• POST /v1/documents/send — la mappatura campo per campo, nell'altro senso.