INNOMATE HR – Online register for dataudtræk & interoperabilitet (Data Act)

Denne side er statisk. Alle detaljer (datasæt, felter, endpoints m.m.) hentes fra den maskinlæsbare registerfil og OData/OpenAPI-metadata. Brug derfor linksene herunder som den autoritative kilde.

• Introduktion til API: API
• Maskinlæsbar registerfil: register.json
• OData service root: https://www.innomate.com/INNOMATE/{customerId}/odata/v1/
• OData metadata (EDMX): https://www.innomate.com/INNOMATE/{customerId}/odata/v1/$metadata
• OpenAPI (Swagger): https://www.innomate.com/INNOMATE/swagger/docs/v1
• Kontakt (support/compliance): data@innomate.com

---

Formål og omfang

Denne side opfylder Data Acts krav om et opdateret online register, der henviser til:

• Datastrukturer og dataformater for de eksportérbare data (via registerfilen og OData $metadata).
• Anvendte standarder og åbne interoperabilitetsspecifikationer.
• Adgangsbetingelser (autentifikation, rater, brugsvilkår).
• Portabilitet/switching i forbindelse med udbyderskifte.

Bemærk: Denne side viser principper og links, ikke en komplet kopi af felter/endpoints. Når registeret ændres, opdateres kun registerfilen.

---

Standarder & formater

• OData v4 (OASIS) – primær API-standard.
• OpenAPI (Swagger) – maskinlæsbar REST-beskrivelse af endpoints.
• Dataformater: JSON (OData v4).
• Tidsstempler: UTC. Se den aktuelle genereringsdato i generatedAt i registerfilen.

---

Adgang, autentifikation og fair use

• Autentifikation: Bearer token i HTTP-headeren (Authorization: Bearer {token}).
• Adgangsomfang: Kunder har API-adgang til egen tenant.
• Rate limits: Standardgrænser pr. API-nøgle.
• Sikkerhed: TLS på alle endpoints.

Eksempel (curl):

curl -H "Authorization: Bearer {token}" "https://www.innomate.com/INNOMATE/{customerId}/odata/v1/Person?$select=FirstName,LastName&$top=10"

---

OData brugsmønstre (læseadgang)

• Filtrering/udvælgelse: brug $select, $filter, $orderby, $top, $skip, $expand.
• Paging: kombiner $top/$skip.
• Delta/ændringsfeed: OData Change Tracking kan anvendes (start med en fuld læsning, fortsæt med @odata.deltaLink).
• Streams/vedhæftede filer: Edm.Stream egenskaber eksponeres som referencer (URLer) til binære data. Kan gøre brug af et tidsbegrænset Azure Storage SAS token.

Eksempel (filtrering & udvidelse):

curl -H "Authorization: Bearer {token}" "https://www.innomate.com/INNOMATE/{customerId}/odata/v1/Person?$expand=AccountabilitiesAsParent&$filter=(Status eq null or Status ne Innomate.HR.PersonStatus'Resigned')"

---

Portabilitet & switching (Data Act – kort fortalt)

• Formål: Gøre udbyderskifte effektivt, rettidigt og sikkert uden urimelige barrierer.
• Eksport: Alle eksportérbare data stilles til rådighed i strukturerede, almindeligt anvendte, maskinlæsbare formater (OData/JSON).
• Proces (anbefalet):
  1. Initial fuld eksport via OData (paged).
  2. Løbende delta-sync (ved større migreringer) for at holde data opdateret hos modtager.
  3. Cut-over med kort skrive-freeze på udvalgte objekter, hvorefter sidste delta afvikles.
  4. Retrieval-vindue efter cut-over til at hente eventuelle restdata (fx vedhæftede filer).
  5. Sletning efter bekræftet succesfuldt skifte og udløb af retrieval-vinduet.

---

Datasæt & felter

Den komplette og til enhver tid gældende liste over datasæt, felter/typer, endpoints og eventuelle begrænsninger findes i den maskinlæsbare registerfil og i OData $metadata:

• Registerfil (JSON): register.json
• OData $metadata: https://www.innomate.com/INNOMATE/{customerId}/odata/v1/$metadata

Tip: Søg efter nøgleord (fx “Person”, “Employment”, “AttachedFile”) i registerfilen for hurtigt at finde relevante felter og endpoints.

---

Begrænsninger & brugsvilkår

• Retentions- og slettepolitikker: Se vores GDPR/privatlivsside for nærmere detaljer om opbevaringsperioder og sletning.
• Versionering: API’er kan udvikles over tid; vi varsler deprecations i god tid og vedligeholder kompatibilitet efter bedste praksis. Se changelog på denne side for generelle noter; felt-/endpoint-detaljer ændres i registerfilen.

---

Support

• Teknisk support & adgang: data@innomate.com

---

Changelog

Denne changelog opdateres kun ved større proces-/principændringer. Felter, endpoints og datasæt ajourføres udelukkende i registerfilen.

• v1.0 – Første version af denne registerside. Links til register.json, OData $metadata og Swagger er etableret; switching-proces beskrevet på overordnet niveau.