Visit the HL7 website
Visit the FHIR website

Pan-Canadian FHIR Exchange (CA:FeX) IGuide 2.2.0 DFT-Ballot CI Build

2.2.0-DFT-Ballot   Canada flag
  • Home
  • Business Context
    • Project Background
    • Scope
    • Relationship to Other Specifications
    • Use Cases
  • Technical Context
    • Overview
    • FHIR Exchange Paradigms
    • 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
  • Change Log
    • Change Log
    1. Home
    2. FHIR Artifacts
    3. Capability Statements
    4. CA:FeX CapabilityStatement - Data Recipient - Option A (Accept FHIR Document)

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 A (Accept FHIR Document)

  • Overview
  • Tree view
  • XML
  • JSON

REST Capabilities Server

ModeServer
Documentation

This server supports CA:FeX-1A: Submit FHIR Document. Data Recipients SHALL support receiving a FHIR Document Bundle via an HTTP POST to the /Bundle endpoint. The submitted Bundle MUST be a valid FHIR Document with type 'document', containing a Composition as the first entry and other referenced resources.

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
BundleSHALLMAYMAYMAY

CapabilityStatement
id : CaFeX-DataRecipient-Option-A
url : http://fhir.infoway-inforoute.ca/io/cafex/CapabilityStatement/CaFeX-DataRecipient-Option-A
version : 2.2.0
name : CAFEX_DataRecipient_Option_A
title : CA:FeX CapabilityStatement - Data Recipient - Option A (Accept FHIR Document)
status : draft
experimental : False
date : 2025-04-01
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
description : CA:FeX-1A: Submit FHIR Document – Conformance expectations for a CA:FeX Data Recipient implementing the Bundle Option (A). The system must accept a FHIR Document Bundle via POST to the /Bundle endpoint. Optionality: R. Conditional create is not supported.
jurisdiction
coding
system : urn:iso:std:iso:3166
code : 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).
kind : requirements
fhirVersion : 4.0.1
format : json
format : xml
rest
mode : server
documentation : This server supports CA:FeX-1A: Submit FHIR Document. Data Recipients SHALL support receiving a FHIR Document Bundle via an HTTP POST to the /Bundle endpoint. The submitted Bundle MUST be a valid FHIR Document with type 'document', containing a Composition as the first entry and other referenced resources.
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 : Bundle
documentation : The server SHALL support HTTP POST to [base]/Bundle for document submission. The Bundle MUST be of type 'document' with a Composition as the first entry. The server SHALL assign ID, versionId, and lastUpdated. Conditional create is not supported. On success, the server returns a 201 Created response, with Location, ETag, and Last-Modified headers. On error, return 400 (Bad Request) or 422 (Unprocessable Entity) with OperationOutcome.
interaction
extension
url : http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation
value : SHALL
code : create
interaction
extension
url : http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation
value : SHOULD
code : create
interaction
extension
url : http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation
value : MAY
code : update
interaction
extension
url : http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation
value : MAY
code : patch
interaction
extension
url : http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation
value : MAY
code : delete
<CapabilityStatement xmlns="http://hl7.org/fhir">
    <id value="CaFeX-DataRecipient-Option-A" />
    <url value="http://fhir.infoway-inforoute.ca/io/cafex/CapabilityStatement/CaFeX-DataRecipient-Option-A" />
    <version value="2.2.0" />
    <name value="CAFEX_DataRecipient_Option_A" />
    <title value="CA:FeX CapabilityStatement - Data Recipient - Option A (Accept FHIR Document)" />
    <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-1A: Submit FHIR Document – Conformance expectations for a CA:FeX Data Recipient implementing the Bundle Option (A). The system must accept a FHIR Document Bundle via POST to the /Bundle endpoint. Optionality: R. Conditional create is not supported." />
    <jurisdiction>
        <coding>
            <system value="urn:iso:std:iso:3166" />
            <code value="CA" />
        </coding>
    </jurisdiction>
    <copyright value="Copyright &#169; 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-1A: Submit FHIR Document. Data Recipients SHALL support receiving a FHIR Document Bundle via an HTTP POST to the /Bundle endpoint.\nThe submitted Bundle MUST be a valid FHIR Document with type &#39;document&#39;, containing a Composition as the first entry and other referenced resources." />
        <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` &quot;Unauthorized&quot;, `HTTP 403` &quot;Forbidden&quot;, or `HTTP 404` &quot;Not Found&quot;" />
        </security>
        <resource>
            <type value="Bundle" />
            <documentation value="The server SHALL support HTTP POST to [base]/Bundle for document submission.\nThe Bundle MUST be of type &#39;document&#39; with a Composition as the first entry.\nThe server SHALL assign ID, versionId, and lastUpdated. Conditional create is not supported.\nOn success, the server returns a 201 Created response, with Location, ETag, and Last-Modified headers.\nOn error, return 400 (Bad Request) or 422 (Unprocessable Entity) with OperationOutcome." />
            <interaction>
                <extension url="http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation">
                    <valueCode value="SHALL" />
                </extension>
                <code value="create" />
            </interaction>
            <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>
        </resource>
    </rest>
</CapabilityStatement>
{
    "resourceType": "CapabilityStatement",
    "id": "CaFeX-DataRecipient-Option-A",
    "url": "http://fhir.infoway-inforoute.ca/io/cafex/CapabilityStatement/CaFeX-DataRecipient-Option-A",
    "version": "2.2.0",
    "name": "CAFEX_DataRecipient_Option_A",
    "title": "CA:FeX CapabilityStatement - Data Recipient - Option A (Accept FHIR Document)",
    "status": "draft",
    "experimental": false,
    "date": "2025-04-01",
    "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"
                }
            ]
        }
    ],
    "description": "CA:FeX-1A: Submit FHIR Document – Conformance expectations for a CA:FeX Data Recipient implementing the Bundle Option (A). The system must accept a FHIR Document Bundle via POST to the /Bundle endpoint. Optionality: R. Conditional create is not supported.",
    "jurisdiction":  [
        {
            "coding":  [
                {
                    "system": "urn:iso:std:iso:3166",
                    "code": "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).",
    "kind": "requirements",
    "fhirVersion": "4.0.1",
    "format":  [
        "json",
        "xml"
    ],
    "rest":  [
        {
            "mode": "server",
            "documentation": "This server supports CA:FeX-1A: Submit FHIR Document. Data Recipients SHALL support receiving a FHIR Document Bundle via an HTTP POST to the /Bundle endpoint.\nThe submitted Bundle MUST be a valid FHIR Document with type 'document', containing a Composition as the first entry and other referenced resources.",
            "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": "Bundle",
                    "documentation": "The server SHALL support HTTP POST to [base]/Bundle for document submission.\nThe Bundle MUST be of type 'document' with a Composition as the first entry.\nThe server SHALL assign ID, versionId, and lastUpdated. Conditional create is not supported.\nOn success, the server returns a 201 Created response, with Location, ETag, and Last-Modified headers.\nOn error, return 400 (Bad Request) or 422 (Unprocessable Entity) with OperationOutcome.",
                    "interaction":  [
                        {
                            "extension":  [
                                {
                                    "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
                                    "valueCode": "SHALL"
                                }
                            ],
                            "code": "create"
                        },
                        {
                            "extension":  [
                                {
                                    "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
                                    "valueCode": "SHOULD"
                                }
                            ],
                            "code": "create"
                        },
                        {
                            "extension":  [
                                {
                                    "url": "http://hl7.org/fhir/StructureDefinition/capabilitystatement-expectation",
                                    "valueCode": "MAY"
                                }
                            ],
                            "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"
                        }
                    ]
                }
            ]
        }
    ]
}

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