Ressource: employees (read-only) #
Mitarbeiter sind in EULANDA freigeschaltete Adressen: Im ERP wird eine
Adresse als Mitarbeiter markiert (Prozedur cn_AdSetMitarbeiter), dadurch
landet ihre Adresse.ID in der Filter-Tabelle Mitarbeiter - dort liegen
auch Personalnummer und Loginname. Die Ressource zeigt genau diese
freigeschalteten Adressen; alle anderen Adressen sind über /employees
nicht sichtbar.
Die Ressource ist bewusst read-only - Freischaltung und Personalpflege
bleiben im ERP. Abzugrenzen: Vertreter (Repräsentanten, die Provisionen
auf Umsätze erhalten und auch Externe sein können) sind ein eigenes
Konzept und kommen bei Bedarf als eigene Ressource.
Typischer Einsatz: der Fahrer-Abgleich von EulandaXtrack
(xtrack.Person.EulandaRef referenziert die Adress-Id).
Endpunkte #
| Methode | Pfad | Scope | Zweck |
|---|---|---|---|
| GET | /api/v1/employees | employees:read | Liste (Paging, q, changedSince, fields) |
| GET | /api/v1/employees/{id} | employees:read | Einzelner Mitarbeiter inkl. personnelNumber/loginName |
Felder (Glossar Entwurf) #
| API-Feld | DB-Spalte | Typ |
|---|---|---|
id / uid | Adresse.ID / Adresse.uid | int/guid |
match | Match | string |
name / name2 | Name1 / Name2 | string |
street / zip / city / country | Strasse / PLZ / Ort / Land | string |
phone / mobile | Tel / Auto | string |
email | EMail | string |
salutation / language | Anrede / Sprache | string |
createdAt / changedAt | CreateDate / ChangeDate | datetime |
personnelNumber / loginName | Mitarbeiter.PersonalNr / Mitarbeiter.Loginname | string (nur im Einzelabruf) |
Beispiele #
$h = @{ Authorization = "Bearer $key" }
Invoke-RestMethod 'http://localhost:8100/api/v1/employees?fields=id,match,name,email' -Headers $h
Invoke-RestMethod 'http://localhost:8100/api/v1/employees/14' -Headers $h
Invoke-RestMethod 'http://localhost:8100/api/v1/employees?changedSince=2026-07-01' -Headers $h
curl.exe -H "Authorization: Bearer %KEY%" "http://localhost:8100/api/v1/employees?fields=id,match,name,email"
curl.exe -H "Authorization: Bearer %KEY%" "http://localhost:8100/api/v1/employees/14"
curl.exe -H "Authorization: Bearer %KEY%" "http://localhost:8100/api/v1/employees?changedSince=2026-07-01"