Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -1,28 +1,28 @@
## Current Release 1.11.1
## Current Release 1.12.0

Product Link | Version | Handle | Phase | State | Release Date | Stability | Change Log Link
-----------------------|---------|---------|----------|-----------------|--------------|------------|-----------------
Implementation Guide | 1.11.1 | v1 | Live | Current Release | 19/05/2026 | Stable |{{pagelink:trn-General}}
[FHIR Package](https://simplifier.net/packages/uk.nhsdigital.bars.r4/1.40.0) | 1.40.0| v1 | Live | Current Release | 19/05/2026 | Stable |
{{pagelink:design-core-1.4.1, text:BaRS Core}} | 1.4.1 | v1 | Live | Current Release | 19/05/2026 | Stable |{{pagelink:trn-core, text: BaRS Core Change Log}}
[API Specification](https://digital.nhs.uk/developer/api-catalogue/booking-and-referral-fhir/v1.4.1) | 1.4.1 | v1 | Live | Current Release | 19/05/2026 | Stable |{{pagelink:trn-api}}
Implementation Guide | 1.12.0 | v1 | Live | Current Release | 16/07/2026 | Stable |{{pagelink:trn-General}}
[FHIR Package](https://simplifier.net/packages/uk.nhsdigital.bars.r4/1.41.0) | 1.41.0| v1 | Live | Current Release | 16/07/2026 | Stable |
{{pagelink:design-core-1.5.0, text:BaRS Core}} | 1.5.0 | v1 | Live | Current Release | 16/07/2026 | Stable |{{pagelink:trn-core, text: BaRS Core Change Log}}
[API Specification](https://digital.nhs.uk/developer/api-catalogue/booking-and-referral-fhir/v1.5.0) | 1.5.0 | v1 | Live | Current Release | 16/07/2026 | Stable |{{pagelink:trn-api}}
{{pagelink: build-testing, text: TKW}} | 1.0.21 | v1 | Live | Current Release | 12/11/2025 | Stable |{{pagelink:trn-tkw}}
{{pagelink:application1, text:BaRS-APP1}} | 2.0.0 | v1 | Live | Current Release | 12/11/2025 | Stable |{{pagelink:trn-app1,text:BaRS APP1 Change Log}}
{{pagelink:application2, text:BaRS-APP2}} | 2.0.0 | v1 | Live | Current Release | 12/11/2025 | Stable |{{pagelink:trn-app2,text:BaRS APP2 Change Log}}
{{pagelink:application1, text:BaRS-APP1}} | 2.1.0 | v1 | Live | Current Release | 16/07/2026 | Stable |{{pagelink:trn-app1,text:BaRS APP1 Change Log}}
{{pagelink:application2, text:BaRS-APP2}} | 2.1.0 | v1 | Live | Current Release | 16/07/2026 | Stable |{{pagelink:trn-app2,text:BaRS APP2 Change Log}}
{{pagelink:application3, text:BaRS-APP3}} | 2.0.0 | v1 | Live | Current Release | 12/11/2025 | Stable |{{pagelink:trn-app3,text:BaRS APP3 Change Log}}
{{pagelink:application4, text:BaRS-APP4}} | 2.0.0 | v1 | Live | Current Release | 12/11/2025 | Stable |{{pagelink:trn-app4,text:BaRS APP4 Change Log}}
{{pagelink:application5, text:BaRS-APP5}} | 1.2.0 | v1 | Live | Current Release | 26/03/2026 | Stable |{{pagelink:trn-app5,text:BaRS APP5 Change Log}}
{{pagelink:application6, text:BaRS-APP6}} | 1.0.0-beta.8 | beta | | Current Release | 19/05/2026 | Pre-Release |{{pagelink:trn-app6,text:BaRS APP6 Change Log}}
{{pagelink:application7, text:BaRS-APP7}} | 1.0.0-alpha.4 | alpha | | Current Release | 02/07/2025 | Pre-Release |{{pagelink:trn-app7,text:BaRS APP7 Change Log}}
{{pagelink:application8, text:BaRS-APP8}} | 1.0.0-alpha.2 | alpha | | Current Release | 19/05/2026 | Pre-Release |{{pagelink:trn-app8,text:BaRS APP8 Change Log}}
{{pagelink:application8, text:BaRS-APP8}} | 1.0.0-alpha.3 | alpha | | Current Release | 16/07/2026 | Pre-Release |{{pagelink:trn-app8,text:BaRS APP8 Change Log}}



### Overview of the release

Release 1.11.1 of the BaRS Implementation Guide is a patch release including an additional encounter.status value for Application 6 CAD to CAD Out of Area Referral, published with supporting documentation. BaRS Core version is uplifted to 1.4.1 in line with an update to the BaRS FHIR API OAS file. Updates to the BaRS FHIR API OAS file are limited to changes relating to internal endpoint catalogue management and do not affect supplier development.
Release 1.12.0 of the BaRS Implementation Guide is a minor release including an additional optional FHIR resource for Related Person in the payloads for Applications 1 and 2. Message definitions and examples in Simplifer are updated to support this change. Use case category codes have been updated to support senders in implementing the change effectively, following supplier feedback. Minor changes are applied to the implmentation guidance for Application 8 following consulation at alpha stage. BaRS Core version is uplifted to 1.5.0 in line with an update to the BaRS FHIR API OAS file.

Also included in this release are minor changes to BaRS Application 8 and bug fixes and corrections throughout the guide.
Also included in this release are minor changes and bug fixes and corrections throughout the guide.

A clinical safety assessment of the scope of this release has determined that it has not significantly changed the clinical safety profile of the BaRS. No new hazards have been identified in this release. The latest version of the BaRS clinical safety case and hazard log can be downloaded from the <a href= "https://digital.nhs.uk/developer/api-catalogue/booking-and-referral-fhir/onboarding-support-information#hazard-log-and-clinical-safety-case-report-cscr-" target="_blank"> BaRS FHIR API onboarding support information page </a>.

Expand Down Expand Up @@ -73,6 +73,10 @@ Table detailing active versions of the latest Applications in Production (or cur
<td>Application 1 v2.0.0</td>
<td><a href="https://simplifier.net/guide/nhsbookingandreferralstandard/home?version=1.10.0" target="_blank">v1.10.0</a></td>
</tr>
<tr>
<td>Application 1 v2.1.0</td>
<td><a href="https://simplifier.net/guide/nhsbookingandreferralstandard/home?version=1.12.0" target="_blank">v1.12.0</a></td>
</tr>
<tr>
<td>Application 2 v1.0.1</td>
<td><a href="https://simplifier.net/guide/nhsbookingandreferralstandard/home?version=1.1.0" target="_blank">v1.1.0</a></td>
Expand Down Expand Up @@ -102,7 +106,10 @@ Table detailing active versions of the latest Applications in Production (or cur
<td><a href="https://simplifier.net/guide/nhsbookingandreferralstandard/home?version=1.10.0" target="_blank">v1.10.0</a></td>
</tr>
<tr>
<td>Application 3 v1.0.0</td>
<td>Application 2 v2.0.0</td>
<td><a href="https://simplifier.net/guide/nhsbookingandreferralstandard/home?version=1.12.0" target="_blank">v1.12.0</a></td>
</tr>
<tr><td>Application 3 v1.0.0</td>
<td><a href="https://simplifier.net/guide/nhsbookingandreferralstandard/home?version=1.4.0" target="_blank">v1.4.0</a></td>
</tr>
<tr>
Expand Down Expand Up @@ -183,10 +190,6 @@ Table detailing active versions of the latest Applications in Production (or cur
<td>Application 5 v1.2.0</td>
<td><a href="https://simplifier.net/guide/nhsbookingandreferralstandard/home?version=1.11.0" target="_blank">v1.11.0</a></td>
</tr>
<tr>
<td>Application 6 v1.0.0-beta.7</td>
<td><a href="https://simplifier.net/guide/nhsbookingandreferralstandard/home?version=1.11.0" target="_blank">v1.11.0</a></td>
</tr>
<tr>
<td>Application 6 v1.0.0-beta.8</td>
<td><a href="https://simplifier.net/guide/nhsbookingandreferralstandard/home?version=1.11.1" target="_blank">v1.11.1</a></td>
Expand All @@ -198,14 +201,10 @@ Table detailing active versions of the latest Applications in Production (or cur
<td rowspan=1 style="text-align: center; vertical-align: middle;"><a href="https://digital.nhs.uk/developer/api-catalogue/booking-and-referral-fhir/v1_0_0" target="_blank">1.0.0</a></td>
</tr>
<tr>
<td>Application 8 v1.0.0-alpha</td>
<td><a href="https://simplifier.net/guide/nhsbookingandreferralstandard/home?version=1.11.0" target="_blank">v1.11.0</a></td>
<td rowspan=1 style="text-align: center; vertical-align: middle;"><a href="https://simplifier.net/guide/nhsbookingandreferralstandard/Home/Core?version=1.11.0" target="_blank">v1.4.0</a></td>
<td rowspan=1 style="text-align: center; vertical-align: middle;"><a href="https://digital.nhs.uk/developer/api-catalogue/booking-and-referral-fhir/v1.4.1" target="_blank">1.4.x</a></td>
</tr>
<tr>
<td>Application 8 v1.0.0-alpha.2</td>
<td><a href="https://simplifier.net/guide/nhsbookingandreferralstandard/home?version=1.11.1" target="_blank">v1.11.1</a></td>
<td>Application 8 v1.0.0-alpha.3</td>
<td><a href="https://simplifier.net/guide/nhsbookingandreferralstandard/home?version=1.12.0" target="_blank">v1.12.0</a></td>
<td rowspan=1 style="text-align: center; vertical-align: middle;"><a href="https://simplifier.net/guide/nhsbookingandreferralstandard/Home/Core?version=1.12.0" target="_blank">v1.5.0</a></td>
<td rowspan=1 style="text-align: center; vertical-align: middle;"><a href="https://digital.nhs.uk/developer/api-catalogue/booking-and-referral-fhir/v1.5.0" target="_blank">1.5.x</a></td>
</tr>
<tr>
<td></td>
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,39 @@
## {{page-title}}

<div class="bars-blg-expander">
<div class="bars-blg-expander-entry" id="v1.11.1">

Product Link | Version | Handle | Phase | State | Release Date | Stability | Change Log Link
-----------------------|---------|---------|----------|-----------------|--------------|------------|-----------------
Implementation Guide | 1.11.1 | v1 | Live | Current Release | 19/05/2026 | Stable |{{pagelink:trn-General}}
[FHIR Package](https://simplifier.net/packages/uk.nhsdigital.bars.r4/1.40.0) | 1.40.0| v1 | Live | Current Release | 19/05/2026 | Stable |
{{pagelink:design-core-1.4.1, text:BaRS Core}} | 1.4.1 | v1 | Live | Current Release | 19/05/2026 | Stable |{{pagelink:trn-core, text: BaRS Core Change Log}}
[API Specification](https://digital.nhs.uk/developer/api-catalogue/booking-and-referral-fhir/v1.4.1) | 1.4.1 | v1 | Live | Current Release | 19/05/2026 | Stable |{{pagelink:trn-api}}
{{pagelink: build-testing, text: TKW}} | 1.0.21 | v1 | Live | Current Release | 12/11/2025 | Stable |{{pagelink:trn-tkw}}
{{pagelink:application1, text:BaRS-APP1}} | 2.0.0 | v1 | Live | Current Release | 12/11/2025 | Stable |{{pagelink:trn-app1,text:BaRS APP1 Change Log}}
{{pagelink:application2, text:BaRS-APP2}} | 2.0.0 | v1 | Live | Current Release | 12/11/2025 | Stable |{{pagelink:trn-app2,text:BaRS APP2 Change Log}}
{{pagelink:application3, text:BaRS-APP3}} | 2.0.0 | v1 | Live | Current Release | 12/11/2025 | Stable |{{pagelink:trn-app3,text:BaRS APP3 Change Log}}
{{pagelink:application4, text:BaRS-APP4}} | 2.0.0 | v1 | Live | Current Release | 12/11/2025 | Stable |{{pagelink:trn-app4,text:BaRS APP4 Change Log}}
{{pagelink:application5, text:BaRS-APP5}} | 1.2.0 | v1 | Live | Current Release | 26/03/2026 | Stable |{{pagelink:trn-app5,text:BaRS APP5 Change Log}}
{{pagelink:application6, text:BaRS-APP6}} | 1.0.0-beta.8 | beta | | Current Release | 19/05/2026 | Pre-Release |{{pagelink:trn-app6,text:BaRS APP6 Change Log}}
{{pagelink:application7, text:BaRS-APP7}} | 1.0.0-alpha.4 | alpha | | Current Release | 02/07/2025 | Pre-Release |{{pagelink:trn-app7,text:BaRS APP7 Change Log}}
{{pagelink:application8, text:BaRS-APP8}} | 1.0.0-alpha.2 | alpha | | Current Release | 19/05/2026 | Pre-Release |{{pagelink:trn-app8,text:BaRS APP8 Change Log}}



### Overview of the release

Release 1.11.1 of the BaRS Implementation Guide is a patch release including an additional encounter.status value for Application 6 CAD to CAD Out of Area Referral, published with supporting documentation. BaRS Core version is uplifted to 1.4.1 in line with an update to the BaRS FHIR API OAS file. Updates to the BaRS FHIR API OAS file are limited to changes relating to internal endpoint catalogue management and do not affect supplier development.

Also included in this release are minor changes to BaRS Application 8 and bug fixes and corrections throughout the guide.

A clinical safety assessment of the scope of this release has determined that it has not significantly changed the clinical safety profile of the BaRS. No new hazards have been identified in this release. The latest version of the BaRS clinical safety case and hazard log can be downloaded from the <a href= "https://digital.nhs.uk/developer/api-catalogue/booking-and-referral-fhir/onboarding-support-information#hazard-log-and-clinical-safety-case-report-cscr-" target="_blank"> BaRS FHIR API onboarding support information page </a>.

</div>
</div>
<hr>
<br>

<div class="bars-blg-expander">
<div class="bars-blg-expander-entry" id="v1.11.0">

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,17 @@
topic: TRN-Core-1.4.1
---

<div class="bars-blg-expander">
<div class="bars-blg-expander-entry" id="v1.4.1">

## {{page-title}}

| Change | Description | Impact |
|------------------------------------------|----------------------------------------|---------------------------------|
| API version increment | API Spec version incremented from v1.4.0 to v1.4.1 | <mark style="background-color: Green">Non-breaking</mark> |

</div>
</div>
<br>
<hr>

### Previous Releases
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
---
topic: TRN-Core-1.5.0
---

## {{page-title}}

| Change | Description | Impact |
|------------------------------------------|----------------------------------------|---------------------------------|


<br>
<hr>

### Previous Releases
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
- name: Index
filename: Index.page.md
- name: 1.5.0
filename: 1.5.0.page.md
- name: 1.4.1
filename: 1.4.1.page.md
- name: 1.4.0
Expand Down
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
<div class="bars-blg-expander">

<div class="bars-blg-expander-entry" id="v1.11.1">

### 1.11.1

## Implementation Guide Changes
Expand All @@ -6,7 +10,10 @@
|---------------------------------------|---------------------------------------------------------------------------------------------------------|
| Bug fixes and corrections |There have been several bug fixes and corrections in the guide, these includes typos, broken links or corrections.|

<p>
</div>
</div>

<br>
<hr>

### Previous Releases
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
### 1.12.0

## Implementation Guide Changes

| Change | Description |
|---------------------------------------|---------------------------------------------------------------------------------------------------------|
| Bug fixes and corrections |There have been several bug fixes and corrections in the guide, these includes typos, broken links or corrections.|

<br>
<hr>

### Previous Releases
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
- name: Index
filename: Index.page.md
- name: 1.12.0
filename: 1.12.0.page.md
- name: 1.11.1
filename: 1.11.1.page.md
- name: 1.11.0
Expand Down
Original file line number Diff line number Diff line change
@@ -1,3 +1,6 @@
<div class="bars-blg-expander">
<div class="bars-blg-expander-entry" id="v2.0.0">

## {{page-title}}
This is a major release with a significant change to the Implementation Guidance and examples for v2.0.0. The changes are detailed in the change log.

Expand All @@ -21,7 +24,9 @@ This is a major release with a significant change to the Implementation Guidance
| Patient.identifier.extension.valueCodeableConcept.coding.code | This SHOULD be populated. Where used this MUST either be number-present-and-verified or no NHS number MUST be sent, no other status is valid | This SHOULD be populated. Where used this MUST be 'number-present-and-verified' or 'number-present-but-not-traced', else no NHS number MUST be sent. No other statuses are permitted. | Update | Booking Request |Accommodate NHS No. Requirement | <mark style="background-color: Red">breaking</mark> |
| Patient.identifier.extension.valueCodeableConcept.coding.display | This SHOULD be populated. Where used this MUST either be populated with 'Number present and-verified' no other status is valid | This SHOULD be populated. Where used this MUST be populated with 'Number present and verified' or 'Number present but not traced'. No other statuses are permitted. | Update | Booking Request |Accommodate NHS No. Requirement | <mark style="background-color: Red">breaking</mark> |

</div>
</div>

<br>
<hr>

### Previous Releases
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
## {{page-title}}
This is a minor release with a change to the Implementation Guidance and examples for v2.1.0. The changes are detailed in the change log.

### Application Change Log


<br>


| Change | Description | Impact |
|-------------------------------------------|-------------------------------------------------|-------------------------------------------------------------------------|
| Added FHIR resource RelatedPerson | Enhanced payload with addition of Related Person to carry Next of Kin details | <mark style="background-color: Green">Addition</mark> |

### Payload Change Log


| FHIR Element | Previous | Current | Other | Referral/Booking | Rationale | Impact |
|------------------------------------------------------|----------|------------|---------|------------------|-------------------------------------------------------------------------------------------------|----------|



<br>
<hr>

### Previous Releases
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
- name: Index
filename: Index.page.md
- name: 2.1.0
filename: 2.1.0.page.md
- name: 2.0.0
filename: 2.0.0.page.md
- name: 1.0.8
Expand Down
Original file line number Diff line number Diff line change
@@ -1,3 +1,6 @@
<div class="bars-blg-expander">
<div class="bars-blg-expander-entry" id="v2.0.0">

## {{page-title}}
This is a major release with a significant change to the Implementation Guidance and examples for v2.0.0. The changes are detailed in the change log.

Expand All @@ -21,7 +24,8 @@ This is a major release with a significant change to the Implementation Guidance
| Patient.identifier.extension.valueCodeableConcept.coding.code | This SHOULD be populated. Where used this MUST either be number-present-and-verified or no NHS number MUST be sent, no other status is valid | This SHOULD be populated. Where used this MUST be 'number-present-and-verified' or 'number-present-but-not-traced', else no NHS number MUST be sent. No other statuses are permitted. | Update | Booking Request |Accommodate NHS No. Requirement | <mark style="background-color: Red">breaking</mark> |
| Patient.identifier.extension.valueCodeableConcept.coding.display | This SHOULD be populated. Where used this MUST either be populated with 'Number present and-verified' no other status is valid | This SHOULD be populated. Where used this MUST be populated with 'Number present and verified' or 'Number present but not traced'. No other statuses are permitted. | Update | Booking Request |Accommodate NHS No. Requirement | <mark style="background-color: Red">breaking</mark> |

</div>
</div>

<br>
<hr>

### Previous Releases
Loading
Loading