Legende
| Onmiddellijke actie vereist (impact op de klant of uitzendkracht) Deze staan steeds bovenaan in het document |
| Actie vereist om de functionaliteit te activeren |
| Kost verbonden aan het activeren van de functionaliteit |
| Geen actie vereist om de functionaliteit te activeren |
Functionele verbeteringen
API
| Met release 2022.01 zullen volgende endpoints verwijderd worden. Deze endpoints zijn sinds release 2020.07 gemarkeerd als deprecated en worden volgens onze logging niet meer gebruikt.
Het gaat over 2 endpoints om prestaties en premies toe te voegen o.b.v. een klant en werknemersnummer.
Wil je prestaties en premies toevoegen, gebruik dan de nieuwe endpoints o.b.v. een contractid (EmploymentContractPerformance & EmploymentContractPremium).
Indien er vragen of opmerkingen zijn, contacteer customercare@prato.be.
|
| De niet-afgehandelde DIMONA meldingen zijn opgenomen in de response van een contract.
GET {{url}}/webservice/integration/employmentcontract/:employmentcontractid geeft meldingen terug via het attribuut "dimona"."messages". voorbeeld { "code": "460", "description": "Laattijdige aangifte", "field": "DimonaIn", "quotaexceedingdays": null, "quotaexceedinghours": null, "quotatype": null, "value": "" }
Alle informatie komt van Dimona : code = de code zoals bij Dimona gekend description = de foutmelding zoals bij Dimona gekend field = het veld bij Dimona waarop de melding betrekking heeft value = de waarde van het veld waarop de melding betrekking heeft quotatype = vb. student, horeca_worker quotaexceedingdays = aantal dagen overschreden volgens quotatype quotaexceedinghours = aantal uren overschreden volgens quotatype
Met deze versie wordt de "description" enkel in het Nederlands teruggegeven.
|
| (Dit endpoint is enkel bruikbaar voor PratoFlex met Earnie)
De implementatie "betaal", PUT {{url}}/webservice/integration/performancestate/:year/:payperiod/:statuteid/:clientId is beschikbaar.
De waarde van de url-parameters zijn terug te vinden via het contract (GET employementcontract) year via employmentcontract.annex.year payperiod via employmentcontract.annex.performanceinfo.payperiod statuteid via employmentcontract.statuteid clientid via employmentcontract.clientid
Als actie kan "Pay" worden doorgegeven icm een memodatum en opmerking.
{ "action": "Pay", "paymentinfo": { "datepayment": "2021-12-10", "infopayslip": "Test via de API" } }
|
| De implementatie "klaarzetten voor betaling", PUT {{url}}/webservice/integration/performancestate/:year/:payperiod/:statuteid/:clientId is beschikbaar met known issues die met een volgende release worden opgelost.
De waarde van de url-parameters zijn terug te vinden via het contract (GET employementcontract) year via employmentcontract.annex.year payperiod via employmentcontract.annex.performanceinfo.payperiod statuteid via employmentcontract.statuteid clientid via employmentcontract.clientid
Als actie kan "Close" worden doorgegeven.
known issues Een close voor een status "Af te sluiten (-10)" geeft een HTTP 500 en moet later een 400 worden. Niet toegelaten combinaties geven nu een HTTP 200 en zullen later een 400 teruggeven. vb. bij een "Close" voor reeds verloonde prestaties.
|
| Het endpoint om een weekcontract te PATCH'en is uitgebreid voor aanpassingen van de periode van het contract. Een contract kunnen wijzigen dat langer duurt dan 1 week, of onbepaalde duur, zal later worden voorzien.
PATCH /integration/employmentContract/:employmentContractId/annex
De periode (begin en einddatum) van bestaande week- of dagcontracten kan aangepast worden. Hierbij wordt rekening gehouden of de DimonaStatus deze aanpassing al dan niet toelaat.
|
| Het response model uit de GET, POST en PATCH van een contract (EmploymentContract) is aangevuld met extra gegevens.
Annex: ClientContactId : Id van een contactpersoon SendInfo : Informatie over het afdrukken en/of de verzending (Afdrukdatum, ondertekend?, eSign-status) PerformanceInfo : Informatie over de prestaties en premies (betaalperiode, status, correctie?)
Workregime:
WorkSchedule:
InflowInfo: Extra: MeasureForPromotionOfEmployment : Bevordering werkgelegenheid ReorganisationMeasure : Reorganisatiemaatregel PermissionLaborUnion: Datum toestemming vakbond SplitCode : Splitscode i.f.v. facturatie TrialPeriod : Aantal dagen proefperiode
Op dit moment ontbreken nog de gegevens die met een volgende versie worden aangevuld: Kostenplaats → hiervoor moeten de endpoints om een kostenplaats te beheren nog worden voorzien. Cyclus & Rooster → hiervoor moeten de endpoints om cyclussen en roosters van een klant nog worden voorzien. De afdeling, kostenplaats & ploeg van een roosterdagdeel → cfr. beheer kostenplaatsen.
|
| De implementatie "klaarzetten voor betaling", PUT {{url}}/webservice/integration/performancestate/:year/:payperiod/:statuteid/:clientId is beschikbaar met known issues die met een volgende release worden opgelost.
De waarde van de url-parameters zijn terug te vinden via het contract (GET employementcontract) year via employmentcontract.annex.year payperiod via employmentcontract.annex.performanceinfo.payperiod statuteid via employmentcontract.statuteid clientid via employmentcontract.clientid
Als actie kan "Calculate" worden doorgegeven.
Known issues Een close voor een status "Af te sluiten (-10)" geeft een HTTP 500 en moet later een 400 worden. Niet toegelaten combinaties geven nu een HTTP 200 en zullen later een 400 teruggeven. vb. "Close" voor verloonde prestaties.
|
| Er is een eerste versie klaar om de einddatum te wijzigen van een weekoverschrijdend contract en contract van onbepaalde duur.
PATCH /integration/employmentContract/{employmentContractId} { "enddate": "2021-12-31T00:00:00", "reasonendofemployment" : "98" }
Known issues: De begindatum kan nog niet gewijzigd worden. wnbetaalperiodestatus van prestaties en premies worden nog niet gecontroleerd bij het inkorten van een contract. Kantoor, klant en statuut gaan later verwijderd worden uit het request model. Het is niet de bedoeling om deze gegevens te wijzigen. De werkwijze zal dan zijn om het contract te verwijderen (of annuleren) en een nieuw aan te maken. Als een einddatum gewijzigd wordt naar een vorige maand (maandoverschrijdend in het verleden), dan zal het contract niet meer automatisch verlengd worden.
Deze known issues zullen met een volgende versie wordt opgelost.
|
| Er is een endpoint voorzien om een weekcontract te wijzigen. Een contract kunnen wijzigen dat langer duurt dan 1 week, of onbepaalde duur, zal later worden voorzien.
PATCH /integration/employmentContract/:employmentContractId/annex
Er zijn ook 2 query-parameters voorzien, nl. fromdate en untildate. Voor weekcontracten hebben deze parameters geen invloed, een weekcontract wordt altijd volledig gewijzigd. Deze query-parameters zullen bij het PATCH'en van een contract dat langer duurt dan 1 week (of onbepaalde duur) geïmplementeerd worden.
Voor het endpoint PATCH zijn de volgende attributen toegevoegd en geïmplementeerd :
Financial:
Extra: General OtherFees Other ShiftPremiums ExtraInfo
Werkregime: ClientWorkRegimeId Q S WeeklyHoursFulltime WeeklyHoursParttime WorkTimeReductionUnpaid WorkTimeReductionPaid
|
ASR
| Er wordt rekening gehouden met de code aard van de dag "2.7" bij het opmaken van de referteperiode in de aangifte.
Aard van de Dag 2.7 is Uitkering C.A.O. 12bis/13bis ingevolge ziekte of ongeval van gemeen recht.
|
| Bij een ASR aangifte van het "Inlichtingenblad mutualiteit" (ZIMA001) kan een commentaar veld ingevuld worden. De inhoud van dit veld wordt bij de aangifte meegegeven in het commentaar blok.
|
| Bij een ASR aangifte Inlichtingenblad Mutualiteit wordt een e-mailadres meegegeven in het blok coördinaten van de contactpersoon. Hierin werd steeds het e-mailadres van het kantoor geplaatst. Nu is er de mogelijkheid om hiervan af te wijken door een algemeen afwijkend e-mailadres in te stellen, hiermee kan men dan indien gewenst een centrale mailbox doorgeven bij deze aangiftes. Het ingestelde adres wordt dan in alle aangifte Inlichtingenblad Mutualiteit opgenomen. Contacteer customercare@prato.be om deze functionaliteit te activeren. |
Bugfixes
API
De reden hiervoor is dat een reden einde contract voor alle bijlagen dezelfde waarde moet hebben.
Het BV% wordt voor Earnie-omgevingen bewaard bij de fiscale gegevens van een persoon. Met HiAnt wordt het BV% bewaard op niveau van statuut.
In bepaalde gevallen werd tijdens het bewaren van een nieuwe persoon onterecht een foutmelding "Het minimum BV percentage is 11.11%" getoond. Dit is opgelost.
Als er via POST {{url}}/webservice/integration/person/:personid/taxationhistory een BV% wordt doorgegeven zal het het BV% nu ook zichtbaar zijn via de UI. De voorwaarde is dat het BV% als code bestaat voor codesoort 291. Met vorige versies werd het doorgestuurde % niet getoond. Later zal het BV% ook als vrije ingave voorzien worden.
Contract Redesign
Als een contract met een cyclus met gemiddelden werd aangemaakt, werd tijdens de berekening van het uurloon o.b.v. een maandloon geen rekening gehouden met de S van de cyclus. Daardoor kon je verschillende uurlonen uitkomen afhankelijk van het rooster, vb. als de roosters een verschillende S als gevolg hadden.
Met deze versie wordt bij de berekening van een uurloon o.b.v. maandloon rekening houden met de gemiddelde S van de cyclus.
Personen
