Changelog

Historique des évolutions majeures de l'API Mobilic.

02/10/2024

• CompanyOutput now has a CurrentUsers field which returns a list of User having worked for or working for the company.

12/08/2024

• le endpoint /companies/download_activity_report envoie un email (ou plusieurs s'il y a trop de données) au gestionnaire qui fait l'appel, plutôt que de télécharger le fichier.

08/07/2024

• La mutation updateCompanyName est renommée updateCompanyDetails et permet de mettre à jour le nom, le numéro de téléphone ainsi que le type d'activité de l'entreprise. On peut préciser si l'on souhaite appliquer le type d'activité aux salariés

• Une mutation ChangePhoneNumber permet de mettre à jour le numéro de téléphone d'un utilisateur

• Une mutation ChangeEmployeeBusinessType permet de modifier le type d'activité d'un salarié rattaché

• Une nouvelle route POST /controllers/download_control_c1b permet de télécharger le fichier C1B d'un contrôle

• Les objets User et Company ont un champ phoneNumber

• Les objets Company et Employment possèdent un champ Business (BusinessType, TransportType)

03/04/2024

• Dans la mutation logLocation, il n'est plus autorisé de renseigner kilometerReading pour une mission sans véhicule

11/03/2024

• Ajout d'un ActivityType : OFF qui correspond à une absence (congé, repos, formation, etc.)

• Ajout de la mutation logHoliday permettant de créer une mission avec une activité de type OFF et de la valider directement. Cliquer ici pour voir la documentation pour créer une absence

• Amélioration des performances (à l'aide de dataloaders)

13/02/2024

• Suppression du paramètre missionsDeleted sur User remplacé par :

• Ajout de l'attribut include_deleted_missions sur missions de User

• Correction de la mutation syncEmployment avec un utilisateur déjà lié plusieurs fois à l'entreprise

15/01/2024

• Ajout du paramètre missionsDeleted sur Company et User (même format que missions)

• Ajout des paramètres deletedAt et deletedBy sur missionsDeleted

18/12/2023

• Correction de la mutation activities.validateMission : il était (encore) possible pour un gestionnaire d'éditer et valider la mission d'un salarié qui ne l'avait pas encore validé, ceci n'est plus possible. À noter qu'il y a 3 exceptions à cette règle documentées ici.

02/10/2023

Création d'une mutation mutations.updateCompanyName

Permet de modifier le nom usuel d'une entreprise en envoyant le new_name et le company_id

14/09/2023

• Ajout du paramètre employee_version dans l'export C1B (POST /companies/generate_tachograph_files)

31/07/2023

• Correction de la mutation syncEmployment lorsqu'un email renseigné correspond à un utilisateur ayant déjà un compte Mobilic

• Pour l'environnement sandbox : les emails envoyés en masse (relance et/ou alerte) ne seront plus envoyés

07/02/2023

Création d'une mutation account.resetPasswordConnected

Cette mutation permet de modifier le mot de passe d'un utilisateur directement en envoyant le user_id et le nouveau password . La requête ne fonctionne que pour l'utilisateur connecté.

Modification des mutations relatives aux nouveaux mot de passe ResetPasswordConnected, ResetPassword et UserSignUp

Elles acceptent désormais un argument password de type Password, et non un String

07/12/2022

Modification de la mutation activities.validateMission Remplacement de l'attribut d'input userId par une liste usersIds, afin de pouvoir valider les missions en équipe en une fois en fournissant une liste de salariés. La valeur de retour de cette mutation est maintenant de type Mission

Modification de la mutation activities.logActivity Une activité peut être renseignée sur une mission via cette mutation uniquement si l'utilisateur qui fait l'appel a créé la mission, ou si cette activité le concerne.

Modification de la mutation activities.editActivity Une activité ne peut être modifié que par son créateur, ou par l'utilisateur concerné par l'activité. Suite aux 2 modifications ci dessus, pour modifier une mission avant validation gestionnaire, il faut utiliser l'attribut activity_items de la mutation activities.validateMission

17/10/2022

Correctif Possibilité de rajouter un véhicule qui aurait été supprimé dans l'interface gestionnaire

16/08/2022

Création d'une mutation activities.cancelMission Permet d'annuler toutes les activités pour un salarié et une mission donnés.

01/08/2022

Création d'une query BulkActivity Permet d'envoyer une liste d'ajouts/modifications/annulations d'activités et de valider leur faisabilité. Les changements potentiels ne sont pas sauvegardés en base.

Modification de la query ValidateMission Ajout d'un argument activity_items représentant une liste d'ajouts/modifications/annulations d'activités à jouer avant la validation de la mission. Ajout d'un argument expenditures_cancel_ids représentant une liste de frais à supprimer avant la validation. Ajout d'un argument expenditures_inputs représentant une liste de frais à ajouter avant la validation.

20/06/2022

Il est désormais impossible pour un gestionnaire de détacher son propre compte de son entreprise.

23/05/2022

Modification du format de l'onglet "Détails" des exports Excel.

Modification cosmétique du PDF d'export mensuel

10/05/2022

Possibilité d'exporter les activités au format Excel dans un ZIP avec un fichier par employé

• Rajout de l'attribut one_file_by_employee dans la route /companies/download_activity_report (False par défaut)

Modification du format de l'onglet "Activités" des exports Excel.

05/04/2022

Possibilité de donner / retirer les droits administrateurs d'un utilisateur

• Rajout de la mutation employments.changeEmployeeRole

20/03/2022

Rajout du temps de liaison comme type d'activité

• Possibilité d'enregistrer une activité de type "transfer" qui correspond au temps de liaison

Possibilité de ne récupérer les données d'une liste d'entreprises spécifiques pour un utilisateur donné.

• ajout du champs company_ids sur la query admin_companies

05/10/2021

Possibilité d'enregistrer des frais par jour sur des missions de plusieurs jours.

• ajout du champs spending_date sur l'entité Expenditure représentant la date du frais.

17/03/2021

Ajout des lieux de début et prise de service

• ajout de l'entité BaseAddress représentant une adresse postale.

• ajout de la mutation activities.logLocation pour enregistrer un lieu de début ou fin de mission.

• ajout des champs startLocation et endLocation sur l'entité Mission.

02/02/2021

• une mission ne peut plus être validée par un gestionnaire tant qu'elle n'est pas encore terminée par le salarié.

• le salarié est mainetnant notifié par mail lorsque le gestionnaire valide avec modifications une mission.

19/01/2021

Ajout des observations

• nouvelle entité Comment représentant une observation faite par un utilisateur à propos d'une mission.

• ajout d'un champ comments sur l'entité Mission.

Autres

• ajout d'un paramètre onlyNonValidatedMissions du champ Company.missions, qui permet de ne récupérer que les missions en attente de validation par un gestionnaire.

04/12/2020

Ajout de champs

• ajout d'un champ serviceDuration sur l'entité WorkDay, donnant directement l'amplitude de la journée de travail (en secondes).

• ajout d'un champ totalWorkDuration sur l'entité WorkDay, donnant directement le temps de travail de la journée (en secondes).

12/11/2020

Simplification des types en sortie

• harmonisation des opérations qui ne retournent aucun résultat via la création d'un type Void.

• l'opération logActivity retourne maintenant uniquement l'activité créée (et non plus la liste des activités de la mission).

• l'opération editActivity retourne maintenant uniquement l'activité modifiée (et non plus la liste des activités de la mission).

• l'opération cancelActivity ne retourne plus la liste des activités de la mission.

• l'opération logExpenditure retourne maintenant uniquement le frais créé (et non plus la liste de tous les frais de la mission).

• l'opération cancelExpenditure ne retourne plus la liste des frais de la mission.

29/10/2020

Ajout de champs

• ajout d'un champ adminedCompanies sur l'entité User, permettant de récupérer la liste des entreprises sur lesquelles l'utilisateur a des droits de gestion.

• ajout d'un champ workDays sur l'entité Company, pour récupérer les journées de travail des salariés de l'entreprise

• ajout d'un champ missions sur l'entité Company, pour récupérer les missions de l'entreprise.

• ajout d'un champ endTime sur l'entité Activity, indiquant la date et l'heure de fin (si renseignées).

• ajout d'un champ lastUpdateTime sur l'entité Activity, indiquant la date et l'heure de dernière modification.

• ajout d'une opération mission (id: Int) de type query pour accéder aux informations d'une mission.

Changement de la logique d'enregistrement

• distinction entre deux modes d'enregistrement : le mode tachygraphe (enregistrement d'un changement d'activité) et le mode classique (enregistrement d'une période d'activité). L'opération logActivity prend désormais un paramètre switch permettant de préciser le mode.

• les identifiants (id) des activités sont maintenant "persistants".

Limitation du volume de sortie

• ajout de paramètres pour restreindre la période d'historique récupérée (pour un utilisateur ou une entreprise).

Divers

• gestion des erreurs par des codes erreurs.

• simplification du format d'entrée pour les horodatages : passage d'un format en millisecondes à un format en secondes.

• les horodatages de début et de fin d'activité sont désormais arrondis à la minute (inférieure).

• les jetons d'accès OAuth ont été rendus permanents (jusqu'à révocation par l'utilisateur) : il n'y a plus de date d'expiration.