Przejdź do treści

OrganizationUnit

OrganizationUnit (jednostka organizacyjna) to zasób reprezentujący jednostkę organizacyjną wewnątrz przedsiębiorstwa – komórkę, dział, oddział – z hierarchią (partOf), okresem funkcjonowania (period), adresem i powiązaniem z podmiotem (organization). Kto jest kierownikiem lub zastępcą danej jednostki określa OrganizationAssignment (pole hierarchyLevel). Wzorowany na SAP (Organizational Management – Organizational Unit), Oracle HCM (PER_ORGANIZATION_UNITS, HR_ORGANIZATION_UNITS), Workday (Organization), D365 (OMDepartment, OMFunctionalArea).

Rozszerza DomainResource.

1. Zakres i zastosowanie

OrganizationUnit = jedna jednostka w strukturze organizacyjnej: identifier, name, symbol, shortName, partOf (Reference do nadrzędnej OrganizationUnit), organization (Reference Party – firma/podmiot; jednostki są zawsze powiązane z firmą), period (okres funkcjonowania od–do), address (adres siedziby). status (z DomainResource) – active / inactive.

  • Struktura organizacyjna – drzewo jednostek przez partOf (OrganizationUnit → OrganizationUnit).
  • Kierownik / zastępca – kto kieruje jednostką (lub jest zastępcą) opisuje OrganizationAssignment: employee (PartyRole) + organizationalUnit (ta jednostka) + hierarchyLevel.
  • Przypisanie pracowników – kto należy do jednostki i w jakim okresie opisuje OrganizationAssignment (employee + organizationalUnit + period, opcjonalnie hierarchyLevel).
  • Stanowiska – Position nie jest w modelu powiązane z jednostką; przynależność pracownika do jednostki wynika z OrganizationAssignment.

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 jednostki w przestrzeni OrganizationUnit.Id (klucz referencyjny); system z NamingSystem
symbol 0..1 string Symbol komórki (np. „ODD-A”)
shortName 0..1 string Nazwa skrócona
organization 1..1 Reference(Party) Podmiot/firma – jednostka jest powiązana z firmą-pracodawcą
address 0..* Address Adres siedziby jednostki (type = permanent, składniki ze słownika address-component-type)
period 0..1 Period Okres funkcjonowania jednostki (od–do); brak end = nadal aktywna w tym zakresie
name 0..1 string Nazwa pełna jednostki organizacyjnej (np. „Dział sprzedaży”, „Oddział Warszawa”)
partOf 0..1 Reference(OrganizationUnit) Jednostka nadrzędna w hierarchii organizacyjnej

Uwaga: status (z DomainResource) – słownik hr/organization-unit-status (active, inactive). type – rodzaj jednostki, słownik hr/organization-unit-type (unit). attribute (z DomainResource) – cechy dodatkowe jednostki; kody nadaje wdrożenie.

2a. Identyfikatory i operacje

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

Zasób jest tylko do odczytu.

GET /v1/organization-units?identifier=<system>|<wartość>&count=20&offset=0
Parametr Wymagany Opis
identifier nie Jedna para system\|wartość (bez list po przecinku)
count, offset nie Paginacja (domyślnie 20 / 0)

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

3. Zgodność z systemami ERP

System Odpowiednik Uwagi
SAP HCM / S/4HANA Organizational Unit (O), struktura OM Jednostka organizacyjna z nadrzędną (parent); kierownik przez Assignment / OrganizationAssignment
SAP SuccessFactors Organization (EC) Hierarchy; manager przez Assignment
Oracle HCM Cloud PER_ORGANIZATION_UNITS, HR_ORGANIZATION_UNITS Organization z parent, dates, cost center
Workday Organization (Cost Center, Department, etc.) Supervisory Organization, hierarchy
D365 HR OMFunctionalArea, OMDepartment Jednostki organizacyjne z hierarchią

Model kanoniczny: OrganizationUnit z identifier, name, partOf, organization i period pokrywa jednostkę organizacyjną z SAP, Oracle, Workday. Kierownik jednostki = OrganizationAssignment z hierarchyLevel.

4. Odniesienia