" // optional
],
MedicationOrderKeys.kStrength: "10 mg", // optional
MedicationOrderKeys.kFormat: "tablet", // optional
MedicationOrderKeys.kRoute: "oral", // optional
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 SukiAmbientCoreManager.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)
}
```
" // optional
],
MedicationOrderKeys.kStrength: "10 mg", // optional
MedicationOrderKeys.kFormat: "tablet", // optional
MedicationOrderKeys.kRoute: "oral", // optional
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. Optional when this order is included.
The coding system for the medication code. Optional for validation. Must match a supported catalog when you send a coded value.
The medication code. Optional for validation. Must match a supported catalog when you send a coded value.
The medication strength (for example dosage amount with unit). Optional when this order is included.
The dose form (for example tablet, capsule). Optional when this order is included.
The route of administration. Optional 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.
Optional for validation: if provided, include 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. Optional when this order is included. If provided, you should set `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.