Connecteurs - FTP

IMPORT DES FICHIERS CSV PAR FTP

FTP (File Transfert Protocol) est un protocole de communication destiné au partage de fichiers. Il permet de copier des fichiers vers un autre ordinateur du réseau, ou de modifier des fichiers sur cet ordinateur.

Dans Shippingbo, cela permet d'importer des commandes, des produits, ou de mettre à jour le stock dans notre solution à partir d'un fichier CSV prédéfini. 

Dans le cas d'un import de commandes, cela permet d'importer des commandes qui ne remonteraient pas dans notre solution avec une connexion en direct avec la source de commande.

Si vous n'utilisez pas de logiciel pour gérer vos FTP, nous pouvons vous proposer d'utiliser FileZilla. Si vous le souhaitez, vous pouvez le télécharger depuis votre navigateur. 

 

ATTENTION

Pour configurer le FTP pour la première fois dans votre compte Shippingbo, merci de vous rapprocher du support afin qu'il fasse le nécessaire.

La configuration devant être réalisée par nos équipes, la connexion d'un FTP est une prestation facturée : 

     - S'il s'agit d'un FTP Shippingbo : 150€ pour la configuration, puis un abonnement à 12€ par mois. 

     - S'il s'agit d'un FTP externe : 240€ pour la configuration.

 

Se connecter à son FTP

 

S'il s'agit d'un FTP Shippingbo : 

Les informations nécessaires à la connexion d'un FTP vous seront transmises par le support. 

Ces informations sont les suivantes : 

  • host : hôte de votre FTP
  • user : votre identifiant
  • password : votre mot de passe

 

ATTENTION

Après 5 tentatives de connexion ratées en 10 minutes, votre IP sera bannie pendant 1 heure et toutes les nouvelles tentatives de connexion résultera en échec (même avec les bons identifiants).
Cela permet de prévenir les abus et de garantir la disponibilité des opérations de Shippingbo et la sécurité des données de ses clients.

 

S'il s'agit d'un FTP externe :

Il faudra nous communiquer les informations de connexion afin que nous puissions réaliser la configuration : 

  • host : hôte de votre FTP
  • user : votre identifiant
  • password : votre mot de passe

 

Options disponibles pour la remontée des commandes sur FTP

 

Une fois le FTP activé, vous pouvez vous rendre dans Configurations→Services externe→ +GenericSftp CsvBased pour consulter les options disponibles correspondant à votre FTP : 

  • tous les champs "..._directory:" sont des champs correspondant au dossier à partir duquel nous récupérons l'information ou vers lequel nous poussons l'information. Par exemple : "orders" pour récupérer les commandes et "shipments" pour renvoyer les informations d'expédition.

  • "col_sep:" il s'agit du séparateur de colonne désigné, à appliquer dans les fichiers csv à importer. Ce peut être une virgule, ou un point virgule.

  • "datetime_fmt:" il s'agit du format de date, ce dernier doit toujours être "%d/%m/%Y"

  • "push_only_on_create:" cette option permet de ne pousser les informations qu'à la création de la commande , notamment si la référence de la commande existe déjà et que vous ne souhaitez pas que les modifications soient possibles si la même référence remonte à nouveau dans le FTP.

 

Créer son fichier CSV à importer

 

ATTENTION

Il est très important de respecter la trame du fichier afin de garantir le succès de l'import par la suite. Les règles suivantes sont notamment à respecter : 

  • Toujours respecter les entêtes des colonnes
  • Toujours conserver les colonnes qui sont obligatoires pour l'import
  • Supprimer les colonnes qui sont vides
  • Enregistrer le fichier au format CSV
  • Respecter l'encodage UTF-8
  • Respecter le séparateur de colonne tel que configuré sur votre compte Shippingbo

 

Vous pouvez retrouver en fin de page un fichier détaillant les différentes colonnes qui peuvent être renseignées ainsi que les consignes à bien respecter pour l'import.

 

Import de commandes :

Voici un exemple de fichier à importer dans "orders" : 

 

Voici un exemple de fichier retourné dans "shipments":

Import de produits :


Import de stock :

 

Déposer un fichier sur votre FTP

 

Renseignez vos informations d’accès au FTP, puis cliquez sur le bouton "Connexion" :

Déposez vos fichiers dans le dossier "orders" en double cliquant sur ce dossier, puis faites un clic droit sur le fichier que vous souhaitez importer dans la partie gauche (1) et sélectionnez "envoyer". 

 

REMARQUE

Vous pouvez aussi faire glisser le fichier de la partie gauche vers la partie droite.

 

Nous enverrons les retours d’information dans le dossier "shipments".

 

Optionnel : configurer un SFTP pour l'export de données

 

Ce tutoriel porte sur la configuration d'un serveur FTP pour l'import de données dans Shippingbo. 

Vous pourrez potentiellement être amené à vouloir automatiser l'export de données depuis Shippingbo sur un SFTP. 

Pour cela, nous vous invitons à consulter notre tutoriel sur la configuration d'un FTP/SFTP pour l'export automatique de données.