Factures, formats et documents
Une facture électronique contient des données structurées permettant son traitement automatique.
Le Flow Service peut manipuler plusieurs syntaxes de facture, notamment Factur-X, UBL et CII.
Les trois syntaxes principales
| Syntaxe | Forme générale | À retenir |
|---|---|---|
| Factur-X | PDF/A-3 avec données structurées embarquées | Associe une représentation lisible et des données structurées |
| UBL | XML structuré | Syntaxe XML couramment utilisée pour l'échange de factures |
| CII | XML structuré | Syntaxe Cross Industry Invoice utilisée dans les échanges normalisés |
Le choix du format dépend de votre SI, de vos flux et du contrat d'échange applicable.
Ces trois syntaxes peuvent être déposées avec la même opération POST /v1/flows. Le JSON flowInfo indique la syntaxe exacte du fichier :
| Format | Valeur de flowSyntax | Partie file |
|---|---|---|
| CII | CII | XML CII |
| UBL | UBL | XML UBL |
| Factur-X | Factur-X | PDF/A-3 complet contenant le XML structuré |
➡️ Voir le contenu de l'appel, les attributs facultatifs et les exemples par format
flowSyntax et flowType
Ces deux notions sont différentes.
flowSyntax décrit la syntaxe du document transmis, par exemple :
Factur-X
UBL
CII
CDAR
flowType décrit la nature métier du flux. Cette qualification est déterminée par la plateforme après réception du document.
Un client API ne doit donc pas essayer de déduire la nature métier d'un flux uniquement à partir de son extension de fichier.
Taille maximale des flux
Le Flow Service applique une taille maximale au fichier déposé. Cette limite dépend de la nature du flux.
flowType | Taille maximale |
|---|---|
CustomerInvoice | 100 MB |
SupplierInvoice | 100 MB |
StateInvoice | 100 MB |
CustomerInvoiceLC | 5 MB |
SupplierInvoiceLC | 5 MB |
StateLC | 5 MB |
Les factures disposent donc d'une limite sensiblement plus élevée que les flux de cycle de vie.
Un fichier qui dépasse la taille maximale applicable à son type de flux est refusé par le Flow Service.
L'intégrateur doit donc contrôler la taille du document avant son dépôt afin d'éviter un envoi voué à l'échec.
Ce tableau décrit uniquement les limites indiquées ci-dessus pour les flux de facture et de cycle de vie. Il ne faut pas en déduire une limite pour les FRR d'e-Reporting lorsqu'elle n'est pas explicitement documentée.
➡️ Déposer un flux avec le Flow Service
Original, représentation lisible et conversion
Selon la nature du flux et les capacités disponibles, le Flow Service peut permettre de récupérer plusieurs représentations :
- Original : le document tel qu'il a été reçu ou déposé ;
- ReadableView : une représentation lisible lorsqu'elle est disponible ;
- Converted : une représentation convertie lorsqu'une conversion est proposée ;
- UBL : une représentation UBL lorsqu'elle est exposée par le service.
Ces représentations ne doivent pas être confondues avec le statut de traitement du flux.
Facture et cycle de vie sont deux flux différents
La facture transporte les données de facturation.
Les événements qui décrivent son évolution métier sont échangés séparément, notamment via des flux de cycle de vie.
➡️ Typologie des flux
➡️ Déposer, rechercher et récupérer
➡️ Cycle de vie et statuts