WRIM presentation 3

WRIM API


 

Utilisation du webservice :

Pour accéder aux données d'un ou plusieurs utilisateurs :

1/ Créez un compte client et une licence :

Vous créez votre compte client, puis vous souscrivez à une licence WRIM Web API, depuis votre interface client :
https://wrim-mycar.pro/licences

Une fois votre compte validé, un QRCode correspondant à votre licence, sera mis à disposition sur votre interface client.


2/ Associer les smartphones avec votre licence :

Il suffit alors à chacun des utilisateurs de lire ce QRCode pour associer son smartphone à votre licence.


3/ Par sécurité, vous devez confirmez les utilisateurs qui demandent une association avec votre licence :

Depuis votre interface client, vous acceptez les utilisateurs qui ont lu le QRCode, et qui demandent donc à s'associer à votre licence :
https://wrim-mycar.pro/licences


4/ Vos utilisateurs choisissent les informations qui vous seront accessibles :

Pour cela, ils indiquent à partir de leur interface d'administration, les trajets effectués dans le cadre professionnel, en cochant la case correspondante :


Ces données sont alors accessibles par le webservice.

L'icone de "note" est également cliquable, et permet de documenter une fiche de visite client.
Ces fiches sont aussi accessibles via le webservice.


Un logiciel de test est mis à votre disposition gratuitement, WRIM Charts, dans le but d'évaluer les fonctionnalités de WRIM API.


Pour tester les différentes requêtes :











 


Dans la série d'exemple ci-dessus, le code IMEI est "WRIM". Dans votre cas, le code sera le code IMEI du smartphone de l'utilisateur.

Description des requêtes

Différentes requêtes HTTP sont disponibles, afin de permettre le développement de solutions personnalisées.
Ces requêtes peuvent être appelées depuis un logiciel sur un ordinateur, une application pour mobile, ou depuis un navigateur internet.

Cet exemple montre comment passer des requêtes entre différents domaines, en javascript :

