Cet article fournit un guide complet sur l'importation efficace de commandes à l'aide d'un fichier CSV. Simplifiez votre gestion des commandes en important des commandes en masse, éliminant ainsi le besoin de saisie manuelle.
Préparation de votre fichier CSV pour l'importation
Avant de lancer le processus d'importation, assurez-vous que votre fichier CSV est correctement structuré. Téléchargez le modèle CSV pour garantir un formatage précis des données. Chaque ligne du fichier CSV doit représenter un article individuel, permettant aux commandes de s'étendre sur plusieurs lignes. Utilisez la colonne « orderReferenceId » pour lier les articles à leurs commandes correspondantes.
Remarque : Si les en-têtes de colonnes apparaissent dans une seule colonne lors de l'ouverture d'un fichier CSV dans Excel, essayez ces solutions alternatives :
Utilisez Google Sheets : Ouvre correctement les fichiers CSV avec des colonnes séparées.
Ajustement manuel dans Excel : Convertissez le fichier au format correct en plaçant chaque en-tête dans une colonne séparée.
Pour chaque ligne, incluez les détails essentiels de la commande :
Identifiant de référence de commande
Détails d'expédition
Détails de l'article
URLs pour chaque zone d'impression
Pour une explication détaillée des champs requis dans le fichier CSV, consultez la page « Soumettre une commande » dans notre documentation API.
Importer des commandes : guide étape par étape
Suivez ces étapes pour importer vos commandes en toute simplicité :
Connectez-vous à Gelato Connect
Ajouter une boutique manuelle.
Accédez à la page des commandes dans GelatoConnect Storefronts et cliquez sur le bouton « Importer ».
Choisissez le magasin désigné pour vos commandes importées. Ces commandes seront marquées comme passées depuis le magasin sélectionné. Vous avez également la possibilité de les importer en tant que commandes manuelles.
Téléchargez le fichier CSV contenant les commandes que vous souhaitez importer. Vous pouvez également télécharger un nouveau modèle CSV depuis cette page.
Vérifiez bien que vous avez sélectionné la boutique de destination et le fichier d'importation corrects. Une fois que tout est en ordre, cliquez sur \"Importer\" pour commencer le processus d'importation.
Vous recevrez une notification confirmant le lancement du processus d'importation.
Une fois le processus d'importation terminé, nous vous enverrons une notification par e-mail. Cet e-mail vous fournira un résumé de l'importation, notamment :
Le nombre total de commandes dans le fichier d'importation.
Le nombre de commandes importées avec succès.
Le nombre de commandes dont l'importation a échoué.
De plus, l'e-mail contiendra un fichier CSV contenant les résultats détaillés de l'importation. Ce fichier comportera trois colonnes :
identifiantRéférenceCommande
résultat (indiquant « réussite » ou « échec » pour chaque commande)
erreurs (fournissant des raisons spécifiques pour tout échec d'importation)
Comprendre les paramètres requis pour l'importation de fichiers CSV
Vous trouverez ci-dessous une explication détaillée des paramètres nécessaires, ainsi que les références de documentation correspondantes, pour vous aider à remplir le tableau avec précision.
Cette méthode est principalement utilisée par celles et ceux qui testent la plateforme avant d'intégrer nos API ou de passer des commandes ponctuelles.
Informations générales sur la commande
orderReferenceId – Affiche le numéro de commande dans le tableau de bord Gelato. Exemple :
G-250202201217.customerReferenceId – Référence d'identifiant client interne.
orderType – Peut être défini comme
draft, mais par défaut estorder.shipmentMethodUid – Indique la méthode d'expédition :
normal,standardouexpress.devise – Devise utilisée pour le paiement.
retailShippingPriceInclVat, retailCurrency, item.retailPriceInclVat – Utilisés dans l'analyse et diverses zones de la plateforme, y compris les formulaires de douane.
Détails de l'adresse de livraison
Ces paramètres correspondent aux champs d'adresse standard :
shippingAddress.firstName
shippingAddress.lastName
shippingAddress.addressLine1
Adresse de livraison, complément d'adresse
shippingAddress.city
shippingAddress.postCode
shippingAddress.state
shippingAddress.country
shippingAddress.email
shippingAddress.phone
shippingAddress.companyName
Informations sur le produit
item.itemReferenceId – Correspond à l’
ID de référence de l’articledans la commande. Pour les commandes sur une plateforme d’E-commerce, il est attribué automatiquement. Pour les commandes manuelles, il doit être défini.item.productUid
item.storeProductVariantId
item.quantity – Indique le nombre d’unités commandées.
item.pageCount – Requis pour les produits comportant plusieurs pages (par exemple, les brochures).
Paramètres spécifiques à la broderie
Pour les motifs de broderie, des paramètres supplémentaires sont requis.
article.ajusterUidProduitSelonTypesDeFichiers
item.file1.id, item.file1.type, item.file1.url, item.file1.threadColors, item.file1.fitMethod, item.file1.fillMethod
item.file2.id, item.file2.type, item.file2.url, item.file2.threadColors, item.file2.fitMethod, item.file2.fillMethod
Étant donné que la soumission de commandes par CSV nécessite une gestion continue des feuilles de calcul et la préparation de fichiers prêts à imprimer, nous vous recommandons d'utiliser des options de traitement des commandes plus rationalisées via l'intégration API. Cette approche optimise l'efficacité et réduit les efforts manuels.