Generatore UBL — ogni caso di business francese, come documento eseguibile

La riforma fornisce un elenco di situazioni di business che una fattura può codificare — i cas d'usage della XP Z12-014 — e una tabella di campi. Quello che non fornisce è una fattura conforme per ciascuna. Così, la prima volta che costruite una fattura di acconto, una fattura ceduta in factoring o un'autofattura, scoprite se avete fatto bene nel momento in cui viene respinta.

Questa pagina colma quel vuoto. Scegliete una situazione di business, leggete che cosa succede davvero e perché la riforma la tratta come un caso a sé, e portate via l'XML UBL 2.1 conforme a EN 16931 e l'esatta chiamata POST /v1/documents/send che lo produce. 59 scenari, che coprono tutti i 45 cas d'usage numerati più i nove fondamentali di cui ogni integrazione francese ha bisogno dal primo giorno.

Perché un generatore e non solo un elenco di campi

Una fattura elettronica francese non è un unico documento con qualche opzione. Gli stessi 10.000 € di lavoro producono un documento materialmente diverso a seconda che si tratti di un acconto, di una fattura finale che scomputa quell'acconto, di un'autofattura, di una fattura ceduta a un factor o di una fattura di subappalto in inversione contabile — codice tipo diverso, cadre de facturation diverso, parti diverse, categoria IVA diversa, ciclo di vita diverso. Ognuna di queste scelte ha una conseguenza giuridica, e ognuna ha una regola che vi respinge se sbagliate.

Tre errori ricorrono più di tutti, e tutti e tre sono decisioni di business prima che tecniche:

Come usarlo

1. Trovate la vostra situazione. Filtrate per tema, o cercate quello che state davvero facendo — «acconto», «factoring», «autofatturazione», «inversione contabile», «Riunione».
2. Leggete la descrizione di business. Che cosa succede, perché la riforma se ne occupa, che cosa va storto e quali campi lo veicolano. Se quella sezione non corrisponde alla vostra situazione, avete il caso sbagliato — continuate a cercare prima di scrivere codice.
3. Prendete gli artefatti. L'XML UBL contro cui validare e la richiesta di invio da lanciare. Entrambi sono già conformi: un diff con il vostro output è l'elenco esatto di ciò che vi manca.

Il generatore

Il cadre de facturation — il campo più «di business» della fattura

Ogni fattura elettronica francese dichiara di che tipo di operazione si tratta, in un solo codice (BT-23, veicolato da cbc:ProfileID). La prima lettera indica Beni, Servizi o Misto; la cifra indica la situazione. È la risposta della riforma stessa alla domanda «che cosa sto guardando?», e determina quali regole si applicano — motivo per cui il generatore lo imposta per scenario invece di mettere tutto a S1.

Fonte: BR-FR-08. Inviare una fattura senza cadre, o con un cadre che contraddice l'esigibilità dell'IVA (BT-8), è lo scarto silenzioso che colloca l'IVA nel periodo sbagliato su entrambi i lati.

I tipi di fattura — e perché «basta mandare 380» non funziona

La Francia accetta un elenco chiuso di tipi documento (BT-3, BR-FR-04). Qualunque altro codice UNTDID 1001 viene respinto. L'elenco è breve ma portante: è ciò che dice a tutta la catena a valle che un documento è un acconto, un'autofattura, una fattura ceduta o una rettifica — prima ancora che qualcuno legga un importo.

Le tre menzioni che ogni fattura francese deve riportare

La regola BR-FR-05 impone almeno tre note, ciascuna qualificata da un codice soggetto (BT-21), su ogni fattura francese. Sono menzioni legali del Code de commerce, non formattazione — e sono la prima causa di fallimento di una fattura peraltro corretta secondo EN 16931, perché gli ERP costruiti per altri mercati non hanno alcun campo per veicolarle.

<cbc:Note>#PMT#Indemnité forfaitaire pour frais de recouvrement en cas de retard de paiement : 40 EUR (art. L441-10 du Code de commerce).</cbc:Note>
<cbc:Note>#PMD#Pénalités de retard : trois fois le taux d'intérêt légal, exigibles le jour suivant la date d'échéance.</cbc:Note>
<cbc:Note>#AAB#Escompte pour paiement anticipé : néant.</cbc:Note>
<cbc:Note>#BAR#B2B</cbc:Note>

In UBL il codice soggetto e il testo condividono un unico cbc:Note, con il codice veicolato da un prefisso #CODE#. La quarta nota qui sopra non è richiesta da BR-FR-05 ma conta altrettanto: BAR dichiara su quale lato della riforma si collochi il documento (BR-FR-20).

IVA — le categorie accettate in Francia e quando l'imposta diventa esigibile

La Francia restringe l'elenco delle categorie IVA di EN 16931 (BR-FR-15) e fissa le aliquote accettate (BR-FR-16). Ogni categoria diversa da S e Z richiede una motivazione e un codice VATEX — una fattura che non addebita IVA senza dire perché viene respinta, e giustamente: la motivazione è ciò che rende l'esenzione difendibile in verifica.

