Téléversement groupé de commandes

Téléchargez le modèle CSV directement depuis la page de téléversement dans Dashboard. Le modèle inclut toutes les colonnes requises et facultatives — les colonnes requises 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 multi-articles, de sorte qu'une commande de trois articles représente trois lignes. Les valeurs au niveau de la commande — destinataire, adresse, niveau de service, montant d'expédition, devise, duty paid by et carton — sont lues à partir de la première ligne de chaque groupe.

Colonnes requises 

Les informations requises pour chaque ligne se répartissent en trois catégories :

Destinataire — Le nom, le numéro de téléphone et l'adresse d'expédition du destinataire, y compris le pays de destination. L'e-mail est facultatif, mais il est validé au niveau du format si vous en fournissez un. Le code postal et l'État/province ne sont requis que pour les pays dont le format d'adresse les utilise — pour un pays sans code postal (par ex. Hong Kong ou la Tanzanie), laissez simplement la cellule vide. Pour les pays avec une liste d'États/provinces, utilisez un nom ou code de région reconnu (par ex. « Dubayy » ou « DU » pour Dubai) afin que les transporteurs puissent tarifer la destination.

Articles — Au minimum, le nom de l'article et le prix. La quantité est facultative et vaut 1 par défaut. Fournir un code HS 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 correspondant à un transporteur configuré sur votre compte (par ex. fedex.international_priority, ups_worldwide_expedited). La colonne Shipping Amount est facultative : saisissez un montant (0 est autorisé) pour l'utiliser comme frais d'expédition de la commande, ou laissez-la vide et une estimation tarifaire transporteur est calculée pour votre niveau de service. Les lignes calculées prennent quelques secondes supplémentaires chacune sur l'écran de confirmation, et les frais transporteur finaux à la création d'é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 uniquement sur ces lignes ; les lignes vides et remplies peuvent coexister librement dans un même fichier.

Colonnes facultatives 

Identifiant fiscal du destinataire — Utilisez les colonnes Tax ID Type et Tax ID Number pour inclure un identifiant fiscal du destinataire sur la commande. Le type doit être l'un des codes ci-dessous (insensible à la casse). Fournissez les deux colonnes ensemble ; un type sans numéro (ou vice versa) est signalé comme erreur sur l'écran de confirmation. L'identifiant fiscal est enregistré sur le destinataire de la commande et transmis au transporteur lors de la création d'une étiquette. Pour les commandes multi-articles, l'identifiant fiscal de la première ligne de la commande est utilisé.

Utilisez le code spécifique au pays lorsqu'il existe ; pour tout pays non listé, utilisez TIN.

Des codes à usage spécial supplémentaires (FED, FTZ, DUN, et les comptes de report de droits et taxes DAN/TAN/DTF) sont acceptés lorsque votre représentant Zonos vous indique d'en utiliser un.

Droits payés par — DDP ou DDU facultatif par commande. Laissez vide pour le comportement par défaut : DDP partout où la destination le prend en charge, avec repli automatique vers DDU là où ce n'est pas le cas. Un DDP explicite est strict — les lignes génèrent une erreur au lieu de basculer — et DDU rend le destinataire responsable des droits et taxes à la livraison. L'écran de confirmation et le téléchargement des résultats indiquent lequel chaque commande a effectivement reçu, avec un badge orange sur les lignes DDU. Pour les commandes multi-articles, la première valeur spécifiée l'emporte, et des valeurs contradictoires constituent une erreur.