$.ajax({type: "GET", url: "https://wrim-mycar.com/admin/WRIM_Licence_list.php?login=WRIM&soc=WRIM&id_wrim=15021001&mdp=c1e7a812fc617af589eedbc3093032b7", cache: false, timeout: 10000, jsonp: "jsoncallback", dataType: "jsonp", crossDomain: true, success: function (myDatas) {...

La réponse est au format JSON

Extraire les utilisateurs associés à votre licence :


Les utilisateurs associés à une licence seront dans cette liste. Seules les données des utilisateurs d'une licence WRIM Web API, pourront être consultées.

https://wrim-mycar.com/admin/WRIM_Flotte_getList.php?login=#&soc=#&mdp=#&id=#


login : identifiant permettant d'accéder à votre compte client.
soc : nom court de la société, affiché dans votre interface client.
id : Identifiant WRIM.
mdp : md5 du mot de passe permettant d'accéder à votre compte client.


Cette requête fournie les données suivantes :

Retour 'Ok' si les données envoyées sont valides. 'NOk' en cas de problème.
Status N'existe que si 'Retour' = 'NOk', pour décrire le problème.
Liste.Android_id Identifiant WRIM
Liste.config.Manufacturer Constructeur du smartphone
Liste.config.ModelId Identifiant du model du smartphone
Liste.config.ModelName Nom du model du smartphone
Liste.config.Serial N° de serial du smartphone
Liste.config.AndroidRelease Version d'android

 

Extraire les trajets (points de départs et d'arrivées) :


Les trajets sont décrits par un point de départ, un point d'arrivée, une distance parcourue (calculée via le GPS) et un temps (calculée par le smartphone).

https://wrim-mycar.com/admin/WRIM_Extract_Trajets.php?login=#&soc=#&id=#&mdp=#&mois=#


login : identifiant permettant d'accéder à votre compte client.
soc : nom court de la société, affiché dans votre interface client.
id : Identifiant WRIM.
mdp : md5 du mot de passe permettant d'accéder à votre compte client.
mois : liste des trajets du mois, exprimé avec le format YYYYMM.

Cette requête fournie les données suivantes :

Retour 'Ok' si les données envoyées sont valides. 'NOk' en cas de problème.
Status N'existe que si 'Retour' = 'NOk', pour décrire le problème.
Liste.name Nom du déplacement. Permet d'identifier un déplacement, ainsi que les positions GPS associées.
Liste.timeStamp Heure du mobile lors de la lecture de la position GPS..
Liste.note Indique si une note est renseignée. Le champ "Name" du trajet = champ "fcdName" de la note
Liste.imei Code IMEI du mobile.
Liste.lat Latitude de la position GPS du début ou de la fin du trajet.
Liste.lng Longitude de la position GPS du début ou de la fin du trajet.
Liste.geocod Adresse postale déterminée par la position GPS.
Liste.parseGeocod Adresse postale complète, avec ';' comme séparateur :
N° rue;nom rue;code postal;ville;département;région;pays
Liste.etatDeplacement Egal à "start" ou "end", pour indiquer le point de départ, ou le point d'arrivée.
Liste.distanceDeplacement Distance du trajet, en mètres, renseignée avec le point d'arrivée.
Liste.dureeDeplacement Durée du trajet, en secondes, renseignée avec le point d'arrivée.
Liste.bt_mac Adresse mac du bluetooth du véhicule de l'utilisateur.
Liste.etatArret Arrêt tel qu'il a été renseigné par l'utilisateur, depuis son interface d'administration.

 

Extraire les tracklogs:


Cette requête permet d'extraire les points GPS qui décrivent précisément les routes empruntées par l'utilisateur, pendant son trajet, justifiant la durée du trajet, et son kilométrage.

https://wrim-mycar.com/admin/WRIM_Extract_TrackLogs.php?login=#&soc=#&id=#&mdp=#&mois=#


login : identifiant permettant d'accéder à votre compte client.
soc : nom court de la société, affiché dans votre interface client.
id : Identifiant WRIM.
mdp : md5 du mot de passe permettant d'accéder à votre compte client.
mois : liste des trajets du mois, exprimé avec le format YYYYMM.

Cette requête fournie les données suivantes :

Retour 'Ok' si les données envoyées sont valides. 'NOk' en cas de problème.
Status N'existe que si 'Retour' = 'NOk', pour décrire le problème.
Liste.name Nom du déplacement. Permet d'identifier un déplacement, ainsi que les positions GPS associées.
Liste.lat Latitude de la position GPS.
Liste.lng Longitude de la position GPS.
Liste.imei Code IMEI du mobile.
Liste.timeStamp Heure du mobile lors de la lecture de la position GPS.

 

Extraire les notes de visites clients :


Depuis l'interface web d'administration, le bouton permet à l'utilisateur de documenter ses visites clients. L'exploitation de ces données participe à tirer le meilleur parti des visites clients, et d'en analyser leur valeur ajoutée.

https://wrim-mycar.com/admin/WRIM_Notes_get.php?login=#&soc=#&id=#&mdp=#&mois=#


login : identifiant permettant d'accéder à votre compte client.
soc : nom court de la société, affiché dans votre interface client.
id : Identifiant WRIM.
mdp : md5 du mot de passe permettant d'accéder à votre compte client.
mois : liste des trajets du mois, exprimé avec le format YYYYMM.

Cette requête fournie les données suivantes :

Retour 'Ok' si les données envoyées sont valides. 'NOk' en cas de problème.
Status N'existe que si 'Retour' = 'NOk', pour décrire le problème.
Liste.imei Identifiant du mobile.
Liste.name Nom du déplacement. Permet d'identifier un déplacement.
Liste.lat Latitude de la position GPS du mobile, décrivant le client.
Liste.lng Longitude de la position GPS du mobile, décrivant le client.
Liste.duree Temps passé chez le client, exprimé sous la forme 00h00
Liste.hDeb Heure d'arrivée sous la forme 00h00
Liste.hFin Heure de départ sous la forme 00h00
Liste.adresse Chaine de caractère encodée en base64
Liste.nomClient Chaine de caractère encodée en base64
Liste.typeVisite Valeurs possibles : "Type du contact", "Prospect", "Projet prospect", "Projet client", "Client régulier", "Client perdu de vue", "Intervention facturable", "Intervention sous garantie", "Intervention gratuite"
Liste.descriptionVisite Chaine de caractère encodée en base64
Liste.reponsesClient Chaine de caractère encodée en base64
Liste.reprendreContact Valeurs possibles : "comm", "tech"

 

Extraire les facturettes :


L'application pour mobile WRIM permet aux utilisateurs de prendre des photos de leurs facturettes. Une fois documentées et cochées, ces renseignements sont accessibles via le webservice.

https://wrim-mycar.com/admin/WRIM_Extract_Facturettes.php?login=#&soc=#&id=#&mdp=#&mois=#


login : identifiant permettant d'accéder à votre compte client.
soc : nom court de la société, affiché dans votre interface client.
id : Identifiant WRIM.
mdp : md5 du mot de passe permettant d'accéder à votre compte client.
mois : liste des trajets du mois, exprimé avec le format YYYYMM.

Cette requête fournie les données suivantes :

Retour 'Ok' si les données envoyées sont valides. 'NOk' en cas de problème.
Status N'existe que si 'Retour' = 'NOk', pour décrire le problème.
Liste.imei Identifiant du mobile.
Liste.name Nom du déplacement. Permet d'identifier un déplacement.
Liste.exif_dateheure Date et heure de la prise de la photo.
Liste.exif_largeur Largeur en pixels de la photo.
Liste.exif_hauteur Hauteur en pixels de la photo.
Liste.exif_lat Latitude de la prise de la photo.
Liste.exif_lng Longitude de la prise de la photo.
Liste.date Date d'enregistrement de la facturette sur le serveur WRIM.
Liste.ocr_date Renseigné par l'OCR : date de la facturette.
Liste.ocr_TTC Renseigné par l'OCR : valeur TTC de la facturette.
Liste.ocr_type Renseigné par l'OCR : type de facturettes.
Liste.ocr_HT Renseigné par l'OCR : valeur HT de la facturette.
Liste.ocr_TVA_1 Renseigné par l'OCR : TVA à 5%.
Liste.ocr_TVA_2 Renseigné par l'OCR : TVA à 10%.
Liste.ocr_TVA_3 Renseigné par l'OCR : TVA à 20%.
Liste.type Type de la facturette, renseignée par l'utilisateur.
Liste.tarif Valeur TTC renseignée par l'utilisateur.
Liste.description Description de la facturette par l'utilisateur.
Liste.typeVisite Valeurs possibles : "Type du contact", "Prospect", "Projet prospect", "Projet client", "Client régulier", "Client perdu de vue", "Intervention facturable", "Intervention sous garantie", "Intervention gratuite"

Types de facturettes possibles : OTH (Autre), PKG (Parking), REST (Restaurant), PGE (Péage), HTL (Hotel), TSP (Transport)

Extraire la photo d'une facturette :


La photo de la facturette est également disponible, via le webservice.

https://wrim-mycar.com/admin/WRIM_Extract_ImageFacturette.php?&login=#&soc=#&id=#&mdp=#name=#


login : identifiant permettant d'accéder à votre compte client.
soc : nom court de la société, affiché dans votre interface client.
id : Identifiant WRIM.mdp : md5 du mot de passe permettant d'accéder à votre compte client.
mdp : md5 du mot de passe permettant d'accéder à votre compte client.
name
 : identifiant de la photo à télécharger. La valeur est fournie par "Liste.name" de la requête précédente.

Cette requête fournie une image au format jpeg de la facturette.

Abonnement intégrateur (webservice)

WRIM propose un système de géolocalisation par smartphone avec des fonctionnalités de type tracker, mais plus simple à mettre en place, à maintenir, et moins coûteux.

Comparé à l'abonnement WRIM pro, l'abonnement WRIM API permet d'accéder aux données d'utilisateurs, une fois que les données sont mises à disposition.

Fonctionannt par abonnement, WRIM API permet de :

  • Accéder aux déplacements professionnels des utilisateurs.
  • Consulter le kilométrage/coût de ces déplacements.
  • Identifier les clients visités par les positions GPS, ou les adresses.
  • Connaitre le temps passé pour les déplacements en clientèle.
  • Connaitre le temps passé chez les clients.
  • Lister les positions GPS, décrivant chaque déplacement.
  • Consulter les notes de visites chez les clients.
  • Génerer de nombreuses statistiques à partir de ces renseignements.
  • Traiter les notes de frais de déplacements, à moindre coût.
  • Estimer les emissions de CO² des véhicules.
  • etc...


Cet abonnement est sans engagement de durée.

L'application pour mobile et le site d’administration WRIM peuvent être personnalisés, selon vos besoins, sur devis.