Téléverser des commandes en lot

Téléchargez le modèle CSV directement à partir de la page de téléversement dans Dashboard. Le modèle comprend toutes les colonnes obligatoires et facultatives — les colonnes obligatoires sont marquées d'un astérisque (*) dans la ligne d'en-tête.

Une ligne par article 

Chaque ligne représente un article, et non une commande. Les lignes qui partagent le même Order ID sont regroupées en une seule commande à plusieurs articles; une commande de trois articles occupe donc trois lignes. Les valeurs propres à la commande — destinataire, adresse, niveau de service, montant de l'expédition, devise, partie qui paie les droits et carton — sont lues à partir de la première ligne de chaque groupe.

Colonnes obligatoires 

Les renseignements obligatoires pour chaque ligne se répartissent en trois catégories :

Destinataire — Le nom, le numéro de téléphone et l'adresse de livraison du destinataire, y compris le pays de destination. Le courriel est facultatif, mais son format est validé si vous en fournissez un. Le code postal et l'État ou la province ne sont obligatoires que pour les pays dont le format d'adresse les utilise — pour un pays sans code postal (p. ex., Hong Kong ou la Tanzanie), laissez simplement la cellule vide. Pour les pays dotés d'une liste d'États ou de provinces, utilisez un nom ou un code de région reconnu (p. ex., « Dubayy » ou « DU » pour Dubaï) afin que les transporteurs puissent établir un tarif pour la destination.

Articles — Au minimum, le nom et le prix de l'article. La quantité est facultative et vaut 1 par défaut. Fournir un code SH et un pays d'origine améliore la précision de la classification et peut réduire le temps de traitement sur l'écran de confirmation.

Expédition — Un code de niveau de service qui correspond à un transporteur configuré dans votre compte (p. ex., fedex.international_priority, ups_worldwide_expedited). La colonne Shipping Amount est facultative : saisissez un montant (0 est permis) pour l'utiliser comme frais d'expédition de la commande, ou laissez-la vide pour qu'une estimation du tarif du transporteur soit calculée selon votre niveau de service. Chaque ligne calculée prend quelques secondes de plus sur l'écran de confirmation, et les frais finaux du transporteur à la création de l'étiquette peuvent différer de l'estimation. Certaines destinations ne peuvent pas être tarifées automatiquement (erreur « service not available for destination country ») — saisissez un montant d'expédition seulement sur ces lignes; les lignes vides et remplies peuvent coexister librement dans un même fichier.

Colonnes facultatives 

Numéro d'identification fiscale du destinataire — Utilisez les colonnes Tax ID Type et Tax ID Number pour ajouter un numéro d'identification fiscale du destinataire à la commande. Le type doit être l'un des codes ci-dessous (sans égard à la casse). Fournissez les deux colonnes ensemble; un type sans numéro (ou l'inverse) est signalé comme une erreur sur l'écran de confirmation. Le numéro d'identification fiscale est enregistré avec le destinataire de la commande et transmis au transporteur lors de la création de l'étiquette. Pour les commandes à plusieurs articles, c'est le numéro de la première ligne de la commande qui est utilisé.

Utilisez le code propre au pays lorsqu'il en existe un; pour tout pays non mentionné, utilisez TIN.

D'autres codes à usage particulier (FED, FTZ, DUN, ainsi que les comptes de report des droits et taxes DAN/TAN/DTF) sont acceptés lorsque votre représentant Zonos vous demande d'en utiliser un.

Duty Paid By — DDP ou DDU, facultatif, par commande. Laissez la cellule vide pour le comportement par défaut : DDP partout où la destination le permet, avec un repli automatique sur DDU ailleurs. Un DDP explicite est strict — les lignes génèrent une erreur au lieu de se replier — et DDU rend le destinataire responsable des droits et taxes à la livraison. L'écran de confirmation et le fichier de résultats téléchargé indiquent l'option réellement appliquée à chaque commande, avec un badge orange sur les lignes DDU. Pour les commandes à plusieurs articles, la première valeur indiquée l'emporte, et des valeurs contradictoires constituent une erreur.

