Configurer les templates d’import

Dans Paramètres › Imports, choisissez Produits, Articles, Commandes ou Réceptions pour gérer les formats de colonnes utilisés par vos imports. Votre rôle doit autoriser la modification des paramètres.

Les traductions de valeurs, par exemple « navy » vers « Bleu marine », se gèrent séparément dans Paramètres › Classifications › Correspondances de valeurs.

Créer un template#

Les pages Produits, Articles, Commandes et Réceptions présentent les templates dans un tableau. Recherchez un template par son nom ou cliquez sur l’en-tête Nom pour inverser le tri. Cliquez sur une ligne pour ouvrir sa configuration.

Chaque liste possède une adresse dédiée sous /settings/import_templates : /products, /variants, /orders et /receipts. La recherche et le tri conservent cette adresse.

Depuis la liste de l’usage concerné, cliquez sur Nouveau dans la barre de titre. Ce bouton n’apparaît pas sur l’accueil Imports. Chaque liste possède son formulaire de création, par exemple /products/new, et ses formulaires d’édition, par exemple /products/7/edit. Le type de template est déterminé par l’adresse : aucun champ Usage n’est à remplir.

Saisissez un nom. Le tableau des correspondances est disponible dès la création et affiche un état vide tant qu’aucun champ n’a été ajouté. Cliquez sur Ajouter dans l’en-tête de la carte pour créer une ligne, puis enregistrez le nom et les correspondances ensemble.

Le fournisseur se choisit sur l’import ou dans la configuration EDI. Le template décrit le format et peut être partagé entre plusieurs fournisseurs.

Ajoutez ses correspondances de champs dans le tableau éditable : une ligne représente une correspondance. Les lignes conservent leur ordre de saisie ; ce tableau de formulaire n’est pas triable. Pour chaque correspondance, renseignez :

• les champs sources, dans les données lues du fichier ;
• le champ Apitail à alimenter ;
• la conversion à appliquer ;
• les correspondances de valeurs, si le champ reçoit une valeur d’option.

Pour le coloris, ciblez supplier_color dans le template Produit et conservez la conversion Copier la valeur. Le libellé fournisseur est enregistré tel quel dans l’attribut Coloris fournisseur ; la couleur standard est ensuite déterminée par les correspondances de l’attribut Couleur standard, communes à tous les fournisseurs de l’organisation. Une correspondance manquante ne bloque pas l’import. Son ajout ultérieur classe les produits existants sans relire le fichier. Pour accepter des libellés fournisseur inconnus, laissez la création de valeurs autorisée sur l’attribut Coloris fournisseur.

Pour prévoir une source de repli, séparez les noms par des virgules. La première source renseignée est retenue. Par exemple, name, short_name utilise le nom court seulement si le nom est vide. Les champs imbriqués utilisent un point, comme header.sales_order_number.

Les conversions disponibles sont la copie, la quantité entière, la date, le prix en centimes et la date de livraison avec le contrôle des dates exceptionnelles. Les sources et destinations dépendent du format lu : vérifiez leur nom dans un fichier représentatif avant de changer un template utilisé.

Cliquez sur Enregistrer dans la barre de sauvegarde. Modifier un template agit sur les imports qui l’utiliseront ensuite ; cela ne modifie pas les documents déjà créés.

Choisir les templates d’un import#

Pour un fichier CSV, sélectionnez les templates dans le formulaire de dépôt. Laissez Format CSV standard si le fichier suit le modèle fourni. Les contrôles habituels restent appliqués après les correspondances de colonnes.

Pour EDI, ouvrez Paramètres › Intégrations › EDI et choisissez les templates dans la configuration du partenaire. Le lecteur du format conserve la responsabilité du regroupement des lignes et des contrôles métier.

Bestseller#

La reprise initiale prépare quatre mappings : Produit, Article, Commande et Réception. Le catalogue PRICAT utilise Produit et Article ensemble ; ORDRSP utilise Commande et DESADV utilise Réception. Les templates peuvent être partagés ; les correspondances de valeurs sont communes à tous les fournisseurs d’une même organisation.

Les chemins des sources EDI concernent les données normalisées par le lecteur. Cet écran ne permet pas de modifier les sélecteurs XML du lecteur. Les champs que le lecteur connaît mais que l’import n’utilisait pas ne sont pas activés automatiquement par la reprise.