Concept: webservices 'Change Benefits'

Workday biedt twee webservices die massale wijzigingen laden voor keuzen voor aanvullende voorzieningen:

Change Benefits
Bulk Import Change Benefits

De webservice

'Change Benefits'

is de oudste van de twee webservices en voert bulkuploads uit. Hiermee kunt u het bedrijfsproces

'Voorzieningen wijzigen voor levensgebeurtenis'

initiëren en voltooien om voorzieningentransacties voor werknemers te genereren. De webservice negeert eventuele aanvullende stappen die u hebt geconfigureerd in het bedrijfsproces

'Voorzieningen wijzigen voor levensgebeurtenissen'

.

Deze webservice is bedoeld voor massale uploads vanaf een extern systeem. We raden u af deze webservice te gebruiken voor stapsgewijze updates van voorzieningen vanuit een systeem voor het beheer van voorzieningen van derden. De webservice werkt door alle keuzen van medewerkers voor aanvullende voorzieningen die overeenkomen met een specifiek type voorzieningsgebeurtenis af te wijzen. Deze worden vervolgens vervangen door de keuzen voor aanvullende voorzieningen die u opgeeft in de webserviceaanroep. Het doel van de webservice is om alleen voorzieningen te laden voor een eerste conversie of acquisitie. Gebeurtenissen worden niet gecoördineerd en als u voorzieningen in de verkeerde volgorde laadt, kunnen in Workday onjuiste keuzen worden geregistreerd voor werknemers.

De webservice

'Bulk Import Change Benefits'

biedt dezelfde functie als

'Change Benefits'

. Het is echter efficiënter en sneller als zeer grote hoeveelheden gegevens worden geladen. Met de webservice wordt ook een aanvraag-ID verstrekt, zodat u de aanvraag kunt volgen via de procesbewaking.

Hoewel deze webservice een aanzienlijke prestatieverbetering biedt, kunt u geen verwerkingsvolgorde opgeven voor meerdere gebeurtenissen voor dezelfde medewerker. Als u meerdere gebeurtenissen voor een medewerker in een bepaalde volgorde moet verzenden, kunt u het volgende doen:

Verzend één sjabloon voor elke gebeurtenis.
Gebruik de webservice
'Change Benefits'
.

Deze webservices uploaden grote aantallen keuzen voor aanvullende voorzieningen Een van de vereiste velden in de webservice is

'Type voorzieningsgebeurtenis'

. Deze waarde laat de webservices weten welke regelingen kunnen worden bijgewerkt.

Op basis van de aanvraag vervangen de webservices de voorzieningen voor het opgegeven gebeurtenistype door de voorzieningen in de webserviceaanroep. In wezen overschrijven ze alle regelingen voor het type voorzieningsgebeurtenis met de nieuwe regelingen in de aanvraag.

We raden aan dat u voor elk verzoek een afzonderlijk type voorzieningsgebeurtenis gebruikt om te voorkomen dat keuzen worden beïnvloed die geen deel uitmaken van een update. Neem in elke aanvraag alleen de voorzieningen op die u moet bijwerken. Voorbeeld: vermijd het gebruik van een algemeen type voorzieningsgebeurtenis, zoals 'Correctie door beheerder'. De webservice verwijdert alle voorzieningen die aan dat gebeurtenistype zijn gekoppeld voordat de regelingen aan de aanvraag worden toegevoegd.

U kunt afzien van een keuze voor aanvullende voorzieningen door vervangende keuzen uit te sluiten voor de typen voorzieningsdekking in de gebeurtenis.

De webservices

'Change Benefits'

en

'Bulk Import Change Benefits'

ondersteunen de volgende typen voorzieningen:

Ziektekostenverzekering
Medische spaarrekening
Uitgaverekening
Verzekering
Pensioenspaarregeling
Aanvullende voorzieningen

De webservices negeren de waarden voor de velden

'Begindatum dekking'

en

'Begindatum inhouding'

. Deze datums worden in Workday berekend op basis van de inschrijvingsgebeurtenisregels. De webservice vereist wel dat u het veld

'Begindatum dekking'

invult.

'Begindatum inhouding'

is optioneel.

U kunt een waarde opnemen voor de velden

'Oorspronkelijke begindatum dekking'

en

'Oorspronkelijke begindatum inhouding'

als u een van de volgende gegevens wilt vastleggen:

De oorspronkelijke datum waarop de medewerker is ingeschreven voor de voorzieningsregeling.
De datum van de eerste inhouding van de medewerker voor de regeling.

De datums die in deze velden zijn geladen, worden weergegeven in de rapportvelden

'Begindatum dekking'

en

'Begindatum inhouding'

in de gebruikersinterface. Doorgaans laadt u deze waarden alleen wanneer u gegevens van een verouderd systeem converteert om de geschiedenis vast te leggen. Bij het laden van een wijziging voor een bestaande regeling willen beheerders doorgaans een nieuwe begindatum van de dekking voor de wijziging vastleggen.

Voordat u de aanvraag maakt, moet u ervoor zorgen dat u over alle referentie-ID's beschikt voor de voorzieningen die u wilt wijzigen. Voorbeelden:

ID van het type voorzieningsgebeurtenis
Frequentie-ID
ID van dekkingsregeling voor ziektekostenverzekering
ID van dekkingsdoel voor ziektekostenverzekering

Voorbeeld: als u de dekking uitbreidt van

'werknemer'

naar

'werknemer + kind'

, moet u het gezinslid in Workday toevoegen met de gezinslid-ID, anders mislukt uw aanvraag.