Quando l'IVA diventa esigibile (BT-8)

Questo singolo codice determina in quale periodo di liquidazione finisce la fattura, per entrambe le parti. I beni sono imponibili alla consegna; i servizi all'incasso, salvo che il venditore abbia optato per la TVA sur les débits. Sbagliarlo non fa fallire la validazione — colloca semplicemente l'IVA nel mese sbagliato.

Usarlo dall'API

Lo stesso referenziale è servito dall'API, così potete collegarlo alla vostra suite di test invece di copiare XML da un browser. Il referenziale e il generatore non richiedono alcuna chiave API — sono funzioni pure, senza accesso ai dati di nessuno.

Elencare tutti i casi di business

curl https://back.flowie.ink/exchange/v1/tools/fr/ubl/scenarios

Filtrate con ?theme=, ?family=, ?channel=e-reporting, ?case=20, oppure cercate nelle descrizioni di business con ?q=factoring.

Generare un caso con le vostre parti

curl -X POST https://back.flowie.ink/exchange/v1/tools/fr/ubl/generate \
  -H "Content-Type: application/json" \
  -d '{
    "scenarioId": "uc-21-final-after-deposit",
    "number": "FA-2027-0042",
    "issueDate": "2027-03-01",
    "seller": { "name": "Ma Société SAS", "siret": "55210055400013" },
    "buyer":  { "name": "Mon Client SA",  "siret": "39158000400021" }
  }'

La risposta contiene la descrizione di business, il modello di fattura, l'XML UBL, i totali calcolati e il corpo POST /v1/documents/send che la invia. Gli schemi degli identificativi restano fissi: una sovrascrittura non può mai produrre una parte il cui SIRET e SIREN si contraddicono (BR-FR-09).

Generare e validare in una sola chiamata

curl -X POST https://back.flowie.ink/exchange/v1/tools/fr/ubl/generate-and-validate \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{ "scenarioId": "uc-10-factoring" }'

Questa richiede una chiave, perché chiama il servizio di schematron per vostro conto. Usatela come risposta di riferimento quando il vostro output per lo stesso caso viene respinto: generate lo scenario, validate entrambi, confrontate. Per validare una fattura che avete costruito voi, usate POST /v1/documents/validate.

Che cosa significa «valido» qui

Ogni documento generato attraversa gli stessi quattro cancelli di una fattura reale:

1. XSD — è strutturalmente una fattura UBL 2.1? UBL è tipizzato per sequenza: un elemento nell'ordine sbagliato fallisce qui, prima che venga eseguita una sola regola di business.
2. Schematron del profilo EN 16931 — i totali tornano (BR-CO-*), ogni riga esente dà una motivazione, ogni ripartizione IVA è coerente?
3. Regole BR-FR — lo strato francese: le menzioni legali, gli elenchi chiusi di codici tipo e di cadres, la coerenza SIRET/SIREN, le aliquote IVA accettate.
4. Controlli di campo CIUS-FR — i campi che la Francia rende legalmente obbligatori mentre EN 16931 li lascia facoltativi: il codice di esigibilità, la data di scadenza, forma giuridica e capitale sociale del venditore, SIREN e indirizzo di instradamento dell'acquirente.

Che cosa il generatore non fa

• Non verifica i vostri dati nell'annuaire. Le regole BR-FR-10 e BR-FR-11 richiedono che i SIREN di venditore e acquirente siano presenti e attivi nella directory del PPF. È una consultazione in tempo reale — vedi instradamento & annuaire.
• Non emette stati del ciclo di vita. Ogni scenario elenca gli stati 200–213 che innesca, ma emetterli resta compito della vostra integrazione — vedi l'esploratore del ciclo di vita e il playbook di integrazione.
• Non produce Factur-X. Gli esempi sono in UBL. Flowie genera Factur-X dagli stessi dati in fase di invio; se vi serve la sintassi CII, inviate con format: "cii-xml".
• I casi multi-venditore sono una forma di partenza, non una risposta finita. I cadres S8/B8/M8 attivano un'intera famiglia di regole aggiuntive (BR-FR-MV-01–BR-FR-MV-12) con identificativi venditore a livello di riga e righe di raggruppamento. Validate prima di costruirci sopra.

Riferimenti

• I 45 cas d'usage, per esteso — il referenziale che questo generatore implementa, con gli approfondimenti per tema.
• Francia · PPF & PA, panoramica — scadenze, campi obbligatori, instradamento, e-reporting.
• Esploratore del ciclo di vita — stati 200–213, chi deve emettere che cosa.
• Playbook di integrazione — accreditamento, invio, e-reporting, go-live.
• Tipi di documento — ogni tipo che Flowie invia, autofatturazione compresa.
• FNFE-MPE — l'associazione che pubblica il CIUS francese e gli schematron.
• impots.gouv.fr · facturation électronique — le pagine di riferimento della DGFiP e le Spécifications externes B2B.