canvas 0.21.0__py3-none-any.whl → 0.22.1__py3-none-any.whl

canvas_generated/messages/events_pb2.pyi

@@ -108,6 +108,26 @@ class EventType(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
     MEDICATION_STATEMENT__MEDICATION__PRE_SEARCH: _ClassVar[EventType]
     MEDICATION_STATEMENT__MEDICATION__POST_SEARCH: _ClassVar[EventType]
     MEDICATION_STATEMENT__MEDICATION__SELECTED: _ClassVar[EventType]
+    ADJUST_PRESCRIPTION_COMMAND__PRE_ORIGINATE: _ClassVar[EventType]
+    ADJUST_PRESCRIPTION_COMMAND__POST_ORIGINATE: _ClassVar[EventType]
+    ADJUST_PRESCRIPTION_COMMAND__PRE_UPDATE: _ClassVar[EventType]
+    ADJUST_PRESCRIPTION_COMMAND__POST_UPDATE: _ClassVar[EventType]
+    ADJUST_PRESCRIPTION_COMMAND__PRE_COMMIT: _ClassVar[EventType]
+    ADJUST_PRESCRIPTION_COMMAND__POST_COMMIT: _ClassVar[EventType]
+    ADJUST_PRESCRIPTION_COMMAND__PRE_DELETE: _ClassVar[EventType]
+    ADJUST_PRESCRIPTION_COMMAND__POST_DELETE: _ClassVar[EventType]
+    ADJUST_PRESCRIPTION_COMMAND__PRE_ENTER_IN_ERROR: _ClassVar[EventType]
+    ADJUST_PRESCRIPTION_COMMAND__POST_ENTER_IN_ERROR: _ClassVar[EventType]
+    ADJUST_PRESCRIPTION_COMMAND__PRE_EXECUTE_ACTION: _ClassVar[EventType]
+    ADJUST_PRESCRIPTION_COMMAND__POST_EXECUTE_ACTION: _ClassVar[EventType]
+    ADJUST_PRESCRIPTION__PRESCRIBE__POST_SEARCH: _ClassVar[EventType]
+    ADJUST_PRESCRIPTION__PRESCRIBE__PRE_SEARCH: _ClassVar[EventType]
+    ADJUST_PRESCRIPTION__INDICATIONS__PRE_SEARCH: _ClassVar[EventType]
+    ADJUST_PRESCRIPTION__INDICATIONS__POST_SEARCH: _ClassVar[EventType]
+    ADJUST_PRESCRIPTION__PHARMACY__PRE_SEARCH: _ClassVar[EventType]
+    ADJUST_PRESCRIPTION__PHARMACY__POST_SEARCH: _ClassVar[EventType]
+    ADJUST_PRESCRIPTION__CHANGE_MEDICATION_TO__PRE_SEARCH: _ClassVar[EventType]
+    ADJUST_PRESCRIPTION__CHANGE_MEDICATION_TO__POST_SEARCH: _ClassVar[EventType]
     ALLERGY_COMMAND__PRE_ORIGINATE: _ClassVar[EventType]
     ALLERGY_COMMAND__POST_ORIGINATE: _ClassVar[EventType]
     ALLERGY_COMMAND__PRE_UPDATE: _ClassVar[EventType]
@@ -484,6 +504,26 @@ class EventType(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
     REASON_FOR_VISIT_COMMAND__POST_INSERTED_INTO_NOTE: _ClassVar[EventType]
     REASON_FOR_VISIT__CODING__POST_SEARCH: _ClassVar[EventType]
     REASON_FOR_VISIT__CODING__PRE_SEARCH: _ClassVar[EventType]
+    REFER_COMMAND__PRE_ORIGINATE: _ClassVar[EventType]
+    REFER_COMMAND__POST_ORIGINATE: _ClassVar[EventType]
+    REFER_COMMAND__PRE_UPDATE: _ClassVar[EventType]
+    REFER_COMMAND__POST_UPDATE: _ClassVar[EventType]
+    REFER_COMMAND__PRE_COMMIT: _ClassVar[EventType]
+    REFER_COMMAND__POST_COMMIT: _ClassVar[EventType]
+    REFER_COMMAND__PRE_DELETE: _ClassVar[EventType]
+    REFER_COMMAND__POST_DELETE: _ClassVar[EventType]
+    REFER_COMMAND__PRE_ENTER_IN_ERROR: _ClassVar[EventType]
+    REFER_COMMAND__POST_ENTER_IN_ERROR: _ClassVar[EventType]
+    REFER_COMMAND__PRE_EXECUTE_ACTION: _ClassVar[EventType]
+    REFER_COMMAND__POST_EXECUTE_ACTION: _ClassVar[EventType]
+    REFER_COMMAND__REFER_TO__POST_SEARCH: _ClassVar[EventType]
+    REFER_COMMAND__REFER_TO__PRE_SEARCH: _ClassVar[EventType]
+    REFER_COMMAND__INDICATIONS__POST_SEARCH: _ClassVar[EventType]
+    REFER_COMMAND__INDICATIONS__PRE_SEARCH: _ClassVar[EventType]
+    REFER_COMMAND__DOCUMENTS_TO_INCLUDE__POST_SEARCH: _ClassVar[EventType]
+    REFER_COMMAND__DOCUMENTS_TO_INCLUDE__PRE_SEARCH: _ClassVar[EventType]
+    REFER_COMMAND__LINKED_ITEMS__POST_SEARCH: _ClassVar[EventType]
+    REFER_COMMAND__LINKED_ITEMS_INCLUDE__PRE_SEARCH: _ClassVar[EventType]
     REFILL_COMMAND__PRE_ORIGINATE: _ClassVar[EventType]
     REFILL_COMMAND__POST_ORIGINATE: _ClassVar[EventType]
     REFILL_COMMAND__PRE_UPDATE: _ClassVar[EventType]
@@ -518,6 +558,20 @@ class EventType(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
     REMOVE_ALLERGY_COMMAND__POST_INSERTED_INTO_NOTE: _ClassVar[EventType]
     REMOVE_ALLERGY__ALLERGY__PRE_SEARCH: _ClassVar[EventType]
     REMOVE_ALLERGY__ALLERGY__POST_SEARCH: _ClassVar[EventType]
+    RESOLVE_CONDITION_COMMAND__PRE_ORIGINATE: _ClassVar[EventType]
+    RESOLVE_CONDITION_COMMAND__POST_ORIGINATE: _ClassVar[EventType]
+    RESOLVE_CONDITION_COMMAND__PRE_UPDATE: _ClassVar[EventType]
+    RESOLVE_CONDITION_COMMAND__POST_UPDATE: _ClassVar[EventType]
+    RESOLVE_CONDITION_COMMAND__PRE_COMMIT: _ClassVar[EventType]
+    RESOLVE_CONDITION_COMMAND__POST_COMMIT: _ClassVar[EventType]
+    RESOLVE_CONDITION_COMMAND__PRE_DELETE: _ClassVar[EventType]
+    RESOLVE_CONDITION_COMMAND__POST_DELETE: _ClassVar[EventType]
+    RESOLVE_CONDITION_COMMAND__PRE_ENTER_IN_ERROR: _ClassVar[EventType]
+    RESOLVE_CONDITION_COMMAND__POST_ENTER_IN_ERROR: _ClassVar[EventType]
+    RESOLVE_CONDITION_COMMAND__PRE_EXECUTE_ACTION: _ClassVar[EventType]
+    RESOLVE_CONDITION_COMMAND__POST_EXECUTE_ACTION: _ClassVar[EventType]
+    RESOLVE_CONDITION__CONDITION__PRE_SEARCH: _ClassVar[EventType]
+    RESOLVE_CONDITION__CONDITION__POST_SEARCH: _ClassVar[EventType]
     ROS_COMMAND__PRE_ORIGINATE: _ClassVar[EventType]
     ROS_COMMAND__POST_ORIGINATE: _ClassVar[EventType]
     ROS_COMMAND__PRE_UPDATE: _ClassVar[EventType]
@@ -842,6 +896,26 @@ ASSESS_COMMAND__CONDITION_SELECTED: EventType
 MEDICATION_STATEMENT__MEDICATION__PRE_SEARCH: EventType
 MEDICATION_STATEMENT__MEDICATION__POST_SEARCH: EventType
 MEDICATION_STATEMENT__MEDICATION__SELECTED: EventType
+ADJUST_PRESCRIPTION_COMMAND__PRE_ORIGINATE: EventType
+ADJUST_PRESCRIPTION_COMMAND__POST_ORIGINATE: EventType
+ADJUST_PRESCRIPTION_COMMAND__PRE_UPDATE: EventType
+ADJUST_PRESCRIPTION_COMMAND__POST_UPDATE: EventType
+ADJUST_PRESCRIPTION_COMMAND__PRE_COMMIT: EventType
+ADJUST_PRESCRIPTION_COMMAND__POST_COMMIT: EventType
+ADJUST_PRESCRIPTION_COMMAND__PRE_DELETE: EventType
+ADJUST_PRESCRIPTION_COMMAND__POST_DELETE: EventType
+ADJUST_PRESCRIPTION_COMMAND__PRE_ENTER_IN_ERROR: EventType
+ADJUST_PRESCRIPTION_COMMAND__POST_ENTER_IN_ERROR: EventType
+ADJUST_PRESCRIPTION_COMMAND__PRE_EXECUTE_ACTION: EventType
+ADJUST_PRESCRIPTION_COMMAND__POST_EXECUTE_ACTION: EventType
+ADJUST_PRESCRIPTION__PRESCRIBE__POST_SEARCH: EventType
+ADJUST_PRESCRIPTION__PRESCRIBE__PRE_SEARCH: EventType
+ADJUST_PRESCRIPTION__INDICATIONS__PRE_SEARCH: EventType
+ADJUST_PRESCRIPTION__INDICATIONS__POST_SEARCH: EventType
+ADJUST_PRESCRIPTION__PHARMACY__PRE_SEARCH: EventType
+ADJUST_PRESCRIPTION__PHARMACY__POST_SEARCH: EventType
+ADJUST_PRESCRIPTION__CHANGE_MEDICATION_TO__PRE_SEARCH: EventType
+ADJUST_PRESCRIPTION__CHANGE_MEDICATION_TO__POST_SEARCH: EventType
 ALLERGY_COMMAND__PRE_ORIGINATE: EventType
 ALLERGY_COMMAND__POST_ORIGINATE: EventType
 ALLERGY_COMMAND__PRE_UPDATE: EventType
@@ -1218,6 +1292,26 @@ REASON_FOR_VISIT_COMMAND__POST_EXECUTE_ACTION: EventType
 REASON_FOR_VISIT_COMMAND__POST_INSERTED_INTO_NOTE: EventType
 REASON_FOR_VISIT__CODING__POST_SEARCH: EventType
 REASON_FOR_VISIT__CODING__PRE_SEARCH: EventType
+REFER_COMMAND__PRE_ORIGINATE: EventType
+REFER_COMMAND__POST_ORIGINATE: EventType
+REFER_COMMAND__PRE_UPDATE: EventType
+REFER_COMMAND__POST_UPDATE: EventType
+REFER_COMMAND__PRE_COMMIT: EventType
+REFER_COMMAND__POST_COMMIT: EventType
+REFER_COMMAND__PRE_DELETE: EventType
+REFER_COMMAND__POST_DELETE: EventType
+REFER_COMMAND__PRE_ENTER_IN_ERROR: EventType
+REFER_COMMAND__POST_ENTER_IN_ERROR: EventType
+REFER_COMMAND__PRE_EXECUTE_ACTION: EventType
+REFER_COMMAND__POST_EXECUTE_ACTION: EventType
+REFER_COMMAND__REFER_TO__POST_SEARCH: EventType
+REFER_COMMAND__REFER_TO__PRE_SEARCH: EventType
+REFER_COMMAND__INDICATIONS__POST_SEARCH: EventType
+REFER_COMMAND__INDICATIONS__PRE_SEARCH: EventType
+REFER_COMMAND__DOCUMENTS_TO_INCLUDE__POST_SEARCH: EventType
+REFER_COMMAND__DOCUMENTS_TO_INCLUDE__PRE_SEARCH: EventType
+REFER_COMMAND__LINKED_ITEMS__POST_SEARCH: EventType
+REFER_COMMAND__LINKED_ITEMS_INCLUDE__PRE_SEARCH: EventType
 REFILL_COMMAND__PRE_ORIGINATE: EventType
 REFILL_COMMAND__POST_ORIGINATE: EventType
 REFILL_COMMAND__PRE_UPDATE: EventType
@@ -1252,6 +1346,20 @@ REMOVE_ALLERGY_COMMAND__POST_EXECUTE_ACTION: EventType
 REMOVE_ALLERGY_COMMAND__POST_INSERTED_INTO_NOTE: EventType
 REMOVE_ALLERGY__ALLERGY__PRE_SEARCH: EventType
 REMOVE_ALLERGY__ALLERGY__POST_SEARCH: EventType
+RESOLVE_CONDITION_COMMAND__PRE_ORIGINATE: EventType
+RESOLVE_CONDITION_COMMAND__POST_ORIGINATE: EventType
+RESOLVE_CONDITION_COMMAND__PRE_UPDATE: EventType
+RESOLVE_CONDITION_COMMAND__POST_UPDATE: EventType
+RESOLVE_CONDITION_COMMAND__PRE_COMMIT: EventType
+RESOLVE_CONDITION_COMMAND__POST_COMMIT: EventType
+RESOLVE_CONDITION_COMMAND__PRE_DELETE: EventType
+RESOLVE_CONDITION_COMMAND__POST_DELETE: EventType
+RESOLVE_CONDITION_COMMAND__PRE_ENTER_IN_ERROR: EventType
+RESOLVE_CONDITION_COMMAND__POST_ENTER_IN_ERROR: EventType
+RESOLVE_CONDITION_COMMAND__PRE_EXECUTE_ACTION: EventType
+RESOLVE_CONDITION_COMMAND__POST_EXECUTE_ACTION: EventType
+RESOLVE_CONDITION__CONDITION__PRE_SEARCH: EventType
+RESOLVE_CONDITION__CONDITION__POST_SEARCH: EventType
 ROS_COMMAND__PRE_ORIGINATE: EventType
 ROS_COMMAND__POST_ORIGINATE: EventType
 ROS_COMMAND__PRE_UPDATE: EventType

canvas_sdk/commands/__init__.py

@@ -1,3 +1,4 @@
+from canvas_sdk.commands.commands.adjust_prescription import AdjustPrescriptionCommand
 from canvas_sdk.commands.commands.allergy import AllergyCommand
 from canvas_sdk.commands.commands.assess import AssessCommand
 from canvas_sdk.commands.commands.close_goal import CloseGoalCommand
@@ -9,6 +10,7 @@ from canvas_sdk.commands.commands.goal import GoalCommand
 from canvas_sdk.commands.commands.history_present_illness import (
     HistoryOfPresentIllnessCommand,
 )
+from canvas_sdk.commands.commands.imaging_order import ImagingOrderCommand
 from canvas_sdk.commands.commands.instruct import InstructCommand
 from canvas_sdk.commands.commands.lab_order import LabOrderCommand
 from canvas_sdk.commands.commands.medical_history import MedicalHistoryCommand
@@ -21,8 +23,10 @@ from canvas_sdk.commands.commands.plan import PlanCommand
 from canvas_sdk.commands.commands.prescribe import PrescribeCommand
 from canvas_sdk.commands.commands.questionnaire import QuestionnaireCommand
 from canvas_sdk.commands.commands.reason_for_visit import ReasonForVisitCommand
+from canvas_sdk.commands.commands.refer import ReferCommand
 from canvas_sdk.commands.commands.refill import RefillCommand
 from canvas_sdk.commands.commands.remove_allergy import RemoveAllergyCommand
+from canvas_sdk.commands.commands.resolve_condition import ResolveConditionCommand
 from canvas_sdk.commands.commands.review_of_systems import ReviewOfSystemsCommand
 from canvas_sdk.commands.commands.stop_medication import StopMedicationCommand
 from canvas_sdk.commands.commands.structured_assessment import StructuredAssessmentCommand
@@ -32,6 +36,7 @@ from canvas_sdk.commands.commands.update_goal import UpdateGoalCommand
 from canvas_sdk.commands.commands.vitals import VitalsCommand
 
 __all__ = (
+    "AdjustPrescriptionCommand",
     "AllergyCommand",
     "AssessCommand",
     "CloseGoalCommand",
@@ -40,6 +45,7 @@ __all__ = (
     "FollowUpCommand",
     "GoalCommand",
     "HistoryOfPresentIllnessCommand",
+    "ImagingOrderCommand",
     "InstructCommand",
     "LabOrderCommand",
     "MedicalHistoryCommand",
@@ -51,8 +57,10 @@ __all__ = (
     "PhysicalExamCommand",
     "QuestionnaireCommand",
     "ReasonForVisitCommand",
+    "ReferCommand",
     "RefillCommand",
     "RemoveAllergyCommand",
+    "ResolveConditionCommand",
     "ReviewOfSystemsCommand",
     "StopMedicationCommand",
     "StructuredAssessmentCommand",

canvas_sdk/commands/base.py

@@ -132,6 +132,7 @@ class _BaseCommand(Model):
             type=f"ORIGINATE_{self.constantized_key()}_COMMAND",
             payload=json.dumps(
                 {
+                    "command": self.command_uuid,
                     "note": self.note_uuid,
                     "data": self.values,
                     "line_number": line_number,

canvas_sdk/commands/commands/adjust_prescription.py

@@ -0,0 +1,24 @@
+from pydantic import Field
+
+from canvas_sdk.commands.commands.refill import RefillCommand
+
+
+class AdjustPrescriptionCommand(RefillCommand):
+    """A class for managing Adjust Prescription command within a specific note."""
+
+    class Meta:
+        key = "adjustPrescription"
+        commit_required_fields = (
+            "fdb_code",
+            "sig",
+            "quantity_to_dispense",
+            "type_to_dispense",
+            "refills",
+            "substitutions",
+            "prescriber_id",
+            "new_fdb_code",
+        )
+
+    new_fdb_code: str | None = Field(
+        default=None, json_schema_extra={"commands_api_name": "change_medication_to"}
+    )

canvas_sdk/commands/commands/imaging_order.py

@@ -0,0 +1,39 @@
+from enum import Enum
+
+from canvas_sdk.commands.base import _BaseCommand as BaseCommand
+from canvas_sdk.commands.constants import ServiceProvider
+
+
+class ImagingOrderCommand(BaseCommand):
+    """A class for managing an Imaging Order command within a specific note."""
+
+    class Meta:
+        key = "imagingOrder"
+        commit_required_fields = (
+            "image_code",
+            "diagnosis_codes",
+            "ordering_provider",
+        )
+
+    class Priority(Enum):
+        ROUTINE = "Routine"
+        URGENT = "Urgent"
+
+    image_code: str | None = None
+    diagnosis_codes: list[str] = []
+    priority: Priority | None = None
+    additional_details: str | None = None
+    service_provider: ServiceProvider | None = None
+    comment: str | None = None
+    ordering_provider_key: str | None = None
+    linked_items_urns: list[str] | None = None
+
+    @property
+    def values(self) -> dict:
+        """The Imaging Order command's field values."""
+        values = super().values
+
+        if self.is_dirty("service_provider"):
+            values["service_provider"] = self.service_provider.__dict__
+
+        return values

canvas_sdk/commands/commands/instruct.py

@@ -1,4 +1,7 @@
+from pydantic_core import InitErrorDetails
+
 from canvas_sdk.commands.base import _BaseCommand as BaseCommand
+from canvas_sdk.commands.constants import CodeSystems, Coding
 
 
 class InstructCommand(BaseCommand):
@@ -8,5 +11,18 @@ class InstructCommand(BaseCommand):
         key = "instruct"
         commit_required_fields = ("instruction",)
 
-    instruction: str | None = None
+    coding: Coding | None = None
     comment: str | None = None
+
+    def _get_error_details(self, method: str) -> list[InitErrorDetails]:
+        errors = super()._get_error_details(method)
+
+        if (
+            self.coding
+            and self.coding["system"] != CodeSystems.SNOMED
+            and self.coding["system"] != CodeSystems.UNSTRUCTURED
+        ):
+            message = f"The 'coding.system' field must be '{CodeSystems.SNOMED}' or '{CodeSystems.UNSTRUCTURED}'."
+            errors.append(self._create_error_detail("value", message, self.coding))
+
+        return errors

canvas_sdk/commands/commands/lab_order.py

@@ -34,11 +34,16 @@ class LabOrderCommand(BaseCommand):
 
         lab_partner_obj = None
         if self.lab_partner:
-            lab_partner_obj = (
-                LabPartner.objects.filter(Q(name=self.lab_partner) | Q(id=self.lab_partner))
-                .values("id", "dbid")
-                .first()
-            )
+            query = {}
+            try:
+                UUID(str(self.lab_partner))
+            except ValueError:
+                query["name"] = self.lab_partner
+            else:
+                query["id"] = self.lab_partner
+
+            lab_partner_obj = LabPartner.objects.filter(**query).values("id", "dbid").first()
+
             if not lab_partner_obj:
                 errors.append(
                     self._create_error_detail(
@@ -61,7 +66,7 @@ class LabOrderCommand(BaseCommand):
 
                 for code in self.tests_order_codes:
                     try:
-                        uuid_tests.append(UUID(code))
+                        uuid_tests.append(UUID(str(code)))
                     except ValueError:
                         order_code_tests.append(code)
 

canvas_sdk/commands/commands/prescribe.py

@@ -28,7 +28,7 @@ class PrescribeCommand(_BaseCommand):
 
     fdb_code: str | None = Field(default=None, json_schema_extra={"commands_api_name": "prescribe"})
     icd10_codes: conlist(str, max_length=2) = Field(  # type: ignore[valid-type]
-        [], json_schema_extra={"commands_api_name": "indications"}
+        default=[], json_schema_extra={"commands_api_name": "indications"}
     )
     sig: str = ""
     days_supply: int | None = None

canvas_sdk/commands/commands/questionnaire/__init__.py

@@ -0,0 +1,102 @@
+from functools import cached_property
+from typing import Any
+
+from pydantic import Field
+
+from canvas_sdk.commands.base import _BaseCommand
+from canvas_sdk.commands.commands.questionnaire.question import (
+    BaseQuestion,
+    CheckboxQuestion,
+    IntegerQuestion,
+    RadioQuestion,
+    ResponseOption,
+    TextQuestion,
+)
+from canvas_sdk.v1.data import Questionnaire
+
+QUESTION_CLASSES: dict[str, type[BaseQuestion]] = {
+    ResponseOption.TYPE_TEXT: TextQuestion,
+    ResponseOption.TYPE_INTEGER: IntegerQuestion,
+    ResponseOption.TYPE_RADIO: RadioQuestion,
+    ResponseOption.TYPE_CHECKBOX: CheckboxQuestion,
+}
+
+
+class QuestionnaireCommand(_BaseCommand):
+    """A class for managing a Questionnaire command within a specific note."""
+
+    class Meta:
+        key = "questionnaire"
+        commit_required_fields = ("questionnaire_id",)
+
+    questionnaire_id: str | None = Field(
+        default=None, json_schema_extra={"commands_api_name": "questionnaire"}
+    )
+    result: str | None = None
+
+    @cached_property
+    def _questionnaire(self) -> Questionnaire | None:
+        if not self.questionnaire_id:
+            return None
+        return Questionnaire.objects.get(id=self.questionnaire_id)
+
+    @cached_property
+    def questions(self) -> list[BaseQuestion]:
+        """
+        Returns a list of question objects.
+
+        For each question in the questionnaire, creates an instance of the
+        appropriate question subclass based on the question.response_option_set.type.
+        """
+        question_objs: list[BaseQuestion] = []
+        if not self._questionnaire:
+            return question_objs
+
+        for question in self._questionnaire.questions.all():
+            qdata: dict[str, Any] = {
+                "name": f"question-{question.pk}",
+                "label": question.name,
+                "coding": {
+                    "system": question.code_system,
+                    "code": question.code,
+                },
+                "options": [
+                    ResponseOption(
+                        dbid=option.pk, name=option.name, code=option.code, value=option.value
+                    )
+                    for option in question.response_option_set.options.all()
+                ]
+                if question.response_option_set
+                else [],
+            }
+            q_type = question.response_option_set.type if question.response_option_set else None
+            q_obj: BaseQuestion
+            if q_type in QUESTION_CLASSES:
+                question_objs.append(QUESTION_CLASSES[q_type](**qdata))
+            else:
+                raise ValueError(f"Unsupported question type: {q_type}")
+            if q_type == ResponseOption.TYPE_TEXT:
+                q_obj = TextQuestion(**qdata)
+            elif q_type == ResponseOption.TYPE_INTEGER:
+                q_obj = IntegerQuestion(**qdata)
+            elif q_type == ResponseOption.TYPE_RADIO:
+                q_obj = RadioQuestion(**qdata)
+            elif q_type == ResponseOption.TYPE_CHECKBOX:
+                q_obj = CheckboxQuestion(**qdata)
+            else:
+                # This should never happen, but just in case
+                raise ValueError(f"Unsupported question type: {q_type}")
+            question_objs.append(q_obj)
+        return question_objs
+
+    @property
+    def values(self) -> dict:
+        """Return the values for the command.
+
+        For questionnaire-related commands, this includes the responses to the questions.
+        """
+        values = super().values
+
+        values["questions"] = {q.name: q.response for q in self.questions if q.response is not None}
+
+        return values

canvas_sdk/commands/commands/questionnaire/question.py

@@ -0,0 +1,134 @@
+import dataclasses
+from abc import ABC, abstractmethod
+from typing import Any
+
+
+@dataclasses.dataclass
+class ResponseOption:
+    """A response option for a question."""
+
+    TYPE_TEXT = "TXT"
+    TYPE_INTEGER = "INT"
+    TYPE_RADIO = "SING"
+    TYPE_CHECKBOX = "MULT"
+
+    def __init__(self, dbid: int, name: str, code: str, value: str) -> None:
+        self.dbid: int = dbid
+        self.name: str = name
+        self.code: str = code
+        self.value: str = value
+
+    def __eq__(self, other: Any) -> bool:
+        if isinstance(other, ResponseOption):
+            return (
+                self.dbid == other.dbid
+                and self.name == other.name
+                and self.code == other.code
+                and self.value == other.value
+            )
+        return False
+
+    def __repr__(self) -> str:
+        return f"ResponseOption({self.dbid=!r}, {self.name=!r}, {self.code=!r}, {self.value=!r})"
+
+
+class BaseQuestion(ABC):
+    """Base class for questions."""
+
+    type: str
+
+    def __init__(
+        self, name: str, label: str, coding: dict[str, str], options: list[ResponseOption]
+    ) -> None:
+        self.name: str = name
+        self.label: str = label
+        self.coding: dict[str, str] = coding
+        self.options: list[ResponseOption] = options
+        self.response: Any | None = None
+
+    def __repr__(self) -> str:
+        return f"Question({self.name=!r}, {self.label=!r}, {self.type=!r}, {self.options=!r}, {self.response=!r})"
+
+    @abstractmethod
+    def add_response(self, *args: Any, **kwargs: Any) -> None:
+        """Record a response for the question.
+
+        Subclasses will override this to perform type-specific validation.
+        """
+        raise NotImplementedError("Subclasses must implement this method.")
+
+
+class TextQuestion(BaseQuestion):
+    """A question that expects a text response."""
+
+    type = ResponseOption.TYPE_TEXT
+
+    def add_response(self, /, text: str) -> None:
+        """For a text question, the response must be a string."""
+        if not isinstance(text, str):
+            raise ValueError(
+                f"Response for a text question must be a string. Question: {self.label}"
+            )
+        self.response = text
+
+
+class IntegerQuestion(BaseQuestion):
+    """A question that expects an integer response."""
+
+    type = ResponseOption.TYPE_INTEGER
+
+    def add_response(self, /, integer: int) -> None:
+        """For an integer question, the response must be convertible to int."""
+        try:
+            self.response = int(integer)
+        except (ValueError, TypeError) as e:
+            raise ValueError(
+                f"Response for IntegerQuestion must be convertible to an integer. Question: {self.label}"
+            ) from e
+
+
+class RadioQuestion(BaseQuestion):
+    """A question that expects a single-choice response."""
+
+    type = ResponseOption.TYPE_RADIO
+
+    def add_response(self, /, option: ResponseOption) -> None:
+        """Record a radio response.
+
+        Expects a single keyword argument 'option' of type ResponseOption.
+        Validates that the option's value is among the allowed options.
+        """
+        if option not in self.options:
+            raise ValueError(
+                f"Invalid response option for radio question '{self.label}'. Allowed options: {self.options}"
+            )
+
+        self.response = option.dbid
+
+
+class CheckboxQuestion(BaseQuestion):
+    """A question that expects a multiple-choice response."""
+
+    type = ResponseOption.TYPE_CHECKBOX
+
+    def add_response(
+        self, /, option: ResponseOption, selected: bool = True, comment: str = ""
+    ) -> None:
+        """Record a checkbox response.
+
+        Validates that:
+          - 'option' is a ResponseOption.
+          - 'selected' is a bool (defaults to True if not provided).
+          - 'comment' is a string (defaults to empty string if not provided).
+        The response is stored as a list of dictionaries.
+        """
+        if option not in self.options:
+            raise ValueError(
+                f"Invalid response option for checkbox question '{self.label}'. Allowed values: {self.options}"
+            )
+
+        if not self.response:
+            self.response = []
+        self.response.append(
+            {"text": option.name, "value": option.dbid, "comment": comment, "selected": selected}
+        )

canvas_sdk/commands/commands/refer.py

@@ -0,0 +1,50 @@
+from enum import Enum
+
+from canvas_sdk.commands.base import _BaseCommand as BaseCommand
+from canvas_sdk.commands.constants import ServiceProvider
+
+
+class ReferCommand(BaseCommand):
+    """A class for managing a Refer command within a specific note."""
+
+    class Meta:
+        key = "refer"
+        commit_required_fields = (
+            "service_provider",
+            "diagnosis_codes",
+            "clinical_question",
+            "notes_to_specialist",
+        )
+
+    class ClinicalQuestion(Enum):
+        """Clinical question choices."""
+
+        COGNITIVE_ASSISTANCE = "Cognitive Assistance (Advice/Guidance)"
+        ASSISTANCE_WITH_ONGOING_MANAGEMENT = "Assistance with Ongoing Management"
+        SPECIALIZED_INTERVENTION = "Specialized intervention"
+        DIAGNOSTIC_UNCERTAINTY = "Diagnostic Uncertainty"
+
+    class Priority(Enum):
+        """Priority choices."""
+
+        ROUTINE = "Routine"
+        URGENT = "Urgent"
+
+    service_provider: ServiceProvider | None = None
+    diagnosis_codes: list[str] = []
+    clinical_question: ClinicalQuestion | None = None
+    priority: Priority | None = None
+    notes_to_specialist: str | None = None
+    include_visit_note: bool = False
+    comment: str | None = None
+    linked_items_urns: list[str] | None = None
+
+    @property
+    def values(self) -> dict:
+        """The Refer command's field values."""
+        values = super().values
+
+        if self.is_dirty("service_provider"):
+            values["service_provider"] = self.service_provider.__dict__
+
+        return values

canvas_sdk/commands/commands/refill.py

@@ -1,4 +1,10 @@
+from typing import Literal
+
+from django.db.models.expressions import Subquery
+from pydantic_core import InitErrorDetails
+
 from canvas_sdk.commands.commands.prescribe import PrescribeCommand
+from canvas_sdk.v1.data import Medication, Note
 
 
 class RefillCommand(PrescribeCommand):
@@ -15,3 +21,25 @@ class RefillCommand(PrescribeCommand):
             "substitutions",
             "prescriber_id",
         )
+
+    def _get_error_details(
+        self, method: Literal["originate", "edit", "delete", "commit", "enter_in_error"]
+    ) -> list[InitErrorDetails]:
+        errors = super()._get_error_details(method)
+
+        if self.fdb_code:
+            subquery = Subquery(Note.objects.filter(id=self.note_uuid).values("patient_id")[:1])
+            if (
+                not Medication.objects.active()
+                .filter(codings__code=self.fdb_code, patient=subquery)
+                .exists()
+            ):
+                errors.append(
+                    self._create_error_detail(
+                        "value",
+                        f"Medication with fdb_code {self.fdb_code} does not exist.",
+                        self.fdb_code,
+                    )
+                )
+
+        return errors