📥 Importer des fichiers et suivre leur traitement – 📚💡 Centre d'aide Hangers

Cet article vous aide à choisir un modèle d’import, envoyer vos données et vérifier ce qui a été enregistré dans votre établissement.

📍 Ici nous allons voir :

🗺️ Accéder aux échanges de fichiers
📋 Choisir le bon import
📤 Exporter, remplir et envoyer le modèle
🔎 Lire le résultat du traitement
🔁 Corriger et reprendre un import
➡️ Continuer avec les références déjà enregistrées

🗺️ Accéder aux échanges de fichiers

Connectez-vous à l’espace gérant de l’établissement concerné.
Ouvrez Mon catalogue / Échanges de fichiers, ou accédez directement aux échanges de fichiers.
Vérifiez l’établissement sélectionné avant d’exporter un modèle ou d’envoyer un fichier.

⚠️ à confirmer : les conditions actuelles d’accès au module d’import. L’ancienne version de cet article mentionne les formules Advanced et Entreprise, une activation après formation et des conditions de réactivation. Ces conditions doivent être validées avant publication.

📋 Choisir le bon import

Le modèle à exporter et le Type de contenu choisi à l’envoi doivent correspondre. Les modèles ne sont pas interchangeables.

Votre objectif	Modèle et guide	Ce qu’il faut préparer
Créer des références simples ou modifier certaines de leurs informations	I1 — NIS, création, modification et correction des références	Associer les catégories à votre établissement. ItemID vide pour créer ; ItemID de la référence pour modifier. Pour changer les prix, utiliser P7.
Initialiser le stock de produits existants	S1, mise en place des stocks	Exporter la liste des produits éligibles sans stock. Conserver leurs ItemID.
Modifier un stock existant	S2, mise à jour des inventaires	Utiliser le StockID et l’action du modèle : ajout, retrait ou ajustement.
Regrouper des références en variations	I5, mise en place des variations	Créer d’abord les références et leurs caractéristiques. Exporter ensuite le modèle prérempli.
Construire des formules	I6, mise en place des formules	Créer d’abord les références utilisées dans la formule. Conserver les lignes de définition et leurs composants.
Modifier les tarifs et leur date d’application	P7, mise à jour des tarifs	Exporter le modèle de tarification. Conserver les identifiants des articles et les contrats concernés.
Importer des clients professionnels en France	U3 — clients B2B par SIREN	Préparer les identifiants légaux et les informations demandées dans le modèle.
Importer des clients professionnels hors de France	U4 — import simple des clients B2B	Vérifier les clients déjà présents avant tout nouvel envoi : ce mode signale un risque de doublon.

⚠️ à confirmer : l’accès client au guide U3 existant et le parcours U4 en production. Le sélecteur du code consulté propose U3 en France et U4 dans les autres pays.

Catalogue par défaut et les catalogues de tarifs négociés sont également proposés à l’export. Pour un import P7, utilisez explicitement le modèle P7 — Mise à jour tarifaire.

Pour les imports d’ingrédients, de clients particuliers, de crédits, de recettes ou les formats fournisseurs spécifiques, faites préciser le modèle et la procédure par l’Assistance avant de préparer le fichier.

⚠️ à confirmer : la disponibilité des anciens imports I3, U1, U2, C1, C2, R1 et I4 cités dans l’article précédent. Ils ne figurent pas dans le sélecteur client consulté ; cette liste ne constitue pas une promesse de disponibilité.

📤 Exporter, remplir et envoyer le modèle

Dans la liste des modèles, sélectionnez le code correspondant à votre objectif.
Téléchargez le modèle depuis l’établissement concerné. Ses listes et ses données préremplies dépendent de cet établissement.
Enregistrez une copie de travail en conservant le format téléchargé, par exemple .xlsm pour NIS.
Remplissez les cellules prévues par le guide de cet import. Conservez les feuilles, les colonnes, les en-têtes et les identifiants préremplis.
Enregistrez le fichier, puis revenez aux Échanges de fichiers.
Ouvrez Importer un nouveau fichier avec le bouton Télécharger. Choisissez le même code dans Type de contenu, sélectionnez votre fichier et validez l’envoi.
Retrouvez l’opération dans la liste des fichiers et suivez son traitement.

Si le fichier n’est pas accepté

