# Appointment - RIVO-Noord Zorgviewer Implementation Guide v1.23.0

* [**Table of Contents**](toc.md)
* [**Artifacts Summary**](artifacts.md)
* **Appointment**

## Resource Profile: Appointment 

| | |
| :--- | :--- |
| *Official URL*:http://fhir.hl7.nl/zorgviewer/StructureDefinition/Appointment | *Version*:1.23.0 |
| Draft as of 2026-03-30 | *Computable Name*:Appointment |

 
Afspraak 

> Dit Profiel is het resultaat van de vergelijking tussen de zib2017 FHIR Profiel en de implementaties in Epic, Chipsoft, Topicus en Nexus. De elementen die in ieder geval in alle output beschikbaar zullen zijn. Voornamelijk bedoeld voor houvast van een client en voor validatie van output.

### Zorginformatiebouwsteen

[ZIB Contact](https://zibs.nl/wiki/Contact-v3.1(2017NL))

### View Definition

[ViewDefinition voor Appointment](ViewDefinition-Appointment.json)

### UI Wireframe

**Afspraken**

* ><: +
  * Bron: Chipsoft
  * Begin: 12-10-2022
  * Eind: 12-10-2022
  * Met: 
  * Locatie: Ziekenhuis Apotheek
  * Status: pending
  * Type: Ambulatory
* ><: 
  * Bron: 
* ><: +
  * Bron: Epic
  * Begin: 20-4-2018
  * Eind: 20-4-2018
  * Met: G. Dijkstra, MDL arts
  * Locatie: Maag- Darm- Leverziekten
  * Status: pending
  * Type: Ambulatory
* ><: 
  * Bron: 

### Kolomdefinities

| | | | | |
| :--- | :--- | :--- | :--- | :--- |
| Bron | `meta.extension('http://hl7.org/fhir/4.0/StructureDefinition/extension-Meta.source').valueUri` | `string` | nvt | Lookup adhv uri (AGB-Z of OID)`<adressering-base>/Organization?identifier=<.meta.tag.code>`en gebruik dan`Organization.name` |
| Begin | `start` | `dateTime` | BeginDatumTijd |  |
| Eind | `end` | `dateTime` | EindDatumTijd |  |
| Met | `participant.where(actor.reference.contains('Practitioner/'))[0].actor.display` | `string` | ContactMet::Zorgverlener |  |
| Locatie | `participant.where(actor.reference.contains('Location/'))[0].actor.display` | `string` | Locatie::Zorgaanbieder |  |
| Status | `status` | `code` | nvt |  |
| Type | `appointmentType.coding.display` | `code` | ContactType |  |

### Request

1. Opvragen (search) afspraken`GET <ontsluiten-bronsysteem-base>/Appointment?status=booked,pending,proposed`

### Bronsysteem herkennen

De **Zorgviewer-backend** of **Ontsluiten bronsysteem** **MOET** na bevragen van het bronsysteem aan elk resultaat resource een meta-tag toevoegen met de AGB, OID of URA identifier van de zorgaanbieder (zie [Organization](StructureDefinition-Organization.md) voor voorbeelden). Dit wordt vervolgens gebruikt in de "Bron" kolom in de Zorgviewer-frontend. N.B. We gebruiken hier een **pre-adopt** van de FHIR R4 [Meta.source](StructureDefinition-extension-Meta.source.md).

Toevoegen aan elke response, dus per resource (bij een read) of per Bundle (bij een search):

```
"meta": {
    "extension": [ {
        "url": "http://hl7.org/fhir/4.0/StructureDefinition/extension-Meta.source",
        "valueUri": "urn:oid:2.16.840.1.113883.2.4.3.8"
    } ]
}

```

**Alternatief:** Elke entry van een search response Bundle bevat een referentie naar de bijbehorende Patient (`<resource>.subject|patient`). Elke patient heeft een `Patient.managingOrganization` en in de gerefereerde `Organization.identifier` staat vervolgens o.a. de OID van het bronsysyeem. Of je gebruikt de identifiers om een volledige Organization op te zoeken in het [adresboek](zorgviewer-services.md#adressering) en zie inhoud [hier](artifacts.md#zorgviewer-services-content).

**Usages:**

* CapabilityStatements using this Profile: [Ontsluiten Bronsysteem](CapabilityStatement-OntsluitenBronsysteem.md)
* This Profile is not used by any profiles in this Implementation Guide

You can also check for [usages in the FHIR IG Statistics](https://packages2.fhir.org/xig/hl7.fhir.nl.zorgviewer|current/StructureDefinition/Appointment)

**Changes since version 1.22.0:**

* One or more text definitions, invariants or bindings have changed

### Formal Views of Profile Content

 [Description of Profiles, Differentials, Snapshots and how the different presentations work](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#structure-definitions). 

 

Other representations of profile: [CSV](StructureDefinition-Appointment.csv), [Excel](StructureDefinition-Appointment.xlsx), [Schematron](StructureDefinition-Appointment.sch) 

### Notes:

### eAfspraak Dependency Issue

Door een issue in de eAfspraak package van Nictiz kunnen we nu niet onderstaande toevoegen. Het issue heeft te maken met de dependency van eAfspraak met de wildcard versie 2.0.x van de zibs package. Tot 15-jan-2026 (IG Publisher v2.0.29) werkte het correct. Vanaf die datum lijkt het niet meer te werken. Na wat verder kijken lijkt het niet de IG Publisher versie te zijn, maar iets met de packages.

StructureDefinition-Appointment.json:

```
  "baseDefinition": "http://nictiz.nl/fhir/StructureDefinition/eAfspraak-Appointment"

```

CapabilityStatement-OntsluitenBronsysteem.json:

```
  "profile": [
    {
      "reference": "http://nictiz.nl/fhir/StructureDefinition/eAfspraak-Appointment",
      "display": "eAfspraak-Appointment"
    } ]

```

zorgviewer-ig.json:

```
  "dependsOn": [
    {
      "id": "eafspraak",
      "uri": "https://simplifier.net/packages/nictiz.fhir.nl.stu3.eafspraak/1.0.6",
      "packageId": "nictiz.fhir.nl.stu3.eafspraak",
      "version": "1.0.6"
    } ]

```



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "Appointment",
  "url" : "http://fhir.hl7.nl/zorgviewer/StructureDefinition/Appointment",
  "version" : "1.23.0",
  "name" : "Appointment",
  "title" : "Appointment",
  "status" : "draft",
  "date" : "2026-03-30T13:23:57+00:00",
  "publisher" : "RIVO-NN HL7NL",
  "contact" : [{
    "name" : "RIVO-NN",
    "telecom" : [{
      "system" : "url",
      "value" : "https://rivo-noord.nl"
    }]
  },
  {
    "name" : "HL7NL",
    "telecom" : [{
      "system" : "url",
      "value" : "https://hl7.nl"
    }]
  }],
  "description" : "Afspraak",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "NL"
    }]
  }],
  "fhirVersion" : "3.0.2",
  "mapping" : [{
    "identity" : "rim",
    "uri" : "http://hl7.org/v3",
    "name" : "RIM Mapping"
  },
  {
    "identity" : "ical",
    "uri" : "http://www.ietf.org/rfc/rfc2445.txt",
    "name" : "iCalendar"
  },
  {
    "identity" : "w5",
    "uri" : "http://hl7.org/fhir/w5",
    "name" : "W5 Mapping"
  },
  {
    "identity" : "v2",
    "uri" : "http://hl7.org/v2",
    "name" : "HL7 v2 Mapping"
  }],
  "kind" : "resource",
  "abstract" : false,
  "type" : "Appointment",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/Appointment",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "Appointment",
      "path" : "Appointment"
    }]
  }
}

```
