Cet article te propose un guide complet pour importer tes commandes efficacement à l'aide d'un fichier CSV. Simplifie ta gestion des commandes en les important en masse, sans avoir à les saisir manuellement.

Préparer ton fichier CSV pour l'importation

Avant de lancer le processus d'importation, assure-toi que ton fichier CSV est correctement structuré. Télécharge le modèle CSV pour garantir un formatage précis des données. Chaque ligne du fichier CSV doit représenter un article unique, ce qui permet aux commandes de s'étendre sur plusieurs lignes. Utilise la colonne « orderReferenceId » pour relier les articles à leurs commandes correspondantes.

Remarque : Si les en-têtes de colonnes apparaissent dans une seule colonne lors de l'ouverture d'un CSV dans Excel, essaie ces solutions :

Utilise Google Sheets : ouvre les fichiers CSV correctement avec des colonnes séparées.
Ajuster manuellement dans Excel : Convertis le fichier au bon format en plaçant chaque en-tête dans une colonne séparée.

Pour chaque ligne, inclus les détails essentiels de la commande :

ID de référence de commande
Détails de livraison
Détails de l'article
URL pour chaque zone d'impression

Pour une explication détaillée des champs requis dans le fichier CSV, consulte la page « Create order » dans notre documentation API. Cette ressource complète fournit des informations précieuses pour structurer efficacement tes données d'importation : Create order.

Importer des commandes : un guide étape par étape

Suis ces étapes pour importer tes commandes en toute simplicité :

Accède à ta page Commandes et clique sur le bouton « Importer ».
Choisis la boutique désignée pour tes commandes importées. Ces commandes seront marquées comme passées depuis la boutique sélectionnée. Tu as aussi la flexibilité de les importer en tant que commandes manuelles.
Télécharge le fichier CSV contenant les commandes que tu veux importer. Tu peux aussi télécharger un nouveau modèle CSV depuis cette page.
Vérifie bien que tu as sélectionné la boutique de destination et le fichier d'importation corrects. Une fois que tout est en ordre, clique sur « Importer » pour lancer le processus d'importation.
Tu recevras une notification confirmant le lancement du processus d'importation.
Une fois le processus d'importation terminé, nous t'enverrons une notification par e-mail. Cet e-mail fournira un résumé de l'importation, incluant :
- Le nombre total de commandes dans le fichier d'importation.
- Le nombre de commandes importées avec succès.
- Le nombre de commandes qui n'ont pas pu être importées.

De plus, l'e-mail inclura un fichier CSV contenant les résultats détaillés de l'importation. Ce fichier comportera trois colonnes :

orderReferenceId
result (indiquant « succès » ou « échec » pour chaque commande)
erreurs (en fournissant des raisons spécifiques pour tout échec d'importation)

Comprendre les paramètres requis pour le fichier CSV à importer

Ci-dessous, tu trouveras une description détaillée des paramètres nécessaires et leurs références de documentation correspondantes pour t'aider à compléter le tableau avec précision.

Cette méthode est principalement utilisée par ceux qui testent la plateforme avant de s'intégrer à nos API ou de soumettre 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'ID client interne.
orderType – Peut être défini comme draft, mais par défaut sur order.
shipmentMethodUid – Spécifie la méthode d'expédition : normal, standard, ou express.
currency – Devise utilisée pour le paiement.
retailShippingPriceInclVat, retailCurrency, item.retailPriceInclVat – Utilisé 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 du paiement :

shippingAddress.firstName
shippingAddress.lastName
shippingAddress.addressLine1
shippingAddress.addressLine2
shippingAddress.city
shippingAddress.postCode
shippingAddress.state
shippingAddress.country
shippingAddress.email
shippingAddress.phone
shippingAddress.companyName

Détails fiscaux et de conformité

shippingAddress.federalTaxId – Le numéro d'identification fiscale fédérale du destinataire. Utilisé pour fournir le CPF/CNPJ pour un destinataire brésilien. Obligatoire pour le Brésil. Pour fournir le CNPJ au lieu du CPF, définis isBusiness sur true.
shippingAddress.stateTaxId – Le numéro d'identification fiscale d'État du destinataire. Utilisé pour fournir l'IE pour un destinataire brésilien. Obligatoire pour le Brésil si le destinataire est une entreprise. Pour renseigner ce champ, définis isBusiness sur true.
shippingAddress.registrationState – Le code numérique d'un état américain ou l'équivalent pour d'autres pays, définissant l'état où l'entreprise destinataire est enregistrée. Obligatoire pour le Brésil si le destinataire est une entreprise. Pour renseigner ce champ, définis isBusiness sur true.

Informations sur le produit

item.itemReferenceId – Correspond à Item Reference ID dans la commande. Pour les commandes de plateforme e-commerce, cela est attribué automatiquement. Pour les commandes manuelles, cela doit être défini.
item.productUid – Suis notre guide sur les UID de produits et comment mapper les produits selon les standards de Gelato.
item.storeProductVariantId – Fournis l'ID de variante depuis l'URL de la boutique, par exemple, https://dashboard.gelato.com/stores/e92a3ee9-e494-41bf-a031-ca80e2fa3558/products/edit/04076663-f5a3-4701-af66-be932c676697.
item.quantity – Spécifie le nombre d'unités commandées.
item.pageCount – Requis pour les produits multipages (par ex., brochures).

Paramètres spécifiques à la broderie

Pour les motifs de broderie, des paramètres supplémentaires sont requis. Consulte le Guide de broderie pour tous les détails.

item.adjustProductUidByFileTypes
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 via CSV nécessite une gestion continue des feuilles de calcul et la préparation de fichiers prêts à imprimer, nous te recommandons d'utiliser des options de traitement des commandes plus fluides via l'intégration API. Cette approche optimise l'efficacité et réduit les efforts manuels. Pour plus de détails, consulte notre Documentation API Gelato.

Comment importer des commandes via un fichier CSV ?