Importation et exportation via CSV et Excel
Grâce à CSV-Porter, vous pouvez transférer des articles, des prix, des stocks, des caractéristiques, des clients et des commandes sous forme de fichier CSV ou Excel : en une seule fois dans l'interface d'administration ou régulièrement via un lien vers des portails de gestion des stocks et des prix. Ce guide vous explique comment créer un Porter, mapper les colonnes, interpréter le rapport d'importation et éviter les erreurs courantes.
En bref
- Où : sous Outils → Gestionnaire d'importation/exportation CSV xoPort. Un « Porter » est une routine enregistrée composée d'une rubrique, de colonnes et de paramètres. Un même « Porter » sert à la fois à l'exportation et à l'importation.
- Porters par défaut : ils sont préconfigurés en usine, mais protégés et désactivés. Dupliquez le Porter qui vous convient et travaillez avec la copie.
- Formats : CSV, TXT, XLS, XLSX et ODS. Pour travailler dans Excel, les formats XLSX ou CSV en UTF-8 sont les plus sûrs.
- Importation : l'écriture est immédiate, il n'y a pas de test préalable. Exportez au préalable les mêmes colonnes à titre de sauvegarde et effectuez un test avec quelques lignes. Le rapport d'importation répertorie chaque ligne rejetée.
- Automatique : liens d’exportation et d’importation pour les portails de prix, les systèmes de gestion des stocks et les tâches Cron. Les données clients et de commande sont stockées dans un répertoire protégé par mot de passe et filtre IP.
Dans ce guide
Fonctionnement de Porter
Un Porter définit les données à transférer, ainsi que les colonnes et le format de fichier utilisés. L'exportation et l'importation s'effectuent selon le même mappage de colonnes. Un fichier exporté peut donc être modifié, puis réimporté à l'aide du même Porter.
Rubrique
La rubrique détermine les données que le Porter prend en charge : produits, options de produits, tarifs par groupe de clients, données clients, données de commande et autres. Elle détermine les colonnes sélectionnables ainsi que le type d'importation ou d'exportation.
Colonnes
Sous « Modifier les colonnes », vous activez les champs qui doivent figurer dans le fichier et attribuez à chaque colonne un « nom de colonne ». Lors de l’importation, la boutique affecte les colonnes du fichier à l’aide de ces noms figurant dans l’en-tête.
Paramètres
Séparateurs de champs et de texte, format de sortie, jeu de caractères, langue de Porter et filtres pour l’exportation. Pour l’importation automatique, un répertoire est ajouté, à partir duquel Porter lit les fichiers.
La vue d’ensemble sous Outils → Gestionnaire d’importation/exportation CSV xoPort classe les Porters dans les onglets « Données produit », « Portails de prix », « Données clients et commandes » et « Autres ». Le menu d’actions d’un Porter propose « Infos et liens », « Modifier les colonnes », « Paramètres », « Importer les données dans la boutique », « Exporter les données de la boutique », « Dupliquer la routine d’exportation » et « Supprimer ». Les Porters par défaut (marqués d’un cadenas) ne disposent ni de l’option « Modifier les colonnes » ni de « Supprimer » ; pour apporter des modifications, vous devez les dupliquer. Le bouton dans la colonne « Statut du Porter » active les liens d’exportation et d’importation. Les importations et exportations dans le backend fonctionnent également lorsque le Porter est désactivé.
Aperçu des porters : les porters standard sont signalés par un cadenas ; le menu déroulant à côté de « Infos et liens » donne accès aux colonnes, aux paramètres, à l’importation, à l’exportation, à la duplication et à la suppression. Cliquez pour agrandir.
Les Porters par défaut
Ces Porters sont fournis avec chaque boutique. Ils sont protégés : leurs colonnes ne peuvent pas être modifiées et ils ne peuvent pas être supprimés. Ils sont désactivés par défaut.
| Porter | Contenu |
|---|---|
| Produits (complets) | tous les champs de produit, idéal comme modèle pour créer votre propre « Porter » de produits |
| Produits | les principales catégories de produits : textes, statut, catégories, stock, poids, prix, taxes, prix promotionnel |
| Mise à jour des prix | ID produit, référence, nom, statut, stock, prix, taxes, prix promotionnel, prix de vente conseillé et prix de base |
| Mise à jour des catégories, mise à jour des fabricants, mise à jour des images | Textes de catégories et informations SEO, données sur les fabricants, images des produits avec description |
| Options de produit (caractéristiques) | Caractéristiques et valeurs par article avec supplément, référence, code EAN et stock |
| Tarifs dégressifs (groupes de clients) | Prix et barèmes par groupe de clients |
| Données clients | Clients avec adresses et groupe de clients |
| Exportation des commandes, partie 1 et partie 2, respectivement « (n°) » et « (statut) » | Commandes dans deux fichiers : données de commande et lignes de commande |
| « Desktop Enterprise… » | Fichiers Porter préparés pour le logiciel de gestion des stocks Desktop Enterprise |
| Onglet « Portails de prix » | Exportations préparées pour les comparaisons de prix, avec des informations sur le fournisseur dans la boîte de dialogue d’exportation |
« Prix », « Stock » et « Catégories » ne sont pas des rubriques à part entière, mais des groupes de champs de la rubrique « Produits ». Les porters standard « Mise à jour des prix » et « Mise à jour des catégories » montrent comment créer à partir de ceux-ci des porters allégés adaptés à une tâche spécifique.
Créer un Porter
Le plus rapide est de dupliquer un Porter standard qui correspond à votre tâche. Vous pouvez également créer un nouveau Porter et sélectionner vous-même les colonnes.
- Pour le Porter correspondant, sélectionnez « Dupliquer la routine d’exportation » dans le menu d’actions. La copie s’appelle par exemple « Mise à jour des prix (copie 1) » et n’est pas protégée. Pour créer un tout nouveau Porter, cliquez sur « Créer un nouveau Porter ».
- Sous « Paramètres », attribuez un « Nom de la routine xoPort » explicite, vérifiez la « Rubrique » et le séparateur, puis enregistrez. Après avoir cliqué sur « Suivant », un nouveau Porter vous mène directement aux colonnes.
- Sous « Modifier les colonnes », activez uniquement les champs que vous souhaitez réellement transférer, puis enregistrez.
- Exportez une fois le Porter à l’aide de « Exporter les données de la boutique ». Le fichier vous montre la structure exacte et sert de modèle pour l’importation.
- N’activez le « Statut du Porter » que lorsque le lien d’exportation ou d’importation est nécessaire.
Les paramètres d’un Porter personnalisé ; les filtres par catégorie et par fabricant ne sont pas affichés sur l’image. Cliquez pour agrandir.
Aperçu des paramètres
| Champ | Effet |
|---|---|
| « Séparateur de champs », « Séparateur de texte » | Caractères entre les champs (par défaut : ;, tabulation : \t) et autour du contenu des champs (par défaut : "). Ils s'appliquent à l'exportation et à l'importation. |
| « Caractère de masquage différent » | laisser vide. Dans un fichier CSV standard, le séparateur de texte se masque lui-même. |
| « Format de sortie » | csv, txt, xls, xlsx ou ods. Pour les formats Excel, la boutique génère un véritable fichier tableur. |
| « Jeu de caractères de sortie » | UTF-8 (par défaut) ou ANSI. Ne s'applique qu'à l'exportation. Ne sélectionnez ANSI que si le système cible ne prend pas en charge l'UTF-8. |
| « Citations CSV » | Quand le séparateur de texte est appliqué : « Norme PHP (fputcsv) » (par défaut), « Toujours (tous les champs) » ou « Minimal (uniquement pour les caractères spéciaux) » |
| « Rubrique », « Regroupement » | quelles données le Porter reconnaît et dans quel onglet de la vue d’ensemble il se trouve |
| « Filtre d’exportation », « Filtre par catégorie », « Filtre par fabricant », « Stock minimum », « Exporter » | ne font que restreindre l’exportation, par exemple à certaines catégories ou à des articles disposant d’un stock et d’un prix. Ils ne s’appliquent pas à l’importation. |
| « Pas de produits inactifs (export) », produits individuels, maîtres et esclaves | quels articles l'exportation contient |
| « Copies de produits (liens) » | Exportation : une ligne par catégorie de l’article. Importation : compléter les affectations de catégories au lieu de les remplacer (voir Importation). |
| « Champs supplémentaires (colonnes) » | Nombre de champs de produit supplémentaires, par exemple pour les informations d’un portail de prix |
| « Langue du portail » | Langue de tous les champs dépendants de la langue, tels que le nom, la description et le nom de la catégorie |
| « Exportation rapide de la catégorie dans la gestion des produits » | affiche le Porter dans la gestion des produits, à côté de la recherche rapide. Il exporte alors la catégorie actuellement affichée, ainsi que ses sous-catégories. |
| « Répertoire d’importation automatique » | Dossier contenant les fichiers que le lien d’importation lit (voir « Automatiquement via un lien ») |
Rubriques et champs
La rubrique détermine également l’emplacement de l’exportation. Les données relatives aux produits et aux places de marché sont destinées aux portails de prix et accessibles via un lien public. Toutes les autres rubriques se trouvent dans le répertoire protégé.
| Rubrique | Contenu | Lien d'exportation |
|---|---|---|
| Produits | Données de base et textes, statuts, catégories, fabricants avec adresse pour la sécurité des produits (GPSR), fournisseurs, stock et expédition, prix et taxes, prix de base, prix promotionnel, prix échelonnés, images, vidéos, titres de page et mots-clés, bonus et valeurs gratuites, champs supplémentaires | ouvert |
| Options de produit | Caractéristiques et valeurs par article : nom ou ID, supplément, ordre, référence, EAN, stock, image, poids, statut, présélection | ouvert |
| Prix par groupe de clients | Prix, barèmes et prix spéciaux par groupe de clients, ainsi que prix individuels par client | protégé |
| Onglets de produit, modèles d'onglets de produit, affectations d'onglets de produit | Onglets de la page produit avec nom et contenu par langue, modèles et leur attribution aux catégories | protégé |
| Téléchargements/chargements, pages CMS | Fichiers relatifs aux articles et contenus des pages CMS | protégé |
| Données clients | Clients, adresses, groupes de clients, paramètres et indicateurs de commande par client | protégé |
| Abonnés à la newsletter | Abonnés à la newsletter de la boutique en ligne | protégées |
| Données de commande (générales), données de commande (produits) | Commandes avec adresses, modes de paiement et montants, ainsi que leurs lignes ; seuls les numéros de suivi peuvent être importés | protégées |
| Plateformes de vente, données des plateformes | Validation par place de marché, ainsi que le prix net ou brut sur la place de marché, les prix en boutique, les prix spéciaux et le stock | ouvert |
| Offres groupées 4.10 | Offres groupées avec leurs composants, quantités, sélection d'attributs et paramètres | protégé |
Caractéristiques
Vous gérez les caractéristiques, les valeurs et les variantes à l’aide du Porter « Options de produit (caractéristiques) ». Le guide « Attributs de produit » explique la structure des caractéristiques et ce que l’API REST propose à ce sujet.
Uniquement lors de l’exportation
Certains champs sont calculés par la boutique et ne sont qu’affichés :
- « Prix échelonnés dans un champ » avec l’échelle de prix complète dans une colonne (
1:0.89 50:0.79), par exemple pour les catalogues d’approvisionnement - « Contenu (quantité avec unité) » comme
0.5 lpour les indications de prix dansles flux 4.9.135
Autres guides
Les colonnes relatives aux bonus et aux articles gratuits sont décrites dans la section « Points bonus et produits gratuits », tandis que les champs du label de garantie européen sont expliqués dans la section « Label de garantie européen ».
Colonnes et options
Sous « Modifier les colonnes », le champ de la boutique apparaît à gauche, la colonne du fichier à droite. Les flèches au milieu indiquent si un champ peut être importé, exporté ou les deux.
| Portée | Effet |
|---|---|
| Le bouton situé devant le champ | permet d’ajouter le champ dans le Porter. Les options « Activer toutes les colonnes » et « Supprimer toutes les colonnes actives » permettent de tout modifier en une seule fois. |
| « Options d’importation » | convertissent la valeur lors de l'importation, par exemple chg=,-->. pour les virgules décimales |
| « Tri » | Ordre des colonnes lors de l’exportation |
| « Nom de colonne » | En-tête dans le fichier. Lors de l’importation, il doit figurer exactement de la même manière dans l’en-tête, y compris en majuscules et minuscules. |
| « Options d’exportation » | permettent de convertir la valeur lors de l'exportation. Le bouton avec le symbole « i » ouvre l'« Aide sur les options xoPort » qui répertorie toutes les options et fournit des exemples. |
Chaque rubrique nécessite des champs clés afin que la boutique puisse attribuer les lignes. Pour les produits, il s’agit de l’« ID produit » ou de la « référence (modèle) » ; pour les clients, de l’ID client, du numéro client individuel ou de l’adresse e-mail ; pour les commandes, du numéro de commande. Si ces champs manquent, la boutique refuse d’enregistrer les colonnes. Les colonnes dont le nom contient « %u », telles que « Categorie %u » ou « Image %u », sont numérotées : « Categorie 1 », « Categorie 2 », et ainsi de suite.
Dans « Modifier les colonnes », vous activez les champs et attribuez les noms de colonnes au fichier ; pour le stock, chg=,--> convertit la virgule décimale lors de l'importation. Cliquez pour agrandir.
Les options les plus importantes
| Option | Effet | Exemple |
|---|---|---|
chg=alt-->neu | remplace le texte, plusieurs fois avec un point-virgule | chg=,-->. transforme 2,99 en 2.99 |
clc= | effectue des calculs avec des nombres : *, /, +, - | clc=/100 convertit les centimes en euros |
rnd= | arrondit au nombre de décimales souhaité | rnd=2 |
set=, alt= | valeur fixe pour toutes les lignes ou valeur de remplacement pour les cellules vides | alt=3-5 Werktage |
date=, datetime= | format de date du fichier | date=d.m.Y |
nohtml= | supprime le code HTML lors de l'exportation, avec 1, 2 ou 3 pour le traitement des sauts de ligne | nohtml=2 |
path=abs, path=catch | Export : URL complète de l'image. Import : charger l'image à partir d'une URL et l'enregistrer dans la boutique – actuellement toujours dans le dossier des images de produits, donc à utiliser uniquement pour les images de produits. | path=catch_if_not_exists charge uniquement les images manquantes |
skip | en tant qu’option d’importation seule : ignorer la colonne lors de l’importation. En tant qu’option d’exportation avec une valeur : omettre les lignes contenant cette valeur. | skip= Omettre les lignes dont le champ est vide |
filter= | Export : ne conserver que les lignes contenant cette valeur | filter=1 |
implode= | Texte de séparation pour les colonnes regroupées telles que le chemin de catégorie ou les caractéristiques, valeur par défaut « > » | implode= :: |
Séparez les différentes options par des points-virgules, par exemple rnd=2;chg=.-->,.
Une cellule vide reste vide avec « clc » et n’interrompt plus l’exportation. 4.9.85
Préparation du fichier
La plupart des erreurs d’importation proviennent du fichier : séparateur incorrect, en-tête de colonne renommé ou chiffres modifiés par le tableur.
Ligne d'en-tête et séparateur
La première ligne contient les noms de colonnes du Porter. Les séparateurs de champs et de texte du fichier doivent correspondre aux paramètres définis. Si le séparateur de champ apparaît dans du texte, par exemple un point-virgule dans la description, le texte doit être placé entre des séparateurs de texte. Sinon, le nombre de valeurs ne correspondra pas à la ligne d'en-tête et la boutique ignorera cette ligne.
Jeu de caractères
Enregistrez les fichiers CSV au format UTF-8, dans Excel avec l’option « CSV UTF-8 (séparé par des délimiteurs) ».
La boutique reconnaît automatiquement les fichiers issus de programmes Windows utilisant un jeu de caractères d'Europe occidentale ou d'Europe centrale. Si des caractères sont perdus lors de cette opération, le rapport d'importation le signale.ab 4.9.26
Fichiers Excel
Le Porter importe directement les fichiers XLS, XLSX et ODS. Il lit la feuille de calcul qui était active lors de l’enregistrement, ainsi que les formules et leurs résultats. Pour les modifier dans Excel, il est préférable d’exporter au format XLSX : les références, les codes EAN et les codes postaux apparaissent alors sous forme de texte dans le fichier et ne perdent pas leurs zéros non significatifs, tandis que les prix et les quantités sont conservés sous forme de nombres réels.
Chiffres, dates, images
L’importation lit les prix et les poids avec une virgule ou un point décimal ; les colonnes numériques nouvellement activées comportent en outre le format « chg=,-->. ». Les séparateurs de milliers ne sont pas autorisés ; les quantités doivent être des nombres entiers. Vous saisissez les données au format défini dans l’option de colonne, généralement 10.09.2026. Vous indiquez les images sous forme de nom de fichier relatif au dossier d’images, ou via path=catch sous forme d’URL vers un fichier JPG, PNG, GIF ou WebP.
Exporter des données
Une exportation copie les données de la boutique vers un fichier. Cela ne modifie en rien la boutique.
- Dans le menu Actions, sélectionnez « Exporter les données de la boutique ». L'onglet « Exportation des données » s'ouvre.
- Choisissez l’emplacement de stockage : « Serveur (conserver le fichier d’exportation sur le serveur) » ou « Local (supprimer le fichier d’exportation après le téléchargement) ».
- Affiner la sélection en fonction de la rubrique : pour les produits, par catégories et fabricants ; pour les clients, par « modifications depuis » une date donnée ; pour les commandes, par une date ou une plage de numéros de commande. Pour les produits, les caractéristiques et les tarifs des groupes de clients, sélectionnez également la « langue du porteur ».
- Cliquezsur « Lancer l’exportation ». À la fin, la boutique affiche le message « … lignes de données plus ligne d’en-tête enregistrées » et lance le téléchargement.
Lors de l’exportation, sélectionnez l’emplacement de stockage et affinez la sélection des produits par catégories et fabricants. Cliquez pour agrandir.
Avec « Serveur », le fichier reste stocké sous xoport_<ID>.<Format>; pour les rubriques « Produits » et « Places de marché », il se trouve dans le dossier public xoport/; pour toutes les autres, dans xoport/secure/. Le chemin d’accès exact est indiqué sous « Infos et liens ». Avec « Local », la boutique supprime le fichier après le téléchargement ; cela se produit systématiquement lorsque Porter est désactivé. Pour les exportations ponctuelles auxquelles personne de l’extérieur ne doit avoir accès, « Local » est le meilleur choix.
Importer des données
L’importation enregistre immédiatement chaque ligne valide dans la boutique. Exportez au préalable les mêmes colonnes à titre de sauvegarde et testez les nouveaux Porter avec quelques lignes seulement.
- Dans le menu Actions , sélectionnez « Importer des données dans la boutique ». L’onglet « Importation de données » s’ouvre.
- Sélectionnez la source : « Téléchargement de fichier depuis votre ordinateur (csv, txt, xls, xlsx ou ods) », un « fichier existant sur le serveur » ou les fichiers du répertoire d’importation automatique.
- Vérifiez la « langue du Porter » pour les produits, les caractéristiques et les prix des groupes de clients.
- Cliquezsur « Lancer l’importation » et attendez que la barre de progression s’affiche. N’interrompez pas l’importation.
L’importation lit un fichier téléchargé, le fichier d’exportation sur le serveur ou les fichiers du répertoire d’importation automatique. Cliquez pour agrandir.
Rechercher et créer un nouvel article
La boutique recherche d’abord un article via l’« ID produit », puis via la « référence (modèle) ». Elle ne crée un nouvel article que si la ligne comporte un numéro d’article et un nom, et si la langue du Porter est la langue par défaut de la boutique. Un Porter ne comportant pas de colonne « Nom » se contente de mettre à jour les données et ignore les articles inconnus.
Ce qu’une ligne modifie
Seules les colonnes présentes dans le fichier et activées dans le Porter sont écrites. Une cellule vide dans une telle colonne vide le champ correspondant. Les champs qui doivent rester inchangés doivent être supprimés du fichier et du Porter.
Une importation partielle, par exemple uniquement les stocks déclarés par entrepôt, ne vide plus les champs d'entrepôt que le Porter ne gère pas du tout. 4.9.94
Attribuer des catégories
Vous indiquez les catégories sous forme de noms dans « Categorie 1 », « Categorie 2 »… ou sous forme d’« ID de catégorie », les catégories supplémentaires étant séparées par des virgules dans « Plus de catégories ». Si l’option « Copies de produits (liens) » est désactivée, la ligne remplace toutes les affectations précédentes de l’article. Si cette option est activée, les catégories sont ajoutées. Après une importation dans le backend, la boutique place les articles sans catégorie dans la catégorie désactivée « xoport_unsorted ».
Prix et taxes
Importez de préférence le prix net. Si seul le prix brut figure dans le fichier, la boutique effectue le calcul en fonction du taux d’imposition de la ligne ou, pour les articles connus, en fonction de leur classe d’imposition. Si un taux d’imposition ou une classe d’imposition associée à un taux est inconnu, la boutique le crée en tant que nouvelle classe d’imposition. Si seul un nom inconnu de classe d’imposition figure dans la ligne, l’article reste sans classe d’imposition. Vérifiez donc au préalable l’orthographe.
Autres langues
Pour les traductions, créez un fichier Porter distinct avec la langue cible comme langue du Porter, qui ne contient que les champs dépendants de la langue et les identifiants. Dans une autre langue, la boutique attribue les catégories et les fabricants uniquement via leur identifiant ; sinon, elle les crée en double.
Caractéristiques
La colonne « options sort order » définit l’ordre des valeurs. Si elle est vide, les valeurs existantes conservent leur ordre tel qu’il apparaît dans la boutique,tandis que les nouvelles valeurs sont ajoutées à la fin. 4.9.106
Suppression par importation
Supprimer certaines valeurs dans la colonne « Statut » au lieu de les modifier. Vérifiez ces fichiers avec une attention particulière.
| Valeur et colonne | Effet |
|---|---|
del dans « Statut du produit » | supprime l'article, les fichiers image restent |
del+ dans « Statut du produit » | supprime l'article et ses fichiers image, à condition qu'aucun autre article ne les utilise |
delmodel dans « Statut du produit » | supprime tous les articles portant ce numéro d'article ; la colonne « Numéro d'article » est obligatoire pour cette opération |
delopt dans « Statut du produit » | supprime toutes les caractéristiques de l'article. Les autres modifications apportées à l'article doivent figurer sur une deuxième ligne avec le statut 0 ou 1. |
del Dans le statut ou dans la présélection d’une caractéristique | supprime cette valeur de caractéristique de l’article |
del Dans le statut de la catégorie | supprime la catégorie ainsi que toutes ses sous-catégories |
del dans le groupe de clients ou le prix client | supprime ce prix |
Consulter le rapport d’importation
Une fois l'importation terminée, la boutique affiche le message « Importation terminée » accompagné du nombre de lignes lues, ainsi qu'un tableau indiquant « Mis à jour », « Nouveaux enregistrements » et « Supprimés » pour chaque type de données, surmonté des messages correspondants.
Rouge et jaune
Les messages en rouge indiquent des erreurs : les lignes n’ont pas été traitées. Les messages en jaune indiquent des lignes ignorées comme prévu, par exemple des articles issus du système de gestion des stocks qui n’existent pas dans la boutique.
Lignes concernées
Le bouton situé à côté d’un message affiche les lignes concernées sous forme de tableau indiquant le numéro de ligne et les valeurs du fichier. Le numéro de ligne commence par l’en-tête (ligne 1), comme dans Excel. Un maximum de 1 000 lignes est affiché. 4.9.106
Rapport CSV
« Erreurs et avertissements au format CSV » exporte toutes les lignes rejetées d’un cycle dans un fichier, avec le type, le message et les colonnes du fichier d’importation. Corrigez les lignes dans ce fichier et réimportez uniquement celles-ci.ab 4.9.106
Un rapprochement de stock comportant six lignes : trois articles mis à jour, deux références inconnues ignorées, une ligne rejetée car contenant trop de valeurs. Cliquez pour agrandir.
Messages fréquents
| Message | Signification et solution |
|---|---|
| « Le nombre de valeurs ne correspond pas à l'en-tête… » | La ligne comporte plus ou moins de champs que l'en-tête ; il s'agit le plus souvent d'un séparateur de champs dans un texte ne comportant pas de séparateur de texte. |
| « L'article n'est pas disponible dans la boutique… » (jaune) | Le Porter ne dispose pas d’une colonne « Nom » et ne crée donc pas d’articles. C’est voulu pour les synchronisations de stock et de prix. 4.9.106 |
| « Les articles à créer doivent avoir un nom ! » | La colonne « Nom » existe, mais la cellule est vide. |
| « ID de l'article ou référence introuvable ! » | L’article est inconnu et n’a pas pu être créé, généralement parce que la langue du Porter n’est pas la langue par défaut. |
| « … caractères … rejetés … » | Le fichier contenait des caractères qui n’existent pas dans le jeu de caractères reconnu. Enregistrez le fichier au format UTF-8 et réimportez-le. |
| « Date non valide… » | La date ne correspond pas à l’option « date= » ou « datetime= ». La boutique en ligne utilise alors la date du jour. |
| « … Groupe(s) de clients non repris … » | Importation de clients avec un groupe qui n’existe pas dans la boutique. Les clients existants conservent leur groupe, les nouveaux se voient attribuer le groupe 0.ab 4.9.139 |
| « Le fichier d’importation contient probablement des données erronées ou ne comporte pas de ligne d’en-tête correspondante… » | Aucune colonne du fichier ne correspond à un nom de colonne de Porter. Vérifiez les séparateurs et les en-têtes de colonnes. |
Protéger les champs contre le remplacement
Si un fichier provient régulièrement du système de gestion des stocks, certains champs de la boutique doivent néanmoins conserver les modifications que vous y avez apportées, par exemple des descriptions révisées.
Porter allégé
La protection la plus sûre : le Porter ne contient que les colonnes que le système de gestion des stocks doit fournir, telles que la référence, le stock et le prix. Tout le reste reste inchangé.
Ignorer une colonne
Si le fichier contient une colonne qui ne doit pas être reprise, saisissez « skip » pour cette colonne dans « Options d’importation ». L’importation l’ignorera alors.
Blocages d’importation au niveau de l’article
Dans la fiche article, vous pouvez bloquer certaines zones dans l’onglet de l’interface de données. Le CSV-Porter prend en compte les options « Mettre à jour le nom » et « Mettre à jour la description ». Les autres blocages, tels que le prix ou le stock, s’appliquent à l’importation XML du système de gestion des stocks.
L’onglet contenant les blocages d’importation n’apparaît dans la fiche produit que si une interface de gestion des stocks est active. Il porte le nom de celle-ci, par exemple « Interface de données xoPort (XML) ».
Lors de l’importation de clients, la boutique ne modifie le groupe de clients que si le fichier mentionne un groupe existant dans la boutique. Un fichier allégé sans colonne « Groupe » conserve le groupetel quel. 4.9.139
Automatiquement via un lien et une tâche Cron
Chaque Porter dispose d’un lien d’exportation et, avec le répertoire d’importation automatique, d’un lien d’importation. Les deux se trouvent sous « Infos et liens ». Lorsque le portail de prix, le système de gestion des stocks ou une tâche Cron accèdent au lien, le Porter s’exécute sans connexion au backend.
Lien d’exportation
Le lien https://ihr-shop.example/xoport.php?id=<ID> génère un nouveau fichier à chaque consultation et le fournit. Vous devez enregistrer ce lien sur le portail de prix ou dans le système de gestion des stocks. Les rubriques protégées utilisent xoport/secure/xoport.php?id=<ID>. Le Porter doit être activé, sinon le lien renvoie le message « Porter is not active ! ».
Lien d’importation
- Dans les paramètres, sous « Répertoire d’importation automatique », créez un répertoire à l’aide de l’icône « + » et enregistrez-le.
- Le système de gestion des stocks stocke ses fichiers via FTP ou SFTP dans
xoport/import/<Verzeichnis>/. - Le lien
&action=importlit tous les fichiers CSV, TXT, XLS, XLSX et ODS du répertoire. Il déplace les fichiers importés avec succès dans le sous-dossierarchiv/; les fichiers erronés restent à leur emplacement d’origine.
« Infos et liens » affiche le fichier d'exportation enregistré, le lien d'exportation et, si le répertoire d'importation automatique est activé, le lien d'importation. Cliquez pour agrandir.
La boutique ne dispose pas de son propre système de planification pour Porter. Pour des exécutions régulières, créez chez votre hébergeur une tâche planifiée (cronjob) qui appelle le lien. Le lien d’importation renvoie STATUS=ok&Files=… ou STATUS=error&Files=…. Si une importation du même Porter est déjà en cours, le système affiche le message « Import already running » et n’en lance pas une deuxième.
Protéger les exportations
La possibilité de consulter une exportation sans connexion dépend de la rubrique et du statut du Porter.
Rubriques ouvertes
Les produits, les options de produits, les places de marché et les données relatives aux places de marché sont destinés aux portails de prix. Votre lien d’exportation et un fichier enregistré sous le nom « Server » dans le dossier xoport/ sont accessibles sans mot de passe tant que le Porter est activé. Désactivez les Porters qui ne sont pas nécessaires en externe et n’incluez pas de champs confidentiels, tels que le prix d’achat, dans un Porter ouvert.
Rubriques protégées
Les données relatives aux clients, aux commandes et toutes les autres données se trouvent dans xoport/secure/. Les fichiers qui y sont stockés sont verrouillés via le Web ; seul le lien d’exportation est accessible.ab 4.9.25
Protégez le lien à l’aide d’un identifiant et d’un mot de passe dans Paramètres → Général → Paramètres de base → Protéger les répertoires clients et commandes xoPort et, si possible, à l’aide d’adresses IP fixes dans Paramètres → Général → Paramètres de base → Filtre IP des répertoires clients et commandes xoPort.
Si le mot de passe et le filtre IP sont configurés, l'accès n'est possible qu'avec un mot de passe valide ou à partir d'une adresse IP autorisée. Dans le filtre IP, il est possible d'indiquer plusieurs adresses et plages, telles que 203.0.113.0/24, séparées par des virgules. Si le mot de passe est manquant, la boîte de dialogue d'exportation affiche un message d'avertissement en rouge.
Exporter les commandes et les clients
Porter exporte les commandes dans deux fichiers : les données de commande et les lignes de commande. Il exporte les clients avec leurs adresses et leurs indicateurs pour les analyses.
Deux Porter pour une commande
Un Porter de la rubrique « Données de commande (générales) » fournit, pour chaque commande, une ligne comprenant le client, l’adresse de facturation et de livraison, le paiement, l’expédition et les totaux. Un Porter de la rubrique « Données de commande (produits) » fournit une ligne par ligne de commande. Les deux sont reliés par le numéro de commande. Lorsque « Sélection d’exportation » = « Numéro de commande », vous associez le Porter des lignes de commande à la rubrique « Porter associé « Données de commande générales » ». Il n’exporte alors jamais plus de commandes que le premier.
Sélection d’exportation
- Numéro de commande : à partir d’un numéro, sous forme de plage (par exemple
100-150) ou avec-100pour toujours les 100 dernières commandes. Après une exportation, la boutique définit le numéro de départ sur la commande suivante, sauf en cas de valeurs négatives. - Statut : toutes les commandes avec le « statut avant exportation ». Ensuite, la boutique attribue le « nouveau statut après exportation » sans en informer le client.
- Toujours complet : toutes les commandes, par exemple en cas de changement de boutique.
- Période : commandes des derniers jours, valeur par défaut 30.
Ré-exporter et suivi
Pour réexporter une commande, réinitialisez le numéro de départ dans les paramètres ou remettez la commande au « statut avant exportation ». Vous pouvez spécifier des plages ponctuelles dans la boîte de dialogue d’exportation sous « Exporter uniquement les commandes avec numéro(s) de commande » ; le numéro de départ enregistré reste alors inchangé. Les commandes elles-mêmes ne peuvent pas être importées. Un importateur utilisant uniquement le « numéro de commande » ou le « numéro d’opération » et le « numéro de suivi » reprend toutefois les numéros d’expédition, séparés par des points-virgules.
Données client
Le Porter « Données client » exporte les comptes clients avec leurs adresses et leur groupe de clients. Sous « Détails des commandes du client », vous trouverez le « Nombre de commandes », la « Valeur nette des commandes », la « Valeur totale des commandes » et la « Date de la dernière commande », par exemple pour une segmentation. Les clients « invités » n’ont pas de compte client et ne figurent pas dans cette exportation. Leurs données se trouvent dans les données de commande.
Il existe des procédures spécifiques pour les analyses de chiffre d’affaires et les factures : Rapports → Export CSV du chiffre d’affaires fournit une ligne par commande avec le montant net, le montant brut et la taxe ; vous pouvez imprimer les factures de manière groupée à partir de l’aperçu des commandes. Pour en savoir plus, consultez le guide « Traiter les commandes ».
Erreurs courantes et solutions
Si une importation ne fonctionne pas comme prévu, cela est presque toujours dû à l’une de ces causes. Vérifiez-les dans l’ordre.
| Constat | Cause | Solution |
|---|---|---|
| Aucun traitement n'est effectué, message d'erreur rouge concernant la ligne d'en-tête | Le séparateur de champs du fichier ne correspond pas ; l'en-tête est lu comme une seule colonne | Harmoniser le séparateur dans le fichier et dans les paramètres |
| Une colonne est ignorée sans avertissement | L'en-tête de colonne diffère du « nom de colonne », même s'il s'agit simplement d'une différence entre majuscules et minuscules | Adaptez l'en-tête du fichier ou le nom de la colonne. Attention : la colonne sera alors prise en compte, par exemple un statut. |
| Les nouveaux articles ne sont pas créés | Pas de colonne « Nom », nom vide ou la langue de Porter n'est pas la langue par défaut | Ajouter une colonne « Nom », définir la langue de Porter comme langue par défaut |
| Prix erronés ou égaux à 0 | Points de séparation des milliers, prix brut sans indication de taxe ou virgule décimale sans l'option d'importation chg=,-->. | Chiffres sans séparateur de milliers ; vérifier l'option d'importation, importer les montants nets ou indiquer le taux d'imposition |
| Articles sans taxe | seul le nom d'une classe d'imposition figure dans le fichier, que la boutique ne reconnaît pas | Écrire les noms exactement comme dans la boutique ou fournir le taux d'imposition |
| Champs soudainement vides | cellules vides dans une colonne activée | Supprimer la colonne du fichier et de Porter ou remplir les valeurs |
| Les articles perdent leurs catégories | L'option « Copies de produits (liens) » est désactivée ; le fichier n'indique qu'une seule catégorie par article | Activer « Copies de produits (liens) » ou indiquer toutes les catégories |
| Les trémas ou caractères spéciaux sont incorrects | Fichier enregistré dans un autre jeu de caractères | Enregistrer au format autre que UTF-8 ; Excel : « CSV UTF-8 » |
| Les zéros non significatifs dans le code EAN ou la référence de l'article sont manquants | Excel a ouvert et enregistré le fichier CSV en tant que nombre | Exporter au format XLSX et modifier, ou importer la colonne dans Excel en tant que texte |
| Catégories ou fabricants en double | Importation dans une autre langue sans ID | Indiquer l'ID de catégorie ou l'ID du fabricant |
| De nombreuses nouvelles tranches d'imposition | La classe fiscale est orthographiée différemment dans le fichier par rapport à la boutique | Harmoniser l'orthographe, supprimer les classes en double |
| Le lien d’exportation renvoie le message « Porter is not active ! » | Le statut de Porter est désactivé | Activer le statut de Porter |
XML, API REST et progiciel de gestion des stocks
Le CSV-Porter est destiné aux fichiers que vous modifiez vous-même ou qu’un système enregistre régulièrement. Des interfaces sont disponibles pour la synchronisation continue avec un système de gestion des stocks.
API REST
L'interface JSON/REST de xoPort permet de lire et d'écrire des produits, des catégories, des clients, des commandes et bien plus encore. Vous pouvez créer vos identifiants d'accès dans Outils → Clients OAuth2 xoPort. La documentation de l'API décrit les points de terminaison, les champs et la procédure de connexion.
Interface XML
Les anciennes connexions aux systèmes de gestion des stocks fonctionnent avec l’interface XML de xoPort. Leurs champs sont également répertoriés dans la documentation de l’API.
Sa disponibilité est contrôlée via Paramètres → Interfaces → Systèmes de gestion des stocks/ERP/Comptabilité → Interface de données xoPort → xoPort : ancienne interface XML utilisable. Les nouvelles boutiques démarrent avec l’interface XML désactivée,tandis que les boutiques existantes la conservent activée. 4.9.78
Gestion des stocks et comptabilité
Il existe des intégrations spécifiques pour JTL-Wawi, Billbee, OpenXE, DATEV et Lexware Office. Nous serons ravis de discuter avec vous pour déterminer celle qui convient le mieux à votre entreprise.
Liste de contrôle avant la première importation
- Fichier de données personnalisé, copié à partir d'un fichier standard, ne contenant que les colonnes nécessaires.
- Sauvegarde : les mêmes colonnes ont été exportées et conservées au préalable.
- Fichier comportant la même en-tête, le même séparateur de champs et de texte, et au format UTF-8 ou XLSX.
- Colonne clé présente : ID produit ou référence article ; pour les clients, ID client ou adresse e-mail.
- Langue du fichier Porter vérifiée ; pour les nouveaux articles, la langue par défaut est utilisée.
- Option « Copies de produits (liens) » sélectionnée délibérément si le fichier contient des catégories.
- Pas de cellules vides dans les colonnes dont les valeurs doivent être conservées.
- Test effectué avec quelques lignes, analyse de l’importation lue, résultat vérifié dans la boutique.
- Le statut « Porter » n’est activé que si un lien externe est nécessaire.
Questions fréquentes
Pourquoi l’importation ne crée-t-elle pas de nouveaux articles à partir du fichier ?
Pourquoi l’importation CSV ne traite-t-elle pas les enregistrements ?
Pourquoi l’importation des prix échoue-t-elle et comment puis-je vérifier le fichier ?
chg=,-->. » et si vous fournissez des prix nets ou bruts. La boutique convertit les prix bruts en prix nets en appliquant le taux d’imposition de la ligne ou la classe d’imposition de l’article. L'analyse de l'importation et le rapport CSV indiquent chaque ligne rejetée avec la raison correspondante.Comment attribuer des catégories supplémentaires à des articles sans perdre celles qui existent déjà ?
Puis-je modifier l’ordre de tri des caractéristiques via une importation ?
Comment supprimer des caractéristiques via une importation CSV ?
del » dans la colonne « Statut » du Porter « Caractéristiques ». Pour supprimer toutes les caractéristiques d’un article, utilisez « delopt » dans la colonne « Statut » d’un Porter « Produit ». Utilisez pour cela une ligne distincte et inscrivez les autres modifications dans une deuxième ligne avec le statut 0 ou 1.Quel champ contrôle la vente d’un article ?
products eol. Ces articles ne peuvent pas être vendus au-delà du stock saisi.Comment importer des méta-textes ou des textes de catégorie ?
Les données sont-elles conservées dans la boutique lors de l'exportation ?
del ».Où puis-je trouver le fichier exporté sur le serveur ?
xoport/xoport_<ID>.<Format> ou, pour les données clients et commandes, xoport/secure/. Le chemin d’accès exact et la date du dernier fichier sont indiqués dans « Infos et liens ». Les flux pour Google Merchant Center sont générés via un chemin spécifique, voir Google Merchant Center & Flux de produits.Puis-je protéger les exportations Porter par un mot de passe ?
Comment exporter des commandes dans une plage de numéros ou les exporter à nouveau ?
100-150. Pour une nouvelle exportation, réinitialisez le numéro de départ ou, en cas d’exportation par statut, remettez la commande sur le « statut avant l’exportation ».Puis-je importer des commandes dans la boutique via CSV-Porter ?
Comment exporter les données clients, y compris celles des commandes d’invités ?
Comment omettre les lignes comportant un champ vide lors de l’exportation ?
skip= » sans valeur. Par exemple, avec « skip=0 », vous omettez les lignes contenant un 0. En revanche, sous « Options d’importation », « skip » signifie simplement que l’importation ignore toute la colonne.Quels formats d’image l’importation à partir d’une URL prend-elle en charge ?
path=catch ou path=catch_if_not_exists, Porter importe les images aux extensions JPG, JPEG, PNG, GIF et WebP à partir d’une URL et les enregistre dans la boutique. Sans cette option, il attend le nom de fichier d’une image qui se trouve déjà dans le dossier des images.Comment mettre à jour les informations du fabricant relatives à la sécurité des produits via une importation ?
DE. La boutique identifie le fabricant via l’« ID du fabricant » ou le « nom du fabricant ».Quel point de terminaison et quelles identifiants dois-je utiliser pour une importation via l’interface ?
Guides complémentaires
Nous mettons en place avec vous votre échange de données
Nous vous aidons à choisir le « Porter » adapté, à définir le mappage des colonnes pour votre système de gestion des stocks et à effectuer la première importation.
Contacter le service d'assistance dès maintenant
