" // required
],
MedicationOrderKeys.kStrength: "10 mg", // required
MedicationOrderKeys.kFormat: "tablet", // required
MedicationOrderKeys.kRoute: "oral", // required
MedicationOrderKeys.kLinkedDiagnosisCodes: [
[
SukiAmbientConstant.kCodeType: "ICD-10",
SukiAmbientConstant.kCode: "E78.5"
]
],
MedicationOrderKeys.kMetadata: [
MedicationOrderKeys.kOrigin: "EMR",
MedicationOrderKeys.kEncounterRelation: "CURRENT_ENCOUNTER"
]
// Optional: MedicationOrderKeys.kDosage, kFrequency, kMedicationTiming, kStatus, kQuantityDispensed, kNumberOfRefills, kStartDate, kEndDate, kDurationInDays, kInstructions, etc
]
]
]
]
try SukiAmbientCore.shared.setSessionContext(with: contextDetail) { result in
switch result {
case .success:
print("Context updated successfully")
case .failure(let error):
print("Error updating context: \(error)")
}
}
} catch {
print(error)
}
```
" // required
],
MedicationOrderKeys.kStrength: "10 mg", // required
MedicationOrderKeys.kFormat: "tablet", // required
MedicationOrderKeys.kRoute: "oral", // required
MedicationOrderKeys.kLinkedDiagnosisCodes: [
[SukiAmbientConstant.kCodeType: "ICD-10", SukiAmbientConstant.kCode: "E78.5"]
],
MedicationOrderKeys.kMetadata: [
MedicationOrderKeys.kOrigin: "EMR",
MedicationOrderKeys.kEncounterRelation: "CURRENT_ENCOUNTER"
]
]
]
]
```
Each object in the `MedicationOrderKeys.kMedicationOrders` array can include the following. The **payload keys** checklist above defines the minimum; the `ResponseField` entries use Swift constant names for the same rules.
The medication name. Required when this order is included in the array.
The coded medication identifier. Required when this order is included.
The coding system for the medication code. Required for validation. Must match a supported catalog when you send a coded value.
The medication code. Required for validation. Must match a supported catalog when you send a coded value.
The medication strength (for example dosage amount with unit). Required when this order is included.
The dose form (for example tablet, capsule). Required when this order is included.
The route of administration. Required when this order is included.
Optional structured dosage information.
Free-text dosage as entered in your system.
Numeric quantity for the dose.
Unit for the quantity. When used as a coded field, must match a supported catalog.
Optional dosing frequency. Uses the same inner keys as `MedicationOrderKeys.kMedicationTiming`.
Free-text frequency.
Structured frequency value. When used as a coded field, must match a supported catalog.
Quantity dispensed.
Number of refills.
Start date for the order when you supply it through context bridging.
End date for the order.
Duration of therapy in days.
Patient- or pharmacy-facing instructions.
Optional timing details for the medication. Same shape as `MedicationOrderKeys.kFrequency`.
Free-text timing.
Structured timing value. When used as a coded field, must match a supported catalog.
Required for validation: at least one object. Each array element uses `code_type` and `code` (`SukiAmbientConstant.kCodeType` and `SukiAmbientConstant.kCode` in Swift).
The coding system for the diagnosis (for example "ICD-10"). Must match a supported catalog when you send a coded value.
The diagnosis code. Must match a supported catalog when you send a coded value.
Order status. When used as a coded field, must match a supported catalog.
Provenance for the order. Required when this order is included. You must set both `origin` and `encounter_relation` under `metadata` (use `MedicationOrderKeys.kOrigin` and `MedicationOrderKeys.kEncounterRelation` in Swift). Each value must be non-empty after trim and must be one of the allowed strings below.
**Payload key** `origin`. Where the order came from. Valid values: `SUKI_AMBIENT`, `EMR`.
**Payload key** `encounter_relation`. How the order relates to the encounter. Valid values: `PRIOR_ENCOUNTER`, `CURRENT_ENCOUNTER`.
This field is **required** if the origin is EMR.