Skip to main content

Fichier d'importation de commande

01/10/2025 image-1662457811981.png 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