Communication need
A communication need contains information about different needs the patient may have related to communication.
The needs have a code from kodeverk Volven 7525.
The patient can only have one need of each code.
| Field | Type | Required | Description |
|---|---|---|---|
| code | String |
x | Type of need, values from codesystem KJ_KOMMUNIKASJON Volven 7525 |
| comment | String |
Comments to the need | |
| status | Boolean |
If the need is active or not, defaults to true | |
| languages | List<String> |
Only mandatory if the code is KJ_KOMMUNIKASJON_7 (NEEDS_INTERPRETER), contains languages the patient knows. Language codes from codesystem Volven 3303 |
Use
When creating a new object with a POST-request, the request body should contain a list of needs. If adding a new need for a patient, it is sufficient to only send in the need with the new code. You cannot POST needs that already exist for a patient, to change something on an existing need, use PUT.
Create communication need object with POST-request:
POST https://test.patient-info.hit.nhn.no/api/patient-info/v1/communicationNeeds
[
{
"code": "KJ_KOMMUNIKASJON_1"
},
{
"code": "KJ_KOMMUNIKASJON_7",
"languages": [
"ALN"
]
}
]
Response:
[
{
"metadata": {
"resourceId": 123123,
"version": 1,
"patientInfoId": 2323,
"lastUpdated": "2025-03-05T06:41:27.217541Z",
"lastUpdatedBy": {
"userType": "HEALTH_CARE_PROFESSIONAL",
"orgNr": "998570328",
"orgName": null,
"treatmentFacilityName": "Andeby Helsestasjon",
"hprNr": "222200063",
"hprRole": "LE",
"name": "Lillehagen, Rolf Fos"
}
},
"code": {
"code": "KJ_KOMMUNIKASJON_1",
"codeSystem": "KJ_KOMMUNIKASJON",
"display": "Sterkt hørselhemmet"
},
"comment": "Slight hearing on right ear",
"languages": null,
"status": true
},
{
"metadata": {
"resourceId": 123124,
"version": 1,
"patientInfoId": 2323,
"lastUpdated": "2025-03-05T06:41:27.217541Z",
"lastUpdatedBy": {
"userType": "HEALTH_CARE_PROFESSIONAL",
"orgNr": "998570328",
"orgName": null,
"treatmentFacilityName": "Andeby Helsestasjon",
"hprNr": "222200063",
"hprRole": "LE",
"name": "Lillehagen, Rolf Fos"
}
},
"code": {
"code": "KJ_KOMMUNIKASJON_7",
"display": "Trenger tolk",
"codeSystem": "KJ_KOMMUNIKASJON"
},
"comment": null,
"languages": [
{
"code": "ALN",
"display": "Albansk",
"codeSystem": "VOLVEN_3303"
}
],
"status": true
}
]
In order to update one or more of the communication needs, use PUT: In order to make sure the latest data is what is updated, first GET the resources for the patient. A resource will not be updated if the version is incorrect.
PUT https://test.patient-info.hit.nhn.no/api/patient-info/v1/communicationNeeds
[
{
"metadata": {
"version": 1
},
"code": "KJ_KOMMUNIKASJON_1",
"comment": "Now has hearing implant",
"status": "false"
}
]
Response:
{
"communicationNeeds": [
{
"metadata": {
"resourceId": 123124,
"version": 2,
"patientInfoId": 2323,
"lastUpdated": "2025-06-05T09:41:27.217541Z",
"lastUpdatedBy": {
"userType": "HEALTH_CARE_PROFESSIONAL",
"orgNr": "998570328",
"orgName": null,
"treatmentFacilityName": "Andeby Helsestasjon",
"hprNr": "222200063",
"hprRole": "LE",
"name": "Lillehagen, Rolf Fos"
}
},
"code": {
"code": "KJ_KOMMUNIKASJON_1",
"display": "Sterkt hørselhemmet",
"codeSystem": "KJ_KOMMUNIKASJON"
},
"comment": "Now has hearing implant",
"languages": null,
"status": false
}
]
}
Read communication need object with GET-request:
GET https://test.patient-info.hit.nhn.no/api/patient-info/v1/communicationNeeds
Response:
[
{
"metadata": {
"resourceId": 123123,
"version": 1,
"patientInfoId": 2323,
"lastUpdated": "2025-03-05T06:41:27.217541Z",
"lastUpdatedBy": {
"userType": "HEALTH_CARE_PROFESSIONAL",
"orgNr": "998570328",
"orgName": null,
"treatmentFacilityName": "Andeby Helsestasjon",
"hprNr": "222200063",
"hprRole": "LE",
"name": "Lillehagen, Rolf Fos"
}
},
"code": {
"code": "KJ_KOMMUNIKASJON_1",
"codeSystem": "KJ_KOMMUNIKASJON",
"display": "Sterkt hørselhemmet"
},
"comment": "Slight hearing on right ear",
"languages": null,
"status": true
},
{
"metadata": {
"resourceId": 123124,
"version": 1,
"patientInfoId": 2323,
"lastUpdated": "2025-03-05T06:41:27.217541Z",
"lastUpdatedBy": {
"userType": "HEALTH_CARE_PROFESSIONAL",
"orgNr": "998570328",
"orgName": null,
"treatmentFacilityName": "Andeby Helsestasjon",
"hprNr": "222200063",
"hprRole": "LE",
"name": "Lillehagen, Rolf Fos"
}
},
"code": {
"code": "KJ_KOMMUNIKASJON_7",
"display": "Trenger tolk",
"codeSystem": "KJ_KOMMUNIKASJON"
},
"comment": null,
"languages": [
{
"code": "ALN",
"display": "Albansk",
"codeSystem": "VOLVEN_3303"
}
],
"status": true
}
]