Measurements¶

Retrieve measurements¶

Retrieve a since or all measurements of the patient.

Request - all measurements¶

{
   "Name": "{{name}}",
   "Key": "{{key}}",
   "Target": "{{target}}",
   "Session": "{{session}}",
   "Method": "MetingenOpvragen"
}

Response¶

Warning

When the WaardeDisplay contains the value -1 the value to display your be retrieved from WaardeTekst.

{
   "uitslagen": [
            {
            "MetingType": {
               "Id": 14837,
               "Naam": "erytrocyten",
               "MinWaarde1000": 0,
               "MaxWaarde1000": 0,
               "Memo": "erytrocyten",
               "WCIAMemo": "ERY/B/MT",
               "MetingEenheid": "",
               "VraagType": "Numeriek"
            },
            "Uitslagen": [
               {
                  "Id": 735875,
                  "Datum": "2010-01-01T13:31:00",
                  "MetingTypeId": 14837,
                  "Memo": "ERY/B/MT",
                  "Waarde": "5000",
                  "WaardeDisplay": "5,00",
                  "WaardeTekst": "5000",
                  "MetingOmschrijving": "erytrocyten",
                  "MetingEenheid": "",
                  "Opmerkingen": "",
                  "Afwijkend": false,
                  "MinVolgensLab1000": 4200,
                  "MaxVolgensLab1000": 5400
               }
            ]
      },
      {
            "MetingType": {
               "Id": 16609,
               "Naam": "thyroïd stimulerend hormoon (TSH)",
               "MinWaarde1000": 0,
               "MaxWaarde1000": 0,
               "Memo": "thyroïd stimulerend hormoon (TSH)",
               "WCIAMemo": "TSH/B/",
               "MetingEenheid": "",
               "VraagType": "Numeriek"
            },
            "Uitslagen": [
               {
                  "Id": 735876,
                  "Datum": "2010-01-01T13:31:00",
                  "MetingTypeId": 16609,
                  "Memo": "TSH/B/",
                  "Waarde": "2700",
                  "WaardeDisplay": "2,70",
                  "WaardeTekst": "2700",
                  "MetingOmschrijving": "thyroïd stimulerend hormoon (TSH)",
                  "MetingEenheid": "",
                  "Opmerkingen": "",
                  "Afwijkend": false,
                  "MinVolgensLab1000": 270,
                  "MaxVolgensLab1000": 4200
               }
            ]
      }
   ],
   "ReturnValue": {
      "ResponseCode": 200,
      "ResponseText": "OK",
      "Melding": "OK",
      "Gelukt": true
   }
}

Request - specific measurements¶

Add a WCIAMemos array to only get the measurements you want

{
   "Name": "{{name}}",
   "Key": "{{key}}",
   "Target": "{{target}}",
   "Session": "{{session}}",
   "Method": "MetingenOpvragen",
   "WCIAMemos": [
      "LNGP/AO/"
   ]
}

Response¶

Warning

When the WaardeDisplay contains the value -1 the value to display your be retrieved from WaardeTekst.

{
   "uitslagen": [
      {
            "MetingType": {
               "Id": 15460,
               "Naam": "lengte patiënt",
               "MinWaarde1000": 0,
               "MaxWaarde1000": 0,
               "Memo": "lengte patiënt",
               "WCIAMemo": "LNGP/AO/",
               "MetingEenheid": "m",
               "VraagType": "Numeriek"
            },
            "Uitslagen": [
               {
                  "Id": 746501,
                  "Datum": "2023-10-29T00:31:45",
                  "MetingTypeId": 15460,
                  "Memo": "LNGP/AO/",
                  "Waarde": "1870",
                  "WaardeDisplay": "1,87",
                  "WaardeTekst": "1870",
                  "MetingOmschrijving": "lengte patiënt",
                  "MetingEenheid": "m",
                  "Opmerkingen": "",
                  "Afwijkend": false,
                  "MinVolgensLab1000": 0,
                  "MaxVolgensLab1000": 0
               },
               {
                  "Id": 740361,
                  "Datum": "2022-07-19T10:53:09",
                  "MetingTypeId": 15460,
                  "Memo": "LNGP/AO/",
                  "Waarde": "1860",
                  "WaardeDisplay": "1,86",
                  "WaardeTekst": "1860",
                  "MetingOmschrijving": "lengte patiënt",
                  "MetingEenheid": "m",
                  "Opmerkingen": "",
                  "Afwijkend": false,
                  "MinVolgensLab1000": 0,
                  "MaxVolgensLab1000": 0
               }
            ]
      }
   ],
   "ReturnValue": {
      "ResponseCode": 200,
      "ResponseText": "OK",
      "Melding": "OK",
      "Gelukt": true
   }
}

