Nos ressources sont regroupées sous le chemin : adresseAPI/API/json/v1.
Pour accéder à nos ressources, l'URL est constituée d'un chemin et d'une requête :
| Methode | Protocole | Adresse | Path | Version | ressource | Parametres |
|---|---|---|---|---|---|---|
GET,POST ,PUT,PATCH ,DELETE | https:// | 127.0.0.1:8080 | /API/json/ | V1/ | Connexion/ | ?Login=ee@e |
Le port d'accès au serveur d'APIs est le 8080.
Le SGBD peut être sur le même serveur (adresse IP 127.0.0.1) ou sur un autre serveur (solution moins préconisée).
adresseAPI peut donc par exemple être remplacé par ceci : 127.0.0.1:8080
Les autres éléments de la requête sont dans la description de chaque API.
Mises à part les APIs de connexion et de déconnexion, il est obligatoire d'indiquer le nom de l'agence (en fait le nom correspondant dans la base de données).
Cette information est à indiquer dans les headers.
Pour faciliter le développement, nos headers comportent la variable {{base}} qui doit donc être définie dans l'environnement Postman utilisé.
Nos APIs sont sécurisées par le token de chaque utilisateur.
Une fois identifié, chaque utilisateur a le profil défini dans le logiciel Billjobs
La récupération de token est mentionnée dans la section \"Connexion\".
Le champ \"Authorization\" dans le \"Headers\" de la requête doit contenir le token retourné par la première connexion.
L'accès aux jeux d'APIs est contrôlé par des clés d'API fournies par BillJobs.
Ces clés sont indiquées ici sous la désignation {{cleAPI}}.
Pour les APIs de liste, les filtres sont passés en paramètre.
Pour les APIs de création ou de mise à jour de ressource, les données sont contenues dans un JSON passé en \"raw\" dans le \"Body\".
Toutes nos APIs renvoient du JSON.
\n\nCode Erreur
Les codes d'erreur suivants sont communs à toutes les APIs (sauf celle ce connexion).
\n| Codes | statut | description |
|---|---|---|
ErreurDB | 500 | Erreur de base de données |
ErrTokenAbsent | 404 | Token non transmis |
ErrTokenInconnu | 498 | Token invalide |
ErrTokenTermine | 498 | Token expiré |
ErrNomBaseVide | 403 | Nom de la base de données non défini |
ErrNomBaseAbsent | 403 | Nom de la base de données non fourni |
ErrAgenceInconnue | 400 | La base de données indiquée n'existe pas |
ErrBaseNonAccessible | 403 | Base de données inaccessible |
ErrApiKeyAbsent | 498 | Clé API vide ou non fournie |
ErrCleAPIInvalide | 498 | Clé API incorrecte |
ErrTypeDonneeNonConforme | 403 | Le type de donnée n'est pas conforme à ce qui est attendu (string, date, double,integer ou numérique) |
ErrPeriodeIncorrecte | 400 | La période indiquée est incorrecte |
ErrAccesLectureImpossible | 403 | L'utilisateur n'a pas de droit de lecture de cette resource |
ErrAccesCreationImpossible | 403 | L'utilisateur n'a pas de droit d'écriture sur cette resource |
ErrAccesModificationImpossible | 403 | L'utilisateur n'a pas de droit de modifier cette resource |
ErrAccesSuppressionImpossible | 403 | L'utilisateur n'a pas de droit de supprimer cette resource |
ErrCommandeInconnue | 404 | Commande inconnue |
En cas d'erreurs', le JSON contient le champ 'Statut' qui reprend le code HTTP entre 400 et 500.
\n\n\nCode Succès
En cas de succès, le JSON contient le champ 'Statut' qui reprend le code HTTP (si sa valeur est égale à 201, cela signifie que la ressource a été créée avec succès et 200 dans les autres cas).
\nEn cas de création ou de mise à jour, la ressource est entièrement retournée dans le JSON.
En cas de suppression, le JSON contient le json \"OK\" ou \"suppressionOK\" avec, comme valeur, true ou l'ID de la ressource supprimée.
Les types de valeurs utilisés sont ceux définis dans la syntaxe JSON (string, number, object, array, boolean, null).
La mention dans cette documentation du type \"NUMERIQUE\" indique que la valeur transmise à nos APIs est soit du type JSON \"string\" (ex:\"1000.00\") soit du type JSON \"number\" (ex: 1000.00 ou 1000.0000000).
Dans l'autre sens, les valeurs de type \"NUMERIQUE\" retournées par nos APIs sont de type \"string\".
Le type MIME de la ressource
\n","type":"text"}],"body":{"mode":"file","file":{"src":""}},"url":"http://{{url}}/api/json/v1/Connexion/?Login={{loginPerso}}&MdP={{mdpPerso}}","description":"API d’identification permettant de vérifier si l’utilisateur a le droit de se connecter. En cas de succès, elle retourne un token d'identification à fournir lors de chaque appel suivant d'API, la liste des bases BillJobs auxquelles a accès cet utilisateur et la dernière utilisée.\nLa durée de vie du token est de 10 minutes après chaque appel d'API.\nSi aucune API n'est appelée pendant ces 10 minutes, la validité du token est terminée et il faudra se reconnecter avec cette API.
\nExemple :{\"Erreur\":[{\"Contenu\":\"ErrLoginAbsent\"},{\"statut\":412}]}| Codes | \ndescription | \n
|---|---|
| ErrLoginAbsent | \nLogin non défini | \n
| ErrMdpAbsent | \nMot de passe vide ou incorrect | \n
| ErrPersonneNonReferencee | \nUtilisateur non reférencé | \n
| ErrDepassementQuotaConnexions | \nnombre de connexions limité | \n
| ErrUtilisateurDejaConnecte | \nUtilisateur déja connecté | \n
| ErrTokenInconnu | \nLe token fourni ne correspond à rien | \n
| ErrTokenTermine | \nLe token fourni n'est lus valable | \n
| ErrAucuneBaseAccessible | \nAucune base accessible | \n
| ErrAgenceInconnue | \nAgence inconnue | \n
Adresse email de la personne référencée de l'agence
\n","type":"text/plain"},"key":"Login","value":"{{loginPerso}}"},{"description":{"content":"son mot de passe
\n","type":"text/plain"},"key":"MdP","value":"{{mdpPerso}}"}],"variable":[]}},"response":[{"id":"2673468f-f7ee-4a0b-b131-6a2aad221c11","name":"Connexion","originalRequest":{"method":"GET","header":[],"url":{"raw":"http://127.0.0.1:8080/api/json/v1/Connexion/?Login={{loginPerso}}&MdP={{mdpPerso}}","protocol":"http","host":["127","0","0","1"],"port":"8080","path":["api","json","v1","Connexion",""],"query":[{"key":"Login","value":"{{loginPerso}}","description":"Adresse email de la personne référencée de l'agence"},{"key":"MdP","value":"{{mdpPerso}}","description":"son mot de passe"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Connection","value":"close"},{"key":"Date","value":"Wed, 15 May 2019 14:37:51 GMT"},{"key":"Content-Length","value":"125"}],"cookie":[],"responseTime":null,"body":"{\n \"listeAgences\": [\n {\n \"nom\": \"Test 17\",\n \"base\": \"bj_test17\"\n }\n ],\n \"token\": \"e70afcyph3p4ac2ac35qvk5sm\",\n \"nom\": \"Zigoulam ZoukouniBoudiné\"\n}"},{"id":"2e4d5348-1379-4d06-8132-109724cda767","name":"Connexion","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","description":"Le type MIME de la ressource","type":"text"}],"body":{"mode":"file","file":{"src":""}},"url":{"raw":"http://{{url}}/api/json/v1/Connexion/?Login={{loginPerso}}&MdP={{mdpPerso}}","protocol":"http","host":["{{url}}"],"path":["api","json","v1","Connexion",""],"query":[{"key":"Login","value":"{{loginPerso}}","description":"Adresse email de la personne référencée de l'agence"},{"key":"MdP","value":"{{mdpPerso}}","description":"son mot de passe"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Connection","value":"close"},{"key":"Date","value":"Fri, 19 Jul 2019 12:37:43 GMT"},{"key":"Content-Length","value":"249"}],"cookie":[],"responseTime":null,"body":"{\n \"listeAgences\": [\n {\n \"nom\": \"Sonhgwane\",\n \"base\": \"bj_sonhgwane\"\n },\n {\n \"nom\": \"Test 17\",\n \"base\": \"bj_test17\"\n }\n ],\n \"derniereAgence\": {\n \"nom\": \"Oswald Orb\",\n \"schema\": \"bj_oswald_orb\"\n },\n \"token\": \"4qrywwqh047jh06599vgcef65\",\n \"nom\": \"Zongua Durand\",\n \"Adresse SGBD\": \"192.168.2.206\"\n}"}],"_postman_id":"b2293cdb-4403-4e7c-b173-559c95a29354"},{"name":"Déconnexion","id":"78d865fa-c338-4e3b-b54f-18eb0664933f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{leTokenPerso}}"}]},"isInherited":false},"method":"GET","header":[{"description":"Le type MIME de la ressource
\n","key":"Content-Type","type":"text","value":"application/json"}],"url":"http://{{url}}/api/json/v1/Deconnexion/","description":"API de déconnexion de l’utilisateur. Appel nécessaire pour pouvoir se reconnecter ensuite à partir de l’application BillJobs
Cf. en tête de cette documentation.
La base de données de BillJobs
\n","key":"base","type":"text","value":"bj_test17"},{"description":"Le type MIME de la ressource
\n","key":"Content-Type","type":"text","value":"application/json"}],"url":"http://{{url}}/api/json/v1/Serveur/Liste/","description":"API donnant la liste des personnes déclarées pouvant utiliser BillJobs et, pour chcune d'elles, la liste de agences auxquelles elles ont accès.
\nCf. en tête de cette documentation.
Cette collection traite les APIs permettant de se connecter vers le serveur BillJobs ou de s'en déconnecter.
\n","event":[{"listen":"prerequest","script":{"id":"df572e06-1e2c-4269-ac6b-50ec4a00339b","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"9bc60476-76b6-41aa-a126-b9fdebcb9069","type":"text/javascript","exec":[""]}}],"_postman_id":"7a236bc4-5769-4bba-a295-b7974c97fbeb"},{"name":"ACTIVITÉS","item":[{"name":"Listes d'activités","item":[{"name":"Liste abregée","id":"d2180af2-ae6b-464f-9ad0-2002297a61a7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{leTokenPerso}}"}]},"isInherited":false},"method":"GET","header":[{"description":"La base de données de Billjobs
\n","key":"base","type":"text","value":"{{agence}}"},{"description":"Le type MIME de la ressource
\n","key":"Content-Type","type":"text","value":"application/json"},{"description":"Votre clé API transmise par Billjobs
\n","key":"APIKey","type":"text","value":"{{CleApi}}"}],"url":"http://{{url}}/api/json/v1/Activites/ListeAbregee/?siEstGroupe=true&idGroupe=61&sisaisiedetemps=true&$lk=&$start=&$nlk=&$eq=","description":"API permettant de lister les activités avec leur tête de groupe.
\nCf. en tête de cette documentation.
(boolean ,optionnel) si true : ne liste que les groupes d'activités
\n","type":"text/plain"},"key":"siEstGroupe","value":"true"},{"description":{"content":"(integer,optionnel) si valorisé : filtre les activités du groupe ayant cet ID.
\n","type":"text/plain"},"key":"idGroupe","value":"61"},{"description":{"content":"(boolean ,optionnel) si true : filtre les activités liées à la saisie de temps
\n","type":"text/plain"},"key":"sisaisiedetemps","value":"true"},{"description":{"content":"(string ,optionnel) si valorisé : filtre les activités dont le nom contient cette valeur
\n","type":"text/plain"},"key":"$lk","value":""},{"description":{"content":"(string ,optionnel) si valorisé : filtre les activités dont le nom commence par cette valeur
\n","type":"text/plain"},"key":"$start","value":""},{"description":{"content":"(string ,optionnel) si valorisé : filtre les activités dont le nom ne contient pas cette valeur
\n","type":"text/plain"},"key":"$nlk","value":""},{"description":{"content":"(string ,optionnel) si valorisé : filtre les activités dont le nom est égal à cette valeur
\n","type":"text/plain"},"key":"$eq","value":""}],"variable":[]}},"response":[{"id":"3f31f2d4-2d61-4f05-a1e5-35e73f753fbd","name":"Liste abregée ","originalRequest":{"method":"GET","header":[{"description":"La base de données de Billjobs","key":"base","type":"text","value":"bj_test17"},{"description":"Le type MIME de la ressource","key":"Content-Type","type":"text","value":"application/json"},{"description":"Votre clé API transmise par Billjobs ","key":"APIKey","type":"text","value":"{{CleApi}}"}],"url":{"raw":"http://127.0.0.1:8080/api/json/v1/Activites/ListeAbregee/?idGroupe=118","protocol":"http","host":["127","0","0","1"],"port":"8080","path":["api","json","v1","Activites","ListeAbregee",""],"query":[{"description":"(boolean ,optionnel) si true : ne liste que les groupes d'activités","key":"siGroupe","value":"true","disabled":true},{"key":"idGroupe","value":"118","description":"(integer,optionnel) si valorisé : filtre les activités du groupe ayant cet ID."},{"description":"(boolean ,optionnel) si true : filtre les activités liées à la saisie de temps","key":"sisaisiedetemps","value":"true","disabled":true},{"description":"(string ,optionnel) si valorisé : filtre les activités dont le nom contient cette valeur","key":"contient","value":"","disabled":true},{"description":"(string ,optionnel) si valorisé : filtre les activités dont le nom commence par cette valeur","key":"commence par","value":"","disabled":true},{"description":"(string ,optionnel) si valorisé : filtre les activités dont le nom ne contient pas cette valeur","key":"ne contient pas","value":"","disabled":true},{"description":"(string ,optionnel) si valorisé : filtre les activités dont le nom est égal à cette valeur","key":"egal","value":"","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Connection","value":"close"},{"key":"Date","value":"Mon, 03 Jun 2019 10:09:07 GMT"},{"key":"Content-Encoding","value":"gzip"},{"key":"Content-Length","value":"168"}],"cookie":[],"responseTime":null,"body":"{\n \"TotalRows\": 4,\n \"listeActivitesTPS\": [\n {\n \"nom\": \"Façonnage\",\n \"id\": 122,\n \"nomgroupe\": \"Fabrication\",\n \"idgroupe\": 118\n },\n {\n \"nom\": \"Frais de déplacement\",\n \"id\": 99,\n \"nomgroupe\": \"Fabrication\",\n \"idgroupe\": 118\n },\n {\n \"nom\": \"Photogravure\",\n \"id\": 120,\n \"nomgroupe\": \"Fabrication\",\n \"idgroupe\": 118\n },\n {\n \"nom\": \"Routage\",\n \"id\": 121,\n \"nomgroupe\": \"Fabrication\",\n \"idgroupe\": 118\n }\n ]\n}"}],"_postman_id":"d2180af2-ae6b-464f-9ad0-2002297a61a7"},{"name":"Liste","id":"4a7e8154-40d1-4c7b-b83a-be5fb4c957b6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{leTokenPerso}}"}]},"isInherited":false},"method":"GET","header":[{"key":"base","type":"text","value":"{{agence}}","description":"La base de données de Billjobs
\n"},{"key":"APIKey","value":"{{CleApi}}","description":"Votre clé API transmise par Billjobs
\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"Le type MIME de la ressource
\n","type":"text"}],"url":"http://{{url}}/api/json/v1/Activites/Liste/?id=212","description":"API permettant de lister toutes les activités avec leur détail.
\nPour lire une seule activité, il y a 2 syntaxes possibles :
\nen url :
\nhttp://{{url}}/api/json/v1/Activites/Liste/IDActivite
\nou en passage de paramètres :
\nhttp://{{url}}/api/json/v1/Activites/Liste/?id=IDActivite
\nDans ces 2 cas, les autres critères sont inutiles et ne seront pas pris en compte.
Autres erreurs : Cf. en tête de cette documentation.
\n","urlObject":{"protocol":"http","path":["api","json","v1","Activites","Liste",""],"host":["{{url}}"],"query":[{"description":{"content":"(integer,optionnel) id d'une activité. Paramètre exculsif de tous les autres
\n","type":"text/plain"},"key":"id","value":"212"},{"disabled":true,"description":{"content":"(Boolean ,optionnel) si true : ne liste que les activités liées à la saisie de temps
\n","type":"text/plain"},"key":"siSaisieTemps","value":"true"},{"disabled":true,"description":{"content":"(Boolean ,optionnel) si true : ne liste que les activités liées aux actions de mandatement
\n","type":"text/plain"},"key":"siMandataire","value":"true"},{"disabled":true,"description":{"content":"(Boolean ,optionnel) si true : ne liste que les activités affichables dans le planning
\n","type":"text/plain"},"key":"siDansplanning","value":""},{"disabled":true,"description":{"content":"(Boolean ,optionnel) si true : ne liste que les têtes de groupes
\n","type":"text/plain"},"key":"siEstGroupe","value":""},{"disabled":true,"description":{"content":"(integer,optionnel) si valorisé : ne liste que les activités dans ce groupe
\n","type":"text/plain"},"key":"idgroupe","value":"130"},{"disabled":true,"description":{"content":"(string ,optionnel) si valorisé : ne liste que les activités dont le nom commence par cette valeur
\n","type":"text/plain"},"key":"$start","value":""},{"disabled":true,"description":{"content":"(string ,optionnel) si valorisé : ne liste que les activités dont le nom contient cette valeur
\n","type":"text/plain"},"key":"$lk","value":"ment"},{"disabled":true,"description":{"content":"(string ,optionnel) si valorisé : exclut les activités dont le nom ne contient pas cette valeur
\n","type":"text/plain"},"key":"$nlk","value":"Exe"},{"disabled":true,"description":{"content":"(string ,optionnel) si valorisé : ne liste que les activités dont le nom est égal à cette valeur
\n","type":"text/plain"},"key":"$eq","value":"Exe"}],"variable":[]}},"response":[{"id":"028ebe4c-58ce-419e-ba83-5073e173dad9","name":"Liste","originalRequest":{"method":"GET","header":[{"key":"base","type":"text","value":"bj_test17","description":"[{\"description\":\"La base de données de Billjobs\",\"key\":\"base\",\"type\":\"text\",\"value\":\"{{agence}}\"}]"},{"key":"APIKey","value":"{{CleApi}}","description":"Votre clé API transmise par Billjobs ","type":"text"},{"key":"Content-Type","value":"application/json","description":"Le type MIME de la ressource","type":"text"}],"url":{"raw":"http://{{url}}/api/json/v1/Activites/Liste/?id=130","protocol":"http","host":["{{url}}"],"path":["api","json","v1","Activites","Liste",""],"query":[{"description":"(Boolean ,optionnel) si true : ne liste que les activités liées à la saisie de temps","key":"siSaisieTemps","value":"true","disabled":true},{"description":"(Boolean ,optionnel) si true : ne liste que les activités liées aux actions de mandatement","key":"siMandataire","value":"true","disabled":true},{"description":"(Boolean ,optionnel) si true : ne liste que les activités affichables dans le planning","key":"siDansplanning","value":null,"disabled":true},{"description":"(Boolean ,optionnel) si true : ne liste que les têtes de groupes","key":"siEstGroupe","value":null,"disabled":true},{"key":"idgroupe","value":"133","description":"(integer,optionnel) si valorisé : ne liste que les activités dans ce groupe","disabled":true},{"description":"(string ,optionnel) si valorisé : ne liste que les activités dont le nom commence par cette valeur","key":"$start","value":"","disabled":true},{"description":"(string ,optionnel) si valorisé : ne liste que les activités dont le nom contient cette valeur","key":"$lk","value":"ment","disabled":true},{"description":"(string ,optionnel) si valorisé : exclut les activités dont le nom ne contient pas cette valeur","key":"$nlk","value":"Exe","disabled":true},{"description":"(string ,optionnel) si valorisé : ne liste que les activités dont le nom est égal à cette valeur","key":"$eq","value":"Exe","disabled":true},{"key":"id","value":"130","description":"(integer,optionnel) si valorisé : ne liste que l'activité ayant cet id "}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Connection","value":"close"},{"key":"Date","value":"Fri, 19 Jul 2019 13:49:54 GMT"},{"key":"Content-Encoding","value":"gzip"},{"key":"Content-Length","value":"348"}],"cookie":[],"responseTime":null,"body":"{\n \"TotalRows\": 1,\n \"listeActivites\": [\n {\n \"activite\": {\n \"nom\": \"Exécution/PAO\",\n \"id\": 130,\n \"nomgroupe\": \"Exécution/PAO\",\n \"idgroupe\": 130,\n \"montantvente\": \"800.0000\",\n \"idtvavente\": 4,\n \"nomclassetvavente\": \"Standard\",\n \"idtx2vente\": 8,\n \"montantcouthoraire\": \"80.0000\",\n \"idtvaachat\": 4,\n \"nomclassetvaachat\": \"Standard\",\n \"sisaisiedetemps\": true,\n \"sipourplanning\": true,\n \"tarifs\": [\n {\n \"idclient\": 53,\n \"nomclient\": \"UPS\",\n \"idactivite\": 130,\n \"tarif\": \"850.0000\"\n }\n ],\n \"comptes\": [\n {\n \"id\": 585,\n \"compte\": \"706000\",\n \"categorie\": \"VTENAT\"\n },\n {\n \"id\": 586,\n \"compte\": \"706500\",\n \"categorie\": \"VTEINT\"\n },\n {\n \"id\": 587,\n \"compte\": \"706400\",\n \"categorie\": \"VTEUE\"\n },\n {\n \"id\": 588,\n \"compte\": \"604000\",\n \"categorie\": \"ACHNAT\"\n },\n {\n \"id\": 589,\n \"compte\": \"605000\",\n \"categorie\": \"ACHINT\"\n },\n {\n \"id\": 590,\n \"compte\": \"604000\",\n \"categorie\": \"ACHUE\"\n }\n ]\n }\n }\n ]\n}"},{"id":"ac90dcf1-7b97-4667-97dd-af5b2dd7f086","name":"Liste","originalRequest":{"method":"GET","header":[{"key":"base","type":"text","value":"{{agence}}","description":"La base de données de Billjobs"},{"key":"APIKey","value":"{{CleApi}}","description":"Votre clé API transmise par Billjobs ","type":"text"},{"key":"Content-Type","value":"application/json","description":"Le type MIME de la ressource","type":"text"}],"url":{"raw":"http://{{url}}/api/json/v1/Activites/Liste/?id=130","protocol":"http","host":["{{url}}"],"path":["api","json","v1","Activites","Liste",""],"query":[{"key":"id","value":"130","description":"(integer,optionnel) id d'une activité. Paramètre exculsif de tous les autres"},{"description":"(Boolean ,optionnel) si true : ne liste que les activités liées à la saisie de temps","key":"siSaisieTemps","value":"true","disabled":true},{"description":"(Boolean ,optionnel) si true : ne liste que les activités liées aux actions de mandatement","key":"siMandataire","value":"true","disabled":true},{"description":"(Boolean ,optionnel) si true : ne liste que les activités affichables dans le planning","key":"siDansplanning","value":null,"disabled":true},{"description":"(Boolean ,optionnel) si true : ne liste que les têtes de groupes","key":"siEstGroupe","value":null,"disabled":true},{"key":"idgroupe","value":"130","description":"(integer,optionnel) si valorisé : ne liste que les activités dans ce groupe","disabled":true},{"description":"(string ,optionnel) si valorisé : ne liste que les activités dont le nom commence par cette valeur","key":"$start","value":"","disabled":true},{"description":"(string ,optionnel) si valorisé : ne liste que les activités dont le nom contient cette valeur","key":"$lk","value":"ment","disabled":true},{"description":"(string ,optionnel) si valorisé : exclut les activités dont le nom ne contient pas cette valeur","key":"$nlk","value":"Exe","disabled":true},{"description":"(string ,optionnel) si valorisé : ne liste que les activités dont le nom est égal à cette valeur","key":"$eq","value":"Exe","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Connection","value":"close"},{"key":"Date","value":"Mon, 25 Nov 2019 08:44:02 GMT"},{"key":"Content-Encoding","value":"gzip"},{"key":"Content-Length","value":"342"}],"cookie":[],"responseTime":null,"body":"{\n \"TotalRows\": 1,\n \"listeActivites\": [\n {\n \"nom\": \"Exécution/PAO\",\n \"id\": 130,\n \"nomgroupe\": \"Exécution/PAO\",\n \"idgroupe\": 130,\n \"montantvente\": \"800.0000\",\n \"idtvavente\": 4,\n \"nomclassetvavente\": \"Standard\",\n \"idtx2vente\": 8,\n \"montantcouthoraire\": \"80.0000\",\n \"idtvaachat\": 4,\n \"nomclassetvaachat\": \"Standard\",\n \"sisaisiedetemps\": true,\n \"sipourplanning\": true,\n \"tarifs\": [\n {\n \"idclient\": 53,\n \"nomclient\": \"UPS\",\n \"idactivite\": 130,\n \"tarif\": \"850.0000\"\n }\n ],\n \"comptes\": [\n {\n \"id\": 585,\n \"compte\": \"706000\",\n \"categorie\": \"VTENAT\"\n },\n {\n \"id\": 586,\n \"compte\": \"706500\",\n \"categorie\": \"VTEINT\"\n },\n {\n \"id\": 587,\n \"compte\": \"706400\",\n \"categorie\": \"VTEUE\"\n },\n {\n \"id\": 588,\n \"compte\": \"604000\",\n \"categorie\": \"ACHNAT\"\n },\n {\n \"id\": 589,\n \"compte\": \"605000\",\n \"categorie\": \"ACHINT\"\n },\n {\n \"id\": 590,\n \"compte\": \"604000\",\n \"categorie\": \"ACHUE\"\n }\n ]\n }\n ]\n}"}],"_postman_id":"4a7e8154-40d1-4c7b-b83a-be5fb4c957b6"}],"id":"da7c5301-2490-4766-8ee0-b1bd36ba0707","_postman_id":"da7c5301-2490-4766-8ee0-b1bd36ba0707","description":""}],"id":"0d1f9226-693e-4614-8fd8-5c98f5eaf9ce","description":"Cette partie traite des activités et des groupes d'activités.
\n","event":[{"listen":"prerequest","script":{"id":"d1b12cb4-cfb8-418f-8434-89572a70db4f","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"7ff70b03-025b-4130-afb1-f9c274a6f005","type":"text/javascript","exec":[""]}}],"_postman_id":"0d1f9226-693e-4614-8fd8-5c98f5eaf9ce"},{"name":"Saisie Temps passé","item":[{"name":"Liste temps passés","id":"b6d9f661-64ee-4aad-a126-d3d08b5b91af","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{leTokenPerso}}"}]},"isInherited":false},"method":"GET","header":[{"description":"La base de données BillJobs
\n","key":"base","type":"text","value":"{{agence}}"},{"description":"Le type MIME de la ressource (toujours \"application/json\")
\n","key":"Content-Type","type":"text","value":"application/json"},{"description":"Votre clé API transmise par Billjobs
\n","key":"APIKey","type":"text","value":"{{CleApi}}"}],"url":"http://{{url}}/api/json/v1/TempsPasses/Liste/?$start=2019-01-01&$end=2019-06-01&idConcerne=508&siAvecNotes=true","description":"API listant les temps passés d'une période.
\nLes temps passés ne concernent que la personne connectée
\nou une autre personne ayant l'id (idConcerne) ou l'adresse email (emailConcerne) si cet utilisateur existe et si la personne connectée a le droit de voir les temps passés des autres personnes.\nSi on veut expressément voir les temps passés d'une personne, on ne doit passer qu’un seul des paramètres idConcerne ou emailConcerne.
L'API retourne un groupe de 2 JSONs :
\n– \"listeDossiers\" qui est un tableau de dossiers avec pour chacun \"id\", \"client\", \"titredossier\" et \"numdossier\"
\n– \"listeTempPasses\" qui est un tableau des temps attribués avec pour chacun
\n\"id\", \"jour\", \"heuredebut\", \"dureereelle\", \"idconcerne\", \"nomconcerne\", \"sexeconcerne\", \"idactivite\", \"nomactivite\", \"iddossier\", \"notes\".
\niddossier se réfère à un des éléments du tableau \"listeDossiers\".
\nnotes est présent si le paramètre \"siAvecNotes\" est présent et à true.
| Codes | \ndescriptions | \n
|---|---|
| ErrTPSCriteresAbsents | \nAucun critère transmis. Il faut au moins une période | \n
| ErrTPSiDErrone | \nL'ID de la feuille de temps est incorrect | \n
| ErrTPSiDDossierErrone | \nL'ID du dossier est incorrect | \n
| ErrTPSiDActiviteErrone | \nL'ID de l'activité est incorrect | \n
| ErrTPSiDConcerneErrone | \nL'ID de l'utilisateur est incorrect | \n
| ErrEmailInconnu | \nL’adresse email indiquée n’existe pas dans cette agence. | \n
| ErrTPSiDBudgetErrone | \nL'ID de la ligne de budget est incorrect | \n
| ErrTPSIDsInexistants | \nAu moins un des IDs fournis ne se réfère à aucune donnée | \n
(date, obligatoire) : date de début de période
\n","type":"text/plain"},"key":"$start","value":"2019-01-01"},{"description":{"content":"(date, obligatoire) : date de fin de période
\n","type":"text/plain"},"key":"$end","value":"2019-06-01"},{"disabled":true,"description":{"content":"(integer,optionnel) si valorisé : restreint la liste aux temps prévus liés à ce dossier
\n","type":"text/plain"},"key":"idDossier","value":null},{"disabled":true,"description":{"content":"(integer,optionnel) si valorisé : restreint la liste aux temps prévus liés à cette activité
\n","type":"text/plain"},"key":"idActivite","value":null},{"disabled":true,"description":{"content":"(integer,optionnel) si valorisé : restreint la liste aux temps prévus liés à cette activité
\n","type":"text/plain"},"key":"idBudget","value":null},{"description":{"content":"(integer,optionnel) ID d'un utilisateur (non pris en compte si la personne connectée n'a pas le droit de voir les temps passés des autres collaborateurs)
\n","type":"text/plain"},"key":"idConcerne","value":"508"},{"disabled":true,"description":{"content":"(string,optionnel) Adresse email d'un utilisateur
\n","type":"text/plain"},"key":"emailConcerne","value":"XXXX@YYYY.com"},{"description":{"content":"(boolean, optionnel) : pour récupérer ou non les éventuelles notes
\n","type":"text/plain"},"key":"siAvecNotes","value":"true"}],"variable":[]}},"response":[{"id":"6a077a45-2b6f-49c2-a89a-e50195c3eb77","name":"Liste temps passés","originalRequest":{"method":"GET","header":[{"description":"La base de données BillJobs","key":"base","type":"text","value":"{{agence}}"},{"description":"Le type MIME de la ressource (toujours \"application/json\")","key":"Content-Type","type":"text","value":"application/json"},{"description":"Votre clé API transmise par Billjobs ","key":"APIKey","type":"text","value":"{{CleApi}}"}],"url":{"raw":"http://{{url}}/api/json/v1/TempsPasses/Liste/?$start=2019-01-01&$end=2019-06-01&idConcerne=508","protocol":"http","host":["{{url}}"],"path":["api","json","v1","TempsPasses","Liste",""],"query":[{"key":"$start","value":"2019-01-01","description":"(date, obligatoire) : date de début de période"},{"key":"$end","value":"2019-06-01","description":"(date, obligatoire) : date de fin de période"},{"description":"(integer,optionnel) si valorisé : restreint la liste aux temps prévus liés à ce dossier","key":"idDossier","value":null,"disabled":true},{"description":"(integer,optionnel) si valorisé : restreint la liste aux temps prévus liés à cette activité","key":"idActivite","value":null,"disabled":true},{"description":"(integer,optionnel) si valorisé : restreint la liste aux temps prévus liés à cette activité","key":"idBudget","value":null,"disabled":true},{"key":"idConcerne","value":"508","description":"(integer,optionnel) ID d'un utilisateur (non pris en compte si la personne connectée n'a pas le droit de voir les temps passés des autres collaborateurs)"},{"key":"emailConcerne","value":"XXXX@YYYY.com","description":"(string,optionnel) Adresse email d'un utilisateur","type":"text","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Connection","value":"close"},{"key":"Date","value":"Tue, 10 Dec 2019 10:05:55 GMT"},{"key":"Content-Encoding","value":"gzip"},{"key":"Content-Length","value":"959"}],"cookie":[],"responseTime":null,"body":"{\n \"TotalRows\": 16,\n \"listeDossiers\": [\n {\n \"id\": 621,\n \"client\": \"WILSON\",\n \"titredossier\": \"Abandon de temps 119\",\n \"numdossier\": \"404\"\n },\n {\n \"id\": 49,\n \"client\": \"INFOPRO\",\n \"titredossier\": \"Devis Plan de Communication\",\n \"numdossier\": \"26\"\n },\n {\n \"id\": 495,\n \"client\": \"La boite à outils\",\n \"titredossier\": \"Nouveau\",\n \"numdossier\": \"314\"\n },\n {\n \"id\": 779,\n \"client\": \"APS\",\n \"titredossier\": \"CA\",\n \"numdossier\": \"520\"\n },\n {\n \"id\": 579,\n \"client\": \"Haribo\",\n \"titredossier\": \"TENSO\",\n \"numdossier\": \"371\"\n },\n {\n \"id\": 760,\n \"client\": \"Build 160\",\n \"titredossier\": \"Formation 2019\",\n \"numdossier\": \"509\"\n },\n {\n \"id\": 791,\n \"client\": \"WILSON\",\n \"titredossier\": \"Acompte\",\n \"numdossier\": \"528\"\n },\n {\n \"id\": 491,\n \"client\": \"La boite à outils\",\n \"titredossier\": \"Test new V.\",\n \"numdossier\": \"312\"\n },\n {\n \"id\": 797,\n \"client\": \"La cave à bijoux\",\n \"titredossier\": \"Refonte du site web\",\n \"numdossier\": \"532\"\n },\n {\n \"id\": 399,\n \"client\": \"Cafeio\",\n \"titredossier\": \"film itw\",\n \"numdossier\": \"260\"\n },\n {\n \"id\": 856,\n \"client\": \"Nouveau client\",\n \"titredossier\": \"Dossier Renommer Bloqued\",\n \"numdossier\": \"574\"\n }\n ],\n \"listeTempPasses\": [\n {\n \"id\": 8358,\n \"jour\": \"2019-01-16\",\n \"heuredebut\": \"8:00\",\n \"dureeprevue\": 120,\n \"idbudget\": 8357,\n \"dureereelle\": 120,\n \"idconcerne\": 508,\n \"nomconcerne\": \"Margaux Sausse\",\n \"sexeconcerne\": \"M\",\n \"idactivite\": 105,\n \"nomactivite\": \"Création\",\n \"iddossier\": 621\n },\n {\n \"id\": 12037,\n \"jour\": \"2019-03-25\",\n \"heuredebut\": \"17:40\",\n \"dureereelle\": 60,\n \"idconcerne\": 508,\n \"nomconcerne\": \"Margaux Sausse\",\n \"sexeconcerne\": \"M\",\n \"idactivite\": 110,\n \"nomactivite\": \"Événement\",\n \"iddossier\": 49\n },\n {\n \"id\": 11690,\n \"jour\": \"2019-03-05\",\n \"heuredebut\": \"12:15\",\n \"dureereelle\": 60,\n \"idconcerne\": 508,\n \"nomconcerne\": \"Margaux Sausse\",\n \"sexeconcerne\": \"M\",\n \"idactivite\": 150,\n \"nomactivite\": \"Business Director\",\n \"iddossier\": 495\n },\n {\n \"id\": 11073,\n \"jour\": \"2019-02-21\",\n \"heuredebut\": \"12:42\",\n \"dureereelle\": 240,\n \"idconcerne\": 508,\n \"nomconcerne\": \"Margaux Sausse\",\n \"sexeconcerne\": \"M\",\n \"idactivite\": 133,\n \"nomactivite\": \"Honoraires et Conseil\",\n \"iddossier\": 779\n },\n {\n \"id\": 11101,\n \"jour\": \"2019-02-22\",\n \"heuredebut\": \"14:54\",\n \"dureereelle\": 1,\n \"idconcerne\": 508,\n \"nomconcerne\": \"Margaux Sausse\",\n \"sexeconcerne\": \"M\",\n \"idactivite\": 133,\n \"nomactivite\": \"Honoraires et Conseil\",\n \"iddossier\": 779\n },\n {\n \"id\": 11503,\n \"jour\": \"2019-03-08\",\n \"heuredebut\": \"8:00\",\n \"dureeprevue\": 300,\n \"idbudget\": 7873,\n \"dureereelle\": 300,\n \"idconcerne\": 508,\n \"nomconcerne\": \"Margaux Sausse\",\n \"sexeconcerne\": \"M\",\n \"idactivite\": 131,\n \"nomactivite\": \"Maquettes\",\n \"iddossier\": 579\n },\n {\n \"id\": 11689,\n \"jour\": \"2019-03-18\",\n \"heuredebut\": \"12:15\",\n \"dureereelle\": 60,\n \"idconcerne\": 508,\n \"nomconcerne\": \"Margaux Sausse\",\n \"sexeconcerne\": \"M\",\n \"idactivite\": 150,\n \"nomactivite\": \"Business Director\",\n \"iddossier\": 495\n },\n {\n \"id\": 11159,\n \"jour\": \"2019-02-25\",\n \"heuredebut\": \"8:00\",\n \"dureeprevue\": 60,\n \"idbudget\": 11158,\n \"dureereelle\": 60,\n \"idconcerne\": 508,\n \"nomconcerne\": \"Margaux Sausse\",\n \"sexeconcerne\": \"M\",\n \"idactivite\": 133,\n \"nomactivite\": \"Honoraires et Conseil\",\n \"iddossier\": 760\n },\n {\n \"id\": 11160,\n \"jour\": \"2019-02-26\",\n \"heuredebut\": \"8:00\",\n \"dureeprevue\": 60,\n \"idbudget\": 11158,\n \"dureereelle\": 60,\n \"idconcerne\": 508,\n \"nomconcerne\": \"Margaux Sausse\",\n \"sexeconcerne\": \"M\",\n \"idactivite\": 133,\n \"nomactivite\": \"Honoraires et Conseil\",\n \"iddossier\": 760\n },\n {\n \"id\": 11161,\n \"jour\": \"2019-02-27\",\n \"heuredebut\": \"8:00\",\n \"dureeprevue\": 60,\n \"idbudget\": 11158,\n \"dureereelle\": 60,\n \"idconcerne\": 508,\n \"nomconcerne\": \"Margaux Sausse\",\n \"sexeconcerne\": \"M\",\n \"idactivite\": 133,\n \"nomactivite\": \"Honoraires et Conseil\",\n \"iddossier\": 760\n },\n {\n \"id\": 11693,\n \"jour\": \"2019-03-04\",\n \"heuredebut\": \"12:23\",\n \"dureereelle\": 60,\n \"idconcerne\": 508,\n \"nomconcerne\": \"Margaux Sausse\",\n \"sexeconcerne\": \"M\",\n \"idactivite\": 110,\n \"nomactivite\": \"Événement\",\n \"iddossier\": 791\n },\n {\n \"id\": 11235,\n \"jour\": \"2019-02-28\",\n \"heuredebut\": \"15:38\",\n \"dureeprevue\": 60,\n \"idbudget\": 7684,\n \"dureereelle\": 60,\n \"idconcerne\": 508,\n \"nomconcerne\": \"Margaux Sausse\",\n \"sexeconcerne\": \"M\",\n \"idactivite\": 105,\n \"nomactivite\": \"Création\",\n \"iddossier\": 491\n },\n {\n \"id\": 11236,\n \"jour\": \"2019-02-28\",\n \"heuredebut\": \"15:38\",\n \"dureeprevue\": 30,\n \"idbudget\": 7746,\n \"dureereelle\": 30,\n \"idconcerne\": 508,\n \"nomconcerne\": \"Margaux Sausse\",\n \"sexeconcerne\": \"M\",\n \"idactivite\": 105,\n \"nomactivite\": \"Création\",\n \"iddossier\": 491\n },\n {\n \"id\": 11887,\n \"jour\": \"2019-03-20\",\n \"heuredebut\": \"12:00\",\n \"dureereelle\": 300,\n \"idconcerne\": 508,\n \"nomconcerne\": \"Margaux Sausse\",\n \"sexeconcerne\": \"M\",\n \"idactivite\": 110,\n \"nomactivite\": \"Événement\",\n \"iddossier\": 797\n },\n {\n \"id\": 12284,\n \"jour\": \"2019-04-01\",\n \"heuredebut\": \"8:00\",\n \"dureereelle\": 60,\n \"idconcerne\": 508,\n \"nomconcerne\": \"Margaux Sausse\",\n \"sexeconcerne\": \"M\",\n \"idactivite\": 110,\n \"nomactivite\": \"Événement\",\n \"iddossier\": 399\n },\n {\n \"id\": 12723,\n \"jour\": \"2019-05-17\",\n \"heuredebut\": \"16:55\",\n \"dureereelle\": 60,\n \"idconcerne\": 508,\n \"nomconcerne\": \"Margaux Sausse\",\n \"sexeconcerne\": \"M\",\n \"idactivite\": 110,\n \"nomactivite\": \"Événement\",\n \"iddossier\": 856\n }\n ]\n}"}],"_postman_id":"b6d9f661-64ee-4aad-a126-d3d08b5b91af"},{"name":"Liste temps prévus","id":"b238d082-96b8-4aa6-8eb5-1cbf7f8f07e0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{leTokenPerso}}"}]},"isInherited":false},"method":"GET","header":[{"key":"base","type":"text","value":"{{agence}}","description":"La base de données de BillJobs
\n"},{"key":"Content-Type","value":"application/json","description":"Le type MIME de la ressource
\n","type":"text"},{"key":"APIKey","value":"{{CleApi}}","description":"Votre clé API transmise par Billjobs
\n","type":"text"}],"url":"http://{{url}}/api/json/v1/TempsPasses/ListeBudgets/?$start=2019-01-01&$end=2019-05-31","description":"API listant les temps prévus d'une période.
\nSelon le profil de l'utilisateur, les temps prévus peuvent ne concerner que la personne connectée
\nou une autre personne ayant l'id (idConcerne) ou l'adresse email (emailConcerne) si cet utilisateur existe et si la personne connectée a le droit de voir les temps passés des autres personnes.
\nSi on veut expressément voir les temps prévus d'une personne, on ne doit passer qu’un seul des paramètres idConcerne ou emailConcerne.
\nLa liste des temps prévus peut inclure les budgets de temps attribués à un service ou non attribués.
L'API retourne un groupe de 2 JSONs :
\n– \"listeDossiers\" qui est un tableau de dossiers avec pour chacun \"id\", \"client\", \"titredossier\" et \"numdossier\"
\n– \"listeTempsAttribues\" qui est un tableau des temps attribués avec pour chacun
\n\"id\", \"jour\", \"heuredebut\", \"dureeprevue\", \"idconcerne\", \"nomconcerne\", \"sexeconcerne\", \"idactivite\", \"nomactivite\", \"iddossier\".
\niddossier se référant à un des éléments du tableau \"listeDossiers\".
| Codes | \ndescriptions | \n
|---|---|
| ErrTPSCriteresAbsents | \nAucun critère transmis. Il faut au moins une période | \n
| ErrTPSiDDossierErrone | \nL'ID du dossier est incorrect | \n
| ErrTPSiDActiviteErrone | \nL'ID de l'activité est incorrect | \n
| ErrTPSiDConcerneErrone | \nL'ID de l'utilisateur est incorrect | \n
| ErrEmailInconnu | \nL’adresse email indiquée n’existe pas dans cette agence. | \n
| ErrTPSiDBudgetErrone | \nL'ID de la ligne de budget est incorrect | \n
| ErrTPSIDsInexistants | \nAu moins un des IDs fournis ne se réfère à aucune donnée | \n
(date, obligatoire) : ne liste que les temps prévus commençant à cette date
\n","type":"text/plain"},"key":"$start","value":"2019-01-01"},{"description":{"content":"(date, obligatoire) : ne liste que les temps prévus se terminant à cette date
\n","type":"text/plain"},"key":"$end","value":"2019-05-31"},{"disabled":true,"description":{"content":"(integer,optionnel) si valorisé : restreint la liste aux temps prévus liés à ce dossier
\n","type":"text/plain"},"key":"idDossier","value":"631"},{"disabled":true,"description":{"content":"(integer,optionnel) si valorisé : restreint la liste aux temps prévus liés à cette activité
\n","type":"text/plain"},"key":"idActivite","value":"105"},{"disabled":true,"description":{"content":"(integer,optionnel) si valorisé : restreint la liste aux temps prévus liés à ce temps budgeté
\n","type":"text/plain"},"key":"idBudget","value":"454"},{"disabled":true,"description":{"content":"(integer,optionnel) ID d'un utilisateur (non pris en compte si la personne connectée n'a pas le droit de voir les temps passés des autres collaborateurs)
\n","type":"text/plain"},"key":"idConcerne","value":"508"},{"disabled":true,"description":{"content":"(string,optionnel) Adresse email d'un utilisateur
\n","type":"text/plain"},"key":"emailConcerne","value":"XXXX@YYYY.com"},{"disabled":true,"description":{"content":"(boolean, optionnel) si valorisé à true : ajoute les temps prévus non attribués
\n","type":"text/plain"},"key":"avecNonAttribues","value":"true"}],"variable":[]}},"response":[{"id":"baf4f7f8-f84d-499d-9264-54c4f458f056","name":"Liste temps prévus","originalRequest":{"method":"GET","header":[{"key":"base","type":"text","value":"bj_test17","description":"La base de données de BillJobs"},{"key":"Content-Type","value":"application/json","description":"Le type MIME de la ressource","type":"text"},{"key":"APIKey","value":"{{CleApi}}","description":"Votre clé API transmise par Billjobs ","type":"text"}],"url":{"raw":"http://127.0.0.1:8080/api/json/v1/TempsPasses/ListeBudgets/?$start=2019-05-01&$end=2019-05-31","protocol":"http","host":["127","0","0","1"],"port":"8080","path":["api","json","v1","TempsPasses","ListeBudgets",""],"query":[{"key":"$start","value":"2019-05-01","description":"(date, obligatoire) : ne liste que les temps prévus commençant à cette date"},{"key":"$end","value":"2019-05-31","description":"(date, obligatoire) : ne liste que les temps prévus se terminant à cette date"},{"description":"(integer,optionnel) si valorisé : restreint la liste aux temps prévus liés à ce dossier","key":"idDossier","value":"631","disabled":true},{"description":"(integer,optionnel) si valorisé : restreint la liste aux temps prévus liés à cette activité","key":"idActivite","value":"105","disabled":true},{"description":"(integer,optionnel) si valorisé : restreint la liste aux temps prévus liés à ce temps budgeté","key":"idBudget","value":"454","disabled":true},{"description":"(integer,optionnel) si valorisé : ID de l'utilisateur (non pris en compte si l'utilisateur n'a pas le droit de voir les temps passés des autres collaborateurs)","key":"idConcerne","value":"5932","disabled":true},{"key":"avecNonAttribues","value":"true","description":"(boolean, optionnel) si valorisé à true : ajoute les temps prévus non attribués","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Connection","value":"close"},{"key":"Date","value":"Mon, 03 Jun 2019 10:22:42 GMT"},{"key":"Content-Encoding","value":"gzip"},{"key":"Content-Length","value":"257"}],"cookie":[],"responseTime":null,"body":"{\n \"TotalRows\": 2,\n \"listeDossiers\": [\n {\n \"id\": 631,\n \"client\": \"Zaprizti\",\n \"titredossier\": \"MN\",\n \"numdossier\": \"411\"\n }\n ],\n \"listeTempsAttribues\": [\n {\n \"id\": 3017,\n \"jour\": \"2019-05-07\",\n \"heuredebut\": \"8:00\",\n \"dureeprevue\": 360,\n \"idconcerne\": 593,\n \"nomconcerne\": \"Zongua Durand\",\n \"sexeconcerne\": \"M\",\n \"idactivite\": 105,\n \"nomactivite\": \"Création\",\n \"iddossier\": 631\n },\n {\n \"id\": 3045,\n \"jour\": \"2019-05-03\",\n \"heuredebut\": \"8:00\",\n \"dureeprevue\": 120,\n \"idconcerne\": 593,\n \"nomconcerne\": \"Zongua Durand\",\n \"sexeconcerne\": \"M\",\n \"idactivite\": 105,\n \"nomactivite\": \"Création\",\n \"iddossier\": 631\n }\n ]\n}"}],"_postman_id":"b238d082-96b8-4aa6-8eb5-1cbf7f8f07e0"},{"name":"Liste des Taux d'occupation","id":"768a5890-1ced-47d2-b9da-a4366a7595e8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{leTokenPerso}}"}]},"isInherited":false},"method":"GET","header":[{"description":"La base de données de BillJobs
\n","key":"base","type":"text","value":"{{agence}}"},{"description":"Le type MIME de la ressource
\n","key":"Content-Type","type":"text","value":"application/json"},{"description":"Votre clé API transmise par Billjobs
\n","key":"APIKey","type":"text","value":"{{CleApi}}"}],"url":"http://{{url}}/api/json/v1/TempsPasses/TauxOccupation/?$start=2019-05-06&$end=2019-06-01&emailConcerne=XXXX@YYYY.com&siAvecWeekEndsEtFeries","description":"API listant par date les taux d'occupation et les absences pour une personne.
\nSelon le profil de l'utilisateur, ces taux peuvent ne concerner que la personne connectée
\nou une autre personne ayant l'id (idConcerne) ou l'adresse email (emailConcerne) si cet utilisateur existe et si la personne connectée a le droit de voir les temps passés des autres personnes.
\nSi on veut expressément voir les taux d'occupation d'une personne, on ne doit passer qu’un seul des paramètres idConcerne ou emailConcerne.
L'API retourne un ensemble de 3 JSONs :
\n– \"nomConcerne\" qui le nom de l'utilisateur\"
\n– \"idConcerne\" qui est son ID (dans l'agence)
\n– \"listeJours\" qui est un tableau des temps attribués avec pour chacun
\ndans le cas d'une absence : \"jour\", \"absence\" et \"designationAbsence\"
\net dans les autres cas : \"jour\", \"dureeTheorique\", \"dureeDisponible\", \"dureeRealisee\", \"dureeAttribuee\" et \"tauxOccupation\"
| Codes | \ndescriptions | \n
|---|---|
| ErrTPSCriteresAbsents | \nAucun critère transmis. Il faut au moins une période | \n
| ErrTPSiDConcerneErrone | \nL'ID de l'utilisateur est incorrect | \n
| ErrEmailInconnu | \nL’adresse email indiquée n’existe pas dans cette agence. | \n
| ErrTPSIDsInexistants | \nL'ID fourni ne se réfère à aucune donnée | \n
| ErrTPSiDBudgetErrone | \nL'ID de la ligne de budget est incorrect | \n
(date, obligatoire) : date de début de période
\n","type":"text/plain"},"key":"$start","value":"2019-05-06"},{"description":{"content":"(date, obligatoire) : date de fin de période
\n","type":"text/plain"},"key":"$end","value":"2019-06-01"},{"disabled":true,"description":{"content":"(integer,optionnel) ID de l'utilisateur (non pris en compte si l'utilisateur n'a pas le droit de voir les taux d'occupation des autres collaborateurs)
\n","type":"text/plain"},"key":"idConcerne","value":""},{"description":{"content":"(string,optionnel) Adresse email d'un utilisateur
\n","type":"text/plain"},"key":"emailConcerne","value":"XXXX@YYYY.com"},{"disabled":true,"description":{"content":"(Boolean,optionel) si true : la liste retournée inclut toutes les dates. Sinon, seules les dates où le taux est différent de 0% ou bien ayant une absence sont retournées.
\n","type":"text/plain"},"key":"siAvecTousLesJours","value":""},{"description":{"content":"(Boolean,optionel) si true, ajoute au résultat les jours feriés et de week end
\n","type":"text/plain"},"key":"siAvecWeekEndsEtFeries","value":null}],"variable":[]}},"response":[],"_postman_id":"768a5890-1ced-47d2-b9da-a4366a7595e8"},{"name":"Modifier un temps passé","id":"656e9364-28f2-4521-be2b-81420b684a00","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{leTokenPerso}}"}]},"isInherited":false},"method":"PATCH","header":[{"description":"La base de données de BillJobs
\n","key":"base","type":"text","value":"{{agence}}"},{"description":"Le type MIME de la ressource
\n","key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"description":"Votre clé API transmise par Billjobs
\n","key":"APIKey","type":"text","value":"{{CleApi}}"}],"body":{"mode":"raw","raw":"{\n\t\"TempsPasse\" : {\n \"id\": 13231,\n \"emailconcerne\": \"margaux@billjobs.com\",\n \"dureereelle\": 120,\n \"notes\": \"Il était une jolie fois\",\n \"heuredebut\": \"10h00\"\n\t}\n}\n"},"url":"http://{{url}}/api/json/v1/TempsPasses/TempsPasse/","description":"API modifiant un temps passé déjà enregistré.
\nLe \"Body\" doit contenir un json décrivant les modifications à apporter au temps passé.
{
\n \"TempsPasse\" : {
\n \"id\": 13230,
\n \"jour\": \"2019-07-11\",
\n \"idDossier\": 631,
\n \"idActivite\": 197,
\n \"dureereelle\": 35,
\n \"emailconcerne\": \"xxxx@yyyy.com\",
\n \"notes\": \"Il était une fois\",
\n \"idbudget\": 456,
\n \"heuredebut\": \"9:00\"\n }
\n}
Les données à transmettre dans ce JSON :
L'API retourne le même genre de données que l'API \"Création temps passé\".
| Codes | \ndescriptions | \n
|---|---|
| ErrTPSDateAnterieureArreteComptable | \nLa date est antérieure à la date d'arrêté comptable | \n
| ErrTPSIDAbsent | \nIdentifiant de la feuille de temps non défini | \n
| ErrTPSFdTInexistant | \nLa feuille de temps n'existe pas | \n
| ErrTPSDateDansLeFutur | \nLa date est dans le futur | \n
| ErrTPSDureeNonConforme | \nLa durée n'est pas conforme | \n
| ErrTPSDureeNulle | \nLa durée n'est pas défini | \n
| ErrTPSBudgetTermine | \nBudget marqué terminé | \n
| ErrEmailInconnu | \nL’adresse email indiquée n’existe pas dans cette agence. | \n
| ErrTPSSuppressionAutreImpossible | \nLa personne connectée n'a pas le droit de modifier une feuille de temps d'une autre personne | \n
La base de données de BillJobs
\n","key":"base","type":"text","value":"{{agence}}"},{"key":"Content-Type","name":"Content-Type","value":"application/json","description":"Le type MIME de la ressource
\n","type":"text"},{"description":"Votre clé API transmise par Billjobs
\n","key":"APIKey","type":"text","value":"{{CleApi}}"}],"body":{"mode":"raw","raw":"{\n\t\"TempsPasse\" : {\n \"jour\": \"2021-01-29\",\n \"numDossier\": \"56\",\n \"nomActivite\": \"Intégration\",\n \"dureereelle\": 35,\n \"emailconcerne\": \"vincent@billjobs.com\",\n \"notes\": \"Il était une fois\",\n \"heuredebut\": \"9:35\"\n\t}\n}\n"},"url":"http://{{url}}/api/json/v1/TempsPasses/TempsPasse/","description":"API créant un temps passé.
\nLe \"Body\" doit contenir un json décrivant le temps passé à créer.
{
\n \"TempsPasse\" : {
\n \"jour\": \"2019-07-11\",
\n [\"idDossier\": 631,]
\n [\"numDossier\": 45,]
\n [\"idActivite\": 197,]
\n [\"nomActivite\": \"Création\",]
\n \"dureereelle\": 35,
\n [\"emailconcerne\": \"xxxx@yyyy.com\",]
\n [\"prenomNom\": \"Zigoulam Babacoul\",]
\n [\"idConcerne\": 874,]
\n \"notes\": \"Il était une fois\",
\n \"idbudget\": 456,
\n \"heuredebut\": \"9:00\"\n }
\n}
\nLes données à transmettre dans ce JSON :
L'API retourne le même genre de données que l'API \"Liste des temps passés\".
| Codes | \ndescriptions | \n
|---|---|
| ErrTPSDateAnterieureArreteComptable | \nLa feuille de temps est antérieure à la date d'arrêté comptable | \n
| ErrTPSJourAbsent | \nJour non défini | \n
| ErrTPSIDDossierAbsent | \nIdentifiant de dossier non défini | \n
| ErrNumDossierAbsent | \nNuméro de dossier non défini | \n
| ErrTPSIDActiviteAbsent | \nIdentifiant de l'activité non défini | \n
| ErrTPSDateDansLeFutur | \nLe jour indiqué est dans le futur | \n
| ErrTPSDureeNonConforme | \nLa durée n'est pas conforme | \n
| ErrTPSDureeNulle | \nLa durée n'est pas définie | \n
| ErrTPSBudgetNonEngage | \nBudget non engagé | \n
| ErrTPSBudgetTermine | \nBudget marqué terminé | \n
| ErrTPSBudgetRefuse | \nBudget refusé | \n
| ErrEmailInconnu | \nL’adresse email indiquée n’existe pas dans cette agence. | \n
| ErrTPSCreationAutreImpossible | \nLa personne connectée n'a pas le droit de créer une feuille de temps pour une autre personne | \n
La base de données de BillJobs
\n","key":"base","type":"text","value":"{{agence}}"},{"description":"Le type MIME de la ressource
\n","key":"Content-Type","name":"Content-Type","type":"text","value":"application/json"},{"description":"Votre clé API transmise par Billjobs
\n","key":"APIKey","type":"text","value":"{{CleApi}}"}],"body":{"mode":"raw","raw":"{\n\t\"TempsPasse\" : {\n \"id\": 21193,\n \"emailconcerne\": \"vincent@billjobs.com\",\n \"nomActivite\": \"Intégration\",\n \"dureereelle\": 120,\n \"notes\": \"Il était une jolie fois\",\n \"heuredebut\": \"10h00\"\n\t}\n}\n"},"url":"http://{{url}}/api/json/v1/TempsPasses/TempsPasse/","description":"API modifiant un temps passé déjà enregistré.
\nLe \"Body\" doit contenir un json décrivant les modifications à apporter au temps passé.
{
\n \"TempsPasse\" : {
\n \"id\": 13230,
\n \"jour\": \"2019-07-11\",
\n [\"idDossier\": 631,]
\n [\"numDossier\": 45,]
\n [\"idActivite\": 197,]
\n [\"nomActivite\": \"Création\",]
\n \"dureereelle\": 35,
\n [\"emailconcerne\": \"xxxx@yyyy.com\",]
\n [\"prenomNom\": \"Zigoulam Babacoul\",]
\n [\"idConcerne\": 874,]
\n \"notes\": \"Il était une fois\",
\n \"idbudget\": 456,
\n \"heuredebut\": \"9:00\"\n }
\n}
Les données à transmettre dans ce JSON :
L'API retourne le même genre de données que l'API \"Création temps passé\".
| Codes | \ndescriptions | \n
|---|---|
| ErrTPSDateAnterieureArreteComptable | \nLa date est antérieure à la date d'arrêté comptable | \n
| ErrTPSIDAbsent | \nIdentifiant de la feuille de temps non défini | \n
| ErrTPSFdTInexistant | \nLa feuille de temps n'existe pas | \n
| ErrTPSDateDansLeFutur | \nLa date est dans le futur | \n
| ErrTPSDureeNonConforme | \nLa durée n'est pas conforme | \n
| ErrTPSDureeNulle | \nLa durée n'est pas défini | \n
| ErrTPSBudgetTermine | \nBudget marqué terminé | \n
| ErrEmailInconnu | \nL’adresse email indiquée n’existe pas dans cette agence. | \n
| ErrTPSSuppressionAutreImpossible | \nLa personne connectée n'a pas le droit de modifier une feuille de temps d'une autre personne | \n
Collection des APIs relatives à la saise de temps passés.
\n","event":[{"listen":"prerequest","script":{"id":"8f5eafe7-aa6d-4f6c-bf63-3742df3d9c31","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"44f5fd2c-fffc-4045-bab0-c10d50566bca","type":"text/javascript","exec":[""]}}],"_postman_id":"e8bcc517-3c41-4917-a1f6-f688678a0e0a"},{"name":"ABSENCES","item":[{"name":"Liste des absences","id":"2ac18e59-777c-4153-af05-cc2feff8a39c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{leTokenPerso}}"}]},"isInherited":false},"method":"GET","header":[{"description":"La base de données de BillJobs
\n","key":"base","type":"text","value":"{{agence}}"},{"description":"Le type MIME de la ressource
\n","key":"Content-Type","type":"text","value":"application/json"},{"description":"Votre clé API transmise par Billjobs
\n","key":"APIKey","type":"text","value":"{{CleApi}}"}],"url":"http://{{url}}/api/json/v1/Absences/Liste/?begin=2019-04-29&end=2019-07-01","description":"API listant les absences par date pour une personne.
\nLes absences ne concernent que la personne connectée (et dans ce cas le paramètre idConcerne n'est pas pris en compte)
\nou une autre personne ayant l'id idConcerne si ce dernier est spécifié et si la personne connectée a le droit de voir les temps passés des autres personnes.
\nLa liste des absences peut inclure ou non les absences notées pendant les week-end ou les jours fériés.
| Codes | \ndescription | \n
|---|---|
| ErrABSCriteresAbsents | \nAucun critère transmis. Il faut au moins une période | \n
| ErrABSiDConcerneErrone | \nL'ID de l'utilisateur est incorrect | \n
| ErrABSIDInexistant | \nL'ID fourni ne se réfère à aucune donnée | \n
(date, obligatoire) : date de début de période
\n","type":"text/plain"},"key":"begin","value":"2019-04-29"},{"description":{"content":"(date, obligatoire) : date de fin de période
\n","type":"text/plain"},"key":"end","value":"2019-07-01"},{"disabled":true,"description":{"content":"(integer,optionnel) ID de l'utilisateur (non pris en compte si l'utilisateur n'a pas le droit de voir les taux d'occupation des autres collaborateurs)
\n","type":"text/plain"},"key":"idConcerne","value":"850"},{"disabled":true,"description":{"content":"(boolean,optionnel) : true pour afficher les jours de week-end et le les jours fériés (selon paramétrage de BillJobs)
\n","type":"text/plain"},"key":"siAvecWeekEndsEtFeries","value":"true"}],"variable":[]}},"response":[{"id":"6d203e31-48cf-43e2-9a47-60deae8ab273","name":"Liste des Taux occupation","originalRequest":{"method":"GET","header":[{"key":"base","value":"bj_test17","description":"La base de BillJobs","type":"text"},{"key":"Content-Type","value":"application/json","description":"Le type MIME de la ressource","type":"text"},{"key":"APIKey","value":"","description":"Votre clé API transmit par Billjobs ","type":"text"}],"url":{"raw":"http://127.0.0.1:8080/api/json/v1/TempsPasses/TauxOccupation/?begin=2019-05-06&end=2019-06-01","protocol":"http","host":["127","0","0","1"],"port":"8080","path":["api","json","v1","TempsPasses","TauxOccupation",""],"query":[{"key":"begin","value":"2019-05-06","description":"(date, obligatoire) : date de début de période"},{"key":"end","value":"2019-06-01","description":"(date, obligatoire) : date de fin de période"},{"key":"idConcerne","value":"","description":"(integer,optionnel) ID de l'utilisateur (non pris en compte si l'utilisateur n'a pas le droit de voir les taux d'occupation des autres collaborateurs)","type":"text","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Connection","value":"close"},{"key":"Date","value":"Wed, 22 May 2019 11:06:45 GMT"},{"key":"Content-Encoding","value":"gzip"},{"key":"Content-Length","value":"222"}],"cookie":[],"responseTime":null,"body":"{\n \"TotalRows\": 5,\n \"listeJours\": [\n {\n \"jour\": \"2019-05-14\",\n \"dureeTheorique\": 480,\n \"dureeDisponible\": 0,\n \"dureeRealisee\": 480,\n \"dureeAttribuee\": 0,\n \"tauxOccupation\": \"100%\"\n },\n {\n \"jour\": \"2019-05-16\",\n \"dureeTheorique\": 480,\n \"dureeDisponible\": 360,\n \"dureeRealisee\": 120,\n \"dureeAttribuee\": 60,\n \"tauxOccupation\": \"25%\"\n },\n {\n \"jour\": \"2019-05-17\",\n \"dureeTheorique\": 420,\n \"dureeDisponible\": 360,\n \"dureeRealisee\": 60,\n \"dureeAttribuee\": 0,\n \"tauxOccupation\": \"14%\"\n },\n {\n \"jour\": \"2019-05-21\",\n \"dureeTheorique\": 480,\n \"dureeDisponible\": 360,\n \"dureeRealisee\": 120,\n \"dureeAttribuee\": 120,\n \"tauxOccupation\": \"25%\"\n },\n {\n \"jour\": \"2019-05-22\",\n \"dureeTheorique\": 480,\n \"dureeDisponible\": 450,\n \"dureeRealisee\": 30,\n \"dureeAttribuee\": 30,\n \"tauxOccupation\": \"6%\"\n }\n ]\n}"}],"_postman_id":"2ac18e59-777c-4153-af05-cc2feff8a39c"}],"id":"b8b5d26b-93ba-4691-b97d-44dfb3345ac5","_postman_id":"b8b5d26b-93ba-4691-b97d-44dfb3345ac5","description":""},{"name":"Utilisateur","item":[{"name":"DescriptifsDroits","id":"3997f14c-e072-43d9-8a8d-568c16ed557a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{leTokenPerso}}"}]},"isInherited":false},"method":"GET","header":[{"description":"La base de données de BillJobs
\n","key":"base","type":"text","value":"{{agence}}"},{"description":"Le type MIME de la ressource
\n","key":"Content-Type","type":"text","value":"application/json"}],"url":"http://{{url}}/api/json/v1/Utilisateur/DescriptifsDroits/","description":"API donnant le descriptif de l'ensemble des droits de l'utilisateur ou d'un utilisateur spécifié.
\n| Codes | \ndescription | \n
|---|---|
| ErrDroitsIDIncorrect | \nL'ID d'utilisateur indiqué n'est pas correct. | \n
(integer, optionnel) : Identifiant de la personne dans l'agence
\n","type":"text/plain"},"key":"id","value":"592"},{"disabled":true,"description":{"content":"(string, optionnel) : Code ISO de la langue du descriptif soit FR, EN ou ES (inutilisé pour l'instant)
\n","type":"text/plain"},"key":"langue","value":"FR"}],"variable":[]}},"response":[{"id":"022ec180-3d6b-46da-9899-b6bbfac0840c","name":"DescriptifsDroits","originalRequest":{"method":"GET","header":[{"description":"La base de données de BillJobs","key":"base","type":"text","value":"bj_test17"},{"description":"Le type MIME de la ressource","key":"Content-Type","type":"text","value":"application/json"}],"url":{"raw":"http://127.0.0.1:8080/api/json/v1/Utilisateur/DescriptifsDroits/?id=592","protocol":"http","host":["127","0","0","1"],"port":"8080","path":["api","json","v1","Utilisateur","DescriptifsDroits",""],"query":[{"description":"(string, optionnel) : Code ISO de la langue du descriptif (inutilisé pour l'instant)","key":"langue","value":"FR","disabled":true},{"key":"id","value":"592","description":"(integer, optionnel) : Identifiant de la personne dans l'agence"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Connection","value":"close"},{"key":"Date","value":"Fri, 14 Jun 2019 10:31:41 GMT"},{"key":"Content-Encoding","value":"gzip"},{"key":"Content-Length","value":"553"}],"cookie":[],"responseTime":null,"body":"{\n \"TotalRows\": 25,\n \"personne\": \"Zigoulam ZoukouniBoudiné\",\n \"id\": \"592\",\n \"Statut\": \"Normal\",\n \"droits\": [\n {\n \"Categorie\": \"Activités\",\n \"Detail\": [\n \"Peut ajouter, modifier, supprimer et fusionner des activités et les changer de groupe\",\n \"Peut utiliser dans les pièces des activités du groupe «Frais généraux»\"\n ]\n },\n {\n \"Categorie\": \"Dossiers\",\n \"Detail\": [\n \"Peut ajuster des dossiers\",\n \"Peut archiver des dossiers\",\n \"Peut rendre ce dossier non facturable ou facturable\",\n \"Peut créer des noms de clients\",\n \"Peut lire, créer, renommer et supprimer des dossiers et gérer les coresponsables\"\n ]\n },\n {\n \"Categorie\": \"Saisie des absences\",\n \"Detail\": [\n \"Saisie de ses absences\",\n \"Saisie des absences de tout le monde\"\n ]\n },\n {\n \"Categorie\": \"Temps passés\",\n \"Detail\": [\n \"Peut créer, modifier et supprimer des temps passés\",\n \"Peut agir sur une feuille de temps, bien que n’étant pas son créateur\"\n ]\n },\n {\n \"Categorie\": \"Lignes de coûts internes\",\n \"Detail\": [\n \"Peut créer, modifier et supprimer des commandes internes\"\n ]\n },\n {\n \"Categorie\": \"Planning\",\n \"Detail\": [\n \"Peut attribuer du temps à des collaborateurs\",\n \"Peut lire et modifier les éléments du planning\",\n \"Peut voir les travaux de l’ensemble des collaborateurs\"\n ]\n }\n ]\n}"}],"_postman_id":"3997f14c-e072-43d9-8a8d-568c16ed557a"},{"name":"Droits","id":"e0f1902d-0bd3-4421-8115-54612f3c3db7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{leTokenPerso}}"}]},"isInherited":false},"method":"GET","header":[{"description":"La base de données de BillJobs
\n","key":"base","type":"text","value":"{{agence}}"},{"description":"Le type MIME de la ressource
\n","key":"Content-Type","type":"text","value":"application/json"}],"url":"http://{{url}}/api/json/v1/Utilisateur/Droits/","description":"API donnant les droits de l'utilisateur ou d'un utilisateur spécifié.
\nLes droits sont retournés sous forme de constante et de valeur.
\nLes valeurs peuvent être
Exemple :{\"Erreur\":[{\"Contenu\":\"ErrDroitsIDIncorrect\"}]}| Codes | \ndescription | \n
|---|---|
| ErrDroitsIDIncorrect | \nL'ID d'utilisateur indiqué n'est pas correct. | \n
(integer, optionnel) : Identifiant de la personne dans l'agence
\n","type":"text/plain"},"key":"ID","value":"592"},{"disabled":true,"description":{"content":"(string, optionnel) : Code ISO de la langue du descriptif (inutilisé pour l'instant)
\n","type":"text/plain"},"key":"langue","value":"FR"}],"variable":[]}},"response":[{"id":"faa91ed0-643c-44c0-a653-738e0b2d91f9","name":"Droits","originalRequest":{"method":"GET","header":[{"key":"base","value":"bj_test17","description":"La base de données de BillJobs","type":"text"},{"key":"Content-Type","value":"application/json","description":"Le type MIME de la ressource","type":"text"}],"url":{"raw":"http://127.0.0.1:8080/api/json/v1/Utilisateur/Droits/?ID=592","protocol":"http","host":["127","0","0","1"],"port":"8080","path":["api","json","v1","Utilisateur","Droits",""],"query":[{"key":"ID","value":"592","description":"(integer, optionnel) : Identifiant de la personne dans l'agence"},{"key":"langue","value":"FR","description":"(string, optionnel) : Code ISO de la langue du descriptif (inutilisé pour l'instant)","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Connection","value":"close"},{"key":"Date","value":"Fri, 14 Jun 2019 10:31:50 GMT"},{"key":"Content-Encoding","value":"gzip"},{"key":"Content-Length","value":"287"}],"cookie":[],"responseTime":null,"body":"{\n \"TotalRows\": 25,\n \"personne\": \"Zigoulam ZoukouniBoudiné\",\n \"id\": \"592\",\n \"Statut\": \"Normal\",\n \"droits\": [\n {\n \"Activites\": [\n {\n \"acces\": 4\n },\n {\n \"accesFraisGeneraux\": true\n }\n ]\n },\n {\n \"Dossiers\": [\n {\n \"ajustement\": 4\n },\n {\n \"changerFacturable\": true\n },\n {\n \"acces\": 4\n },\n {\n \"changerArchivage\": true\n },\n {\n \"creerClient\": true\n }\n ]\n },\n {\n \"Absences\": [\n {\n \"gererSesAbsences\": true\n },\n {\n \"gererAbsencesDesAutres\": true\n }\n ]\n },\n {\n \"FdT\": [\n {\n \"acces\": 4\n },\n {\n \"modifierTempsDesAutres\": 1\n }\n ]\n },\n {\n \"Cmi\": [\n {\n \"acces\": 4\n }\n ]\n },\n {\n \"Planning\": [\n {\n \"modifierFdTDesAutres\": true\n },\n {\n \"attribuerDuTemps\": true\n },\n {\n \"acces\": 4\n }\n ]\n }\n ]\n}"}],"_postman_id":"e0f1902d-0bd3-4421-8115-54612f3c3db7"}],"id":"e037f2e6-b2a1-48b1-ba14-650dd90fd802","_postman_id":"e037f2e6-b2a1-48b1-ba14-650dd90fd802","description":""},{"name":"Clients-Dossiers","item":[{"name":"DOSSIERS","item":[{"name":"Liste Dossiers simplifiée pour la saisie de feuille de temps","id":"ce6912c3-51b2-4d5d-b741-3e60aab6484a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{leTokenPerso}}"}]},"isInherited":false},"method":"GET","header":[{"description":"La base de données de BillJobs
\n","key":"base","type":"text","value":"{{agence}}"},{"description":"Le type MIME de la ressource
\n","key":"Content-Type","type":"text","value":"application/json"},{"description":"Votre clé API transmise par Billjobs
\n","key":"APIKey","type":"text","value":"{{CleApi}}"}],"body":{"mode":"raw","raw":""},"url":"http://{{url}}/api/json/v1/Dossiers/ListeSimplifieePourSaisieTemps/?SiAccesUtilisateur=true","description":"API affichant une liste simplifiée des dossiers pour la saisie de feuille de temps.
Cf. en tête de cette documentation.
(String ,optionnel) si valorisé : ne liste que les dossiers contenant cette valeur
\n","type":"text/plain"},"key":"$lk","value":"Dossier"},{"disabled":true,"description":{"content":"(String ,optionnel) si valorisé : ne liste que les dossiers commencant par cette valeur
\n","type":"text/plain"},"key":"$start","value":"Dossier"},{"disabled":true,"description":{"content":"(String ,optionnel) si valorisé : exclut les dossiers ayant cette valeur
\n","type":"text/plain"},"key":"$nlk","value":"Dossier"},{"disabled":true,"description":{"content":"(String ,optionnel) si valorisé : ne liste que les dossiers ayant cette valeur
\n","type":"text/plain"},"key":"$eq","value":"Dossier 3"},{"description":{"content":"(Boolean ,optionnel) Si présent : ne liste que les dossiers dont l'utilisateur ont le droit d'accès
\n","type":"text/plain"},"key":"SiAccesUtilisateur","value":"true"},{"disabled":true,"description":{"content":"(integer, optionnel ou obligatoire si le critère \"page\" est fourni) nombre de lignes par plage
\n","type":"text/plain"},"key":"per_page","value":"5"},{"disabled":true,"description":{"content":"(integer, optionnel ou obligatoire si le critère \"per_page\" est fourni) numéro de la plage
\n","type":"text/plain"},"key":"page","value":"500"}],"variable":[]}},"response":[{"id":"90ed1444-1c6b-4bd8-b48f-2276926a52ac","name":"Lister Dossiers Simplifies pour la saisie de feuille de temps","originalRequest":{"method":"GET","header":[{"description":"nom de la base Billjobs","key":"base","type":"text","value":"bj_test17"}],"body":{"mode":"raw","raw":""},"url":{"raw":"http://127.0.0.1:8080/api/json/v1/Dossiers/ListeSimplifieeST/?lignes=5&ligne début=500","protocol":"http","host":["127","0","0","1"],"port":"8080","path":["api","json","v1","Dossiers","ListeSimplifieeST",""],"query":[{"description":"(String ,optionnelle) si valorisé : ne liste que les dossiers contenants cette valeur","key":"contient","value":"","disabled":true},{"description":"(String ,optionnelle) si valorisé : ne liste que les dossiers commencants par cette valeur","key":"commence","value":"","disabled":true},{"description":"(String ,optionnelle) si valorisé : exclut les dossiers ayants cette valeur","key":"ne contient pas","value":"","disabled":true},{"description":"(String ,optionnelle) si valorisé : ne liste que les dossiers ayants cette valeur","key":"égal","value":"","disabled":true},{"key":"lignes","value":"5","description":"(Integer ,optionnelle) ce paramètre définit le nombre de lignes à retourner"},{"key":"ligne début","value":"500","description":"(Integer ,optionnelle) ce paramètre définit le numéro de début de ligne du résultat"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=UTF-8"},{"key":"Connection","value":"close"},{"key":"Date","value":"Wed, 15 May 2019 14:26:59 GMT"},{"key":"Content-Encoding","value":"gzip"},{"key":"Content-Length","value":"271"}],"cookie":[],"responseTime":null,"body":"{\n \"TotalRows\": 5,\n \"Statut\": \"200\",\n \"listeDossiers\": [\n {\n \"id\": 170,\n \"num\": \"89\",\n \"client\": \"- COMPÉTITIONS\",\n \"titre\": \"UPS - Refonte de site 2018\"\n },\n {\n \"id\": 17,\n \"num\": \"9\",\n \"client\": \"Thierry Mugler\",\n \"titre\": \"Campagne digitale ALIEN\"\n },\n {\n \"id\": 171,\n \"num\": \"90\",\n \"client\": \"- COMPÉTITIONS\",\n \"titre\": \"DANONE - Crèmes desserts\"\n },\n {\n \"id\": 172,\n \"num\": \"91\",\n \"client\": \"- COMPÉTITIONS\",\n \"titre\": \"Refonte site Billjobs\"\n },\n {\n \"id\": 173,\n \"num\": \"92\",\n \"client\": \"BADOIT\",\n \"titre\": \"BADOIT - Refonte identité - Compétition\"\n }\n ]\n}"}],"_postman_id":"ce6912c3-51b2-4d5d-b741-3e60aab6484a"}],"id":"bf752f27-bef5-4381-b88a-509615bc1a9b","description":"Cette collection décrit les API qui gérent les dossiers.
\nUn dossier est lié à un client et peut être lié à un classeur.
La base de données de BillJobs
\n","type":"text"},{"key":"Content-Type","value":"application/json","description":"Le type MIME de la ressource
\n","type":"text"}],"url":"http://{{url}}/api/json/v1/Erreur/?codeErreur=ErrErreurCodeInconnu","description":"API donnant le descriptif d'un code d'erreur retourné par le serveur.
\nExemple :{\"Erreur\":[{\"Contenu\":\"ErreurDB\"},{\"statut\":400}]}| Codes | \ndescription | \n
|---|---|
| ErrErreurCodeAbsent | \nLe code d'erreur n’est pas indiqué. | \n
| ErrErreurCodeInconnu | \nLe code d'erreur est inconnu. | \n
(string, obligatoire) : Code d'erreur ayant été retourné par le serveur
\n","type":"text/plain"},"key":"codeErreur","value":"ErrErreurCodeInconnu"},{"disabled":true,"description":{"content":"(string, optionnel) : Code ISO de la langue du descriptif (inutilisé pour l'instant)
\n","type":"text/plain"},"key":"langue","value":"FR"}],"variable":[]}},"response":[],"_postman_id":"adbaa226-7ae2-47ab-b3cc-f3de3eaa340a"},{"name":"Réglages du calendrier","id":"f495d9d6-2bf9-401c-bbb7-38548667d2a7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{leTokenPerso}}"}]},"isInherited":false},"method":"GET","header":[{"key":"base","value":"{{agence}}","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"url":"http://{{url}}/api/json/v1/ReglagesAgence/Calendrier/","description":"Récupére les différents réglages de calendrier : temps de travail par semaine et jour, nombre de jours par semaine, etc.
\nCf. en tête de cette documentation.
\n","urlObject":{"protocol":"http","path":["api","json","v1","ReglagesAgence","Calendrier",""],"host":["{{url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"f495d9d6-2bf9-401c-bbb7-38548667d2a7"},{"name":"Jours fériés","id":"a5fed435-0e94-463e-be40-755d7088f064","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{leTokenPerso}}"}]},"isInherited":false},"method":"GET","header":[{"key":"base","type":"text","value":"{{agence}}"},{"key":"Content-Type","type":"text","value":"application/json"}],"url":"http://{{url}}/api/json/v1/ReglagesAgence/JoursFeries/?begin=2020-01-12&end=2020-04-30","description":"API permettant d'obtenir la liste des jours fériés dans une période.
\nUn Json est retourné contenant le rappel des dates de début et fin de la période,\n
le numéro de semaine du 1er jour de la période et la liste des éventuels jours fériés dans cette période\n
(s'il n'y en a pas, l'élément \"joursFeries\" est absent).
}\n
| Codes | \ndescription | \n
|---|---|
| ErrCriteresAbsents | \nAucun critère transmis. Il faut au moins une période | \n
| ErrDateDebutNonConforme | \nLa date de début de la période est incorrecte ou n’eest pas indiquée. | \n
| ErrDateFinNonConforme | \nLa date de fin de la période est incorrecte ou n’eest pas indiquée. | \n
(date, obligatoire)
\n","type":"text/plain"},"key":"begin","value":"2020-01-12"},{"description":{"content":"(date, obligatoire)
\n","type":"text/plain"},"key":"end","value":"2020-04-30"}],"variable":[]}},"response":[],"_postman_id":"a5fed435-0e94-463e-be40-755d7088f064"}],"event":[{"listen":"prerequest","script":{"id":"cf9be7da-2e54-4690-bd94-e583b756f5fb","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"13d425bb-1d36-4d02-8a2f-6005e26b7ba8","type":"text/javascript","exec":[""]}}]}