WRIM est une marque déposée par VDL Solutions

Team-API

Récupérez les données brutes de l’application et intégrez-les dans votre solution

Exploitez vos données de déplacements dans votre propre solution. Avec Team-API récupérez les données générées par vos équipes commerciales et techniques.

Guide d’utilisation de l’API WRIM :

Utilisation du webservice :

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

  • Créez un compte client et une licence : Vous créez votre compte client, puis vous souscrivez à une licence WRIM-API, depuis votre interface client : https://team-licences.wrim-solutions.com. Une fois votre compte validé, un QRCode correspondant à votre licence, sera mis à disposition sur votre interface client.
  • Associer les smartphones avec votre licence : Il suffit alors à chacun des utilisateurs de lire ce QRCode pour associer son smartphone à votre licence.
  • Par sécurité, vous devez confirmer 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://team-licences.wrim-solutions.com.
  • 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’icône de « note » est également cliquable, et permet de documenter une fiche de visite client. Ces fiches sont aussi accessibles via le webservice.

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://team-api.wrim-solutions.com/WRIM-API_GetLicences_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-API, pourront être consultées via le lien : https://team-api.wrim-solutions.com/WRIM-API_GetLicences.php?login=#&domaine=#&mdp=#&id_licence=#.

  • login : identifiant permettant d’accéder à votre compte client
  • domaine: nom court de la société, affiché dans votre interface client
  • mdp : md5 du mot de passe permettant d’accéder à votre compte client

Cette requête fournit 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.android_id

Identifiant WRIM.

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.

 

1/ Notes de frais

1.1/ 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. Accessible via le lien suivant : https://team-api.wrim-solutions.com/WRIM-API-NDF_GetTrackLogs.php?login=#&domaine=#&id_licence=#&mdp=#&mois=#&android_id=#.

  • login : identifiant permettant d’accéder à votre compte client
  • domaine: nom court de la société, affiché dans votre interface client
  • android_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 fournit 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.

 

1.2/ 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. Accessible via le lien suivant : https://team-api.wrim-solutions.com/WRIM-API-NDF_GetNotes.php?login=#&domaine=#&id_licence=#&mdp=#&mois=#&android_id=#.

  • login : identifiant permettant d’accéder à votre compte client
  • domaine : nom court de la société, affiché dans votre interface client
  • android_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 fournit 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.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 »

 

1.3/ 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. Accessible via le lien suivant : https://team-api.wrim-solutions.com/WRIM-API-NDF_GetFacturettes.php?login=#&domaine=#&id_licence=#&mdp=#&mois=#&android_id=#.

  • login : identifiant permettant d’accéder à votre compte client
  • domaine : nom court de la société, affiché dans votre interface client
  • android_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 fournit 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.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_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).

 

1.4/ Extraire la photo d’une facturette

La photo de la facturette est également disponible avec le webservice via le lien suivant : https://team-api.wrim-solutions.com/WRIM-API-NDF_GetImageFacturette.php?&login=#&domaine=#&id_licence=#&mdp=#name=#&android_id=#.

  • login : identifiant permettant d’accéder à votre compte client
  • domaine : nom court de la société, affiché dans votre interface client
  • android_id : Identifiant WRIM
  • 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.

2/ Géolocalisation

2.1/ Géolocaliser un véhicule

La géolocalisation d’un véhicule est disponible avec le webservice via le lien suivant : https://team-api.wrim-solutions.com/WRIM-API-GEO_GetPosition.php?&login=#&domaine=#&id_licence=#&mdp=#&android_id=#.

  • login : identifiant permettant d’accéder à votre compte client
  • domaine: nom court de la société, affiché dans votre interface client
  • android_id : Identifiant WRIM
  • mdp : md5 du mot de passe permettant d’accéder à votre compte client

Cette requête fournit 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.nomTrajet

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

Identifiant WRIM

Liste.timeStamp

Heure du mobile lors de la lecture de la position GPS.

Liste.timeCreated

Heure du serveur lors de la lecture de la position GPS.

Liste.geocod

Adresse postale déterminée par la position GPS.

Liste.batLevel

Niveau de la batterie du smartphone. Valeur positive si le smartphone est en charge.

Liste.cap

Direction par rapport au nord, fournie par le GPS.

 

2.2/ Géolocaliser tous les véhicules d’une licence

La géolocalisation des véhicules associés à une licence est disponible avec le webservice via le lien suivant : https://team-api.wrim-solutions.com/WRIM-API-GEO_GetPosition.php?&login=#&domaine=#&id_licence=#&mdp=#.

  • login : identifiant permettant d’accéder à votre compte client
  • domaine: nom court de la société, affiché dans votre interface client
  • id_licence : numéro de licence WRIM
  • mdp : md5 du mot de passe permettant d’accéder à votre compte client

Cette requête fournit 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.nomTrajet

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

Identifiant WRIM

Liste.timeStamp

Heure du mobile lors de la lecture de la position GPS.

Liste.timeCreated

Heure du serveur lors de la lecture de la position GPS.

Liste.geocod

Adresse postale déterminée par la position GPS.

Liste.batLevel

Niveau de la batterie du smartphone. Valeur positive si le smartphone est en charge.

Liste.cap

Direction par rapport au nord, fournie par le GPS.

 

2.3/ Extraire un trajet

L’extraction d’un trajet d’un véhicule est disponible avec le webservice via le lien suivant : https://team-api.wrim-solutions.com/WRIM-API-GEO_GetPosition.php?&login=#&domaine=#&id_licence=#&mdp=#&name=#&android_id=#.

  • login : identifiant permettant d’accéder à votre compte client
  • domaine: nom court de la société, affiché dans votre interface client
  • android_id : identifiant WRIM
  • nom_trajet : nom du trajet a extraire
  • mdp : md5 du mot de passe permettant d’accéder à votre compte client

Cette requête fournit 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.nomTrajet

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

Identifiant WRIM

Liste.timeStamp

Heure du mobile lors de la lecture de la position GPS.

Liste.timeCreated

Heure du serveur lors de la lecture de la position GPS.

Liste.geocod

Adresse postale déterminée par la position GPS.

Liste.batLevel

Niveau de la batterie du smartphone. Valeur positive si le smartphone est en charge.

Liste.cap

Direction par rapport au nord, fournie par le GPS.

 

Conclusion

Fonctionnant par abonnement, Team-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
  • 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
  • Traiter les notes de frais de déplacements, à moindre coût
  • Analyser les coûts des déplacements à partir des notes de frais
  • Estimer les émissions de CO² des véhicules.
  • Etc…

Cet abonnement est sans engagement de durée. Vous pouvez télécharger gratuitement l’application 

VDL Solutions

    Adresse 1 Mail Gay Lussac 95000 Neuville-sur-Oise
VOIR L'ADRESSE
MASQUER L'ADRESSE
Les CGU Les CGV La politique de confidentialité
Copyright All Right Reserved 2018