Légende 


Action immédiate requise (impact sur le client ou sur l’intérimaire)

Figurent toujours en tête de document

Action requise pour activer la fonctionnalité

Frais liés à l’activation de la fonctionnalité

Aucune action requise pour activer la fonctionnalité


Améliorations fonctionnelles 


INFO IMPORTANTE : Que signifie la version bêta pour l'API ?


Nous travaillons intensément sur les nouveaux endpoints pour les contrats, les prestations et les primes.  Étant donné que nous ne pouvons pas tout faire en même temps et que nous ne pouvons donc pas lancer un produit complet, nous allons lancer les nouveaux endpoints en version bêta.  Cela signifie que vous pouvez déjà effectuer une analyse technique, éventuellement une petite mise en œuvre en test, mais nous ne recommandons toujours pas d'utiliser les endpoints bêta dans un environnement de production. La raison en est que les modèles de domaine ne sont pas assez stables et peuvent encore changer avec une version ultérieure.


Pour les endpoints en version bêta, ce texte est visible dans Swagger.



Si les endpoints sont stables, la désignation bêta sera supprimée. Nous le communiquerons via les release notes.



API        

Nouveaux ajouts             

Un nouvel endpoint est prévu pour récupérer les prestations d'un contrat.

Cet endpoint permet de récupérer toutes les prestations pour un contrat avec un certain identifiant de contrat.

GET /integration/employmentContract/{employmentContractId}/performances

Les paramètres de l'url sont :

  • :employmentContractId --> peut être récupéré à partir des endpoints de /integration/employmentcontract


Les paramètres de la requête sont :

  • code : pour filtrer sur 1 code (ex. AD)

  • fromdate : pour filtrer sur la date de (incl.)

  • untildate : pour filtrer sur la date jusqu'au

  • pagenumber : la page dépend de la taille de la page

  • pagesize : par défaut 10, maximum 100    

Un nouvel endpoint est prévu pour récupérer les prestations d'un contrat.

Cet endpoint permet de demander 1 prestation pour un contrat avec un certain id de contrat.

GET/integration/employmentContract/{employmentContractId}/performance/{performanceId}

Les paramètres de l'url sont :

  • :employmentContractId --> peut être récupéré à partir des endpoints de /integration/employmentcontract

  • :performanceId --> peut être récupéré via les endpoints de /integation/employmentcontract/{id}/performance

Il existe un nouvel endpoint pour demander les primes d'un contrat.

Cet endpoint permet de demander toutes les primes pour un contrat avec un certain id de contrat.


GET /integration/employmentContract/{employmentContractId}/premiums


Les paramètres de l'url sont :

  • :employmentContractId --> peut être récupéré à partir des endpoints de /integration/employmentcontract


Les paramètres de la requête sont :

  • code : pour filtrer sur 1 code de prime.

  • fromdate : pour filtrer sur la date de (incl.)

  • untildate : pour filtrer sur la date jusqu'au

  • pagenumber : la page dépend de la taille de la page

  • pagesize : par défaut 10, maximum 100

Il existe un nouvel endpoint pour demander une prime d'un contrat.

Cet endpoint permet de demander 1 prime pour un contrat avec un certain id de contrat.


GET /integration/employmentContract/{employmentContractId}/premium/{premiumId}


Les paramètres de l'url sont :

  • :employmentContractId --> peut être récupéré à partir des endpoints de /integration/employmentcontract

  • :premiumId --> peut être récupéré via les endpoints de /integation/employmentcontract/{id}/premium    

Un nouvel endpoint est prévu pour récupérer les options client d'un client.

Cet endpoint permet de récupérer la liste des options client attribuées à un client.

GET/integration/client/{clientId}/options

Les paramètres de l'url sont :

  • :clientId--> peut être récupéré à partir des endpoints de /integration/client

Un nouvel endpoint est prévu pour ajouter les options d'un client.

POST /integration/client/{clientId}/options


Les paramètres de l'url sont :

  • :clientId--> peut être récupéré à partir des endpoints de /integration/client


