Koppeltaal 2.0 Implementation Guide (Full Documentation) - Local Development build (v0.15.1) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Rol Code Mapping

Changelog

Rol Code Mapping voor Autorisaties

Deze pagina beschrijft de mapping tussen de functionele rollen zoals gedefinieerd in de autorisatieregels en de bijbehorende SNOMED CT codes. Deze codes worden gebruikt in CareTeam.participant.role om de autorisatierol van een deelnemer te identificeren.

De SNOMED CT codes zijn gereviewd door Nictiz (Mirte).

Code System

CodeSystem: http://snomed.info/sct

Practitioner Rollen

De onderstaande SNOMED CT codes zijn beschikbaar voor Practitioners binnen een CareTeam. De permissies per rol zijn beschreven in Practitioner autorisaties.

ValueSet

ValueSet: http://vzvz.nl/fhir/ValueSet/koppeltaal-practitioner-role

Deze ValueSet bevat:

• De SNOMED CT autorisatierollen voor Practitioners
• Alle codes uit de ZorgverlenerRolCodelijst (backwards compatibility)

Voorbeeld: Practitioner als Behandelaar

{
  "resourceType": "CareTeam",
  "participant": [
    {
      "role": [
        {
          "coding": [
            {
              "system": "http://snomed.info/sct",
              "code": "405623001",
              "display": "Assigned practitioner (occupation)"
            }
          ]
        }
      ],
      "member": {
        "reference": "Practitioner/123"
      }
    }
  ]
}

RelatedPerson Relaties

De onderstaande SNOMED CT codes zijn beschikbaar voor RelatedPersons binnen een CareTeam. De permissies per relatie zijn beschreven in RelatedPerson autorisaties.

ValueSet

ValueSet: http://vzvz.nl/fhir/ValueSet/koppeltaal-relatedperson-role

Specifieke familierelaties

Voor meer specifieke familierelaties kunnen de volgende SNOMED CT codes worden gebruikt:

Onderscheid RelatedPerson.relationship en CareTeam rol

De RelatedPerson.relationship en de CareTeam.participant.role leggen twee verschillende dimensies vast:

• RelatedPerson.relationship beschrijft wie iemand is ten opzichte van de patiënt: de sociale of biologische band (ouder, partner, vriend). Dit gebruikt de standaard FHIR ValueSet relatedperson-relationshiptype.
• CareTeam.participant.role beschrijft welke rol iemand vervult in de zorgcontext, en daarmee welke autorisaties gelden (mantelzorger, wettelijk vertegenwoordiger, naaste, buddy).

Deze dimensies zijn niet uitwisselbaar: een ouder (relationship) kan mantelzorger of wettelijk vertegenwoordiger zijn (rol). Een vriend (relationship) kan naaste of buddy zijn (rol). De sociale relatie bepaalt niet automatisch de autorisatierol.

De CareTeam rol is leidend voor autorisatie. De RelatedPerson.relationship is informatief en kan gebruikt worden om context te bieden (wie is deze persoon voor de patiënt), maar de rechten worden altijd afgeleid van de CareTeam.participant.role.

Voorbeeld: RelatedPerson als Mantelzorger

{
  "resourceType": "CareTeam",
  "participant": [
    {
      "role": [
    {
      "coding": [
        {
          "system": "http://snomed.info/sct",
              "code": "407542009",
              "display": "Informal carer (person)"
        }
      ]
    }
      ],
      "member": {
        "reference": "RelatedPerson/456"
      }
    }
  ]
}

Autorisatielogica

De autorisatielogica werkt als volgt:

┌─────────────────────────────────────────────────────────────────────────┐
│  1. Haal CareTeam(s) op waar gebruiker lid van is                       │
│     CareTeam?participant=Practitioner/{id}                              │
│     CareTeam?participant=RelatedPerson/{id}                             │
├─────────────────────────────────────────────────────────────────────────┤
│  2. Bepaal rol binnen elk CareTeam                                      │
│     CareTeam.participant[x].role.coding                                 │
│     system = http://snomed.info/sct                                     │
├─────────────────────────────────────────────────────────────────────────┤
│  3. Leid permissies af van SNOMED code via permissiematrix              │
│     405623001 (behandelaar) → CRUD op CareTeam resources                │
│     224608005 (zorgondersteuner) → CRUD taken, geen launch              │
│     768821004 (case manager) → organisatie-breed lezen, taken starten   │
│     etc.                                                                │
├─────────────────────────────────────────────────────────────────────────┤
│  4. Pas permissies toe bij resource access                              │
│     Search narrowing, CRUD restricties                                  │
└─────────────────────────────────────────────────────────────────────────┘

Fallback Gedrag

Practitioner zonder autorisatierol

Wanneer een Practitioner wel lid is van een CareTeam maar geen SNOMED autorisatiecode uit de ValueSet heeft (alleen ZorgverlenerRolCodelijst code), gelden de regels van "Practitioner zonder rol in CareTeam":

• Alleen eigen taken en toegewezen resources
• Minimale rechten

RelatedPerson zonder rol

Wanneer een RelatedPerson niet is opgenomen in een CareTeam of geen rol heeft, gelden de regels van "Geen rol in CareTeam":

• Alleen eigen taken
• Geen toegang tot patiënttaken

Implementatieoverwegingen

Binding Strength

De ValueSet bindings zijn extensible:

• SNOMED CT codes MOETEN worden gebruikt voor autorisatie
• Aanvullende codes (zoals ZorgverlenerRolCodelijst) MOGEN worden toegevoegd
• Onbekende codes vallen terug op minimale rechten

SNOMED CT Hiërarchie en Subsumptie

SNOMED CT is een hiërarchisch terminologiestelsel. De codes in de Koppeltaal ValueSets bevinden zich op verschillende niveaus in deze hiërarchie. Terminologisch gezien zou een hogere code ook moeten gelden voor alle onderliggende (meer specifieke) codes — dit heet subsumptie.

Koppeltaal maakt vooralsnog geen gebruik van subsumptie. De gekozen codes worden als discrete codes behandeld: alleen de exact gespecificeerde codes in de ValueSets worden herkend voor autorisatiedoeleinden. Subsumptie kan in de toekomst een rol spelen, maar voor het huidige model houden we de logica eenvoudig en expliciet.

Meerdere Rollen

Een participant kan meerdere role codings hebben. De autorisatielogica evalueert de meest specifieke SNOMED CT code die aanwezig is.

Validatie

De FHIR Validator accepteert:

• SNOMED CT codes uit de Koppeltaal ValueSets
• Codes uit de ZorgverlenerRolCodelijst (via include in ValueSet)

Referenties

• SNOMED CT Browser
• ​KoppeltaalPractitionerRoleValueSet
• ​KoppeltaalRelatedPersonRoleValueSet
• Practitioner autorisaties
• RelatedPerson autorisaties
• CareTeam profiel