Skip to main content
Skip table of contents

Bijlage typecodering documenten (v0.5)

Aanleiding

De usecase Verzamelen documenten over PGO-koppelvlak beschrijft hoe een PGO documenten verzamelt bij een bron-PGO op initiatief van de patiëntgebruiker. Doel is de documenten over te nemen als PGO-overstapservice. We noemen dit ook wel portabiliteit. Bij het selecteren van portabiliteitsdocumenten gebruiken wij identificerende codes. Deze bijlage beschrijft een voorstel voor een nieuwe codewaardelijst MedMijPortabiliteitCodelijst, ter beoordeling bij Nictiz.

Probleem

MedMij-portabiliteitsdocumenten zijn specifiek voor de uitwisseling tussen MedMij-deelnemers. Omdat het hier gaat om exportdocumenten, voldoen de terminologiecodes uit codelijsten niet die doorgaans toegepast worden in gegevensdienst Documenten Verzamelen. De codelijsten LOINC (klinische concepten) en SNOMED CT (labcodes, observaties) zijn bijvoorbeeld niet toereikend. Gepubliceerde valuesets bij Nictiz zijn ook niet specifiek genoeg om overdracht te beschrijven van documenten in PGO-overstapservice.

Oplossing

MedMij stelt voor een nieuwe codelijst te introduceren waarin wij expliciet de typen portabiliteitsdocumenten voor PGO-overstapservice vastleggen. Deze valueset omvat een generieke aanduiding voor portabiliteitsdocumenten waarlangs PGO’s documenten verzamelen en aanvullende typen om verschil te maken tussen verschillende documenten. Naast een PDF-document maakt doel-PGO bijvoorbeeld ook een portabiliteitsrapport beschikbaar in XML. PGO gebruikt deze codes tijdens selectie.

Middel

Waardecodelijst MedMijPortabiliteitCodelijst zoals hieronder beschreven past goed.

Technisch ontwerp voor overdracht van het patiëntlevensloopdossier langs het PGO-koppelvlak beschrijft hoe bevragend doel-PGO bij beschikbaarstellend bron-PGO documenten opvraagt langs gegevensdienst 51 Verzamelen Documenten 3.0 (PDF/A 3.0). In functie Find collection (raadplegen) geeft doel-PGO met een een typeaanduiding specifiek aan welke documenten te verzamelen.

Waardecodelijst

Waardecodelijsten (valuesets) zijn een concept binnen FHIR om gegevens in te delen op categorieën en typeaanduiding. De lijst bevat een selectie van codes in gebruik voor het herkennen van onderwerp en doel. Doel- en bron-PGO selecteren en herkennen het type document hieraan.

MedMij vraagt Nictiz een waardecodelijst te publiceren in ZIB2017 (STU3) en ZIB2020 (R4). Uit deze lijst kennen we elk document een of meerdere typecodes toe, zie ook uitleg systeemcodevoorbeeld.

MedMijPortabiliteitCodelijst. Deze waardecodelijst importeert codes van de volgende systemen: • De volgende codes van system urn:oid:2.16.528.1.1023.11.3.1.1.1:

Code

Display

Synonym (nl-NL)

EXPORT *

Portability document

Portabiliteitsdocument

REPORT

Portability report

Portabiliteitsrapport

DOSSIER

Personal health dossier

Persoonlijk gezondheidsdossier

ATTACHMENT

Personal health dossier attachment

Persoonlijk gezondheidsdossier bijlage

* PGO kent altijd code EXPORT toe aan alle portabiliteitsdocumenten. Andere codes vullen aan.

Raadplegen met typecode

MedMij hanteert een waardecodelijst. Documenten voor overstapservice zijn bekend onder één generieke code EXPORT voor dataportabiliteit met daarnaast codes voor specifieke subtyperingen.

YAML
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
HTTP GET [base-url]/DocumentReference?type=urn:oid:2.16.528...1|EXPORT

Hierop komt een bundel terug met tenminste een portabiliteitsrapport (in XML) en een export van het medische levensloopdossier (in PDF). Een document kan meerdere typecodes hebben.

resourceType

type.coding [*]

attachment.contentType [1]

DocumentReference

EXPORT Portabiliteitsdocument *
REPORT Portabiliteitsrapport

application/xml

DocumentReference

EXPORT Portabiliteitsdocument *
DOSSIER Persoonlijk gezondheidsdossier

application/pdf

Voorbeeldrespons verzamelen met typecodes

FHIR-resourceserver beantwoordt het verzoek voor documenten met code EXPORT als hieronder.

JSON
Content-Type: application/fhir+json
200 OK
{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 2,
  "entry": [
    {
      "resource": {
        "resourceType": "DocumentReference",
        "type": {
          "coding": [
            {
              "system": "urn:oid:2.16.528.1.1023.11.3.1.1.1",
              "code": "EXPORT",
              "display": "Portabiliteitsdocument"
            },
            {
              "system": "urn:oid:2.16.528.1.1023.11.3.1.1.1",
              "code": "REPORT",
              "display": "Portabiliteitsrapport"
            }
          ]
        },
        "subject": { "reference": "Patient/medmij-bgz-patient-ts-01" },
        "content": [
          {
            "attachment": {
              "contentType": "application/xml",
              "url": "https://deoudepgo.nl/portabiliteitsrapport?subject=medmij-bgz-patient-ts-01"
            }
          }
        ]
      }
    },
    {
      "resource": {
        "resourceType": "DocumentReference",
        "type": {
          "coding": [
            {
              "system": "urn:oid:2.16.528.1.1023.11.3.1.1.1",
              "code": "EXPORT",
              "display": "Portabiliteitsdocument"
            },
            {
              "system": "urn:oid:2.16.528.1.1023.11.3.1.1.1",
              "code": "DOSSIER",
              "display": "Persoonlijk gezondheidsdossier"
            }
          ]
        },
        "subject": { "reference": "Patient/medmij-bgz-patient-ts-01" },
        "content": [
          {
            "attachment": {
              "contentType": "application/pdf",
              "url": "https://deoudepgo.nl/genereer_pdf?document=voorbeeld123"
            }
          }
        ]
      }
    },
  ]
}

Voorbeeldimportbestand

Voor gebruik in FHIR-resourceserver tijdens ontwikkelfase ‘geïsoleerd testen en ontwikkelen’.

CODE
HTTP GET [base-url]/ValueSet
{
    "resourceType": "ValueSet",
    ...
}

MedMijPortabiliteitCodelijst.json

Overwegingen

  • Codesysteem v3-NullFlavor met OTH en veldinvulling beperkt zoeken in collectie. Selecteren langs PDF/A Find collection (raadplegen) wordt daarmee lastig en wijkt af van de bedoeling. Bij een selectie op NullFlavor komen documenten mee die mogelijk niet relevant zijn, de PGO moet deze documenten er dan weer uit filteren op basis van content in beschrijvend tekstveld van de code. Dataminialisatie kan niet gehandhaaft.

  • Code EXPORT leest prettig in FHIR-queries. Codes PORT, PORTABILITY of DOCUMENT passen ook.

  • Voorbeelden als WijzeBaringBegin en WondweefselCodelijst geven aan hoe te importeren.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.