Prescripción de paracetamol (ATC)

Escenario

Una receta de paracetamol 500 mg que sale de un sistema de atención primaria hacia una farmacia ambulatoria se codifica con ATC (Anatomical Therapeutic Chemical, WHO), el sistema con el que el bus MINSAL agrega estadísticas. La TFC (Terminología Farmacéutica Chilena, ISP) aún no tiene canónico oficial publicado, por lo que esta receta usa solo ATC. Inspect valida que MedicationRequest lleve status, intent, subject y medication[x]: las cuatro reglas cl-medreq-*.

Payload válido

MedicationRequest con ATC

{
  "resourceType": "MedicationRequest",
  "status": "active",
  "intent": "order",
  "medicationCodeableConcept": {
    "coding": [
      {
        "system": "http://www.whocc.no/atc",
        "code": "N02BE01",
        "display": "Paracetamol"
      }
    ],
    "text": "Paracetamol 500 mg comprimido"
  },
  "subject": { "reference": "Patient/example" },
  "authoredOn": "2026-05-12",
  "requester": { "reference": "Practitioner/example" },
  "dosageInstruction": [
    {
      "text": "1 comprimido cada 8 horas por 3 días",
      "timing": {
        "repeat": { "frequency": 3, "period": 1, "periodUnit": "d" }
      },
      "route": {
        "coding": [
          {
            "system": "http://snomed.info/sct",
            "code": "26643006",
            "display": "Vía oral"
          }
        ]
      }
    }
  ],
  "dispenseRequest": {
    "quantity": { "value": 9, "unit": "comprimido" },
    "numberOfRepeatsAllowed": 0
  }
}

Brecha TFC: cuando el ISP/MINSAL publique el canónico oficial de la Terminología Farmacéutica Chilena, se agrega como segundo coding en medicationCodeableConcept.coding[]. Mientras no exista una URI oficial verificable, la receta se codifica solo con ATC.

Cómo validarlo

curl -X POST https://fhiron.cl/api/validate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $FHIRON_API_KEY" \
  -d @medication-request.json

const response = await fetch("https://fhiron.cl/api/validate", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": process.env.FHIRON_API_KEY,
  },
  body: JSON.stringify(medicationRequest),
});
const outcome = await response.json();

import os, requests
response = requests.post(
    "https://fhiron.cl/api/validate",
    headers={
        "Content-Type": "application/json",
        "X-API-Key": os.environ["FHIRON_API_KEY"],
    },
    json=medication_request,
)
outcome = response.json()

Resultado esperado

Si la receta lleva los cuatro campos obligatorios y al menos un coding con system canónico, valid es true e issues[] viene vacío. Errores típicos cuando falta algo:

cl-medreq-01: falta status.
cl-medreq-02: falta intent (la regla más frecuente al migrar desde HIS legacy que no distinguen order / plan / proposal).
cl-medreq-03: falta subject.
cl-medreq-04: falta medication[x] (ni medicationReference ni medicationCodeableConcept).

Tips

ATC hoy, TFC cuando exista: el bus MINSAL agrega estadísticas con ATC. Cuando la TFC tenga canónico oficial publicado, incluir ambos codings en medicationCodeableConcept.coding[] evitará un round-trip de mapeo en el consumidor.

intent=order es para recetas firmadas. Para sugerencias generadas por un asistente clínico usar intent=proposal; para protocolos precargados, intent=plan. La regla cl-medreq-02 no es opinionada sobre cuál usar, solo exige que esté presente.

La cantidad dispensable (dispenseRequest.quantity.value) se calcula desde el tratamiento: 1 comp × 3 veces/día × 3 días = 9 comprimidos. La farmacia no debería tener que recalcular esto.

Vía de administración: SNOMED CT (26643006 = vía oral) es más portable que un código local. Para inyectables, 47625008 (vía intravenosa), 78421000 (vía intramuscular).

Inspect valida este MedicationRequest contra el perfil R4 base y las reglas locales cl-medreq-01..04. Si falta intent, devuelve cl-medreq-02 con quickFix (replacement: "order").

Empezar

IA + MCP

Recetas

Inspect — Validación FHIR

CLI — Línea de comandos

SDK — Validación embebida

Insight — FHIR Score

Sandbox

Conceptos

Seguridad

Legal

Prescripción de paracetamol (ATC)

Escenario

Payload válido

Cómo validarlo

Resultado esperado

Tips

​Escenario

​Payload válido

​Cómo validarlo

​Resultado esperado

​Tips

Escenario

Payload válido

Cómo validarlo

Resultado esperado

Tips