UMI.CMS et 1C avec Eofferix : catalogue, external

Ce guide concerne le flux catalogue 1C -> Eofferix -> UMI.CMS. Utilisez-le lorsque 1C exporte produits, sections, offres, prix, stocks, images et propriétés, et qu’une correspondance fiable entre produits, offres et commandes est nécessaire.

Si le module UMI.CMS n’est pas encore installé, commencez par Importer un catalogue dans UMI.CMS avec Eofferix. Cette page se concentre sur le scénario 1C : identifiants, profils complet et mises à jour, et contrôles avant une commande de test.

Ce Que Fait Eofferix

Eofferix reçoit le catalogue depuis 1C, lit import.xml, offers.xml et les archives d’images, applique les règles du snapshot et envoie les éléments préparés au module UMI.CMS installé. Le module écrit le résultat dans le catalogue du site.

Eofferix ne prend pas en charge l’échange des commandes. Les commandes doivent être envoyées vers 1C par l’intégration native des commandes entre UMI.CMS et 1C. Eofferix doit d’abord charger le catalogue afin que UMI.CMS puisse transmettre à 1C des identifiants reconnaissables du produit et de l’offre choisie.

Résultat Attendu

Après configuration, un produit 1C doit être retrouvé sur le site par la clé choisie, chaque offre doit être liée à son produit, et le prix, le stock et les propriétés de variante doivent être stockés sur l’offre. Un import répété sans changement doit ignorer rapidement les éléments inchangés.

Pour les commandes, le nom du produit et l’article visible ne suffisent pas. UMI.CMS a besoin des identifiants 1C natifs du produit et de l’offre choisie. Sans eux, 1C peut recevoir une commande sans article reconnu ou créer un doublon.

Ordre Minimal De Configuration

Connectez le site UMI.CMS et attendez une vérification de connexion réussie.
Sélectionnez le type de données UMI.CMS pour les produits et celui des sections.
Pour les produits 1C, sélectionnez external_id dans les champs d’identification produit.
Pour les offres, sélectionnez external_id de l’offre dans les champs d’identification.
Dans le snapshot, marquez les rôles section, produit et offre.
Liez prix, stock et propriétés de variante dans le rôle d’offre.
Lancez une petite exportation de test avant le profil complet.

Champs D’identification

Champ	Utilisation	Important
`external_id` produit	Clé principale du produit depuis 1C.	C’est généralement ce dont UMI.CMS a besoin pour reconnaître le produit dans une commande.
`external_id` offre	Clé d’une variante : taille, couleur, emballage ou autre option.	Le produit et l’offre ont des valeurs différentes. Ne les mélangez pas.
Article produit `artikul`	Champ produit normal dans les modèles de données UMI.CMS.	À utiliser pour la recherche seulement si le métier fait vraiment la correspondance par article produit.
Article d’offre `vendor_code`	Article système de l’offre dans UMI.CMS.	C’est l’article visible de l’offre. Il ne remplace pas `external_id` pour les commandes 1C.
Clé de service Eofferix `guid`	Correspondance interne dans Eofferix.	Ce n’est pas un champ d’échange des commandes UMI.CMS et 1C.
ID de page UMI `id`	ID interne dans une installation UMI.CMS.	À utiliser seulement pour un chargement retour vers le même site.

Règle Principale De Recherche

Eofferix recherche les produits, sections et offres existants uniquement par les champs choisis dans le modèle. Si external_id est sélectionné, la recherche utilise external_id. Si un article est sélectionné, elle utilise cet article. Le service ne doit pas passer silencieusement à vendor_code, sku ou un autre champ.

Si aucun champ d’identification de section n’est sélectionné, il est plus sûr d’utiliser le chemin complet des sections après transformations. Ainsi Electronics / Other et Sensors / Other ne sont pas fusionnés par erreur.

Rôles Dans Le Snapshot

Dans le catalogue complet, marquez trois rôles : section, produit et offre. Liez l’identifiant produit à external_id produit. Liez l’identifiant offre à external_id offre.

Les variables et transformations peuvent préparer les clés avant export. Vérifiez la valeur transformée, pas la valeur XML brute.

Rôles produit et offre dans le snapshot XML 1C

Configurer La Liaison De L’offre Au Produit

Une offre n’est pas le premier produit de la liste ni une copie du produit parent. C’est une variante séparée avec son propre identifiant, prix, stock et propriétés. Si les offres sont imbriquées dans les produits, marquez-les avec le rôle d’offre. Si produits et offres arrivent séparément dans import.xml et offers.xml, configurez la clé qui relie l’offre au produit.

1C transmet sa propre clé produit sous la forme productGuid#offerGuid. Pour l’intégration, nous recommandons de l’utiliser pour l’export vers external_id (clé de l’offre) et vers product_external_id (clé qui relie l’offre au produit).

Propriétés, Prix Et Stock D’offre

Les propriétés produit vont au produit, celles de section à la section, et celles d’offre à l’objet de données de cette offre. Utilisez les champs d’offre renvoyés par le site UMI.CMS connecté. Taille, couleur, prix d’offre, stock d’offre et vendor_code ne doivent pas être écrits par erreur sur le produit parent.

Lier une valeur source à un champ UMI.CMS

Catalogue Complet Et Mises À Jour

Pour les projets 1C, utilisez deux profils lorsque c’est possible. Le premier reçoit le catalogue complet et peut posséder le catalogue du site. Le second reçoit seulement les changements et ne doit pas prendre la propriété au profil complet.

