Fichier d'importation de commande 01/10/2025 Version 2.1 Objectif Dans le cas de tournées ponctuelles ou en attendant une intégration par API, nous pouvons importer vos fichiers de missions. Vous pouvez les adresser directement à notre administration des ventes ou les déposer automatiquement sur notre serveur SFTP (accès à demander auprès de votre commercial). Le compte doit être en facturation mensuelle pour être éligible à l'importation. Protocole Les fichiers doivent être au format CSV UTF8 (séparateur ";" et champs texte entre ""). Le nom du fichier doit respecter la nomenclature suivante : <>_YYYYMMDD_<>. Depuis Excel, choisir Enregistrer sous puis le format de fichier suivant : Liste des champs En cas d'envoi de plusieurs colis pour la même mission, il convient d'avoir une ligne par colis en répétant les informations d'adresse et en les regroupant les uns à la suite des autres, ils seront importés en une seule mission. NOM REQUIS TYPE DESCRIPTIF FromAddress.Company O Varchar(50) Nom de l'Entreprise d'enlèvement dans le cas d'une société FromAddress.Address O Varchar(120) Numéro et rue de l'adresse d'enlèvement FromAddress.PostalCode O Varchar(10) Code Postal de l’adresse d’enlèvement FromAddress.City O Varchar(50) Ville d’enlèvement FromAddress.Country O Varchar(50) Pays d’enlèvement (exemple : France) FromAddress.Contact O Varchar(50) Contact d’enlèvement FromAddress.EMail N Varchar(100) Email d’enlèvement FromAddress.PhoneNumber O Varchar(30) Téléphone d’enlèvement FromAddress.Comment N Varchar(100) Précision enlèvement. L'information est enregistrée avec le contact créé, elle doit donc être liée à l'adresse ou le contact comme un code porte, une consigne (ne pas mettre un numéro de colis par exemple) ToAddress.Company N Varchar(50) Nom de l'Entreprise à livrer dans le cas d'une société ToAddress.Address O Varchar(120) Numéro et rue de l’adresse de livraison ToAddress.PostalCode O Varchar(10) Code Postal de l’adresse de livraison ToAddress.City O Varchar(50) Ville de livraison ToAddress.Country O Varchar(50) Pays de livraison (exemple : France) ToAddress.Contact O Varchar(50) Contact de livraison ToAddress.EMail N Varchar(100) Email de livraison ToAddress.PhoneNumber O Varchar(30) Téléphone de livraison ToAddress.Comment N Varchar(100) Précision livraison. L'information est enregistrée avec le contact créé, elle doit donc être liée à l'adresse ou le contact comme un code porte, une consigne (ne pas mettre un numéro de colis par exemple) ServiceId O int Nature de la prestation sous forme d'Id en fonction des accord contractuels. Ces codes vous sont données à la création du compte et vous pouvez également les récupérer en temps réel en appelant l'API devis qui vous donnera les services disponibles pour votre compte pour la date choisie. Pour tester (1=course en Normal, 2=course en Exclu,  3=course en double Exclu, 10=sur créneau 2h) StartDate N DateHeure Par défaut égale à maintenant, permet de spécifier une date en différé par exemple pour tenir compte d'un cutoff. Format « YYYY-MM-DD HH:MM:SS ». Dans le cas d'un créneau, il s'agit de la date de début du créneau. Reference1 N Varchar(50) Numéro de commande du client Reference2 N Varchar(50) Référence interne du client, nous pouvons sur simple demande splitter ou regrouper vos factures par Reference2 Reference3 N Varchar(50) Référence interne du client, nous pouvons sur simple demande splitter ou regrouper vos factures par Reference3 PackageName O Varchar(32) Texte libre : nature du colis (Pli, Colis, Sac, Palette...) Pour des raisons de sécurité, éviter de préciser une nature d'objet dans le cas de marchandise à forte valeur (montre, bijou...) Tracking O Varchar(40) Numéro de suivi du colis qui apparait sur les étiquettes pour le scan Weight O double Poids en kilos Length O double Longueur en cm Width O double Largeur en cm Height O Double Hauteur en cm Si vous ne disposez pas des mesures précises de vos envois, vous pouvez vous référer à la grille standard ci dessous Name Weight Length Width Height Exemple XS 1 30 20 5 Pli S 3 30 25 25 Petit Colis M 5 40 30 30 Moyen colis L 15 60 40 40 Gand Colis XL 100 80 60 100 Demi Palette XXL 250 80 120 100 Palette Les colisages erronées peuvent entrainer un supplément et un retard de livraison Fichier de retour Un fichier de retour est généré avec les champs suivants ajoutés au fichier original et envoyé par email à l'email de contact du client. NOM Taille DESCRIPTIF MissionNumber int Numéro de la course, c'est ce numéro qui permet de dialoguer avec notre coursier, le service client et l'API de tracking PickupStartDate Datetime Début du créneau d’enlèvement PickupEndDate Datetime Fin du créneau d’enlèvement DeliveryStartDate Datetime Début du créneau de livraison DeliveryEndDate Datetime Fin du créneau de livraison Price Float Prix HT de la prestation CO2 Float Emissions de CO2 générées pour faire cette prestation (en kg) Exemple de fichier Template Excel à enregistrer au format csv : https://api.coursier.fr/7000000_20201001_1.xlsx Template csv : https://api.coursier.fr/7000000_20201001_1.csv Exemple de données en réponse MissionNumber: 9999999, PickupStartDate:2020-06-22 18:20:09, PickupEndDate: 2020-06-22 19:20:09, DeliveryStartDate: 2020-06-22 19:20:09, DeliveryEndDate: 2020-06-22 21:20:09, price:99.99, CO2:2.5