72.3.1Create an Organization Resource

 

The FHIR Organization resource represents the provider system in the FHIR repository. It serves as the foundation for assigning access permissions and linking provider systems to attributed members.

72.3.1.1Create an Organization Resource

  1. Access the FHIR repository in the Smile CDR instance.
  2. Create a new Organization resource for the provider system.
  3. Include identifying information such as:
    • Name of the provider system
    • Business identifier (NPI and/or other business identifiers used by the provider)
    • OIDC identifier (Client ID used for OAuth / SMART client mapping)
      • identifier.system = https://smiledigitalhealth.com/credentialmap/oidc/client
  4. Tag the resource to indicate that it belongs to the Exchange Directory:
    • meta.tag.system = https://smiledigitalhealth.com/payer-exchange-directory
    • meta.tag.code = Exchange Directory

Example Organization Resource

{
  "resourceType": "Organization",
  "meta": {
    "tag": [
      {
        "system": "https://smiledigitalhealth.com/payer-exchange-directory",
        "code": "Exchange Directory"
      }
    ]
  },
  "identifier": [
    {
      "system": "https://smiledigitalhealth.com/credentialmap/oidc/client",
      "value": "provider-system-client-id"
    },
    {
      "system": "http://hl7.org/fhir/sid/us-npi",
      "value": "1234567893"
    }
  ],
  "name": "ABC Provider System"
}

Notes:

  • Group resources (representing attributed members) will reference this Organization resource for access control.
  • Ensure that identifiers match those used during provider system registration in the IdP.