Charger des données dans SAP Commerce Cloud : ImpEx, Hot Folders et API

SAP Commerce Cloud offre quatre façons d’importer des données. ImpEx pour les chargements en masse. Les Cloud Hot Folders pour les flux de fichiers planifiés. Les API REST OCC pour les modifications unitaires en temps réel. SAP Integration Suite lorsqu’un flux traverse plusieurs systèmes, typiquement Commerce et l’ERP. Choisir la mauvaise méthode casse rarement quelque chose le premier jour, mais la solution devient plus lente et plus difficile à maintenir à chaque version.

Voici comment fonctionne chaque méthode, où elle s’applique, et les erreurs que nous trouvons le plus souvent lorsque nous reprenons un projet Commerce Cloud existant.

En bref : ImpEx pour les chargements initiaux, les migrations et la préparation des environnements. Les Cloud Hot Folders pour les flux de fichiers récurrents venant d’un PIM, d’un WMS ou de l’ERP. Les API OCC quand une action utilisateur modifie quelques enregistrements. SAP Integration Suite pour les commandes, les prix et les données de base échangés entre Commerce Cloud et S/4HANA. Le choix dépend du volume, de la fréquence et du besoin de temps réel.

Qu’est-ce qu’ImpEx et quand l’utiliser ?

ImpEx (Import/Export) est le moteur d’import et d’export textuel livré avec SAP Commerce. Il lit des fichiers de type CSV dont les lignes d’en-tête renvoient à des types d’objets et à des attributs, et il crée, modifie, supprime ou exporte des objets de la plateforme comme des produits, des clients ou des commandes (SAP Help : ImpEx). Un principe simple, mais d’une profondeur étonnante. Presque tous les projets Commerce Cloud commencent ici, et chaque développeur de l’équipe devrait bien le maîtriser avant de toucher au reste de la plateforme.

Ce qu’ImpEx fait bien :

• Migration initiale : charger des milliers de produits, de catégories et de clients depuis un ancien système
• Préparation des environnements : alimenter les environnements de développement et de préproduction avec des données de test
• Mises à jour de contenu : modifier en lot les prix, les stocks et les descriptions produits
• Configuration : pages CMS, configuration du site, groupes d’utilisateurs

Exemple de syntaxe ImpEx :

INSERT_UPDATE Product; code[unique=true]; name[lang=en]; catalogVersion(catalog(id),version)
; PROD001 ; Widget A ; productCatalog:Staged
; PROD002 ; Widget B ; productCatalog:Staged

Là où ImpEx n’est pas le bon outil : tout ce qui relève du temps réel. ImpEx travaille par lots et exécute des scripts sur la base de données. Si le prix d’un seul produit doit changer à la suite d’une action client, utilisez plutôt l’API OCC. Avant le premier gros import, les bonnes pratiques ImpEx de SAP méritent une lecture.

Comment fonctionnent les Cloud Hot Folders ?

Les Hot Folders automatisent les imports récurrents sans code d’intégration. Dans SAP Commerce Cloud (la version exploitée par SAP), ils fonctionnent sous forme de Cloud Hot Folders : les fichiers n’arrivent pas dans un répertoire local ou partagé, mais dans Microsoft Azure Blob Storage, où la plateforme les récupère (SAP Help : Cloud Hot Folders). Si vous venez d’une installation on-premise avec des Hot Folders classiques, prévoyez ce changement dans le cadre de la migration.

Le déroulement :

1. Un système externe ou une tâche planifiée dépose un fichier (généralement CSV, éventuellement compressé) dans le conteneur Blob Storage
2. Commerce Cloud le déplace vers une zone de traitement et le prend en charge
3. Un convertisseur transforme les données brutes en ImpEx
4. La plateforme exécute l’import ImpEx
5. Les fichiers traités sont archivés ; les fichiers en erreur aboutissent dans une zone d’erreur

Cas d’usage typiques :

• Mises à jour planifiées des stocks depuis un système de gestion d’entrepôt
• Flux de prix issus de l’ERP à intervalle fixe
• Synchronisation du catalogue depuis un PIM qui exporte des fichiers
• Imports de médias : chargement d’images en masse avec mappage des métadonnées

Mettez toujours en place une gestion des erreurs. Les Hot Folders échouent en silence : si personne ne surveille la zone d’erreur, les imports ratés s’accumulent sans que personne ne s’en aperçoive. Sur un projet que nous avons repris, des fichiers de catalogue échouaient depuis des semaines avant que quelqu’un ne remarque des produits manquants dans la boutique. Utilisez le suivi des Cloud Hot Folders dans le Backoffice et ajoutez une alerte en cas d’échec. C’est l’erreur la plus fréquente que nous voyons avec les Hot Folders.

Quand utiliser les API OCC ?

Les API OCC (Omni Commerce Connect) sont les points d’accès REST par lesquels Commerce Cloud met ses fonctions de commerce à disposition de tout système capable d’appeler une API REST (SAP Help : Omni Commerce Connect). SAP Composable Storefront repose entièrement sur elles. Elles sont aussi le bon choix pour :

• Les storefronts sur mesure en React, Vue ou Next.js (nous comparons les options dans SAP Composable Storefront ou React et Next.js)
• Les applications mobiles : applications iOS ou Android natives qui accèdent au panier, au checkout et aux données produits
• Les intégrations tierces : systèmes de caisse, bornes, portails partenaires
• Les opérations unitaires : modifier le prix d’un produit ou l’adresse d’un client

