Visit the HL7 website
Visit the FHIR website

Pan-Canadian FHIR Exchange (CA:FeX) IGuide

2.2.0-DFT   Canada flag
  • Home
  • Business Context
    • Project Background
    • Scope
    • Relationship to Other Specifications
    • Use Cases
  • Technical Context
    • Overview
    • FHIR Exchange Paradigms
    • Data Exchange
    • Document Exchange
    • RESTful API Interactions
    • Sequence Diagrams
    • Actor Mapping to Interoperability Specification
    • Security
  • Actor and Conformance Options
    • Technical Actors
    • Actor Options
    • Conformance Requirements
  • FHIR Artifacts
    • Profiles and Extensions
    • Search Parameters
    • Operations
    • Capability Statements
    • Capability Statements - Server
  • Change Log
    • Change Log
    1. Home
    2. FHIR Artifacts
    3. Capability Statements
    4. CA:FeX CapabilityStatement - Data Recipient - Option B (Metadata)

DFT Ballot - This specification is currently in ballot review and subject to change. It is not ready for limited roll-out or production level use. For a full list of available versions, see the Directory of published versions

CA:FeX CapabilityStatement - Data Recipient - Option B (Metadata)

  • Overview
  • Tree view
  • XML
  • JSON

REST Capabilities Server

ModeServer
Documentation

This server supports CA:FeX-1B – allowing a Data Source to submit FHIR document metadata and content on a DocumentReference endpoint with the $generate-metadata operation.

Security

Description
  1. See the security section of the CA:FeX guide for security requirements and recommendations.
  2. A server SHALL reject any unauthorized requests by returning an HTTP 401 "Unauthorized", HTTP 403 "Forbidden", or HTTP 404 "Not Found"

Resource Interactions

Resource TypeSupported ProfilesCreateUpdatePatchDelete
DocumentReferenceSHOULDMAYMAYMAY

Operations per resource type

DocumentReference

