--- title: Chapter 3.1. Register Healthcare Facility Organization Structure code: fhir-tutorial fhir-tutorial-en3 tags: fhir-project-ig --- # Register Healthcare Facility Organization Structure ## Table of Contents [TOC] ## Introduction ![](https://i.imgur.com/DyQX6Y4.png) *<center>fig 1.1 Structure diagram of specialty department in a hospital</center>* Organizational structure of healthcare facility starts from the healthcare facility organization as the parent where this data is stored in FHIR Organization resource. *Organization* can also be used to define different types of departments or units in a healthcare facility. For example in the organization diagram (fig 1.1), it shows a hierarchical tree of parent and child relationships between hospitals, cluster, and specialty department. --- Another example provided in the HL7 FHIR website, there are two *Organization* resources which are [Burgers UMC](https://www.hl7.org/fhir/organization-example-f001-burgers.html) and [Burgers UMC Cardiology unit](https://www.hl7.org/fhir/organization-example-f002-burgers-card.html). The "Burgers UMC" is a hospital and "The Burgers UMC Cardiology unit" is one of unit in the Burgers UMC. #### Organization.partOf When you see the JSON example of [Burgers UMC Cardiology unit](https://www.hl7.org/fhir/organization-example-f002-burgers-card.json.html), you can find a field called “partof” that shows the relation of Burgers UMC Cardiology unit with its parent node, the Burgers UMC Hospital. ![](https://i.imgur.com/ucihrqt.png =500x350) *<center>fig 1.2 Burgers UMC Hospital and Burgers UMC Cardiology unit relation</center>* The field “partof” can link every units in a hospital and show the relation between the parent and child node. When the whole relation are linked, the organization treeview will establish, it is the base for the healthcare system implementation. ## Scope and Data Specification The FHIR Organization can be used to describe data in different scenario as seen below: <table> <tr> <td><b>Scenario 1</b></td> <td>Healthcare facility</td> <td><a href="https://docs.google.com/spreadsheets/d/1u6K00fGyW2begO9RmZat0yyQLOlHSo2eYVOMXno5Q5Y/edit#gid=0&range=D2:G2">Specification</a></td> </tr> <tr> <td><b>Scenario 2</b></td> <td>Department of Healthcare facility</td> <td><a href="https://docs.google.com/spreadsheets/d/1u6K00fGyW2begO9RmZat0yyQLOlHSo2eYVOMXno5Q5Y/edit#gid=0&range=H2:I2">Specification</a></td> </tr> </table> :::info :pushpin: FHIR standard is designed to be flexible and adaptable to various healthcare scenarios, thus the required fields specificiation also different for each scenario. ::: <!--## Data Specification <!--The column SC1, SC2, ..., SCn refers to the mandatory field status in each scenario mentioned in [Scope](https://hackmd.io/qb-3lk2WTLqGTw2zgCiC_Q?both#Scope) part. | NO | VARIABLE | DATA TYPE | SC1 | SC2 | DEFINITION | NOTES | |-|-|-|-|-|-|-| | 1 | Organization.id | string | R | R | Resource ID. ID bisa di generate otomatis dari server-side sesuai sequence dan bisa juga di custom sendiri dari client-side |   | | 2 | Organization.identifier | [Identifier](https://www.hl7.org/fhir/datatypes.html#Identifier) | R | R | Dapat diisi dengan informasi terkait kode/nomor internal suborganisasi yang dimiliki oleh organisasi induk |   | | 3 | Organization.active | boolean | R | R | Status keaktifan data organisasi |   | | 4 | Organization.type | [CodeableConcept](https://www.hl7.org/fhir/datatypes.html#CodeableConcept) | R | R | Tipe organisasi | http=//terminology.hl7.org/CodeSystem/organization-type | | 5 | Organization.name | string | R | R | Nama organisasi |   | | 6 | Organization.alias | string | O | O | Nama lain organisasi |   | | 7 | Organization.telecom | [ContactPoint](https://www.hl7.org/fhir/datatypes.html#ContactPoint) | O | O | Detail narahubung untuk organisasi |   | | 8 | Organization.address | [Address](https://www.hl7.org/fhir/datatypes.html#Address) | R | O | Alamat organisasi |   | | 9 | Organization.partOf | Reference(Organization) | O | R | Wajib diisi apabila organisasi bagian dari organisasi lain (suborganisasi) |   | | 10 | Organization.contact | [BackboneElement](https://www.hl7.org/fhir/backboneelement.html) | O | O | Kontak organisasi untuk tujuan tertentu (billing, administrasi, HR, dll.) |   | | 11 | Organization.contact.purpose | [CodeableConcept](https://www.hl7.org/fhir/datatypes.html#CodeableConcept) | O | O | Tipe narahubung | [http://terminology.hl7.org/CodeSystem/contactentity-type](http://terminology.hl7.org/CodeSystem/contactentity-type) | | 12 | Organization.contact.name | [HumanName](https://www.hl7.org/fhir/datatypes.html#HumanName) | O | O | Nama contact person terkait |   | | 13 | Organization.contact.telecom | [ContactPoint](https://www.hl7.org/fhir/datatypes.html#ContactPoint) | O | O | Detail narahubung (telepon, email, dll.) |   | --> ## Payload ### Format Scenario 1. Healthcare facility ```gherkin= { "resourceType": "Organization", "identifier": [ { "use": "official", "system": "http://misac.org/CodeSystem/organization-id", "value": "{{hospital_internal_code}}" }], "active": {{active_status}}, "type": [ { "coding": [ { "system": "http://terminology.hl7.org/CodeSystem/organization-type", "code": "prov", "display": "Healthcare Provider" } ] } ], "name": "{{hospital_name}}", "telecom": [ { "system": "email", "value": "{{hospital_email}}", "use": "work" }, { "system": "url", "value": "{{hospital_website_url}}", "use": "work" } ], "address": [ { "extension": [ { "url": "https://fhir.kemkes.go.id/r4/StructureDefinition/administrativeCode", "extension": [ { "url": "province", "valueString": "{{hospital_province}}" }, { "url": "city", "valueString": "{{hospital_city}}" }, { "url": "district", "valueString": "{{hospital_district}}" } ] } ], "use": "work", "type": "both", "line": [ "{{hospital_full_address}}" ], "city": "{{hospital_city}}", "postalCode": "{{hospital_postal_code}}", "country": "{{hospital_country}}" } ], "contact": [ { "purpose": { "coding": [ { "system": "http://terminology.hl7.org/CodeSystem/contactentity-type", "code": "ADMIN", "display": "Administrative" } ] }, "name": { "text": "{{hospital_contact_name}}" }, "telecom": [ { "system": "phone", "value": "{{hospital_phone_no}}", "use": "work" } ] } ] } ``` ### Example :::spoiler [Example SC1: Tzu Chi Hospital](https://hapi.fhir.org/baseR4/Organization/1cfef442-08d8-4e43-a256-3ec28b0e3ba9) JSON example ```gherkin= { "resourceType": "Organization", "id": "1cfef442-08d8-4e43-a256-3ec28b0e3ba9", "identifier": [ { "use": "official", "system": "HOSP_RowId", "value": "1" }, { "use": "usual", "system": "HOSP_Code", "value": "8888" } ], "active": true, "type": [ { "coding": [ { "system": "http://terminology.hl7.org/CodeSystem/organization-type", "code": "prov", "display": "Healthcare Provider" } ] } ], "name": "Tzu Chi Hospital", "telecom": [ { "system": "email", "value": "tzuchihospital.ind@gmail.com", "use": "work" }, { "system": "url", "value": "www.tzuchihospital.co.id/", "use": "work" } ], "address": [ { "extension": [ { "url": "https://fhir.kemkes.go.id/r4/StructureDefinition/administrativeCode", "extension": [ { "url": "province", "valueString": "DKI Jakarta" }, { "url": "city", "valueString": "Kota Adm. Jakarta Utara" }, { "url": "district", "valueString": "Penjaringan" } ] } ], "use": "work", "type": "both", "line": [ "Jl. Pantai Indah Kapuk Boulevard. Jakarta Utara 14470" ], "city": "Jakarta", "postalCode": "14470", "country": "ID" } ], "contact": [ { "purpose": { "coding": [ { "system": "http://terminology.hl7.org/CodeSystem/contactentity-type", "code": "ADMIN", "display": "Administrative" } ] }, "name": { "text": "Emergency" }, "telecom": [ { "system": "phone", "value": "(021)50950800", "use": "work" } ] }, { "purpose": { "coding": [ { "system": "http://terminology.hl7.org/CodeSystem/contactentity-type", "code": "ADMIN", "display": "Administrative" } ] }, "name": { "text": "Call Center Telephone" }, "telecom": [ { "system": "phone", "value": "(021)50950888", "use": "work" } ] }, { "purpose": { "coding": [ { "system": "http://terminology.hl7.org/CodeSystem/contactentity-type", "code": "ADMIN", "display": "Administrative" } ] }, "name": { "text": "Call Center WA" }, "telecom": [ { "system": "other", "value": "(+62)811160195", "use": "work" } ] } ] } ``` ::: :::spoiler [Example SC2-1: Cluster Pulmonology](https://hapi.fhir.org/baseR4/Organization/de83fbb6-f8c6-434d-8619-c48f50430984) JSON example ```gherkin= { "resourceType": "Organization", "id": "de83fbb6-f8c6-434d-8619-c48f50430984", "meta": { "versionId": "1", "lastUpdated": "2023-02-23T08:49:50.721+00:00", "source": "#vDGMfLwze7HBdtmH" }, "identifier": [ { "system": "CLUSTER_RowId", "value": "1" }, { "system": "CLUSTER_Code", "value": "CPU" } ], "active": true, "type": [ { "coding": [ { "system": "https://www.hl7.org/fhir/codesystem-organization-type.html", "code": "dept", "display": "Hospital Department" } ], "text": "Hospital Department" } ], "name": "Pulmonology Center", "partOf": { "reference": "Organization/1cfef442-08d8-4e43-a256-3ec28b0e3ba9" } } ``` ::: :::spoiler [Example SC2-2: Cluster Dermatovenerology](https://hapi.fhir.org/baseR4/Organization/7a99eff2-36f3-42ae-817c-a7c66a626580) JSON example ```gherkin= { "resourceType": "Organization", "id": "7a99eff2-36f3-42ae-817c-a7c66a626580", "meta": { "versionId": "4", "lastUpdated": "2024-01-10T03:58:44.804+00:00", "source": "#7z3jxUfXZOJ1a4xg" }, "identifier": [ { "system": "CLUSTER_RowId", "value": "14" }, { "system": "CLUSTER_Code", "value": "CSE" } ], "active": true, "type": [ { "coding": [ { "system": "https://www.hl7.org/fhir/codesystem-organization-type.html", "code": "dept", "display": "Hospital Department" } ], "text": "Hospital Department" } ], "name": "Dermatovenerology Center", "partOf": { "reference": "Organization/1cfef442-08d8-4e43-a256-3ec28b0e3ba9" } } ``` ::: <br> :::info :pushpin: **To search all cluster from Tzu Chi Hospital, use below search parameter**: https://hapi.fhir.org/baseR4/Organization?partof=1cfef442-08d8-4e43-a256-3ec28b0e3ba9 ::: :::spoiler [Example SC2-3: Departemen Spesialis Pulmonology](https://hapi.fhir.org/baseR4/Organization/9f436ce4-f176-4f5d-8ea0-664fbca07f52) JSON example ```gherkin= { "resourceType": "Organization", "id": "9f436ce4-f176-4f5d-8ea0-664fbca07f52", "meta": { "versionId": "1", "lastUpdated": "2023-02-21T11:03:32.708+00:00", "source": "#srWMlqEjTfriasWI" }, "identifier": [ { "system": "DEPT_RowId", "value": "50" }, { "system": "DEPT_Code", "value": "TCHTB" } ], "active": true, "type": [ { "coding": [ { "system": "https://www.hl7.org/fhir/codesystem-organization-type.html", "code": "dept", "display": "Hospital Department" } ], "text": "Hospital Department" } ], "name": "Pulmonology TB Clinic (Lobby)", "partOf": { "reference": "Organization/de83fbb6-f8c6-434d-8619-c48f50430984" } } ``` ::: :::spoiler [Example SC2-4: Departemen Spesialis Kulit (Dermatovenerology)](https://hapi.fhir.org/baseR4/Organization/9f52d975-9780-4d85-8c33-1f898344dc86) JSON example ```gherkin= { "resourceType": "Organization", "id": "9f52d975-9780-4d85-8c33-1f898344dc86", "meta": { "versionId": "2", "lastUpdated": "2024-01-10T04:04:27.018+00:00", "source": "#l30mc0JEXUvLS83s" }, "identifier": [ { "system": "DEPT_RowId", "value": "77" }, { "system": "DEPT_Code", "value": "TCHDER" } ], "active": true, "type": [ { "coding": [ { "system": "https://www.hl7.org/fhir/codesystem-organization-type.html", "code": "dept", "display": "Hospital Department" } ], "text": "Hospital Department" } ], "name": "Dermatovenerology Clinic (5th fl)", "partOf": { "reference": "Organization/7a99eff2-36f3-42ae-817c-a7c66a626580" } } ``` ::: <br> :::info :pushpin: **To search all specialty departement of Pulmonology Cluster, use below search parameter:**: https://hapi.fhir.org/baseR4/Organization?partof=de83fbb6-f8c6-434d-8619-c48f50430984 :::