Huli FHIR Core Implementation Guide (R4) - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

HealthcareService Mapping

HealthcareService Mapping: Huli -> FHIR R4

HealthcareService exposes the bookable services a Huli organization offers, sourced from the organization's service catalog. It is read-only on the Public API; the catalog is managed through the operator-facing platform.

HealthcareService is a discovery resource: a booking client lists the services, then uses the resolved service identity to populate Appointment.serviceType on a create. Access is gated by the booking scope system/Appointment.rs (see Terminology).

The org-service identity rides in type.coding

The Huli organization-service UUID is carried in HealthcareService.type[0].coding under the Huli-defined system https://fhir.huli.ai/r4/CodeSystem/org-service. Clients copy that coding verbatim into Appointment.serviceType.coding when booking, so the appointment is bound to the exact catalog entry.

FHIR path	Notes
HealthcareService.type[0].coding[0].system	https://fhir.huli.ai/r4/CodeSystem/org-service
HealthcareService.type[0].coding[0].code	The org-service UUID (the catalog entry id)
HealthcareService.type[0].coding[0].display	Service name, for human-readable rendering

Every offered specialty is emitted, with a bookable identity

A service may be offered for multiple clinical specialties. HealthcareService.specialty carries one CodeableConcept per offered specialty (not just the first), so a multi-specialty service advertises all of them. A service offered for all specialties (no restriction) carries an empty specialty.

Each specialty CodeableConcept carries up to two codings:

Coding	Notes
https://fhir.huli.ai/r4/CodeSystem/specialty	The global specialty catalog UUID (id_specialty). Bookable — copy it verbatim into Appointment.specialty.coding to book this specialty.
http://snomed.info/sct	The human SNOMED coding (when the catalog entry has one), for human-readable rendering.

HealthcareService.specialty[*].text carries the Spanish display name.

Interactions

Interaction	Supported
read	Yes
search-type	Yes
vread	No
update	No
patch	No
delete	No
history	No
create	No

Read by id via GET /fhir/R4/HealthcareService/{id}; list via GET /fhir/R4/HealthcareService (offset pagination).

Mapping

Huli concept	FHIR path	Cardinality	Notes
Service id (UUID)	HealthcareService.id	1..1	UUID of the catalog entry
Last update	HealthcareService.meta.lastUpdated	0..1	Set by the platform
Active status	HealthcareService.active	0..1	true for bookable services
Service name	HealthcareService.name	1..1	Display name
Org-service identity	HealthcareService.type	0..1	org-service coding (see above)
Specialty	HealthcareService.specialty	0..*	All offered specialties, each with the bookable org-specialty UUID coding (see above)

Search parameters

Parameter	Type	Notes
_id	token	Exact id match
name	string	Filter by service name
specialty	token	Filter by specialty
_count	number	Page size
_offset	number	Offset pagination