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.
| ||
---|---|---|
Code | Display | Synonym (nl-NL) |
| Portability document | Portabiliteitsdocument |
| Portability report | Portabiliteitsrapport |
| Personal health dossier | Persoonlijk gezondheidsdossier |
| 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.
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] |
---|---|---|
|
|
|
|
|
|
Voorbeeldrespons verzamelen met typecodes
FHIR-resourceserver beantwoordt het verzoek voor documenten met code EXPORT als hieronder.
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’.
HTTP GET [base-url]/ValueSet
{
"resourceType": "ValueSet",
...
}
MedMijPortabiliteitCodelijst.json
Overwegingen
Codesysteem
v3-NullFlavor
metOTH
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. CodesPORT
,PORTABILITY
ofDOCUMENT
passen ook.Voorbeelden als WijzeBaringBegin en WondweefselCodelijst geven aan hoe te importeren.