Message ou situation	Cause à vérifier	Solution
Aucun fichier sélectionné	La fenêtre d’envoi ne contient pas de fichier.	Ouvrez Choisir un fichier, sélectionnez votre copie enregistrée, puis validez l’envoi.
Un fichier Excel est attendu	L’extension ne correspond pas au type d’import sélectionné.	Sélectionnez le bon Type de contenu et conservez le format du modèle exporté. NIS utilise .xlsm, même si le message n’énumère que .xls et .xlsx.
Un fichier CSV est attendu	Le parcours choisi attend un format fournisseur CSV.	Vérifiez que vous utilisez bien ce parcours. Consultez Charger un fichier CSV fournisseur pour ce format ; choisissez I1 pour un classeur NIS.
Le téléchargement a échoué…	Une erreur est survenue pendant l’envoi ou la création de l’opération.	Conservez le message et recherchez si une opération a déjà été créée dans la liste avant de réessayer. Si le résultat est ambigu, faites vérifier l’opération par le Support Client.
File content not yet supported	Le traitement ne reconnaît pas le contenu déclaré.	Vérifiez le modèle et le Type de contenu. Faites vérifier l’opération si la combinaison correspond bien au modèle fourni.

⚠️ Attention : le message « fichier téléchargé avec succès » confirme la réception du fichier. Consultez ensuite le résultat du traitement pour savoir quelles données ont été enregistrées.

🔎 Lire le résultat du traitement

Statut ou information	Ce que vous devez faire
Chargé. En attente de traitement	Attendez le traitement. Un second envoi du même fichier n’accélère pas l’opération.
En cours de traitement	Actualisez la liste pour suivre l’opération.
Succès	Lisez la colonne Résultat. Pour NIS, téléchargez aussi le classeur résultat : certaines lignes peuvent encore nécessiter une correction.
Succès, certains éléments n’ont pas été validés/enregistrés	Consultez les détails et le fichier disponible pour identifier les données enregistrées et celles à reprendre.
Échec	Lisez le motif avant de réessayer. La reprise dépend du type d’import et de l’étape à laquelle il s’est arrêté.

Lisez la colonne Résultat de l’opération. Ouvrez les informations supplémentaires si l’icône de détail est proposée.
Cliquez sur le nom du fichier dans la colonne Fichier pour télécharger le résultat disponible après traitement.
Pour NIS, ouvrez la feuille Data et comparez Error, ItemID et la référence concernée. Le guide NIS explique la lecture ligne par ligne.
Vérifiez que les références attendues sont présentes dans le catalogue avant de considérer votre travail terminé.

⚠️ à confirmer : la façon d’afficher la feuille Data dans le modèle actuellement distribué. Une différence entre le modèle et son export a été relevée pendant la revue.

🔁 Corriger et reprendre un import

NIS : conserver les réussites et reprendre les erreurs

L’import NIS permet d’avancer par étapes. Si 99 références sur 100 sont enregistrées, vous pouvez déjà utiliser ces 99 références et concentrer la reprise sur la dernière.

Conservez une copie du classeur résultat avec les ItemID attribués.
Dans une copie destinée au nouvel envoi, supprimez les lignes de données déjà réussies. Conservez la structure du modèle.
Corrigez les lignes restantes à partir de leur message d’erreur : catégorie à associer, titre à compléter, taux à sélectionner, etc.
Préparez les cellules Error pour la reprise, selon la procédure détaillée du guide NIS.
Envoyez ce fichier avec I1 — NIS et téléchargez le nouveau résultat après traitement.
Répétez jusqu’à ce que toutes les références souhaitées soient enregistrées et qu’aucune ligne ne reste à corriger ou à vérifier.

⚠️ Attention : pour un import de création, un ItemID attribué confirme la création de la référence. Pour une modification d’une référence existante, l’ItemID était déjà présent : vérifiez aussi l’absence d’erreur et les données du catalogue.

Les autres imports : vérifier leur règle de reprise

Import	Règle de reprise à appliquer
S1, S2, I5 et I6	Une erreur de validation peut empêcher l’enregistrement du lot. Corrigez le fichier en conservant les lignes nécessaires, notamment les liens d’une formule. Ne supprimez pas des lignes en supposant qu’elles ont réussi comme en NIS.
P7	Corrigez les erreurs du fichier tarifaire. Un import accepté peut préparer une application ultérieure : vérifiez également la date d’entrée en vigueur et le résultat sur les tarifs.
U3 et U4	Contrôlez les clients et contrats déjà créés avant la reprise. Faites préciser les lignes à renvoyer si le résultat est ambigu.

