Carin BB

Setup Aidbox with CARIN Consumer Directed Payer Data Exchange (CARIN IG for Blue Button®) version 2.0.0 with prebuilt Aidbox config

To correctly set up Aidbox, we'll utilize the Aidbox configuration projects.

There's an existing guide for this process. Adhere to this guide, but note a variation when you reach the Configure the Aidbox step: instead of using the recommended configuration projects (R4,R4B,R5,etc.) — clone this specific project:

git clone \
  --branch=carin-bb \
  --depth=1 \
  https://github.com/Aidbox/aidbox-project-template.git \
  aidbox-project && \
  cd aidbox-project && \
  rm -rf .git

The git template project contains CARIN Consumer Directed Payer Data Exchange (CARIN IG for Blue Button®) version 2.0.0 FHIR IG preconfigured via .env file.

If you already have a running Aidbox instance, please refer to the following guide:

Upload FHIR Implementation Guide

Validate example resources against Carin BB profiles

Valid Patient resource

POST /fhir/Patient
content-type: text/yaml
accept: text/yaml

resourceType: Patient
meta:
  lastUpdated: '2020-07-07T13:26:22.0314215+00:00'
  profile:
  - http://hl7.org/fhir/us/carin-bb/StructureDefinition/C4BB-Patient|2.0.0
language: en-US
identifier:
- type:
    coding:
    - system: http://terminology.hl7.org/CodeSystem/v2-0203
      code: MB
  system: https://www.xxxhealthplan.com/fhir/memberidentifier
  value: 1234-234-1243-12345678901
- type:
    coding:
    - system: http://hl7.org/fhir/us/carin-bb/CodeSystem/C4BBIdentifierType
      code: um
  system: https://www.xxxhealthplan.com/fhir/iniquememberidentifier
  value: 1234-234-1243-12345678901u
active: true
name:
- family: Example1
  given:
  - Johnny
telecom:
- system: phone
  value: "[phone]"
  rank: 2
gender: male
birthDate: '1986-01-01'
address:
- type: physical
  line:
  - 123 Main Street
  city: Pittsburgh
  state: PA
  postalCode: '12519'
maritalStatus:
  coding:
  - system: http://terminology.hl7.org/CodeSystem/v3-NullFlavor
    code: UNK

The sample of the Patient resource is invalid because it does not include the required key, meta.lastUpdated. The sample violates the patient-meta-profile-version FHIRPath constraint due to the absence of the version in the profile canonical URL. Additionally, it violates the required slicing on the identifier property due to the absence of a slice identifier with the system http://terminology.hl7.org/CodeSystem/v2-0203 and the value MB.

Invalid Patient resource

POST /fhir/Patient
content-type: text/yaml
accept: text/yaml

resourceType: Patient
meta:
  profile:
  - http://hl7.org/fhir/us/carin-bb/StructureDefinition/C4BB-Patient
language: en-US
identifier:
- type:
    coding:
    - system: http://hl7.org/fhir/us/carin-bb/CodeSystem/C4BBIdentifierType
      code: um
  system: https://www.xxxhealthplan.com/fhir/iniquememberidentifier
  value: 1234-234-1243-12345678901u
active: true
name:
- family: Example1
  given:
  - Johnny
telecom:
- system: phone
  value: "[phone]"
  rank: 2
gender: male
birthDate: '1986-01-01'
address:
- type: physical
  line:
  - 123 Main Street
  city: Pittsburgh
  state: PA
  postalCode: '12519'
maritalStatus:
  coding:
  - system: http://terminology.hl7.org/CodeSystem/v3-NullFlavor
    code: UNK