Sommige klanten hebben de wens om een personeelssysteem te koppelen aan Ecmanage zodat nieuwe medewerkers automatisch aangemaakt worden en kleding kunnen bestellen.
Er is de mogelijkheid om een token aan te vragen bij de supportafdeling van Ecmanage voor het activeren van een klantspecifieke API.
Via deze API kunnen nieuwe gebruikers worden aangemaakt, mutaties worden doorgestuurd en gebruikers worden verwijderd. Dit werkt door een xml-bericht te sturen naar een HTTPS-adres. Het veld personid_extern wordt gebruikt om een gebruiker te identificeren, als deze gevonden wordt dan wordt de gebruiker gemuteerd en anders wordt er een nieuwe gebruiker aangemaakt.
De API is beveiligd met een token, deze wordt als header meegestuurd in de HTTPS communicatie.
Het XML-bericht bevat een of meerdere person records, zie als voorbeeld de volgende:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<persons>
<person personid_extern="HRM001"
functionid_extern="F01"
employmenttypeid_extern="VT"
companyid_extern="KANTOOR"
datestart="2011-02-08"
genderid="M"
firstname="Voornaam"
lastname="Achternaam"
middlename=""
username="vachternaam@bedrijf.nl"
title=""
active="Y"
authorised="Y"
remarks=""
email="vachternaam@bedrijf.nl"
isolanguage="nl-NL"
startset_ordered="N"
reorder_startset_date="2012-01-01"
signed_agreement="Y"
measurements=""
budget="10"
role="drager"
use_custom_products="Y"
reference_1=""
reference_2=""
reference_3=""
reference_4=""
reference_5="" />
</persons>
Het aanmaken van gebruiker accounts is een intensief proces. Grote aantallen gebruikers kunnen in de nacht of in het weekend worden aangeboden. Voor kleine aantallen kunnen wijzigingen ook overdag worden aangeboden. Denk bij kleine aantallen tientallen en grote aantallen meer dan tientallen.
Veel van deze velden zijn optioneel, de volgende velden zijn minimaal relevant:
personid_extern
Dit is een unieke identificatie van een gebruiker. Dit kan een personeelsnummer zijn.
firstname en lastname
Naam van de gebruiker.
username
Unieke gebruikersnaam, vaak wordt hier het emailadres gebruikt.
En de volgende velden zijn van belang zodat we in het systeem de persoon aan het juiste kledingpakket kunnen koppelen. De kledingpakketten zijn afhankelijk van functie, dienstverband en geslacht.
functionid_extern
employmenttypeid_extern
genderid
En voor de beveiliging is een rol en een afdeling nodig. Als er geen afdelingen aanwezig zijn kan deze overgeslagen worden, alle gebruikers zitten dan op het zelfde niveau.
companyid_extern
role
Veel van de bovenstaande gegevens kunt u samen met uw kledinglaverancier verder bepalen en invullen. De kledingleverancier weet hoe hij de kledingpakketten dan kan inrichten.