Quantité de cartons — Si une commande est expédiée dans plusieurs boîtes identiques, définissez Carton Quantity en plus des colonnes Carton Length/Width/Height/Weight. Les colonnes de carton décrivent une seule boîte (le poids est celui d'une seule boîte emballée), et la quantité la multiplie — par exemple, 360 unités emballées à raison de 30 par boîte utiliseraient les dimensions de la boîte, le poids d'une boîte pleine et une quantité de cartons de 12. Une cellule vide signifie 1. Les commandes comportant des boîtes de tailles différentes ne peuvent pas être décrites dans le CSV — laissez les colonnes de carton vides pour ces commandes, et Zonos les emballera automatiquement en fonction du poids des articles.

Conseils 

• Utilisez les codes de niveau de service exacts affichés dans vos paramètres de transporteurs. Les lignes dont le code de niveau de service n'est pas reconnu afficheront un avertissement sur l'écran de confirmation.
• Les territoires américains diffèrent : les îles Vierges des États-Unis utilisent leur propre code de pays (VI) et sont expédiées à l'international, tandis que Porto Rico utilise US et est expédié comme envoi intérieur.
• Les transporteurs (UPS en particulier) refusent les adresses de livraison à une case postale — les lignes contenant « P.O. Box » dans une ligne d'adresse peuvent échouer à la tarification avec une erreur générique de disponibilité du service. Utilisez une adresse municipale dans la mesure du possible.
• La ponctuation typographique provenant de Word ou d'Excel (guillemets courbes, tirets demi-cadratin et cadratin) est corrigée automatiquement. Des points d'interrogation à la place de lettres accentuées indiquent que le fichier a perdu son encodage — ces lignes sont signalées pour que vous puissiez saisir le texte de nouveau.
• Pour les pays de destination qui exigent un code d'État ou de province (p. ex., le Brésil, les États-Unis, le Canada), assurez-vous que le champ de l'État est rempli avec le bon code ISO.
• L'Order ID est obligatoire et doit être unique dans l'ensemble de votre compte, y compris les téléversements précédents — un ID déjà utilisé auparavant (même dans le fichier d'une saison précédente ou pour une commande annulée) est refusé à la création de la commande. Vous réutilisez un fichier? Ajoutez un suffixe aux ID (par exemple ACALB-33 pour le volume 33). L'ID s'affiche sur l'écran de confirmation et est reporté sur la commande créée comme référence du marchand.
• Les noms des destinataires, les adresses, la ville, l'État ou la province, le nom de l'entreprise et le nom des articles doivent utiliser des caractères latins. Les écritures non latines, comme le japonais ou l'arabe, sont refusées.
• Les lignes entièrement vides sont ignorées; les lignes vides à la fin de votre fichier ne posent donc aucun problème.

Toutes les colonnes du modèle standard, dans l'ordre du modèle. Conditionnelle signifie que la colonne n'est obligatoire que dans certains cas — consultez Colonnes obligatoires ci-dessus pour plus de détails.

Japan Post utilise son propre modèle CSV, qui se télécharge de la même façon à partir de la page de téléversement. Il ne comporte aucune colonne de niveau de service — le téléversement attribue le premier niveau de service du transporteur, et vous en sélectionnez un de nouveau dans le processus de création d'étiquette — ni de colonne de quantité de cartons, puisque ces envois sont toujours expédiés en un seul carton.

Colonnes facultatives dans le modèle standard, mais obligatoires pour Japan Post :

• HS code
• Country of origin
• Item weight — l'unité de poids reste facultative ici et correspond aux grammes par défaut
• Postal code
• State/province
• Shipping amount — contrairement au modèle standard, cette colonne ne peut pas être laissée vide

Le modèle ajoute aussi des champs d'expédition propres à Japan Post, qui sont enregistrés avec la commande et appliqués à l'envoi lors de la création de l'étiquette : Contents Type, Licence Number, Certificate Number, Invoice, Tax Code/VAT Number, Pay Condition, Remarks, Sender's Reference Number et Non-commercial. Tous sont facultatifs. Les champs texte acceptent jusqu'à 25 caractères, et Non-commercial n'accepte que true ou false.

Après le téléversement, un écran de confirmation affiche la ventilation du landed cost calculé pour chaque commande avant que quoi que ce soit ne soit créé. L'écran présente :

Des lignes peuvent afficher 0 $ de droits, de taxes et de frais lorsque la destination ne perçoit pas de frais d'importation à la valeur déclarée de l'envoi (celle-ci étant inférieure au seuil de minimis du pays) — le landed cost est réellement nul, et non manquant, et l'expédition est alors le seul coût de ces commandes.

Le bouton Create orders affiche le nombre de commandes qui seront soumises (p. ex., Create 17 orders). Seules les lignes à l'état Ready ou Warning sont incluses — les lignes comportant des erreurs sont exclues.

Utilisez Download results CSV pour exporter la ventilation complète des soumissions (tarif sélectionné, total des articles, expédition, droits, taxes, frais et totaux par commande) — pratique pour préparer des soumissions à vos clients avant de créer des commandes. Cliquez sur Start over pour abandonner le téléversement et recommencer avec un fichier révisé.

Lorsque vous laissez Shipping Amount vide, la colonne du niveau de service affiche le tarif qui correspond au niveau de service de votre CSV. Si le niveau de service demandé n'est pas offert pour une destination, le tarif disponible le plus proche est sélectionné et signalé par un badge Different service level — ou, lorsque plusieurs options existent, un menu déroulant Select a rate vous permet de choisir avant que la commande puisse être créée.

Les problèmes sont signalés directement sur l'écran de confirmation.

Erreurs 

Les lignes comportant des erreurs sont exclues lorsque vous cliquez sur Create orders. Corrigez le problème dans votre CSV et téléversez-le de nouveau pour inclure ces lignes. Erreurs courantes :

• Low-value orders not allowed — La valeur de la commande est inférieure au seuil minimal de votre boutique.
• Invalid state code — Le code d'État ou de province n'est pas valide pour le pays de destination. Obligatoire pour des pays comme le Brésil, les États-Unis et le Canada.
• Missing required field — Une colonne obligatoire est vide ou ne peut pas être analysée.
• Order ID already exists — Chaque ID de commande doit être unique dans l'ensemble de votre compte, y compris les commandes de téléversements précédents. Les lignes dont l'ID a déjà été utilisé échouent à la création, alors que le reste du fichier est traité avec succès — téléversez de nouveau seulement les lignes en échec avec de nouveaux ID (un suffixe comme -33 convient bien).

Avertissements 

Les lignes comportant des avertissements sont incluses dans la soumission. Passez-les en revue avant de cliquer sur Create orders. Avertissements courants :

• Service level not configured — Le code de niveau de service de votre CSV n'est pas associé à votre compte. La commande sera créée, mais la tarification pourrait être inexacte. Vérifiez vos paramètres de transporteurs ou mettez à jour le code de niveau de service dans votre CSV.

La limite actuelle de téléversement est de 200 commandes par CSV. Les commandes sont soumises par lots d'au plus 50 par appel d'API — si votre téléversement contient plus de 50 commandes prêtes, elles sont automatiquement traitées en plusieurs lots.

Bientôt offert : Une prochaine mise à jour supprimera la limite de 200 commandes et ajoutera le traitement en arrière-plan pour les téléversements plus volumineux.