Care trajectories ​
The Care trajectories screen shows a client's care trajectories — the treatments within which you schedule appointments, bill, and record the clinical details (setting, lead practitioner, care-demand typing, diagnosis, profile and referral). From the overview you create new trajectories, filter by status, and close or reopen a trajectory. On the detail screen you manage the clinical fields of a single care trajectory.
Overview ​
| Route | /clients/:clientId/care-trajectories (overview), /clients/:clientId/care-trajectories/:careTrajectoryId (detail) |
| Audience | Practitioner |
| Required permissions | care_trajectories.read (view); care_trajectories.create (create); care_trajectories.update (edit, close, reopen) |
How it works ​
A care trajectory is the treatment context within which you schedule appointments and bill. The clinical choices you record here — setting, location, care-demand typing, diagnosis and profile — flow through into scheduling and billing. Read this section before changing fields, so you understand what a change actually does.
Versioning: a change does not overwrite ​
Many clinical fields are versioned. A change does not overwrite the existing value but creates a new period with its own effective date. The old value is kept as history, so you can always see which value applied on which date. When changing such a field you therefore enter, besides the new value, an effective date and an optional reason.
| Field | Versioned? |
|---|---|
| Setting | Yes |
| Lead practitioner | Yes |
| Care-demand typing | Yes |
| DSM-5 diagnosis | Yes |
| Basic GGZ profile | Yes |
| Name | No — the change replaces the value directly. |
| Start date | No — corrects the existing date. |
| Referral | No — the change replaces the data directly. |
The care-demand typing history at the bottom of the detail screen shows these periods for the typing.
Status determines what you can do ​
A trajectory's status acts as a gate for scheduling and billing:
| Status | Meaning |
|---|---|
| Active | The trajectory is ongoing; you can schedule appointments, edit data, and bill. |
| Closed | The trajectory has ended with an end date. You can no longer schedule new appointments or bill; you can reopen the trajectory. |
Clinical terms ​
| Term | Meaning |
|---|---|
| Setting | The GGZ setting (treatment environment) of the trajectory. Together with the location it determines the billing AGB code and, via the contract, the tariff. |
| Care-demand typing (zorgvraagtypering) | The code that types the nature and severity of the care demand. It is determined on creation and afterwards recalibrated rather than overwritten. |
| DSM-5: definitive vs. differential | A diagnosis is definitive (established) or differential (still to be distinguished — a working hypothesis). |
| Primary diagnosis | When there are multiple DSM-5 diagnoses, you mark one as primary: the diagnosis that drives the treatment. |
| Basic GGZ | The care domain for mild to moderate problems. The Basic GGZ profile indicates the expected care intensity within that domain. |
From setting and location to billing ​
The trajectory's setting and location together determine the billing AGB code used to bill appointments: the location supplies the AGB code, and the setting selects — together with the insurer and the date of care — the applicable tariff from the contract. A change to the setting thus flows through into future billing; that is why the setting is versioned, so that billing before and after the change each use the correct tariff.
Why the recalibration dialog opens automatically ​
Immediately after creating a care trajectory, the recalibration dialog for the care-demand typing opens. The typing is not an ordinary input field but a separate, justified step: it determines the care-demand typing code and is later recalibrated while preserving history. By opening the dialog right away, Scrivio ensures that every new trajectory gets a substantiated care-demand typing from the outset, instead of that step being skipped.
Create care trajectory ​
Click New care trajectory at the top right of the overview (or, on an empty list, Create first care trajectory) to open the create dialog. This action requires the care_trajectories.create permission.
| Field | Required | Description |
|---|---|---|
| Name | No | Free-text name for the trajectory. |
| Location | No | Location for the billing AGB code; defaults to the organization location. |
| Setting | Yes | The mental-health setting of the trajectory. |
| Start date | Yes | Effective date of the trajectory. |
| Lead practitioner | Yes | The responsible practitioner. |
| DSM-5 diagnosis | No | One or more DSM-5 diagnoses. |
| Basic GGZ profile | No | The treatment profile. |
| Care intensity | No | The care intensity. |
| Referral | No | Indicate whether a referral is present and fill in the referrer details. |
After creation the recalibration dialog opens directly, so you can determine the care-demand typing as a separate step.
Filter by status ​
Above the list is a status filter. Choose All, Active or Closed to limit the list to trajectories with that status. The filter defaults to Active, so you immediately see the ongoing trajectories when you open the tab.
Close care trajectory ​
Close an active care trajectory when the treatment has ended. Click Close on the trajectory in the overview, or use the Close button at the top right of the detail screen. A dialog opens in which you confirm the end date.
| Field | Required | Description |
|---|---|---|
| End date | Yes | The date on which the trajectory ended. Defaults to today. |
The trajectory then receives the status Closed. Closing requires the care_trajectories.update permission.
Reopen care trajectory ​
Reopen a closed care trajectory via Reopen in the overview or with the Reopen button at the top right of the detail screen. The end date is cleared and the trajectory returns to status Active. This action also requires the care_trajectories.update permission.
Edit name ​
On the detail screen you edit the name of the trajectory. Click Edit next to the Name heading, adjust the name and save with Save. The name is not versioned: the change overwrites the existing value directly.
Edit start date ​
Click Edit next to the Start date heading, pick a new date and save. The start date cannot always be changed — for example when data is already tied to the original start date. If editing is not possible the button is disabled and a hint shows the reason.
Change setting ​
The setting is a versioned field. Click Edit next to Setting to create a new period.
| Field | Required | Description |
|---|---|---|
| New setting | Yes | The setting that applies from the effective date. |
| Effective date | Yes | The date on which the new setting takes effect. |
| Reason | No | Explanation of the change. |
Change lead practitioner ​
The lead practitioner is a versioned field. Click Edit next to Lead practitioner to assign a new practitioner or reassess the current one. This action is only available if you are authorized.
| Field | Required | Description |
|---|---|---|
| New practitioner | Yes | The practitioner responsible from the effective date. |
| Effective date | Yes | The date on which the change takes effect. |
| Reason | No | Explanation of the change. |
Recalibrate care-demand typing ​
The care-demand typing determines the trajectory's care-demand typing code. Click Recalibrate next to Care-demand typing to record a new typing. For a new trajectory without a typing the dialog opens in first-determination mode. Recalibration is only available if you are authorized.
| Field | Required | Description |
|---|---|---|
| New code | Yes | The new care-demand typing code. |
| Effective date | Yes | The date on which the new typing takes effect. |
| Reason | No | Explanation of the recalibration. |
Edit diagnosis ​
The DSM-5 diagnosis is a versioned field. Click Edit next to DSM-5 diagnosis to create a new diagnosis period.
| Field | Required | Description |
|---|---|---|
| DSM-5 diagnosis | Yes | One or more DSM-5 diagnoses. |
| Status | Yes | Definitive or differential. |
| Primary diagnosis | No | Mark which diagnosis is primary. |
| Comment | No | Free-text note. |
| Effective date | Yes | The date on which the diagnosis takes effect. |
| Reason | No | Explanation of the change. |
Edit profile ​
The Basic GGZ profile is a versioned field. Click Edit next to Basic GGZ profile to create a new period.
| Field | Required | Description |
|---|---|---|
| New profile | Yes | The treatment profile that applies from the effective date. |
| Effective date | Yes | The date on which the new profile takes effect. |
| Reason | No | Explanation of the change. |
Edit referral ​
The referral is not versioned. Click Edit next to Referral to adjust the referrer details.
| Field | Required | Description |
|---|---|---|
| Referral present | No | Tick whether a referral exists. The other fields only appear when this is ticked. |
| Referrer type | No | The type of referrer (for example, general practitioner). |
| Referrer name | No | Name of the referrer. |
| No | Email address of the referrer. | |
| Referrer AGB code | No | The AGB code of the referrer. |
| Referral date | No | The date of the referral. |
View referral letter ​
If a referral letter is attached, the Referral block shows an option to open it. Click it to view the referral letter in the document viewer.
View care-demand typing history ​
At the bottom of the detail screen, the Care-demand typing section lists the full history of typings, including the current period. This lets you see at a glance how the trajectory's care-demand typing has evolved.