Schémas personnalisés

Lorsque vous avez besoin de lire quelque chose d'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

• Document d'un fournisseur avec une mise en page non standard.
• Spécificité sectorielle : reçus de pesée, protocoles d'essai, cartes de carburant.
• Champs dont vous avez besoin dans votre système et qui n'apparaissent nulle part ailleurs.

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

Comment définir

Avec l'éditeur dans l'onglet Schémas. Il s'é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 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 champs des modèles ont des noms en anglais tout comme les schémas système, donc le formulaire de contrôle trouvera la description ; les descriptions des champs sont dans la langue de l'interface et peuvent être réécrites.

Les liens, allOf, oneOf, conditions et constructions similaires ne sont pas autorisés par l'éditeur ; le schéma doit être un arbre de champs plat. Une copie du schéma système porte aussi sa définition pour le modèle, donc elle est reconnue aussi bien que le modèle ; avec le bouton Dissocier, elle 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 sert non seulement à l'utilisateur, elle est lue aussi par le modèle. La différence entre "numéro de commande" et "numéro de commande, commençant par Z- et comportant six chiffres, généralement dans le coin supérieur droit près du code-barres" est énorme en termes de succès.

Limites

Le nombre de champs est régi 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 descriptions sont envoyés au modèle pour chaque document, donc un schéma plus long signifie un traitement plus coûteux.

Essais

L'éditeur vérifie la syntaxe en continu et ne permet pas l'enregistrement tant que le schéma n'est pas correct. Vous ne pouvez le tester que sur un vrai document : téléchargez-le avec le schéma sélectionné, ou pour un document déjà terminé, choisissez Traiter à nouveau. Les deux consomment des crédits comme un traitement normal.

Modifications et suppressions

Le schéma modifié est valide pour les traitements futurs. Les documents qui ont déjà été traités conservent les données telles qu'elles ont été créées. Un schéma selon lequel au moins un document a été reconnu ne peut pas être supprimé — les documents perdraient le formulaire de contrôle.