La règle empirique que je donne à nos développeurs : moins d’une centaine d’enregistrements en réponse à une action utilisateur, c’est l’API. Des milliers d’enregistrements selon un calendrier, c’est ImpEx ou les Hot Folders.

Quelle place pour SAP Integration Suite ?

SAP Integration Suite sur SAP BTP intervient lorsque Commerce Cloud doit dialoguer avec plusieurs systèmes d’entreprise, à commencer par l’ERP.

Flux courants via Integration Suite :

• Réplication des commandes : les commandes passées dans Commerce Cloud partent vers S/4HANA pour la livraison, la facturation et la comptabilité
• Prix en temps réel : le checkout interroge S/4HANA pour les prix spécifiques au client et le stock disponible (ATP)
• Données de base clients : les nouveaux comptes créés dans Commerce Cloud deviennent des partenaires commerciaux dans S/4HANA
• Données de base produits : attributs, classifications et hiérarchies passent de S/4HANA à Commerce Cloud

SAP fournit des contenus d’intégration préconfigurés pour les flux les plus courants entre Commerce et S/4HANA (le SAP Commerce Cloud Integration Extension Pack et les packages d’intégration du SAP Business Accelerator Hub). Ce n’est pas du prêt à l’emploi : configuration et mappage restent nécessaires. Mais ils évitent une bonne part du développement d’intégration spécifique. Nous décrivons ce scénario avec S/4HANA Public Cloud comme cœur ERP dans SAP Commerce Cloud et S/4HANA Public Cloud en B2B.

Quelles sont les erreurs de chargement les plus fréquentes ?

L’erreur que nous voyons le plus souvent : les équipes font tout passer par ImpEx, y compris des opérations qui devraient clairement être des appels d’API. Les autres suivent de près.

Charger trop de données d’un coup. Des imports complets du catalogue pendant les heures d’ouverture entrent en concurrence avec le trafic en direct. Planifiez les imports en masse en dehors des heures de pointe et chargez de façon incrémentielle : uniquement les enregistrements modifiés.

Ne pas valider les données. ImpEx importe aussi des données mal formées qui cassent ensuite le storefront. Vérifiez avant l’import les champs obligatoires, les types de données et l’intégrité référentielle. Commerce Cloud ne vous empêchera pas d’importer un produit qui renvoie à une catégorie inexistante.

Négliger la gestion des erreurs des Hot Folders. Les fichiers en échec restent dans la zone d’erreur, et personne n’est averti tant que vous ne l’avez pas configuré.

Utiliser ImpEx pour le temps réel. Exécuter des scripts ImpEx en réponse à des actions utilisateur individuelles crée des goulets d’étranglement et des conflits d’accès concurrents. Pour les modifications unitaires en temps réel, utilisez les API OCC.

Ne pas tester en préproduction. Exécutez d’abord les scripts ImpEx et les configurations de Hot Folders en préproduction. Un script défectueux peut corrompre des données produits dont le nettoyage prend des heures.

Vous préparez une migration importante ou souhaitez un deuxième avis sur votre configuration actuelle ? Parlez à notre équipe Commerce, ou lisez notre comparaison des partenaires SAP Commerce Cloud en Suisse.

Questions fréquentes

Qu’est-ce qu’ImpEx dans SAP Commerce Cloud ?

ImpEx (Import/Export) est le moteur textuel de SAP Commerce pour les opérations de données en masse. Sa syntaxe ressemble au CSV, et les en-têtes renvoient au système de types de Commerce : vous définissez le type d’objet, les attributs et les lignes de données. ImpEx traite produits, clients, commandes, contenus CMS et configuration, donc pratiquement tous les types de données de la plateforme.

Peut-on utiliser ImpEx pour des mises à jour en temps réel ?

Techniquement oui, en pratique non. ImpEx est conçu pour le traitement par lots : chargements initiaux, mises à jour planifiées, données de test. Pour les opérations unitaires en temps réel (un prix mis à jour à la connexion d’un client, une commande passée depuis une application mobile), utilisez les API REST OCC, conçues pour des échanges requête-réponse rapides.

Quelle est la différence entre Hot Folders et ImpEx ?

Les Hot Folders utilisent ImpEx en arrière-plan. La différence tient à l’automatisation : un fichier arrive dans un emplacement surveillé (dans SAP Commerce Cloud, Azure Blob Storage) et la plateforme le traite d’elle-même. Avec ImpEx seul, vous lancez les scripts manuellement via le Backoffice ou l’Administration Console (HAC). Pour les imports récurrents comme les flux de stocks, les mises à jour de prix et la synchronisation du catalogue, les Hot Folders conviennent mieux.

Comment mener une grande migration de données vers Commerce Cloud ?

Découpez la migration en phases : d’abord les données de référence (catégories, classifications), puis les produits, les clients et enfin les commandes. Écrivez des scripts ImpEx que l’on peut relancer sans créer de doublons (INSERT_UPDATE avec des clés uniques) et testez chaque phase en préproduction. Pour des millions d’enregistrements, l’exécution parallèle d’ImpEx et les heures creuses permettent à la plateforme de rester réactive.

Quand préférer SAP Integration Suite aux appels d’API directs ?

Quand un flux de données traverse plusieurs systèmes. Si une commande dans Commerce Cloud doit récupérer un prix dans S/4HANA, mettre à jour le stock d’un WMS et déclencher un message dans SAP Engagement Cloud (anciennement SAP Emarsys), c’est le terrain d’Integration Suite. Les appels OCC directs suffisent pour les intégrations point à point ; Integration Suite apporte le mappage, la gestion des erreurs, la supervision et les reprises automatiques dont les flux multi-systèmes ont besoin.