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. De token wordt dan als header meegestuurd.
Het XML-bericht bevat een person record, 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>
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.