Pour l'instant, il n'est possible d'ajouter que des codes de type "Oui". D'autres codes seront ajoutés lors d'une prochaine version.

Les codes avec le type "Oui" sont :

BN,EMZB,FPF,GBN,GPA,GPP,GUP,KAPP,KKPP,MIU,NKP,PIM,AVO,GVA,SYND,VCA,TTP,VWB,VUT,BCGAS,CRN,TGP,GGC,IAV,IKV,KGM,PPU,PAP,AOF,BM,EFT,FTOT,FZD,GAF,SFK,TAK,TDA,TKN,TKP,TOFALWAYS,UCF,VAF,SFN,KLBB,IBV,GKC,BIN,GCI,BBKT,VCSK,GOK,SFUF,NPA,TGW,PIU,CCBC

Un nouvel endpoint est prévu pour supprimer les options d'un client.

DELETE /integration/client/{clientId}/options/{optionid}

les paramètres de l'url sont :

  • :optionId--> peut être récupéré à partir des endpoints de /integration/client/{clientid}/options.

Un nouvel endpoint est prévu pour préparer un client pour le contrat de travail. Après la préparation pour le contrat de travail, il est possible de créer des contrats pour le client.


PUT /integration/client/:clientId/setreadyforemploymentcontracts


Les paramètres de l'url sont :

  • :clientID --> peut être récupéré à partir des endpoints de /integration/client


Les contrôles comme les options syndicales, la présence de minimum un régime de travail, l'option GBN pour les clients sans numéro de TVA, ..... etc. sont également effectués.

Les options client peuvent être gérées via /integration/client/{clientId}/options

Les régimes de travail peuvent être gérés via /integration/client/{clientId}/workregime


Il n'est pas possible de préparer un client pour le contrat de travail plus d'une fois.

Un nouvel endpoint est prévu pour créer un contrat hebdomadaire avec les champs obligatoires + régime de travail et horaire.

Il n'est pas encore possible de créer un contrat de >1 semaine ou de durée indéterminée.

POST /integration/employmentcontract

