write_checked_invoice.json
Le fichier JSON de l'exemple « Une facture qui demande avant de revendiquer ». La bibliothèque lit la facture telle qu'elle est et nomme, clause par clause, tout ce qui la sépare de Factur-X. Deux choses font obstacle, puis une, puis plus aucune — et c'est seulement alors qu'un fichier est écrit.
Ce fichier est une requête : une application l'envoie par le réseau au serveur, qui crée le PDF et le renvoie. Il donne la même page que les versions Rust et Python de cet exemple. Une requête nomme chaque fichier qu'elle emploie, jamais le contenu de ces fichiers ; l'appel porte la requête et les fichiers ensemble. Une police que le serveur détient déjà, comme DejaVuSans, se nomme sans rien y joindre. Envoyez la requête à l'adresse que donne la page de l'API.
Cette requête nomme des fichiers qu'elle ne contient pas : invoice_xml. Chacun voyage à côté de la requête, dans le même appel, comme une pièce fournie nommée exactement comme la requête la nomme ici — la description dit quel nom joue quel rôle, vous nommez donc vos fichiers comme vous voulez. Une requête qui nomme un fichier dont l'appel ne contient rien est refusée.
À quoi sert cet exemple
Tout autre document ici atteint une norme en la déclarant : le fichier dit qu'il est Factur-X, et il est écrit en Factur-X. Déclarer est facile ; avoir raison ne l'est pas. Un document peut nommer une facture qu'il n'a jamais jointe, revendiquer un niveau de détail que le XML à l'intérieur ne suit pas, et tenir dans un contenant que la norme n'autorise pas — et sortir en disant les trois, pour revenir refusé par le service comptable auquel il a été envoyé.
Ce que montre cet exemple
- Tous les constats d'un coup, chacun nommant la clause dont il vient et le fichier dont il parle.
- Deux obstacles à la première composition, un seul une fois le fichier contenu et la norme d'archivage revendiquée, aucun une fois que le niveau de détail revendiqué est celui que le XML suit.
- Le document mesuré avant qu'un seul octet n'en sorte, et refusé plutôt qu'écrit tant que quelque chose fait obstacle.