Store measurement by patient¶

Store measurements for the logged in patient.

It is also possible to add measurements without a logged in patient, more information can be found in “Store measurement for patient”.

Request¶

{
   "Name": "{{name}}",
   "Key": "{{key}}",
   "Target": "{{target}}",
   "Session": "{{session}}",
   "Method": "MetingenOpslaan",
   "waarden": [
      {
         "WCIAMemo": "ESPD/AQ/",
         "Waarde": "2000",
         "Opmerkingen": "Remark for measurement"
      }
   ]
}

The example above will store “aantal e-sigaretten per dag” with the value of 2 cigarettes.

Parameters

waarden: Object of measurements to store:
- WCIAMemo: NHG memo code of measurement
- Waarde: NHG numeric values measurements needs to be multiplied by 1000
- Opmerkingen: Remark for the measurement

WCIAMemo’s and their values (Waarde) are based on the codes that can be found at the “Bepalingenviewer”.

Response¶

{
   "ReturnValue": {
      "ResponseCode": 200,
      "ResponseText": "OK",
      "Melding": "OK",
      "Gelukt": true
   }
}

Store measurements by patient on a specific date¶

You can add a date/time when you need to store a measurement for a specific moment. When you do not add this information the date/time of the request will be added to the measurement.

To give a specific date/time you need to add the tijdstip key to the request:

Request¶

{
   "Name": "{{name}}",
   "Key": "{{key}}",
   "Target": "{{target}}",
   "Session": "{{session}}",
   "Method": "MetingenOpslaan",
   "waarden": [
      {
         "WCIAMemo": "ESPD/AQ/",
         "Waarde": "2000",
         "Opmerkingen": "Remark for measurement"
      }
   ],
   "tijdstip": "2023-06-01T09:00:00"
}

Response¶

{
   "ReturnValue": {
      "ResponseCode": 200,
      "ResponseText": "OK",
      "Melding": "OK",
      "Gelukt": true
   }
}

Store measurement for patient¶

Add measurements to the patients medical file with the following request. Optionally, the username of the employee can be provided, otherwise the entry in the medical file will be created by “Extern”.

You will receive the ID of the stored contact.

When you want to store measurements for logged in users, you need to use another request. More information can be found in “Store measurement by patient”.

Request¶

{
  "Name": "{{name}}",
  "Key": "{{key}}",
  "Target": "{{target}}",
  "Method": "NieuweMetingen",
  "medewerkerAgbOfNaam": "medewerker1",
  "patientId": 123456,
  "uitslagen": [
    {
      "WCIAMemo": "ESPD/AQ/",
      "Waarde": "2000"
    },
    {
      "WCIAMemo": "STPG/AQ/",
      "Waarde": "200"
    }
  ]
}

Parameters

patientId: ID of the patient.
uitslagen: A list of objects that contain the measurements:
- WCIAMemo: NHG memo code of measurement
- Waarde: NHG numeric values measurements needs to be multiplied by 1000
medewerkerAgbOfNaam: The username or the AGB-code of the employee (optional).

WCIAMemo’s and their values (Waarde) are based on the codes that can be found at the “Bepalingenviewer”.

Response¶

{}

contactId: The ID of the contact.