Fichier d'importation de commande

01/10/2020 logo_coursier.png Version 1.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 colis de natures différentes à une même addresse, le fichier doit contenir une ligne par nature de colis (exemple : 2 plis et un sac = 1 ligne pour les deux plis, 1 ligne pour le sac)

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)

Référence interne du client, nous pouvons sur simple demande splitter ou regrouper vos factures par Reference1

 

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...)

 

NumberOfPackage

O

Int

Nombre de colis similaires

 

Weight

O

double

Poids unitaire en kilos

 

Length

O

double

Longueur unitaire en cm

 

Width

O

double

Largeur unitaire en cm

 

Height

O

Double

Hauteur unitaire 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