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) oraz opcjonalnie atrybutami (np. ośrodek kosztów, MPK). Kto jest kierownikiem lub zastępcą danej jednostki określa OrganizationAssignment (pole hierarchyLevel – np. główny przełożony, zastępca). 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 (np. hr-organization-unit-id), name, symbol, shortName, partOf (Reference do nadrzędnej OrganizationUnit), organization (Reference Party – firma/podmiot; jednostki są powiązane z firmą), period (okres funkcjonowania od–do), address (adres siedziby), attribute[] (np. MPK – ośrodek kosztów). 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 (np. primary-manager, deputy).
  • Przypisanie pracowników – kto należy do jednostki i w jakim okresie opisuje OrganizationAssignment (employee + organizationalUnit + period, opcjonalnie hierarchyLevel).
  • Stanowiska – Position może być powiązane z jednostką przez attribute lub profil (Position w danej OrganizationUnit).

2. Zawartość (struktura)

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

Nazwa Kard. Typ Opis
identifier 0..* Identifier Identyfikatory jednostki (np. system hr-organization-unit-id)
name 0..1 string Nazwa jednostki organizacyjnej (np. „Dział sprzedaży”, „Oddział Warszawa”)
symbol 0..1 string Symbol komórki (np. „ODD-A”)
shortName 0..1 string Nazwa skrócona
partOf 0..1 Reference(OrganizationUnit) Jednostka nadrzędna w hierarchii organizacyjnej
organization 1..1 Reference(Party) Podmiot/firma (NFRM) – jednostka jest powiązana z firmą-pracodawcą
address 0..* Address Adres siedziby jednostki
period 0..1 Period Okres funkcjonowania jednostki (od–do); brak end = nadal aktywna w tym zakresie
attribute 0..* Attribute Cechy jednostki (np. MPK – ośrodek kosztów); code + value* – struktura w Attribute

Uwaga: type lub category (z DomainResource) – rodzaj jednostki (dział, oddział, pion – system np. https://api-erp.kamsoft.pl/ns/organization-unit-type). attribute – np. code=MPK (ośrodek kosztów), valueString lub valueQuantity; system atrybutów np. https://api-erp.kamsoft.pl/ns/organization-unit-attribute-type.

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, period i attribute[] (MPK) pokrywa jednostkę organizacyjną z SAP, Oracle, Workday. Kierownik jednostki = OrganizationAssignment z hierarchyLevel (np. primary-manager).

4. Odniesienia