Ces données peuvent être transmises pour sauvegarder un nouveau contrat hebdomadaire :

  • Branch (Agence)

  • BeginDate (Date de début)

  • EndDate (Date de fin)

  • ClientId (Id du client)

  • StatuteId (Numéro de l'intérimaire)

  • JobdescriptionId (Id de la fonction)

  • HourlyWage (Salaire horaire)

  • ReferenceWage (Salaire de référence)

  • Coefficient (Coefficient)

  • SelectionTempworker (SelectionIntérimaire)

  • RemunerationMethod (Type de rémunération)

  • Type (Type)

  • ReasonOfEmployment (Raison du contrat)

  • MeansOfTransport (Moyen de transport)

  • ClientWorkRegimeId (Id du régime de travail du client)

  • WorkingSystem (Régime)

  • Q (Q)

  • S (S)

  • WeeklyHoursFulltime (Heures hebdomadaires à temps plein)

  • WeeklyHoursPartime (Heures hebdomadaires à temps partiel)

  • WorkTimeReductionUnpaid (RTT non payé)

  • WorkTimeReductionPaid (RTT payé)

  • WorkSchedule (Horaire de travail)

Au endpoint POST /integration/employmentcontract les attributs suivants sont ajoutés et implémentés :

  • ProfileId --> peut être récupéré via les endpoints /integration/client/{clientid}/profile

  • FunctionDescription --> description de la fonction en texte libre

  • TaxExemptionImmovablePropertyWork --> oui ou non pour l'exonération du PP pour travaux immobiliers

  • MealVoucherManualCalculation --> oui ou non si les CR doivent être calculés manuellement

  • VacancyId --> une demande/une offre d'emploi comme motif = "insertion"

  • PlaceOfEmployment --> Lieu d'emploi (texte, non structuré)

  • ExtraInfo --> informations supplémentaires (texte)

Le nouvel endpoint pour récupérer les contrats a été étendu avec des informations sur la Dimona.

GET {{url}}/webservice/integration/employmentcontract/:employmentcontractid

retourne :

  • Numéro de la Dimona

  • Heure de la Dimona (de la dernière action envoyée par PratoFlex à l'ONSS)

  • Statut : Accepted, Rejected, Cancelled, Processing ou Blocked

Un nouvel attribut "payperiod" a été ajouté aux réponses de l'endpoint /integation/employmentcontract.


Cet attribut peut être utilisé pour modifier le statut des prestations (par exemple, prêt pour la rémunération). Le statut des prestations peut être modifié via l'endpoint /integration/performancestate pour lequel une variable "payperiod" est disponible (et obligatoire).

                                                Nouveaux ajouts comme version bêta


Le modèle POST d'un nouveau contrat a été mis à disposition en version bêta.

La réponse du POST contiendra toujours les mêmes informations.


La mise en œuvre sera prévue dans les prochaines versions.

Le modèle POST permettant de créer des prestations pour un contrat a été mis à disposition en version bêta.

La réponse contiendra toujours les mêmes informations.


La mise en œuvre est prévue dans les versions ultérieures.

Le modèle GET permettant de saisir des prestations pour un contrat a été mis à disposition en version bêta.

La réponse contiendra toujours les mêmes informations.

La mise en œuvre sera prévue dans les prochaines versions.


Le modèle PATCH pour modifier les prestations d'un contrat a été mis à disposition en version bêta.

La réponse contiendra toujours les mêmes informations.


La mise en œuvre est prévue dans les versions ultérieures.

Le modèle DELETE permettant de supprimer les prestations d'un contrat a été mis à disposition en version bêta.


La mise en œuvre est prévue dans les versions ultérieures.

Le modèle POST permettant de créer des primes pour un contrat a été mis à disposition en version bêta.

La réponse contiendra toujours les mêmes informations.


L'implémentation sera prévue dans les versions ultérieures.

Le modèle GET permettant de saisir les primes d'un contrat a été mis à disposition en version bêta.

La réponse contiendra toujours les mêmes informations.


La mise en œuvre sera prévue dans les prochaines versions.

Le modèle DELETE permettant de supprimer les primes d'un contrat a été mis à disposition en version bêta.

La mise en œuvre est prévue dans les versions ultérieures.

Le modèle PUT permettant de modifier le statut d'une période de paie a été mis à disposition en version bêta. Ces endpoints peuvent être utilisés en combinaison avec POST, PATCH et DELETE des prestations et des primes pour apporter des corrections ou pour faire passer le statut à une étape suivante ou précédente. (Par exemple, préparer pour la rémunération, faire des corrections/révisions, ...)


Pour l'instant, la réponse du PUT retournera toujours 200.

La mise en œuvre sera prévue dans les prochaines versions.

Modifications


Un bouleversement a été apporté au GET /integration/employementcontract/{id}.


Les pauses (break) et les heures travaillées (timeworked) étant exprimées en centaines dans PratoFlex, l'API a également été modifiée à cet effet. La version précédente retournait ces heures en 60s.


Avec cette version, voici le modèle correct :


Integration.EmploymentContract.WorkSchedulePart {

break (number, optional),

costcenterid (integer, optional),

departmentid (integer, optional),

shift (string, optional): Issue a GET request to /integration/codes with kind 45 for all possible codes ,

start (string, optional): Format: HH:MM ,

stop (string, optional): Format: HH:MM ,

timeworked (number)

}


Modifications dans la version bêta 


Une modification a été apportée aux modèles EmployementContract. Étant donné qu'il s'agit d'une version bêta, nous avons apporté un changement radical.

  • L'attribut "EmployeeNumber" a été changé en "StatuteId". De cette façon, le nommage est cohérent avec les résultats de GET /integration/person/{id}/statute. La modification a été apportée aux modèles de GET, POST et PATCH.

  • Désormais, il n'est plus possible de transmettre des heures pour la date de début et de fin. Un message d'erreur "Invalid model The field BeginDate should not contain time." et/ou "Invalid model The field EndDate should not contain time." s'affiche. Ce changement a été effectué pour le POST et le PATCH.    


Comme nous avons dû apporter quelques modifications au endpoint GET /integration/employmentcontract, cet endpoint a également été inclus en tant que version bêta. Via GET, il est déjà possible de demander un contrat hebdomadaire ou quotidien. Un contrat de plus d'une semaine et à durée indéterminée n'a pas encore été mis en œuvre.


Changements dans cette version :

  • Si aucun salaire de référence n'est connu, le salaire de référence est fixé à un montant égal au salaire horaire brut. (le salaire de référence est un attribut obligatoire pour les contrats de l'écran redesign).

  • Le salaire mensuel était obligatoire et est maintenant facultatif

  • Toutes les décimales sont formatées avec 2 ou 4 chiffres après la virgule.


Clients

Une option client MAXADV "Maximum quotidien pour l'accumulation RTT" a été prévue.

Lorsqu'on effectue le décompte complet de la RTT d'un client, il faut tenir compte de ce maximum quotidien d'accumulation RTT, indépendamment du niveau de statut, du régime de travail, etc.

Un nouveau droit a été ajouté qui permet aux utilisateurs de gérer les coefficients (de facturation) au niveau du client ou non. Le nouveau droit "Gérer les coefficients" est initialement configuré pour tous les utilisateurs de la même manière que le droit "Gérer les clients". 

Personnes                                                

Deux nouveaux types de détails ont été ajoutés au type d'attestation "Réductions ONSS", à savoir.

  • 3705 Réduction du groupe cible relance corona - autre

  • 3706 Réduction du groupe cible corona relance - sévèrement affecté

Clients de Prato payroll : pour l'explication des conditions générales et particulières pour l'application de la réduction du groupe cible relance corona, nous renvoyons à la communication qui a été envoyée à ce sujet au début du mois d'octobre et à l'article sur notre site web. 

Correctifs


Contrats

  • Un défaut survenait lorsque vous vouliez calculer la distance domicile-travail sur un contrat et que l'adresse de l'emploi contenait un signe inattendu dans Google. Cela entraînait une erreur système et une distance non calculée, mais à partir de cette version, la distance est à nouveau calculée correctement.

  • Dans une version précédente, nous avons intégré un contrôle supplémentaire pour vérifier que le dernier sous-contrat d'un contrat master ne pouvait pas être supprimé. Cela a posé un problème avec l'annulation de Dimona. Dimona n'a pas fonctionné parce que le dernier contrat n'a pas été supprimé. Un cercle vicieux... Avec cette version, nous avons résolu le problème de l'annulation de Dimona même s'il reste un dernier contrat de sous-traitance. Les conditions pour pouvoir annuler une Dimona sont inchangées.


Dimona

  • Le message d'erreur dimona "jeune employé sans expérience" est un message informatif, et il est traité automatiquement. Cependant, cela ne s'est pas produit dans tous les cas et a été résolu.            


Documents

  • Les heures RTT (non rémunérées et rémunérées) seront toujours indiquées avec 2 décimales.
    (2 est imprimé comme 2.00, 2.1 est imprimé comme 2.10, 2.11 est imprimé comme 2.11)


Clients

  • Si un numéro de client était attribué à un client alors qu'un profil était également ajusté pour ce même client, il était possible que le numéro de client soit supprimé par erreur. 
    À partir de cette version, nous avons fait en sorte que cela ne puisse plus se produire.


  • Il pourrait y avoir des problèmes lorsque deux utilisateurs différents modifient le même client. Nous avons maintenant intégré une notification qui empêche un utilisateur d'enregistrer un client si d'autres modifications ont déjà été apportées à ce dernier depuis le chargement de l'écran.


  • Il y avait un problème qui faisait que les contacts conservaient les droits de libre-service après avoir été désactivés dans l'écran Contacts dans le fichier du client. Nous avons corrigé ce problème depuis cette version.