FTP et échanges de fichiers
Aperçu
ZigZag propose une intégration via le protocole de transfert de fichiers (FTP).
Il s'agit d'un protocole standard utilisé pour transmettre des fichiers plats au format CSV (de votre système vers le serveur via un réseau).
Nous proposons deux types de connexions FTP:
- FTP V1
- FTP V2
FTP v1 - Suivi des colis
La version FTP v1 vous permet de nous transmettre simultanément les informations de commande et de suivi (c'est-à-dire uniquement lorsque le numéro de suivi est connu).
Cette version est plus simple à configurer, mais plus limitée que la v2.
FTP v2 - Commandes
La version v2 introduit la notion de fulfillment (préparation des colis), qui permet d'activer les fonctionnalités suivantes:
- Expéditions en plusieurs colis
- Pré-expédition
- Processus de traitement en magasin
- Contenu des commandes et des colis
- Smart State "Order without tracker" (pour détecter les retards de préparation des colis)
Informations importantes
-
Le fichier doit être encodé en UTF-8 pour pouvoir être importé.
-
Code transporteur + numéro de suivi - Il est important de renseigner ces deux informations ensemble. Si vous ne connaissez pas encore le numéro de suivi, vous n'avez pas besoin de renseigner le champ
carrier_code.En revanche, si vous connaissez le numéro de suivi, le champ
carrier_codeest obligatoire. -
v1 vs v2 - Les fichiers doivent être déposés dans le dossier upload pour FTP v1 et dans le dossier uploadV2 pour FTP v2.
-
Langues - Vous pouvez renseigner les langues à utiliser selon cette nomenclature (en minuscules). Dans le cas contraire, nous utiliserons la langue du pays du destinataire.
-
Évitez les guillemets doubles ("") - Les guillemets doubles ("…") peuvent être présents dans un fichier CSV, mais vous devez vous assurer que les champs n'en contiennent pas lors de l'importation des fichiers.
-
Fréquence de mise à jour des fichiers - Nous synchronisons les informations toutes les heures. Nous vous recommandons de déposer votre fichier plusieurs fois par jour.
-
Synchronisation manuelle - Vous pouvez déclencher manuellement la synchronisation de l'importation des fichiers en accédant à Paramètres du portail -> Paramètres des notifications -> Intégrations, puis en cliquant sur les trois points à côté de FTP et en sélectionnant Synchronisation manuelle.
Champs requis
Vous trouverez ci-dessous les champs à configurer dans vos fichiers CSV.
Champs requis pour la v1
| Valeur | Description | Obligatoire ou facultatif |
|---|---|---|
| carrier_code | Utilisez notre nomenclature des codes transporteurs pour identifier le transporteur chargé du colis. | Obligatoire |
| carrier_service_code | Renseignez les codes des services de transport pour obtenir des dates de livraison estimées plus précises (obligatoire pour la fonctionnalité SDE). La nomenclature doit respecter notre documentation technique. | Facultatif (mais fortement recommandé) |
| tracking_number | Numéro de suivi du colis (doit être une référence officielle utilisée par le transporteur). | Obligatoire |
| Adresse e-mail du client. | Facultatif (mais fortement recommandé) | |
| order_number | Référence de la commande. | Obligatoire |
| order_date | Date de création de la commande. | Facultatif (mais fortement recommandé) |
| first_name | Prénom du client. | Facultatif (mais fortement recommandé) |
| last_name | Nom du client. | Facultatif (mais fortement recommandé) |
| address_name | Nom associé à l'adresse du client. | Facultatif (mais fortement recommandé) |
| address_street | Adresse postale du client. | Facultatif (mais fortement recommandé) |
| address_city | Ville du client. | Facultatif (mais fortement recommandé) |
| address_zip | Code postal du client. | Facultatif (mais fortement recommandé) |
| address_country | Utilisez la nomenclature internationale (en majuscules). Exemple pour la France: FR. | Facultatif (mais fortement recommandé) |
| language_code | Langue à utiliser pour les notifications (en minuscules). Consultez notre documentation technique. | Facultatif (mais fortement recommandé) |
| phone | Numéro de téléphone du client. Format international: +33 ou 0033. Format national: ZigZag ajoutera l'indicatif international en fonction de l'adresse de livraison. | Facultatif |
| warehouse_merchant_id | Référence de l'entrepôt en cas d'utilisation de plusieurs entrepôts (utile pour la mise en place de la fonctionnalité SDE). | Facultatif |
| store_id | Référence du compte ZigZag (en cas de comptes multiples). | Facultatif |
| order.custom_variable | Variables Liquid personnalisées permettant de proposer une expérience client hautement personnalisée (texte des notifications, contenu de la page de suivi, etc.). | Facultatif |
Champs requis pour la v2
| Valeur | Description | Obligatoire ou facultatif |
|---|---|---|
| order.merchant_id | Référence garantissant l'unicité de la commande. Si les numéros de commande sont uniques, vous pouvez les utiliser directement comme référence. | Obligatoire |
| ordered_at | Date de commande. | Facultatif (mais fortement recommandé) |
| order.order_number | Numéro de commande. | Obligatoire |
| order.email | Adresse e-mail du client. | Facultatif (mais fortement recommandé) |
| order.first_name | Prénom du client. | Facultatif (mais fortement recommandé) |
| order.last_name | Nom du client. | Facultatif (mais fortement recommandé) |
| order.language_code | Langue à utiliser pour les notifications (en minuscules). Consultez notre documentation technique. | Facultatif (mais fortement recommandé) |
| fulfillment.merchant_id | Référence unique du colis. | Obligatoire |
| fulfillment.fulfillment_number | Numéro du colis. | Obligatoire |
| fulfillment.status_code | Statut de pré-expédition (utilisé pour les notifications de pré-expédition). Consultez notre documentation technique. | Facultatif |
| shipping_address.address1 | Adresse de livraison du colis. | Facultatif (mais fortement recommandé) |
| shipping_address.city | Ville de livraison du colis. | Facultatif (mais fortement recommandé) |
| shipping_address.country | Pays du destinataire. | Facultatif (mais fortement recommandé) |
| shipping_address.country_code | Utilisez la nomenclature internationale (en majuscules). Exemple pour la France: FR. | Facultatif (mais fortement recommandé) |
| shipping_address.first_name | Prénom du destinataire. | Facultatif (mais fortement recommandé) |
| shipping_address.last_name | Nom du destinataire. | Facultatif (mais fortement recommandé) |
| shipping_address.zip | Code postal de l'adresse de livraison. | Facultatif (mais fortement recommandé) |
| line_item.merchant_id | Référence unique de l'article. | Facultatif (mais fortement recommandé) |
| line_item.title | Nom de l'article. | Facultatif (mais fortement recommandé) |
| line_item.sku | Référence SKU de l'article. | Facultatif |
| line_item.quantity | Quantité de l'article. | Obligatoire |
| line_item.thumbnail.src | URL de l'image de l'article. | Obligatoire |
| tracker.carrier_code | Code transporteur. Consultez notre documentation technique. | Obligatoire |
| tracker.carrier_service_code | Codes des services de transport permettant d'obtenir des dates de livraison estimées plus précises (obligatoire pour la fonctionnalité SDE). La nomenclature doit respecter notre documentation technique. | Facultatif |
| tracker.tracking_number | Numéro de suivi du colis (doit être une référence officielle utilisée par le transporteur). | Obligatoire |
| fulfillment.warehouse_merchant_id | Référence de l'entrepôt en cas d'utilisation de plusieurs entrepôts (requise pour la fonctionnalité SDE). | Facultatif |
| order.store_id | Référence du compte Shipup (en cas de comptes multiples). | Facultatif |
| order.custom_variables | Variables Liquid personnalisées permettant de proposer une expérience client hautement personnalisée (notifications, contenu de la page de suivi, etc.). Consultez notre documentation technique pour connaître le format des variables personnalisées. | Facultatif |
Comment configurer une connexion FTP
- Contactez votre Account Manager ou notre équipe d'assistance pour demander l'accès au serveur FTP.
- Nous vous enverrons vos identifiants de connexion dès qu'ils seront disponibles.
- Préparez le fichier CSV en vous assurant que tous les champs obligatoires sont correctement renseignés.
- Transmettez le fichier à votre interlocuteur ZigZag pour vérification et validation.
- Après validation, une importation de test sera effectuée pour vérifier que les colis sont correctement suivis dans ZigZag.
- Une fois le bon fonctionnement confirmé, vous pourrez automatiser le dépôt des fichiers sur le serveur (nous vous recommandons de programmer plusieurs synchronisations par jour).