Przejdź do treści

OrganizationAssignment

OrganizationAssignment (przypisanie do jednostki organizacyjnej) to zasób reprezentujący przypisanie pracownika do jednostki organizacyjnej: kto (employee), do której komórki (organizationalUnit), w jakim okresie (period) oraz opcjonalnie w jakim stopniu hierarchii (hierarchyLevel, hierarchyIndex, hierarchyLabel), z powiązaniem do zatrudnienia (employment) i zatrudnienia głównego (primaryEmployment). Jednostka organizacyjna (komórka, dział, pion itd.) jest zawsze reprezentowana przez OrganizationUnit. Wzorowany na SAP (Assignment do Organizational Unit, PA w kontekście O), Oracle HCM (Assignment do Organization), Workday (Worker Assignment to Organization, Supervisory Organization).

Rozszerza DomainResource.

1. Zakres i zastosowanie

OrganizationAssignment = jedno przypisanie pracownika do jednostki: employee (Reference PartyRole – rola pracownika), organizationalUnit (Reference OrganizationUnit), period (okres pracy w tej komórce). Opcjonalnie hierarchyLevel (CodeableConcept – stopień w hierarchii kierowniczej), employment (Reference Employment) oraz primaryEmployment (Reference Employment).

  • Rejestr przypisań – lista OrganizationAssignment po stronie pracownika lub jednostki (employee, organizationalUnit, period); powiązanie z Employment opcjonalne.
  • Struktura a zatrudnienie – Employment opisuje stosunek pracy (employer, employee, position); OrganizationAssignment opisuje przynależność do jednostki organizacyjnej (komórka, dział, pion – wszystkie jako OrganizationUnit) w czasie.

2. Zawartość (struktura)

Oprócz elementów DomainResource (id, resourceType, meta, owner, comment, category, status, type, contained, attribute):

Nazwa Kard. Typ Opis
identifier 0..* Identifier Identyfikatory przypisania w przestrzeni OrganizationAssignment.Id (klucz referencyjny); system z NamingSystem
employee 0..1 Reference(PartyRole) Pracownik – referencja do PartyRole (role=employee); dane osoby w PartyRole.party → Party
organizationalUnit 0..1 Reference(OrganizationUnit) Jednostka organizacyjna (komórka, dział), do której przypisany jest pracownik
period 0..1 Period Okres przypisania (początek/koniec pracy w tej komórce); brak end = nadal przypisany
hierarchyLevel 0..1 CodeableConcept Stopień hierarchii kierowniczej; system https://api-erp.kamsoft.pl/vs/hr/organization-assignment-hierarchy-level, kody nadaje wdrożenie (słownik dostępny przez zasób ValueSet)
hierarchyIndex 0..1 integer Liczbowy stopień przełożonego (do sortowania i budowy ścieżki hierarchii)
hierarchyLabel 0..1 string Etykieta stopnia (np. „1”, „1.2”)
employment 0..1 Reference(Employment) Powiązane zatrudnienie (opcjonalnie)
primaryEmployment 0..1 Reference(Employment) Powiązane zatrudnienie główne pracownika

Uwaga: status (z DomainResource) – kody nadaje wdrożenie. Pion, dział, komórka itd. to rodzaje jednostki organizacyjnej – modelowane wyłącznie przez OrganizationUnit (type/category).

2a. Identyfikatory i operacje

Przestrzeń identyfikatora przypisania to urn:oid:1.2.616.1.113769.4.<instalacja>.<klucz> – parametr wdrożenia (zob. Identyfikacja i parametry wdrożenia); klucz przestrzeni: OrganizationAssignment.Id.

Zasób jest tylko do odczytu.

GET /v1/organization-assignments?identifier=<system>|<wartość>&employeeId=<int>&organizationUnitId=<int>&count=20&offset=0
Parametr Wymagany Opis
identifier nie Jedna para system\|wartość (bez list po przecinku)
employeeId nie Liczbowy identyfikator pracownika w systemie źródłowym
organizationUnitId nie Liczbowy identyfikator jednostki organizacyjnej w systemie źródłowym
count, offset nie Paginacja (domyślnie 20 / 0)

Odpowiedź: { "items": [...], "nextToken": null }.

3. Zgodność z systemami ERP

System Odpowiednik Uwagi
SAP HCM / S/4HANA Assignment do Object (Org Unit), PA0001 w kontekście O Przypisanie osoby do jednostki organizacyjnej z datami
SAP SuccessFactors JobAssignment, Organization Assignment Worker → Organization z effective dates
Oracle HCM Cloud Assignment do Organization (PER_ALL_ASSIGNMENTS_M), org unit Person + organization + dates
Workday Worker Assignment to Organization, Supervisory Organization Assignment z period, reporting hierarchy

Model kanoniczny: employee + organizationalUnit + period + opcjonalnie hierarchyLevel, employment, primaryEmployment pokrywa przypisanie do jednostki organizacyjnej w SAP, Oracle, Workday.

4. Odniesienia