Schémas personnalisés

Lorsque vous avez besoin de lire quelque chose sur un document qui n'est pas dans les schémas système, vous définissez le vôtre.

Quand cela a-t-il du sens

• Un document d'un fournisseur avec une mise en page non standard.
• Spécialité sectorielle : bons de pesée, protocoles d'essai, cartes de carburant.
• Champs nécessaires à votre système qui n'apparaissent nulle part ailleurs.

Gardez à l'esprit qu'un document avec un schéma personnalisé ne peut pas être envoyé à la comptabilité ou exporté dans des formats comptables — ceux-ci ne lisent que les champs fixes de la facture. Les formats disponibles restent JSON, XML, YAML, CSV, Excel et PDF. Seul un document avec le champ numérique TotalAmount est pris en compte dans les rapports.

Comment définir

Utilisez l'éditeur dans l'onglet Schémas. On écrit en JSON Schema — un objet avec properties, pour chaque champ type et description, des listes comme array avec items. Ceux qui connaissent le standard ne seront pas surpris ; ceux qui ne le connaissent pas commenceront à partir d'un modèle (facture, facture avec TVA, reçu, bon de livraison, minimum) ou d'une copie du schéma système.

Les références, allOf, oneOf, conditions et autres constructions similaires ne sont pas autorisées dans l'éditeur ; le schéma doit être un arbre plat de champs. Une copie du schéma système emporte également sa définition pour le modèle, ce qui permet une reconnaissance aussi bonne que celle du modèle ; en utilisant le bouton Dissocier, cela devient un schéma personnalisé ordinaire.

La description du champ est un guide pour le modèle

C'est la chose la plus importante de toute la page. description ne sert pas seulement à l'utilisateur, mais elle est également lue par le modèle. La différence entre "numéro de commande" et "numéro de commande, commençant par Z- et ayant six chiffres, se trouve en haut à droite à côté du code-barres" a un impact énorme sur le succès.

Limites

Le nombre de champs est déterminé par le tarif : 80 pour Free et Starter, 160 pour Business, 240 pour Scale. Les champs imbriqués et les champs d'articles sont également comptés. Les noms et les descriptions sont transmis au modèle pour chaque document, donc un schéma plus long signifie un traitement plus coûteux.

Test

L'éditeur vérifie la syntaxe en continu et n'autorisera pas l'enregistrement tant que le schéma n'est pas valide. Vous ne pouvez le tester que sur un document réel : téléchargez-le avec le schéma sélectionné, ou pour un document déjà finalisé, choisissez Re-traiter. Dans les deux cas, cela consomme des crédits comme un traitement normal.

Modifications et suppression

Un schéma modifié s'applique au traitement ultérieur. Les documents qui ont déjà été traités conservent les données telles qu'elles ont été créées. Un schéma sous lequel au moins un document a été reconnu ne peut pas être supprimé — les documents perdraient le formulaire de contrôle.