Huli FHIR Core Implementation Guide (R4)
0.1.0 - Release
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
Huli extends FHIR R4 base resources with a small number of profiles for Latin American healthcare contexts and Huli operational metadata. Each extension is documented inline on the StructureDefinition page (see the Artifacts index in the navbar) — this page is a high-level catalog.
| Extension | Notes |
|---|---|
HuliSecondLastname |
Secondary family name on HumanName (multi-surname conventions: LATAM, Iberian, Filipino, etc.). Required for MX patients. |
HuliBloodType |
Bound to HuliBloodTypeVS. |
HuliEthnicity (experimental) |
IG-only. v1 runtime does not emit. |
HuliPrivateInsurance |
Tracks private insurance provider + policy number. |
| Extension | Notes |
|---|---|
HuliConfirmationStatus |
Bound to HuliConfirmationStatusCS. |
HuliCancellationInfo |
Complex extension: who cancelled, when, free-text notes. cancelledBy is a logical reference (identifier under https://huli.io/fhir/identifier/user-id) — see D-013. |
HuliCreatedBy |
Logical reference (identifier under https://huli.io/fhir/identifier/user-id) to the internal user who created the appointment (D-013). |
HuliModifiedBy |
Logical reference (identifier under https://huli.io/fhir/identifier/user-id) to the internal user who last modified the appointment (D-013). |
HuliInsuranceSnapshot |
Point-in-time insurance snapshot at booking. |
All extension URLs are anchored to the IG's canonical (https://fhir.huli.ai/r4)
and emitted as written by the Public API. Partner systems should treat the
URLs published on each extension's StructureDefinition page (linked from the
Artifacts index) as the wire identifier.
Patient.identifier[].type.coding[0] carries the literal Huli identifier
type (CURP, RFC, NSS, INE, CED, DIMEX, DPI, PPN, MR)
under system = http://terminology.hl7.org/CodeSystem/v2-0203 — see
the HuliPatient profile.
These literals (CURP, RFC, etc.) are not standard v2-0203 codes —
the standard set is TAX, NI, SS, PPN, MR, DL, etc.
Huli publishes the source-system literal so a partner reading the FHIR
resource can distinguish CURP (Mexican national identity, RENAPO) from RFC
(Mexican tax ID, SAT) without parsing the system URI — both would
collapse to #TAX under the standard codes, and CURP/INE would collapse
to #NI, losing semantic precision.
| Huli code | Issuer | Country | System URI |
|---|---|---|---|
CURP |
RENAPO (national identity) | MX | http://www.renapo.gob.mx/curp |
RFC |
SAT (tax) | MX | http://www.sat.gob.mx/rfc |
NSS |
IMSS (social security) | MX | http://www.imss.gob.mx/nss |
INE |
INE (voter credential) | MX | http://www.ine.mx/credencial |
CED |
TSE (cédula de identidad) | CR | http://www.tse.go.cr/cedula |
DIMEX |
Dirección de Migración (residence ID) | CR | http://www.migracion.go.cr/dimex |
DPI |
RENAP (national identity) | GT | http://www.renap.gob.gt/dpi |
PPN |
Standard v2-0203 code (passport) | varies | http://hl7.org/fhir/sid/passport-<cc> |
MR |
Standard v2-0203 code (medical rec) | – | (empty, org-local) |
Partner guidance: switch on coding.code (literal), not on a v2-0203
ValueSet match. If/when Huli adopts the standard v2-0203 codes the runtime,
FSH profile, and Patient examples will flip together; the IG canonical URL
(https://fhir.huli.ai/r4) is the source of truth.