Quantité de cartons — Si une commande est expédiée dans plusieurs cartons identiques, définissez Carton Quantity avec les colonnes Carton Length/Width/Height/Weight. Les colonnes carton décrivent un carton (le poids est celui d'un seul carton emballé), et la quantité le multiplie — par exemple, 360 unités emballées 30 par carton utiliseraient les dimensions du carton, le poids d'un carton plein et une quantité de cartons de 12. Vide signifie 1. Les commandes avec des tailles de cartons mixtes ne peuvent pas être décrites dans le CSV — laissez les colonnes carton vides sur ces commandes et Zonos les cartonnera automatiquement selon les poids des articles.

Conseils 

• Utilisez les codes de niveau de service exacts affichés dans vos paramètres transporteur. Les lignes avec des codes de niveau de service non reconnus afficheront un avertissement sur l'écran de confirmation.
• Les territoires US diffèrent : les US Virgin Islands utilisent leur propre code pays (VI) et sont expédiés en international, tandis que Puerto Rico utilise US et est expédié en domestique.
• Les transporteurs (UPS en particulier) refusent les adresses de boîte postale — les lignes avec « P.O. Box » dans une ligne d'adresse peuvent échouer au tarif avec une erreur générique de disponibilité de service. Utilisez une adresse postale lorsque c'est possible.
• La ponctuation typographique de Word ou Excel (guillemets courbes, tirets en/em) est corrigée automatiquement. Des points d'interrogation apparaissant à la place de lettres accentuées indiquent que le fichier a perdu son encodage — ces lignes sont signalées pour que vous puissiez ressaisir le texte.
• Pour les pays de destination exigeant un code d'État ou de province (par ex. Brésil, États-Unis, Canada), assurez-vous que le champ État est rempli avec le code ISO correct.
• L'Order ID est requis et doit être unique sur votre compte, y compris les téléversements précédents — un ID déjà utilisé (même dans un fichier d'une saison antérieure ou une commande annulée) est rejeté à la création. Vous réutilisez un fichier ? Ajoutez un suffixe aux ID (par exemple ACALB-33 pour le volume 33). L'ID apparaît sur l'écran de confirmation et est transmis à la commande créée comme référence marchand.
• Les noms de destinataire, adresses, ville, État/province, nom d'entreprise et noms d'article doivent utiliser des caractères latins. Les écritures non latines telles que le japonais ou l'arabe sont rejetées.
• Les lignes entièrement vides sont ignorées, donc les lignes vides en fin de fichier sont sans conséquence.

Chaque colonne du modèle standard, dans l'ordre du modèle. Conditionnel signifie que la colonne n'est requise que dans certains cas — voir Colonnes requises ci-dessus pour plus de détails.

Japan Post utilise son propre modèle CSV, téléchargé depuis la page de téléversement de la même manière. Il n'a aucune colonne de niveau de service — le téléversement attribue le premier niveau de service du transporteur et vous en resélectionnez un dans le flux d'étiquette — ni de colonne de quantité de cartons, car ces téléversements sont toujours expédiés en un seul carton.

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

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

Le modèle ajoute également des champs d'expédition Japan Post qui sont enregistrés sur la commande et appliqués à l'envoi lors de la création d'une é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 accepte uniquement true ou false.

Après le téléversement, un écran de confirmation affiche la répartition du coût rendu calculé pour chaque commande avant toute création. L'écran affiche :

Les lignes peuvent afficher 0 USD de droits, taxes et frais lorsque la destination ne prélève pas de frais d'importation à la valeur déclarée de l'envoi (elle est en dessous du seuil de minimis du pays) — le coût rendu est réellement zéro, pas manquant, et l'expédition est le seul coût pour ces commandes.

Le bouton Create orders affiche le nombre de commandes qui seront soumises (par ex. Create 17 orders). Seules les lignes avec le statut Ready ou Warning sont incluses — les lignes avec erreurs sont exclues.

Utilisez Download results CSV pour exporter la répartition complète du devis (tarif sélectionné, total articles, expédition, droits, taxes, frais et totaux par commande) — utile pour deviser vos clients avant toute création de commande. 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 niveau de service affiche le tarif correspondant au niveau de service de votre CSV. Si le niveau de service demandé n'est pas disponible pour une destination, le tarif disponible le plus proche est sélectionné et signalé avec un badge Different service level — ou, lorsque plusieurs alternatives 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 en ligne sur l'écran de confirmation.

Erreurs 

Les lignes avec erreurs sont exclues lorsque vous cliquez sur Create orders. Corrigez le problème dans votre CSV et retéléversez pour inclure ces lignes. Erreurs courantes :

• Low-value orders not allowed — La valeur de la commande est inférieure au seuil minimum pour votre boutique.
• Invalid state code — Le code d'État ou de province n'est pas valide pour le pays de destination. Requis pour des pays comme le Brésil, les États-Unis et le Canada.
• Missing required field — Une colonne requise est vide ou ne peut pas être analysée.
• Order ID already exists — Chaque ID de commande doit être unique sur votre compte, y compris les commandes des téléversements précédents. Les lignes avec des ID déjà utilisés échouent à la création tandis que le reste du fichier réussit — retéléversez uniquement les lignes échouées avec de nouveaux ID (un suffixe comme -33 fonctionne bien).

Avertissements 

Les lignes avec avertissements sont incluses dans la soumission. Examinez-les avant de cliquer sur Create orders. Avertissements courants :

• Service level not configured — Le code de niveau de service dans votre CSV n'est pas connecté à votre compte. La commande sera créée mais peut ne pas se tarifer correctement. Vérifiez vos paramètres transporteur 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 de jusqu'à 50 par appel API — si votre téléversement contient plus de 50 commandes prêtes, elles sont traitées en plusieurs lots automatiquement.

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