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 : <<client_id>>_YYYYMMDD_<<file_id>>.
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

No Comments