FHIR R4 Implementation Guide

KodRx Verified Prescription Profile v1.0

Public Draft

Perfil técnico v1.0 para representar recetas médicas verificables usando FHIR R4, recursos clínicos estándar y trazabilidad KodRx.

Resumen

KodRx representa una receta médica como un FHIR Bundle que contiene datos clínicos estructurados y una capa de trazabilidad verificable mediante Provenance, hash y bloque.

Este perfil no reemplaza FHIR. Define cómo KodRx utiliza FHIR R4 para expresar una receta médica digital verificable.

FHIR R4 Prescription Provenance Verified Bundle KodRx v1.0

Nombre del perfil

KodRx Verified Prescription Bundle v1.0

Tipo actual: Bundle.type = collection

En futuras versiones podrá evolucionar a Bundle.type = document incorporando un recurso Composition.

Recursos soportados

Patient

Representa al paciente de la receta.

Practitioner

Representa al médico emisor y su cédula profesional.

MedicationRequest

Representa cada medicamento prescrito.

Observation

Representa signos vitales como peso, talla, temperatura, IMC y presión arterial.

Condition

Representa el diagnóstico asociado a la receta.

Provenance

Representa la trazabilidad verificable de la receta KodRx.

Recursos obligatorios v1

Bundle
├── Patient
├── Practitioner
├── MedicationRequest mínimo 1
└── Provenance

Recursos opcionales v1

Observation
Condition

Extensiones KodRx

KodRx utiliza extensiones FHIR personalizadas dentro de Provenance.extension. 

https://kodrx.app/fhir/StructureDefinition/hash
https://kodrx.app/fhir/StructureDefinition/block
https://kodrx.app/fhir/StructureDefinition/recetaId

hash

Hash criptográfico asociado a la receta sellada.

block

Número de bloque donde se registró la evidencia de la receta.

recetaId

Identificador interno de la receta KodRx.

Reglas del perfil KodRx v1

1. Todo Bundle KodRx debe incluir Patient.
2. Todo Bundle KodRx debe incluir Practitioner.
3. Todo Bundle KodRx debe incluir al menos un MedicationRequest.
4. Todo MedicationRequest debe referir al Patient.
5. Todo MedicationRequest debe referir al Practitioner.
6. Todo Observation debe referir al Patient.
7. Todo Condition debe referir al Patient.
8. Todo Provenance debe apuntar a los recursos clínicos del Bundle.
9. Todo Provenance debe incluir recetaId.
10. Si la receta está sellada, Provenance debe incluir hash y block.

Ejemplo mínimo

{
  "resourceType": "Bundle",
  "type": "collection",
  "entry": [
    {
      "resource": {
        "resourceType": "Patient"
      }
    },
    {
      "resource": {
        "resourceType": "Practitioner"
      }
    },
    {
      "resource": {
        "resourceType": "MedicationRequest"
      }
    },
    {
      "resource": {
        "resourceType": "Provenance"
      }
    }
  ]
}

Estado

Esta guía corresponde a la versión inicial del perfil KodRx FHIR. Su propósito es documentar la primera implementación pública del exportador FHIR de recetas verificables KodRx. 

FHIR Version: R4

Profile Version: 1.0.0

Supported Resources: 6

Custom Extensions: 3

Last Update: June 2026/pre>