Réglage	Catalogue complet	Échange de changements
Source	Fichier ou échange contenant tout le catalogue actuel.	Export 1C séparé avec seulement les objets modifiés.
Scénario	Synchronisation complète de la source.	Mise à jour prudente sans nettoyage complet.
Propriété du profil	Activée quand ce profil possède le catalogue.	Désactivée si le profil complet doit rester propriétaire.
Suppression des absents	Seulement dans cette source et avec une limite de protection.	Généralement désactivée. Absent du fichier de changements ne veut pas dire supprimé.
Stock zéro	Peut suivre les règles du catalogue complet.	Appliquer seulement aux objets présents dans l’échange actuel.
Images	Supprimer les images absentes seulement si la source est complète.	Conserver les images existantes si elles sont simplement absentes du fichier de changements.

Deux Sources

Créez ou conservez la source pour le catalogue complet 1C.
Créez une deuxième source pour les changements.
Configurez 1C pour envoyer l’export complet vers la première source et les changements vers la deuxième.
Copiez le profil complet pour conserver types, rôles et champs.
Basculez la copie vers la source de changements.
Désactivez les options qui donnent au profil de changements la propriété du catalogue ou lancent un nettoyage complet.
Testez un petit changement : prix, stock, une propriété ou une image.

Nettoyage Et Images

La suppression doit être activée seulement lorsque la source est une vérité complète. Dans un fichier partiel 1C, un produit ou une image absent signifie souvent inchangé, pas supprimé.

N’activez pas le nettoyage complet dans le profil de changements. Si la source envoie seulement les produits modifiés, le nettoyage complet peut considérer le reste du catalogue comme absent.

Forcez la suppression des images absentes seulement pour un catalogue complet avec un jeu d’images garanti. Si une archive d’images n’arrive pas temporairement, ce réglage peut supprimer les images déjà chargées sur le site.

Réglages avancés des images pour UMI.CMS

Un export de test normal ne lance pas le nettoyage des objets absents. Si Test comme lancement complet est activé, les règles du lancement complet s’appliquent à l’échantillon limité : le nettoyage peut toucher les produits, offres, sections et images absents dans le périmètre choisi.

Le module Eofferix pour UMI.CMS ne supprime pas les propriétés, les caractéristiques ni les valeurs de dictionnaire. Il peut associer une propriété ou une valeur existante, ou créer celle qui manque, mais il ne supprime ni ne détache les propriétés et valeurs créées lors des exécutions suivantes. Les règles concernant les produits, offres, sections et images absents fonctionnent séparément.

L’import dans UMI.CMS ne permet pas de revenir à l’état d’une exécution précédente et ne crée pas de point de retour arrière. Un lancement arrêté ne peut reprendre que si un point de reprise confirmé existe ; sinon, corrigez la cause et lancez un nouvel import normal. Sauvegardez le site et la base de données avant un lancement complet avec des règles de suppression.

Import Répété Et Coût

Après le premier import, les lancements suivants doivent retrouver les produits et offres existants. Si les données transformées n’ont pas changé, l’élément doit passer par l’action moins chère UMI.CMS · élément inchangé. Si chaque lancement recrée le catalogue, vérifiez les champs d’identification et l’enregistrement de external_id.

Vérifier Dans UMI.CMS

Ouvrez un produit dans l’administration UMI.CMS.
Vérifiez que l’identifiant 1C du produit est rempli.
Ouvrez les offres et vérifiez qu’elles sont créées dans le produit.
Vérifiez external_id, vendor_code, prix et stock de l’offre choisie.
Vérifiez que les propriétés de variante sont sur l’offre, pas sur le produit parent.
Ouvrez les images du produit et vérifiez que les fichiers sont réellement visibles dans UMI.CMS.

Commande De Test

Passez une commande pour une offre précise sur le site de test.
Envoyez la commande vers 1C par l’intégration native des commandes entre UMI.CMS et 1C.
Dans 1C, confirmez que la commande correspond à un produit existant et à la variante choisie.
Si 1C crée un nouveau produit ou reçoit une commande sans article, revenez aux identifiants produit et offre.

Si La Commande Ne Correspond Pas

Symptôme	À vérifier
La commande n’a pas d’article	Si `external_id` du produit et de l’offre choisie sont remplis dans UMI.CMS.
1C crée un nouveau produit	Quelle clé externe UMI.CMS a envoyée et si cette clé existe dans 1C.
La commande utilise le produit sans variante	Si les offres existent et si la boutique sélectionne une offre précise.
Le stock existe sur produit mais pas sur offre	Si le stock d’offre a été écrit dans le champ du produit parent.
Un import répété crée des doublons	Si les champs d’identification choisis correspondent aux valeurs réellement chargées.
Les images ont disparu	Si la suppression forcée des images est activée dans un profil partiel.

Liste Finale

Le profil complet charge sections, produits, offres, prix, stocks, propriétés et images.
Chaque produit a son propre external_id.
Chaque offre a son propre external_id.
vendor_code sert d’article d’offre, mais ne remplace pas l’identifiant 1C.
Les propriétés d’offre sont enregistrées sur l’offre précise, pas sur le produit parent.
Le profil de changements ne lance pas de nettoyage complet et ne prend pas la propriété du catalogue.
Un import répété sans changement est facturé comme éléments inchangés.
Une commande de test dans 1C correspond à un produit existant et à l’offre choisie.