Flexkracht webservice

Benodigde gegevens

Voor een flexkracht moeten de volgende gegevens aanwezig zijn in de XML:

• Een programma-breed uniek identificatie nummer;
• Een voornaam;
• Een achternaam;
• Een e-mailadres.

De volgende aanvullende informatie kan aangeleverd worden:

• Een (mobiel) telefoonnummer;
• Een land;
• Een postcode;
• Een gemeente;
• Een straatnaam;
• Een huisnummer;
• Een BSN-nummer;
• Een nationaliteit;
• Een geboorteplaats;
• Een geboortedatum;
• Een burgerlijke staat;
• Een geslacht;
• Een rekeningnummer;
• Een rekeninghouder;
• de taal.

Ook hier geldt dat als de informatie niet beschikbaar is, het verstandiger is om in de XML de hele tag weg te laten in plaats van deze leeg laten.

Burgerlijke staat

De burgerlijke staat kan in de XML worden gegeven met één van de volgende waarden:

• "Domestic Partner"
• "Divorced"
• "Married"
• "Unreported"
• "Separated"
• "Unmarried"
• "Widowed"
• "Legally Separated"

Geboortedatum

De geboortedatum moet in de XML het formaat YYYY-MM-DD hebben.

Geslacht

Het geslacht moet met één van de volgende codes aangegeven worden:

• '0' = Onbekend
• '1' = Man
• '2' = Vrouw

Taal

Als de taal van de flexkracht in de XML aanwezig is, dan wordt deze taal in e-UUR bij het aanmaken van een nieuwe flexkracht direct ingesteld, zodat de welkomst e-mail ook direct in die taal verstuurd wordt. Als de taal niet beschikbaar is in de e-UUR omgeving, dan wordt de meegestuurde taal niet ingesteld.

Bij een update van een flexkracht wordt deze taal niet verwerkt, aangezien de flexkracht de taal ondertussen in e-UUR al naar een andere taal ingesteld kan hebben.

De taalomschrijving of het acroniem kan gebruikt worden in het bericht.

Hieronder vind je twee voorbeelden.

<HumanResource>

   ...flexkracht gegevens..

   <UserArea>
         <Language>en_US</Language>
   </UserArea> 
</HumanResource>

<HumanResource>

   ...flexkracht gegevens..

   <UserArea>
         <AdditionalFields>
               <Language>Engels</Language>
          </AdditionalFields>
   </UserArea> 
</HumanResource>

Status ophalen flexkracht

Als een flexkracht wordt opgehaald uit e-UUR, wordt hetzelfde XML-bericht met dezelfde gegevens aangeleverd. Er wordt een status toegevoegd die aangeeft of de flexkracht nieuw is aangemaakt of gewijzigd is. Deze status kan de volgende waarden hebben:

• ‘accepted’: de flexkracht bestond al en is gewijzigd;
• ‘new’: de flexkracht is nieuw aangemaakt in e-UUR.

Actieve flexkrachten

De webservice GetHumanResources haalt alle flexkrachten van een inlener op die een lopende plaatsing hebben bij deze inlener. De aanroep van deze webservice dient daarom ook te gebeuren met inloggegevens van een inlener. Hierboven kun je meer lezen over de specifieke gegevens van een flexkracht.

Het resulterende XML bericht is een verzameling van flexkrachtberichten zoals hieronder is omschreven. De verzameling wordt weergegeven door een overkoepelende <HumanResources>…</HumanResources> tag –die het gehele bericht omvat. Elke flexkracht is een eigen <HumanResource>…</HumanResource> tag binnen deze verzameling, waarbij de inhoud hiervan wordt opgebouwd zoals hieronder weergegeven.

Minimale flexkracht XML

Hieronder vind je een code, een voorbeeld-XML, met minimale gegevens, waarmee de flexkracht richting de e-UUR-webservice wordt gestuurd.

Aanvullende flexkracht XML

Hieronder vind je een code, een voorbeeld-XML, met aanvullende gegevens, waarmee de flexkracht richting de e-UUR-webservice wordt gestuurd.