Les schémas : transformer un bon de commande EDI en champs que votre système attend
Chaque partenaire envoie le même 850 un peu différemment, et chaque système comptable veut sa propre forme. Le schéma est la petite pièce vérifiable au milieu.
Faire passer un fichier EDI de votre partenaire à vos systèmes, c’est la moitié facile d’une intégration. L’autre moitié, c’est de le remodeler : une date écrite AAAAMMJJ doit devenir une date que votre logiciel accepte, un code d’entrepôt doit devenir l’un de vos clients, une caisse de 12 doit devenir 12 unités. C’est ce que fait un schéma.
Qu’est-ce qu’un schéma ?
Un schéma décrit le document qu’attend votre système et, pour chacun de ses champs, d’où vient la valeur dans le document EDI. Chaque champ contient une courte expression écrite en JSONata, un langage de requête ouvert et documenté. La plupart tiennent sur une ligne : prendre tel élément, reformater telle date, chercher tel code.
| Champ de destination | Expression | Résultat |
|---|---|---|
| Date de commande | $formatDate("20261001", "YYYY-MM-DD") | 2026-10-01 |
| Heure de livraison | $formatDate("1345", "h:mm A") | 1:45 PM |
| Client | $lookupTable(12, "0412") | Centre de distribution Sumner |
| Unités commandées | 2 * 12 | 24 |
Les exemples utilisent des valeurs écrites en clair pour être lisibles ; dans un vrai schéma, chacun pointe plutôt vers l’élément du document du partenaire.
Comment en créer un
Décrivez la destination
Collez un exemple du JSON qu’attend votre système, ou son schéma JSON. Weredi en fait une structure vide, avec une case par champ, prête à remplir.
Rédigez chaque champ avec l’aide à portée de main
L’éditeur complète chaque fonction JSONata pendant que vous tapez, avec sa signature et un exemple, plus deux fonctions faites pour l’EDI :
$formatDateréécrit les dates et heures EDI,$lookupTabletraduit un code au moyen de l’une de vos tables.Essayez-le sur un vrai document
Choisissez un exemple de ce partenaire : l’éditeur montre la valeur produite par chaque champ, le nombre de passages de chaque groupe répété et tout champ vide ou invalide, avant même qu’une vraie commande y passe.
Traduisez les codes avec des tables de recherche
Quand un code du partenaire n’a pas encore de correspondance, l’éditeur le signale et vous permet d’ajouter la ligne sur-le-champ. L’expression est enveloppée dans
$lookupTablepour vous. Plus de détails sur les tables de recherche.N104PO1TD5
Les transformations dont vous aurez vraiment besoin
- Dates et heures. L’EDI écrit
20261001et1345; votre système veut 2026-10-01 et 13 h 45. - Codes. Un numéro de magasin ou de centre de distribution devient un client ou une adresse de livraison dans vos livres ; un code de transporteur devient un nom de transporteur.
- Unités et quantités. Une commande en caisses devient des unités, ou l’inverse.
- Lignes répétées. Chaque ligne
PO1devient une ligne dans votre système comptable, peu importe leur nombre. - Conditions. Utiliser l’adresse de livraison du partenaire quand elle est présente, votre entrepôt par défaut sinon.
- Texte. Joindre, rogner ou découper des noms et des références pour qu’ils entrent dans le champ de destination.
Partez du schéma par défaut du connecteur
Les connexions à QuickBooks Online, Xero, Sage et NetSuite viennent avec un schéma par défaut pour chaque sens et chaque document. Vous ne modifiez que ce que votre partenaire fait autrement, et vous pouvez revenir au schéma par défaut en tout temps. Voir l’intégration ERP et comptable.
Programmer à la main ou utiliser un schéma Weredi
Intégration programmée à la main
- Chaque différence de partenaire exige une modification de code et un déploiement
- Les essais se font sur de vraies commandes, après coup
- Les tables de codes vivent dans la tête d’un développeur ou dans un chiffrier
Un schéma Weredi
- Chaque champ est une expression lisible et modifiable
- Essayé sur l’exemple du partenaire avant de servir
- Les tables de codes sont des tables de recherche que vous pouvez modifier et compléter
Questions
Faut-il être développeur ?
Non, mais il aide d’être à l’aise avec les formules. La plupart des champs reprennent une valeur telle quelle ; l’éditeur complète les fonctions pendant que vous tapez et montre le résultat sur un vrai document.
Que se passe-t-il quand un partenaire modifie ses documents ?
Vous changez l’expression du champ qui a bougé, l’essayez sur un nouvel exemple de ce partenaire, puis enregistrez. Rien d’autre n’est redéployé.
Quels forfaits comprennent les schémas ?
Les schémas, les tables de recherche et les connexions comptables font partie de Weredi Plus et Entreprise, ainsi que de tout essai en cours.
Articles connexes
Tous les articles →Configurez une fois, puis laissez passer chaque commande
Les schémas et les tables de recherche font partie de Weredi Plus, tout comme les connexions à QuickBooks Online, Xero, Sage et NetSuite qu’ils alimentent.