OperationReferenceLevel
$generate-metadata??SHALL
CapabilityStatement
id : CaFeX-DataRecipient-Option-B
url : http://fhir.infoway-inforoute.ca/io/cafex/CapabilityStatement/CaFeX-DataRecipient-Option-B
title : CA:FeX CapabilityStatement - Data Recipient - Option B (Metadata)
description : CA:FeX-1B – Conformance expectations for a CA:FeX Data Recipient implementing Metadata Option (B). The system must support receiving DocumentReference metadata and associated Binary payloads via create interactions.
status : draft
version : 2.2.0
name : CAFEX_DataRecipient_Option_B
date : 2025-04-01
kind : requirements
experimental : False
fhirVersion : 4.0.1
format : json
format : xml
jurisdiction
coding
code : CA
system : urn:iso:std:iso:3166
publisher : Canada Health Infoway
contact
name : National Standards Release Centre
telecom
system : url
value : http://www.infoway-inforoute.ca
telecom
system : email
value : standards@infoway-inforoute.ca
copyright : Copyright © 2021–2025+ Canada Health Infoway. All rights reserved. [Terms of Use and License Agreements](https://ic.infoway-inforoute.ca/en/about/tou). [Privacy Policy](https://www.infoway-inforoute.ca/en/legal/privacy-policy).
rest
mode : server
documentation : This server supports CA:FeX-1B – allowing a Data Source to submit FHIR document metadata and content on a DocumentReference endpoint with the $generate-metadata operation.
security
description : 1. See the security section of the CA:FeX guide for security requirements and recommendations. 2. A server **SHALL** reject any unauthorized requests by returning an `HTTP 401` "Unauthorized", `HTTP 403` "Forbidden", or `HTTP 404` "Not Found"
resource
type : DocumentReference
operation
name : $generate-metadata
definition : http://fhir.infoway-inforoute.ca/io/cafex/OperationDefinition/generate-metadata
extension
url : http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation
value : SHALL
interaction
code : create
extension
url : http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation
value : SHOULD
interaction
code : update
extension
url : http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation
value : MAY
interaction
code : patch
extension
url : http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation
value : MAY
interaction
code : delete
extension
url : http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation
value : MAY
<CapabilityStatement xmlns="http://hl7.org/fhir">
<id value="CaFeX-DataRecipient-Option-B" />
<url value="http://fhir.infoway-inforoute.ca/io/cafex/CapabilityStatement/CaFeX-DataRecipient-Option-B" />
<version value="2.2.0" />
<name value="CAFEX_DataRecipient_Option_B" />
<title value="CA:FeX CapabilityStatement - Data Recipient - Option B (Metadata)" />
<status value="draft" />
<experimental value="false" />
<date value="2025-04-01" />
<publisher value="Canada Health Infoway" />
<contact>
<name value="National Standards Release Centre" />
<telecom>
<system value="url" />
<value value="http://www.infoway-inforoute.ca" />
</telecom>
<telecom>
<system value="email" />
<value value="standards@infoway-inforoute.ca" />
</telecom>
</contact>
<description value="CA:FeX-1B – Conformance expectations for a CA:FeX Data Recipient implementing Metadata Option (B). The system must support receiving DocumentReference metadata and associated Binary payloads via create interactions." />
<jurisdiction>
<coding>
<system value="urn:iso:std:iso:3166" />
<code value="CA" />
</coding>
</jurisdiction>
<copyright value="Copyright © 2021–2025+ Canada Health Infoway. All rights reserved. [Terms of Use and License Agreements](https://ic.infoway-inforoute.ca/en/about/tou). [Privacy Policy](https://www.infoway-inforoute.ca/en/legal/privacy-policy)." />
<kind value="requirements" />
<fhirVersion value="4.0.1" />
<format value="json" />
<format value="xml" />
<rest>
<mode value="server" />
<documentation value="This server supports CA:FeX-1B – allowing a Data Source to submit FHIR document metadata and content on a DocumentReference endpoint with the $generate-metadata operation." />
<security>
<description value="1. See the security section of the CA:FeX guide for security requirements and recommendations.\n2. A server **SHALL** reject any unauthorized requests by returning an `HTTP 401` "Unauthorized", `HTTP 403` "Forbidden", or `HTTP 404` "Not Found"" />
</security>
<resource>
<type value="DocumentReference" />
<interaction>
<extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHOULD" />
</extension>
<code value="create" />
</interaction>
<interaction>
<extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="MAY" />
</extension>
<code value="update" />
</interaction>
<interaction>
<extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="MAY" />
</extension>
<code value="patch" />
</interaction>
<interaction>
<extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="MAY" />
</extension>
<code value="delete" />
</interaction>
<operation>
<extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
<valueCode value="SHALL" />
</extension>
<name value="$generate-metadata" />
<definition value="http://fhir.infoway-inforoute.ca/io/cafex/OperationDefinition/generate-metadata" />
</operation>
</resource>
</rest>
</CapabilityStatement>
{
"resourceType": "CapabilityStatement",
"id": "CaFeX-DataRecipient-Option-B",
"url": "http://fhir.infoway-inforoute.ca/io/cafex/CapabilityStatement/CaFeX-DataRecipient-Option-B",
"title": "CA:FeX CapabilityStatement - Data Recipient - Option B (Metadata)",
"description": "CA:FeX-1B – Conformance expectations for a CA:FeX Data Recipient implementing Metadata Option (B). The system must support receiving DocumentReference metadata and associated Binary payloads via create interactions.",
"status": "draft",
"version": "2.2.0",
"name": "CAFEX_DataRecipient_Option_B",
"date": "2025-04-01",
"kind": "requirements",
"experimental": false,
"fhirVersion": "4.0.1",
"format": [
"json",
"xml"
],
"jurisdiction": [
{
"coding": [
{
"code": "CA",
"system": "urn:iso:std:iso:3166"
}
]
}
],
"publisher": "Canada Health Infoway",
"contact": [
{
"name": "National Standards Release Centre",
"telecom": [
{
"system": "url",
"value": "http://www.infoway-inforoute.ca"
},
{
"system": "email",
"value": "standards@infoway-inforoute.ca"
}
]
}
],
"copyright": "Copyright © 2021–2025+ Canada Health Infoway. All rights reserved. [Terms of Use and License Agreements](https://ic.infoway-inforoute.ca/en/about/tou). [Privacy Policy](https://www.infoway-inforoute.ca/en/legal/privacy-policy).",
"rest": [
{
"mode": "server",
"documentation": "This server supports CA:FeX-1B – allowing a Data Source to submit FHIR document metadata and content on a DocumentReference endpoint with the $generate-metadata operation.",
"security": {
"description": "1. See the security section of the CA:FeX guide for security requirements and recommendations.\n2. A server **SHALL** reject any unauthorized requests by returning an `HTTP 401` \"Unauthorized\", `HTTP 403` \"Forbidden\", or `HTTP 404` \"Not Found\""
},
"resource": [
{
"type": "DocumentReference",
"operation": [
{
"name": "$generate-metadata",
"definition": "http://fhir.infoway-inforoute.ca/io/cafex/OperationDefinition/generate-metadata",
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHALL"
}
]
}
],
"interaction": [
{
"code": "create",
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "SHOULD"
}
]
},
{
"code": "update",
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "MAY"
}
]
},
{
"code": "patch",
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "MAY"
}
]
},
{
"code": "delete",
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
"valueCode": "MAY"
}
]
}
]
}
]
}
]
}

IG © based on FHIR R4 | Package package:ca.infoway.io.cafex@2.2.0-DFT
HL7® and FHIR® are the registered trademarks of Health Level Seven International