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.

Colonnes requises 

Chaque ligne représente une commande. Les informations requises pour chaque ligne se répartissent en trois catégories :

Destinataire — Le nom, l'e-mail, le numéro de téléphone et l'adresse d'expédition du destinataire, y compris le pays de destination. 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 Tanzania), 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, nom de l'article, quantité et prix. 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.

Duty Paid By — 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. Brazil, US, 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.

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 Brazil, US et 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.