Retrouver une correction selon le message

Import et message / symptôme	Cause et correction	Guide utile
NIS — Category (…) not found on partner	Associez la catégorie au bon établissement, réexportez le modèle et choisissez le libellé exact.	Ajouter une catégorie ; le guide NIS détaille la reprise et sa vérification.
NIS — titre, prix, TVA, ItemID ou classeur incorrect	Lisez ensemble Error et Résultat. Une ligne peut nécessiter plusieurs corrections, ou être ignorée sans message explicite.	Diagnostic complet NIS
S1 — already has stock setup	Le produit possède déjà un stock : utilisez S2 pour le modifier. Ce parcours S1 ne crée pas un inventaire secondaire.	Mise à jour des inventaires S2
S1 — inventory type not found	Sélectionnez un type d’inventaire autorisé dans le modèle du bon établissement.	Mise en place des stocks S1
S2 — Inventory with ID not found / Item with ID not found	Réexportez les inventaires du bon établissement. Conservez StockID pour le stock et ItemID pour la référence ; ils ne sont pas interchangeables.	Opérations de stocks dans l’espace en ligne
S2 — action not found / incorrect value	Choisissez exactement ADD_QUANTITY, REMOVE_QUANTITY ou ADJUST_QUANTITY et une quantité entière appropriée. Pour retirer, saisissez la quantité à retirer en positif ; pour ajuster, saisissez le total cible. Si un ajustement à zéro est refusé, faites vérifier le stock et la procédure de correction.	Guide S2 ; rapport des mouvements de stock pour vérifier ce qui a déjà été appliqué.
I5 — missing mandatory datas (item ID, title, variation type)	Vérifiez que la référence existe et est éligible, que le nom de variation a au moins trois caractères et que le type vient du modèle. Réexportez après la création des références.	Mise en place des variations I5 ; Créer une variation pour le fonctionnement du regroupement.
I6 — First Component is missing / should be in one component	Renseignez le premier composant sur la définition de la formule et affectez chaque référence enfant à au moins un composant.	Mise en place des formules I6 ; Créer une formule pour comprendre sa structure.
I6 — référence introuvable ou non associée à une formule	Vérifiez la ligne de définition et la présence de la référence enfant dans le catalogue. Réexportez la liste du modèle, puis sélectionnez la référence exacte sans reconstituer son libellé approximativement.	Guide I6 ; Créer une prestation ou un produit si une référence nécessaire manque encore.
P7 — Please see the … errors into the file	Téléchargez le classeur et corrigez les cellules signalées. Conservez les identifiants et contrats de l’export.	Mise à jour des tarifs
P7 — import accepté mais tarif attendu non visible	Vérifiez la date d’entrée en vigueur, la publication et le contrat concernés, puis l’application du changement.	Historique de tarification
U3 / U4 — identifiant légal, adresse ou type de contrat non reconnu	Vérifiez les champs du modèle et les clients déjà créés. Faites préciser les lignes à reprendre avant renvoi, particulièrement avec U4.	La procédure complète doit être confirmée avec l’Assistance ; le guide U3 existant est réservé à un accès restreint et reste à compléter.

⚠️ à confirmer : les parcours des articles liés et leur adéquation à la version déployée. Ces renvois désignent des procédures existantes ; les comportements particuliers de reprise sont issus du code examiné et doivent être vérifiés avant publication.

⚠️ Attention : ne renvoyez pas un mouvement S2 déjà appliqué. Un nouvel ajout ou retrait peut modifier le stock une seconde fois. En cas d’erreur technique après traitement, vérifiez d’abord le stock réel.

➡️ Continuer avec les références déjà enregistrées

Conservez les ItemID des références réussies. Vous pouvez poursuivre avec elles pendant que vous corrigez les autres.

Vérifiez ces références dans le catalogue.
Exportez un nouveau modèle S1, I5, I6 ou P7, selon l’étape suivante. Le modèle doit être exporté après la création pour prendre en compte les nouvelles références éligibles.
Préparez ce nouvel import avec ses propres colonnes et ses règles. Le classeur NIS reste le résultat de l’étape de création.

💡 Le saviez-vous : vous n’avez pas besoin d’attendre la correction de tout le catalogue pour avancer. Seules les références nécessaires à l’opération suivante doivent déjà exister.

Articles dans cette section