---
{
  "title": "Extensión de recursos FHIR",
  "description": "La especificación FHIR incluye numerosos recursos que describen distintos tipos de datos médicos. En ocasiones, sin embargo, los recursos básicos son insuficientes para describir los datos; en esos casos, FHIR ofrece los siguientes mecanismos para extender los recursos básicos.",
  "date": "2025-04-11",
  "author": "Ivan Bagrov",
  "reading-time": "4 min",
  "tags": [
    "System Design",
    "FHIR Standard"
  ]
}
---

> For the complete documentation index, see [llms.txt](https://www.health-samurai.io/llms.txt).
> Use it to discover all available pages before guessing URLs.

---
## ¿Qué son las extensiones FHIR?

La especificación FHIR incluye numerosos recursos que describen distintos tipos de datos médicos. En ocasiones, sin embargo, los recursos básicos son insuficientes para describir los datos; en esos casos, FHIR ofrece los siguientes mecanismos para extender los recursos básicos.

Una extensión FHIR es un mecanismo que permite añadir elementos adicionales a los **recursos FHIR** más allá de la especificación base. Esto es necesario para satisfacer los requisitos específicos de distintas implementaciones, manteniendo al mismo tiempo la simplicidad y universalidad del modelo FHIR base.

FHIR proporciona su propio conjunto de [extensiones](/blog/fhir-profiling-extensions). Por ejemplo, para indicar el lugar de nacimiento de un paciente, se propone la siguiente extensión:


```javascript
resourceType: Patient
extension:
  - url: http://hl7.org/fhir/StructureDefinition/patient-birthPlace
    valueAddress: 
      city: Springfield
      district: Sangamon 
      state: Illinois
```


FHIR ofrece extensiones completas que permiten describir objetos más complejos. Por ejemplo:


```javascript
resourceType: Patient
extension:
  - url: http://hl7.org/fhir/StructureDefinition/geolocation
    extension:
      - url: latitude
        valueDecimal: 39.7817
      - url: longitude
        valueDecimal: -89.6501
```


Las extensiones pueden especificarse en la raíz de un recurso, así como en tipos FHIR complejos (HumanName, Address, etc.) y primitivos (string, decimal, code, etc.).

Un ejemplo de cómo especificar una extensión en un tipo complejo:


```javascript
resourceType: Patient
name:
  - use: official
    family: Doe
    given:
      - John
    extension:
      - url: http://hl7.org/fhir/StructureDefinition/humanname-assembly-order
    	 valueCode: F
```


Un ejemplo de cómo especificar una extensión en un tipo primitivo:


```javascript
resourceType: Patient
birthDate: '1985-06-15'
_birthDate:
  extension:
    - url: 'http://hl7.org/fhir/StructureDefinition/patient-birthTime'
      valueDateTime: '1985-06-15T08:30:00-04:00'
```


Si el campo que contiene un valor de tipo primitivo es un array y es necesario especificar una extensión en un elemento concreto de dicho array:


```javascript
resourceType: Patient
name:
  - use: official
    family: Doe
    given:
      - John
      - Michael
    _given:
      extension:
        - null
        - url: http://hl7.org/fhir/StructureDefinition/humanname-assembly-order
    	    valueCode: F
```


Pruébelo en su [servidor FHIR local](https://www.health-samurai.io/fhir-server)

Véase también: [Extensiones FHIR para la gestión de secretos](/blog/fhir-extensions-as-a-bridge-to-external-secret-management).