E-UUR heeft een webservice beschikbaar zodat externe pakketten door middel van SOAP XML berichten kunnen communiceren met e-UUR. Voor het versturen van uren kan gebruik worden gemaakt van de functie UpTimecardImport. In het artikel De webservice kun je meer algemene informatie vinden over de webservice van e-UUR.
SOAP parameters
De URL van de webservice is gekoppeld aan de URL van de e-UUR-omgeving waar de informatie naar gezonden moet worden. Indien de e-UUR-omgeving te vinden is op http://xyz.flexportal.eu/, dan is de webservice-URL als volgt: http://xyz.flexportal.eu/service.php. Hier vind je meer informatie over de functie upTimecardImport.
Voor het versturen van uren naar e-UUR zijn de volgender vier (SOAP) parameters vereist (allen string):
- username
- password
- message
- callFrom
Voor de username en password kunnen de gegevens van een inlenergebruiker worden gebruikt. In het artikel Hoe kan een inlenergebruiker een nieuwe gebruiker aanmaken voor de inlener? kun je lezen hoe je een specifiek account kunt aanmaken voor het pakket dat je gaat koppelen met e-UUR. De gebruikersnaam van de inlenergebruiker (vaak koppeling pakket x genoemd) kun je opgeven bij de username en het aangemaakte wachtwoord kun je gebruiken als password.
Bij message kun je het XML bericht ingeven. Deze gegevens worden door e-UUR omgezet in een importbestand. Hieronder vind je een voorbeeld van een XML voor het aanbieden van uren aan e-UUR.
Tot slot moet je bij callFrom een identificerende string invullen van het versturende pakket. Deze string is gelijk voor het versturen van uren voor alle inleners met wie je koppelt.
Voorbeeld XML
Hieronder vind je een voorbeeld XML voor het aanbieden van uren aan e-UUR.
Aanvullend kan ook het te gebruiken importprofiel worden meegestuurd via de XML. De waarde die moet worden opgestuurd is een e-UUR ID van een bestaand importprofiel die ook is gekoppeld aan de betreffende inlener. Dit kan worden toegevoegd onder AdditionalData -> StaffingAdditionalData -> ReferenceInformation -> ImportProfileId.
Meer informatie over de benodigde gegevens vind je in het artikel Urenbriefje webservice.
Statuscodes webservice
Worden uren goed overgestuurd vanuit een extern pakket naar e-UUR, kan krijg je statuscode 100 terug. Dit betekent dat de uren goed zijn overgekomen.
Een veel voorkomende melding is statuscode 900. Dit betekent dat de autorisatiegegevens niet goed zijn ingesteld. Controleer dan de username en het password in e-UUR en het XML bericht.
Een overzicht van alle status- en foutcodes vind je in het artikel Webservice status codes.
Gebruik van de koppeling
Wanneer de koppeling is gelegd, kunnen vanuit het externe pakket de uren naar e-UUR worden verzonden. De uren komen binnen in de importwachtrij. Deze is te vinden via Start > Urenbriefjes > Importwachtrij. In de importwachtrij is de status van de te importeren uren te zien.
De uren die vanuit het externe pakket e-UUR binnen komen, worden aangeboden als xml. E-UUR zet deze xml om in een importbestand. Voor dit importbestand moet een importprofiel gemaakt worden.
De inlenergebruiker heeft hierna op zijn dashboard de tegel Importwachtrij van waaruit hij uren uit de importwachtrij kan importeren. Net als bij de importmodule is het mogelijk om de import als leverancier uit te voeren.
De uren uit het externe pakket worden automatisch omgezet naar een Excelbestand. Dit Excelbestand vind je onder deze tegel.
Urenbriefjes importeren
Vervolgens kan het Excelbestand worden geïmporteerd via de importmodule in e-UUR. Hiervoor kan eenmalig een importprofiel voor de koppeling worden aangemaakt. Elke keer dat er vervolgens uren vanuit de het externe pakket naar e-UUR worden verstuurd, kunnen deze uren via het importprofiel worden geïmporteerd in e-UUR.
Meer weten over onze importmodule en het importeren van uren vanuit een bestand? Lees dan het artikel Uren importeren vanuit bestand.
Technische ondersteuning
Kom je er met de informatie in de kennisbank niet uit? Technische ondersteuning is mogelijk. Neem dan contact op met Akyla.