Przejdź do treści

Qualification (kwalifikacja zawodowa)

Qualification (kwalifikacja zawodowa) to zasób reprezentujący prawo, uprawnienie lub kwalifikację zawodową przypisaną do pracownika – np. prawo wykonywania zawodu (PWZ) albo specjalizacja. Holder (posiadacz) to PartyRole w roli pracownika. Zasób ma numer, typ (CodeableConcept), datę nadania i okres ważności. Wzorowany na FHIR Practitioner.qualification oraz rejestrach zawodowych.

Rozszerza DomainResource.

1. Zakres i zastosowanie

Qualification = jedno prawo/uprawnienie/kwalifikacja: holder (Reference PartyRole – pracownik), type (prawo wykonywania zawodu albo specjalizacja), number, issuedDate, validityPeriod (Period). Umożliwia rejestr kwalifikacji bez obciążania Party ani Employment; zasób jest tylko do odczytu.

  • Rejestr kwalifikacji – lista Qualification po typie, opcjonalnie po pracowniku (holder) lub identyfikatorze.
  • Walidacja ważności – validityPeriod.end.

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 kwalifikacji: id i numer prawa wykonywania zawodu albo id specjalizacji — osobne przestrzenie wdrożeniowe; system z NamingSystem
holder 0..1 Reference(PartyRole) Posiadacz – PartyRole (role=employee)
number 0..1 string Numer dokumentu / licencji (np. nr PWZ)
issuedDate 0..1 string Data wydania (tekst daty)
validityPeriod 0..1 Period Okres ważności (start, end); brak end = bez daty wygaśnięcia

Uwaga: type (z DomainResource) – słownik hr/qualification-type: professional-license (prawo wykonywania zawodu), specialty (specjalizacja). status – kody nadaje wdrożenie. attribute – kody ze słownika hr/qualification-attribute-type (specialty-level, is-primary, professional-license-type).

2a. Identyfikatory i operacje

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

Zasób jest tylko do odczytu.

GET /v1/qualifications?type=https://api-erp.kamsoft.pl/vs/hr/qualification-type|professional-license&holder=PartyRole|<wartość>&count=20&offset=0
Parametr Wymagany Opis
type tak Jedna para system\|kod ze słownika hr/qualification-type (professional-license albo specialty); kod nierozpoznany daje pustą listę
identifier nie Jedna para system\|wartość (bez list po przecinku)
holder nie Referencja posiadacza w formacie PartyRole\|<wartość>
number nie Numer kwalifikacji (dla specialty – liczbowy identyfikator specjalizacji)
count, offset nie Paginacja (domyślnie 20 / 0)

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

3. Zgodność z systemami ERP i FHIR

System / kontekst Odpowiednik Uwagi
FHIR Practitioner qualification Zgodność z FHIR (typ, numer, okres)
Rejestry zawodowe (NIL, ministerstwo) Prawo wykonywania zawodu, PWZ, specjalizacje number, type, validityPeriod
SAP / Oracle HCM Competency, Qualification, License Osobna encja na uprawnienia/prawa
Workday Credential, License Podobna semantyka holder + type + period

4. Odniesienia