Client pour le service EnvoiMoinsCher (http://www.envoimoinscher.com).
Le module traduit le XML de l'API d'EnvoiMoinsCher en JSON.
$ npm install node-envoimoinscher
Avant toute chose, l'identifiant, le mot de passe et une clé d'API sont nécessaires à l'authentification auprès d'EnvoiMoinsCher.
La clé d'API est à demander par mail.
Ces information sont nécessaires à l'initialisation du module:
var emc = require ( " node-envoimoinscher " ) ( {
username : " ... " ,
password : " ... " ,
key : " ... " ,
environment : " ... "
} ) ;
La propriété environment est optionnelle et peut prendre deux valeurs "prod" et "test". La valeur par défaut est "test".
callback suit la convention habituelle de Node.js, c'est à dire qu'il attend deux arguments :
err: (object) objet de type Error s'il existe une erreur, sinon null.data: (json) réponse de l'API convertie en JSON s'il n'y a pas d'erreur, sinon null.
conf, callback)Obtient l'ensemble des offres possibles ainsi qu'un récapitulatif de la demande.
conf: (json) contient les informations nécessaires à la demande de cotations.
Exemple:
{
" courriers " : [ { / / ( a r r a y ) u n e c o l l e c t i o n d ' o b j e t s r e p r é s e n t a n t l ' e n v o i
" type " : " colis " , / / ( s t r i n g ) t y p e d ' e n v o i : " pli " , " colis " , " encombrant " , " palette "
" hauteur " : 10 , / / ( i n t ) l a h a u t e u r , n e p a s r e n s e i g n e r s i l e c o u r r i e r e s t u n " pli "
" largeur " : 11 , / / ( i n t )
" longueur " : 12 , / / ( i n t )
" poids " : 13 , / / ( i n t )
" valeur " : 14 / / ( n u m b e r ) e n e u r o s
} ] ,
" code_contenu " : 80100 , / / ( i n t ) i d o b t e n u v i a e m c . c o n t e n t s B y C a t e g o r y ( ) , p a r e x e m p l e
" destinataire " : {
" pays " : " FR " , / / ( s t r i n g ) c o d e I S O d u p a y s v i a e m c . c o u n t r i e s ( ) , p a r e x e m p l e
" code_postal " : " 75001 " , / / ( s t r i n g )
" type " : " entreprise " / / ( s t r i n g ) t y p e d ' i n t e r l o c u t e u r : " particulier " , " entreprise "
} ,
" expediteur " : {
" pays " : " FR " ,
" code_postal " : " 13001 " ,
" type " : " entreprise "
} ,
" collecte " : " 2014-10-02 " , / / ( s t r i n g ) d a t e a u f o r m a t I S O Y Y Y Y - M M - D D
" delai " : " aucun " / / ( s t r i n g ) l e t r i d e l a r é p o n s e d é p e n d d e s a v a l e u r : " aucun " , " minimum " , " course "
}
Exemple:
emc . quotation ( conf , function ( err , data ) {
if ( err ) return console . log ( err ) ;
return console . log ( data ) ;
} ) ;
Extrait de réponse:
Il est possible voir à quoi ressemble une réponse dans quotation_response.json .
conf, callback)Effectue la commande et récupère l'objet retourné par EnvoiMoinsCher.
conf: (json) contient les informations nécessaires à la soumission d'une commande. C'est un objet conf de cotation étendu.
Exemple:
{
" courriers " : [ {
" type " : " colis " ,
" hauteur " : 10 ,
" largeur " : 10 ,
" longueur " : 10 ,
" poids " : 1 ,
" valeur " : 0 ,
" description " : " Du vide. "
} ] ,
" code_contenu " : 80100 ,
" destinataire " : {
" adresse " : " 1 rue de Rivoli " ,
" civilite " : " M. " ,
" code_postal " : " 75001 " ,
" email " : " bernard@lesbronzes.com " ,
" nom " : " Morin " ,
" pays " : " FR " ,
" prenom " : " Bernard " ,
" type " : " particulier " ,
" ville " : " Paris " ,
" tel " : " 06060606060 "
} ,
" expediteur " : {
" adresse " : " 1 avenue de la Canebière " ,
" civilite " : " M. " ,
" code_postal " : " 13001 " ,
" email " : " jc@lesbronzes.com " ,
" nom " : " Dusse " ,
" pays " : " FR " ,
" prenom " : " Jean-Claude " ,
" societe " : " bitbucket " , / / ( s t r i n g ) s i l a p a r t i e p r e n a n t e e s t d e t y p e " entreprise "
" type " : " entreprise " ,
" ville " : " Marseille " ,
" tel " : " 06060606060 "
} ,
" collecte " : " 2014-10-02 " ,
" delai " : " aucun " ,
" operateur " : " UPSE " ,
" service " : " Express " ,
" disponibilite " : {
" HDE " : " 11:00 " , / / ( s t r i n g ) a u f o r m a t I S O h h : m m
" HLE " : " 19:00 "
}
}
Exemple:
emc . order ( conf , function ( err , data ) {
if ( err ) return console . log ( err ) ;
return console . log ( data ) ;
} ) ;
Extrait de réponse:
Il est possible voir à quoi ressemble une réponse dans order_response_ok.json .
quotation)Rend les offres d'une cotation requêtable. Les méthodes mises à la chaîne rendent la requête facilement lisible et sont exécutées dans l'ordre.
L'exemple suivant retourne cinq offres de l'opérateur UPSE (UPS) classé dans le sens alphabétique contraire:
emc .
find ( data ) .
where ( " operator " ) .
is ( " UPSE " ) .
orderBy ( " service " ) .
desc ( ) .
limitTo ( 5 ) .
then ( function ( offers ) {
offers . forEach ( function ( elt ) {
console . log ( elt . service . label ) ;
} ) ;
} ) ;
data).where(type).is(value)Ces deux méthodes doivent être utilisées de pair.
type: (string) peut prendre pour valeur "collection", "delivery", "mode", "operator", "service"value: (string) peut prendre différentes valeur selon le filtre associé
collection: "COMPANY", "DROPOFF_POINT", "HOME", "POST_OFFICE"delivery: "COMPANY", "HOME", "PICKUP_POINT"mode: "COM", "SYN"operator: (string) libre, correspond au code de l'opérateur, par exemple "USPE"service: (string) libre, correspond au code du service, par exemple "ExpressNational18H"
data).orderBy(type)Permet d'ordonner les offres par type.
data).desc()Permet d'inverser l'ordre des offres.
data).limitTo(limit)Permet de imiter le nombre de résultats.
data).then(callback)Exécute le callback (function), return() et when() ne peuvent pas être utilisées ensemble.
callback ne prend qu'un seul argument:
offers: (array) collection d'offres.
data).return()Retourne la collection d'offres (array), return() et when() ne peuvent pas être utilisées ensemble.
Exemple:
var offers = emc .
find ( data ) .
where ( " operator " ) .
is ( " UPSE " ) .
orderBy ( " service " ) .
desc ( ) .
limitTo ( 5 ) .
return ( ) ;
callback)Obtient la liste complète des pays.
Exemple:
emc . countries ( function ( err , data ) {
if ( err ) return console . log ( err ) ;
return console . log ( data ) ;
} ) ;
Extrait de réponse:
{
" countries " : {
" country " : [
{
" code " : " P1 " ,
" label " : " ACORES (PORTUGAL) "
} ,
{
" code " : " AF " ,
" label " : " AFGHANISTAN "
} ,
/ / . . .
]
}
}
callback)Obtient la liste complète des catégories de contenus possibles.
Exemple:
emc . categories ( function ( err , data ) {
if ( err ) return console . log ( err ) ;
return console . log ( data ) ;
} ) ;
Extrait de réponse:
{
" content_categories " : {
" content_category " : [
{
" code " : 10000 ,
" label " : " Livres et documents "
} ,
{
" code " : 20000 ,
" label " : " Alimentation et matières périssables "
} ,
/ / . . .
]
}
}
callback)Obtient la liste complète des contenus possibles.
Exemple:
emc . contents ( function ( err , data ) {
if ( err ) return console . log ( err ) ;
return console . log ( data ) ;
} ) ;
Extrait de réponse:
{
" contents " : {
" content " : [
{
" code " : 100 ,
" label " : " Contenu non spécifié " ,
" category " : 0
} ,
{
" code " : 10100 ,
" label " : " Documents sans valeur commerciale " ,
" category " : 10000
} ,
{
" code " : 10120 ,
" label " : " Journaux " ,
" category " : 10000
} ,
/ / . . .
]
}
}
id, callback)Obtient la liste des contenus d'une catégorie.
id: (string) référence de la catégorie.
Exemple:
emc . contentsByCategory ( 80000 , function ( err , data ) {
if ( err ) return console . log ( err ) ;
return console . log ( data ) ;
} ) ;
Extrait de réponse:
{
" contents " : {
" content " : [
{
" code " : 80100 ,
" label " : " Produits culturels : livres, jeux, CD, DVD etc "
} ,
{
" code " : 80200 ,
" label " : " Appareils électroniques, Image et son etc "
} ,
/ / . . .
]
}
}
id, [country,] callback)Obtient le détail d'un point relais de départ.
id: (string) référence du point relai.country: (string) code pays ISO, "FR" par défaut.
Exemple:
emc . dropoff ( " SOGP-C3084 " , function ( err , data ) {
if ( err ) return console . log ( err ) ;
return console . log ( data ) ;
} ) ;
Extrait de réponse:
{
" dropoff_point " : {
" code " : " SOGP-C3084 " ,
" name " : " STOCK PREMIUM " ,
" address " : " 25 RUE RICHARD LENOIR " ,
" city " : " PARIS 11 " ,
" zipcode " : 75011 ,
" country " : " FR " ,
" phone " : { } ,
" description " : { } ,
" schedule " : {
" day " : [
{
" weekday " : 1 ,
" open_am " : " 11:00:00 " ,
" close_am " : " 15:00:00 " ,
" open_pm " : " 15:00:00 " ,
" close_pm " : " 20:00:00 "
} ,
/ / . . .
]
}
}
}
id, [country,] callback)Obtient le détail d'un point relais d'arrivée.
id: (string) référence du point relai.country: (string) code pays ISO, "FR" par défaut.
Exemple:
emc . pickup ( " SOGP-C3059 " , function ( err , data ) {
if ( err ) return console . log ( err ) ;
return console . log ( data ) ;
} ) ;
Extrait de réponse:
{
" pickup_point " : {
" code " : " SOGP-C3059 " ,
" name " : " PLASTIC SOUL RECORDS " ,
" address " : " 93, AVENUE LEDRU ROLLIN " ,
" city " : " PARIS 11 " ,
" zipcode " : 75011 ,
" country " : " FR " ,
" phone " : { } ,
" description " : { } ,
" schedule " : {
" day " : [
{
" weekday " : 1 ,
" open_am " : " $horaire.debut_am " ,
" close_am " : " $horaire.fin_am " ,
" open_pm " : " 16:30:00 " ,
" close_pm " : " 20:00:00 "
} ,
/ / . . .
]
}
}
}
