{"type":"doc","content":[{"type":"paragraph","content":[{"text":"The Referral Scheduling module adds a full solution for walking a patient through scheduling an appointment with an appropriate provider for the medical service they were referred to.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The Referral Scheduling module is dependent on Orbita Blaze being available and configured.","type":"text"}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"db79492a-36b7-45eb-abf8-27721607d197"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"252009af-b045-45af-a167-80f8795003dc"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Dependencies","type":"text"}]},{"type":"paragraph","content":[{"text":"The Referral Scheduling module is dependent on the following modules:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Project Context","type":"text","marks":[{"type":"underline"},{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659032/4.x+Project+Context"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Utilities","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659054/4.x+Utilities"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Settings","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659083/4.x+Settings"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Error Handling","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659118/4.x+Error+Handling"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Flow Manager","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659179"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Chatbot","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659139"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Provider Service","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659517"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Location Service","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659540"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Patient Service","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659563"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Order Service","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659586"}}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"The Referral Scheduling module will read and respect the values shown below. To add or edit configuration values follow this path: Experience Manager > Create tab > Content component > Settings item > referralScheduling section.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"chatbotSettingsKey (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The key of the chatbot settings to use when the Referral Scheduling page is rendered (","type":"text"},{"text":"see Endpoints","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#Endpoints"}}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"disableKeyboard (boolean): ","type":"text","marks":[{"type":"strong"}]},{"text":"Whether or not keyboard input should be disabled","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"verification (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"Container for verification settings","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"dob (boolean): ","type":"text","marks":[{"type":"strong"}]},{"text":"Whether or not to verify the patient’s date of birth","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"maximumResults (number): ","type":"text","marks":[{"type":"strong"}]},{"text":"The maximum number of results to display. If not specified there will be no limit on the number of results returned.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"appointmentTypes (array):","type":"text","marks":[{"type":"strong"}]},{"text":" An array of appointment type options each with the following properties:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"label (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The display label for the appointment type, used in content and on the selection button","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"description (string, optional): ","type":"text","marks":[{"type":"strong"}]},{"text":"A description of the appointment type","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"schedulingId (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The id for this appointment type in whatever system has been integrated with for scheduling","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"virtualVisit (boolean, optional, default = false): ","type":"text","marks":[{"type":"strong"}]},{"text":"Whether or not this is a virtual visit type.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"sort (array): ","type":"text","marks":[{"type":"strong"}]},{"text":"An array of sort properties for any provider searches, where each entry is an object with a single property, where the key is the sort property name, and the value is a sort direction of either “asc” or “desc”.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ageFilter (boolean): ","type":"text","marks":[{"type":"strong"}]},{"text":"Whether or not to automatically filter by patient age (if available)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"distance (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The distance to search within. Should be in the format “XXmi”. If not specified (or invalid), a default of “50mi” will be used.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"content (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"Container for content settings","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"schedulingPhoneNumber (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The scheduling phone number (offered in certain content)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"healthSystem (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The health system name (used in certain content)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"repeatHealthSystem (string, optional): ","type":"text","marks":[{"type":"strong"}]},{"text":"If filled out, will lead to the health system name being repeated in certain contexts, such as before references to the target service.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"insuranceReminder (boolean): ","type":"text","marks":[{"type":"strong"}]},{"text":"Whether or not to include a reminder to verify that a chosen provider will take the patient’s insurance before scheduling.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"includeReferringProvider (boolean): ","type":"text","marks":[{"type":"strong"}]},{"text":"Whether or not to include the referring provider’s name in content (if available in the referral data).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"includeReferringLocation (boolean): ","type":"text","marks":[{"type":"strong"}]},{"text":"Whether or not to include the referring location name in content (if available in the referral data).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"dobVerificationPhrase (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"A string of content to override the default date of birth verification input phrase.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"nameVerificationPhrase (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"A string of content to override the default name verification input phrase.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"zipCodeTerm (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The term to use in content when referring to a zip code (otherwise the default of “zip code” will be used.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"providerTerm (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The term to use in content when referring to a provider (otherwise the default of “provider” will be used. The term should be something that can be pluralized by adding an “s” to the end.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"onlineManagementReminder (boolean): ","type":"text","marks":[{"type":"strong"}]},{"text":"Whether or not to include a reminder about online appointment management in the sign-off content.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"patientPortal (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"A container for settings for the patient portal link:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"text (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The text for the patient portal link.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"url (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The url for the patient portal link.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"patientPortalServices (array): ","type":"text","marks":[{"type":"strong"}]},{"text":"An array of patient portal services to include in the online management reminder content.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"overrides (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"A container for content overrides.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"targetService (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"A container for target service flow content overrides.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"locationOnly (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"An override for the initial content in the target service flow when only the referring location data is available (and configured to be used).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"providerOnly (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"An override for the initial content in the target service flow when only the referring provider data is available (and configured to be used).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"neither (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"An override for the initial content in the target service flow when neither referring provider or location information is available (or neither is configured to be used).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"both (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"An override for the initial content in the target service flow when both referring provider and location information is available (and both are configured to be used).","type":"text"}]}]}]}]}]}]}]}]}]},{"type":"paragraph","content":[{"text":"The following tokens can be used in content overrides and custom phrases:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"{{patient.firstName}}","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"{{patient.lastName}}","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"{{contentSettings.healthSystem}}","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"{{contentSettings.repeatHealthSystem}}","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"{{contentSettings.providerTerm.singular}}","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"{{contentSettings.providerTerm.plural}}","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"{{contentSettings.providerTerm.capitalized}}","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"{{referral.referringProvider.fullName}}","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"{{referral.referringLocation.name}}","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"{{referral.targetService}}","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"An example of JSON for the above settings:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\"referralScheduling\": {\n \"chatbotSettingsKey\": \"outreach\",\n \"disableKeyboard\": true,\n \"verification\": {\n \"dob\": false\n },\n \"maximumResults\": 10,\n \"appointmentTypes\": [\n {\n \"label\": \"Appointment Type A\",\n \"description\": \"Description of appointment type A\",\n \"schedulingId\": \"A\"\n },\n {\n \"label\": \"Appointment Type B\",\n \"schedulingId\": \"B\"\n }\n ],\n \"sort\": [\n {\n \"customData.isEmployed\": \"desc\"\n },\n {\n \"customData.nextAvailableDate\": \"asc\"\n },\n {\n \"lastName.keyword\": \"asc\"\n }\n ],\n \"ageFilter\": true,\n \"content\": {\n \"schedulingPhoneNumber\": \"1-800-888-5555\",\n \"healthSystem\": \"Valley Health\",\n \"repeatHealthSystem\": \"Valley Health\",\n \"insuranceReminder\": true,\n \"includeReferringProvider\": true,\n \"includeReferringLocation\": true,\n \"dobVerificationPhrase\": \"Custom DOB verification phrase.\",\n \"nameVerificationPhrase\": \"Custom name verification phrase ({{patient.firstName}} {{patient.lastName}})\",\n \"zipCodeTerm\": \"ZIP Code\",\n \"providerTerm\": \"doctor\",\n \"onlineManagementReminder\": true,\n \"patientPortal\": {\n \"text\": \"our patient portal\",\n \"url\": \"https://www.google.com\"\n },\n \"patientPortalServices\": [\n \"service A\",\n \"service B\",\n \"service C\"\n ],\n \"overrides\": {\n \"targetService\": {\n \"locationOnly\": \"

Perfect! Thanks for confirming. Your {{contentSettings.healthSystem}} {{contentSettings.providerTerm.singular}} has referred you to {{contentSettings.repeatHealthSystem}} {{referral.targetService}} as a follow-up to your recent visit at {{referral.referringLocation.name}}.

I'm reaching out to help schedule your follow-up appointment.

\",\n \"providerOnly\": \"

Perfect! Thanks for confirming. Your {{contentSettings.providerTerm.singular}}, {{referral.referringProvider.fullName}}, has referred you to {{contentSettings.repeatHealthSystem}} {{referral.targetService}} as a follow-up to your recent visit.

I'm reaching out to help schedule your follow-up appointment.

\",\n \"neither\": \"

I'm reaching out to help schedule your follow-up appointment.

\",\n \"both\": \"

I'm reaching out to help schedule your follow-up appointment.

\"\n }\n }\n }\n}","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Intermediary Models","type":"text"}]},{"type":"paragraph","content":[{"text":"The following intermediary models are used internally by the solution code, and are exposed under referralScheduling.models in the project context for convenience when writing custom handlers.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Referral","type":"text"}]},{"type":"paragraph","content":[{"text":"This serves as a simpler form of only referral-specific data from an order. The intermediary referral model is:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"id (string):","type":"text","marks":[{"type":"strong"}]},{"text":" The Orbita ID of the order record","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"referringProviderId (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"originProviderId from the order record","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"referringProvider (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"null by default, to be populated by ","type":"text"},{"text":"the loadReferralData handler","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#%5BinlineExtension%5DloadReferralData"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"referringLocationId (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"originLocationId from the order record","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"referringLocation (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"null by default, to be populated by ","type":"text"},{"text":"the loadReferralData handler","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#%5BinlineExtension%5DloadReferralData"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"targetService (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"referral.targetService from the order record, falling back to referralTargetService from the order record","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"targetProviderId (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"referral.targetProviderId from the order record","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"targetProvider (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"null by default, to be populated by ","type":"text"},{"text":"the loadReferralData handler","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#%5BinlineExtension%5DloadReferralData"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"targetProviderName (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"referral.targetProviderName from the order record","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"targetProviderPhone (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"referral.targetProviderPhone from the order record","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"reasonCode (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"referral.reasonCode from the order record","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"customData (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"customData from the order record","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Appointment Slot","type":"text"}]},{"type":"paragraph","content":[{"text":"This serves as a formatted version of appointment slot data that gets submitted when an appointment slot button is clicked in the UI. The intermediary appointment slot model is:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"provider (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The provider data (","type":"text"},{"text":"determined by the getAppointmentSlots handler","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#getAppointmentSlots"}}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"location (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The location data (","type":"text"},{"text":"determined by the getAppointmentSlots handler","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#getAppointmentSlots"}}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"id (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The id of the appointment slot (","type":"text"},{"text":"determined by the getAppointmentSlots handler","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#getAppointmentSlots"}}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"date (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The date portion of the submitted datetime, formatted as “M/D/YYYY”.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"time (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The time portion of the submitted datetime, formatted as “h:mm A”","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Flow Studio Flows","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Verification","type":"text"}]},{"type":"paragraph","content":[{"text":"This is the initial flow the user is brought into as part of the experience. It verifies that the link is still considered active for the user, performs the necessary and configured identity verification, and redirects the user to either the ","type":"text"},{"text":"Target Provider","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#Target-Provider"}}]},{"text":" or ","type":"text"},{"text":"Target Service","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#Target-Service"}}]},{"text":" flow based on the determined referral type.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Target Provider","type":"text"}]},{"type":"paragraph","content":[{"text":"This flow is used when the referral is considered a target provider referral, with initial dialogue and referral confirmation specific to that context, and varying depending on the available referral data and content configuration settings. It will then confirm if the user wants assistance scheduling an appointment, allow the option to specify a different zip code from the one in their record, and perform the search for relevant providers, displaying an appropriate message if no results are found, or moving them on to the ","type":"text"},{"text":"Schedule Appointment","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#Schedule-Appointment"}}]},{"text":" flow otherwise.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Target Service","type":"text"}]},{"type":"paragraph","content":[{"text":"This flow is used for target service referrals, with initial dialogue and referral confirmation similar in some regards to the Target Provider flow, but without reference to a target provider. It confirms that the user wants assistance scheduling an appointment, offers up the same zip code input option, and performs the search for relevant providers, directing them to the ","type":"text"},{"text":"Schedule Appointment","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#Schedule-Appointment"}}]},{"text":" flow if results are found or displaying a message if there were no results.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Schedule Appointment","type":"text"}]},{"type":"paragraph","content":[{"text":"This flow delivers a reminder for the patient to confirm their insurance is accepted (if configured), displays the carousel of results, handles filtering by the user of those results, confirms the appointment that the user selected, returning them to the carousel if they do not confirm or submitting a request to book that appointment when they do confirm. It will end with a sign off message telling the user to look out for further communication about the appointment.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Two filters in particular will be hidden from the display and automatically includes in the requests, the specialty, based on the target service, and (if age filter is enabled in the settings) the age group seen, based on the patient’s age, as determined by their date of birth.","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Handlers","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"isLinkActive","type":"text"}]},{"type":"paragraph","content":[{"text":"This handler is called to determine if a referral link is still active for a patient.","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"patient (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The patient data (","type":"text"},{"text":"see Patient intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659563/Patient+Service#%5BinlineExtension%5DIntermediary-Model"}}]},{"text":").","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Returns: A promise that resolves with a boolean indicating if the link is still active for the particular patient.","type":"text"}]},{"type":"paragraph","content":[{"text":"The default implementation of this handler always returns true.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"loadReferralData","type":"text"}]},{"type":"paragraph","content":[{"text":"This handler is called to load referral data from a particular order.","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"order (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The order data (","type":"text"},{"text":"see Order intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659586/Order+Service#%5BinlineExtension%5DIntermediary-Model"}}]},{"text":").","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Returns: A promise that resolves with the referral data derived from the order (","type":"text"},{"text":"see Referral intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#Referral"}}]},{"text":").","type":"text"}]},{"type":"paragraph","content":[{"text":"The default implementation of this handler attempts to load the following fields from the referenced ID fields (using the appropriate service) on the assumption that the ID is that of an Orbita record:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"referringProvider:","type":"text","marks":[{"type":"strong"}]},{"text":" referringProviderId","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"referringLocation: ","type":"text","marks":[{"type":"strong"}]},{"text":"referringLocationId","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"targetProvider: ","type":"text","marks":[{"type":"strong"}]},{"text":"targetProviderId","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"dobValidationFailed","type":"text"}]},{"type":"paragraph","content":[{"text":"This handler is called when a patient fails to verify their date of birth twice.","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"patient (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The patient data (","type":"text"},{"text":"see Patient intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659563/Patient+Service#%5BinlineExtension%5DIntermediary-Model"}}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"referral (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The referral data (","type":"text"},{"text":"see Referral intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#Referral"}}]},{"text":").","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Returns: Nothing.","type":"text"}]},{"type":"paragraph","content":[{"text":"The default implementation of this handler does nothing.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"nameValidationFailed","type":"text"}]},{"type":"paragraph","content":[{"text":"This handler is called when a patient indicates they are not the named patient.","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"patient (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The patient data (","type":"text"},{"text":"see Patient intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659563/Patient+Service#%5BinlineExtension%5DIntermediary-Model"}}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"referral (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The referral data (","type":"text"},{"text":"see Referral intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#Referral"}}]},{"text":").","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Returns: Nothing.","type":"text"}]},{"type":"paragraph","content":[{"text":"The default implementation of this handler does nothing.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"getReferralType","type":"text"}]},{"type":"paragraph","content":[{"text":"This handler is called to determine if the current referral is for a target service, or a target provider.","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"referral (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The referral data (","type":"text"},{"text":"see Referral intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#Referral"}}]},{"text":").","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Returns: A promise that results with “provider” if the referral is determined to be a target provider referral, “service” otherwise.","type":"text"}]},{"type":"paragraph","content":[{"text":"The default implementation will return “provider” if referral.targetProviderName or referral.targetProvider is available in the referral data, and “service” otherwise.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"selfScheduled","type":"text"}]},{"type":"paragraph","content":[{"text":"This handler is called when a patient answers the question as to whether or not they have already scheduled an appointment.","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"patient (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The patient data (","type":"text"},{"text":"see Patient intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659563/Patient+Service#%5BinlineExtension%5DIntermediary-Model"}}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"referral (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The referral data (","type":"text"},{"text":"see Referral intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#Referral"}}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"didSelfSchedule (boolean):","type":"text","marks":[{"type":"strong"}]},{"text":" True if the patient has indicated that they already self scheduled. False otherwise.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Returns: Nothing.","type":"text"}]},{"type":"paragraph","content":[{"text":"The default implementation of this handler does nothing.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"zipCodeValidationFailed","type":"text"}]},{"type":"paragraph","content":[{"text":"This handler is called if a patient enters an invalid zip code twice.","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"patient (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The patient data (","type":"text"},{"text":"see Patient intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659563/Patient+Service#%5BinlineExtension%5DIntermediary-Model"}}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"referral (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The referral data (","type":"text"},{"text":"see Referral intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#Referral"}}]},{"text":").","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Returns: Nothing.","type":"text"}]},{"type":"paragraph","content":[{"text":"The default implementation of this handler does nothing.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"getAppointmentSlots","type":"text"}]},{"type":"paragraph","content":[{"text":"This handler is called to retrieve available appointment slots for a particular provider, at a particular location, for a certain timeframe.","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"projectId (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The Orbita project ID","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"locationName (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The name of the currently selected location","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"providerId (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The ID of the provider record","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"start (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The start date formatted as “MM-DD-YYYY”","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"end (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The end date formatted as “MM-DD-YYYY”. Only passed for the scope “month”.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"days (number): ","type":"text","marks":[{"type":"strong"}]},{"text":"The number of days to return appointment slots from. Only passed for the scope “next”.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"timezone (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The relevant timezone.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"scope (string):","type":"text","marks":[{"type":"strong"}]},{"text":" “next” for next available appointments, “month” for appointments for a month, “day” for appointments for a specific day.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"type (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The appointment type ID","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"patientId (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The ID of the current patient","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Returns: A promise that resolves with available timeslots, formatted in one of the following manners depending on scope:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"next: ","type":"text","marks":[{"type":"strong"}]},{"text":"An array of results in the following format:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"date (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"Formatted as “MM/DD/YYYY”","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"timeslots (array):","type":"text","marks":[{"type":"strong"}]},{"text":" An array of timeslot strings in the format \"h:mm AM/PM\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"slotId (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"A stringified JSON object containing the following properties:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"locationName (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The name of the currently selected location.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"providerId (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The ID of the provider record","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"data (object):","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"_source (object):","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"location (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"Location data to pass when submitting the appointment request","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"provider (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"Provider data to pass when submitting the appointment request","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"idMapping (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"An object mapping with the timeslot (in the format “h:mm AM/PM”) as the key, and the appointment ID as the value.","type":"text"}]}]}]}]}]}]}]}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The stringified JSON ","type":"text"},{"text":"slotId","type":"text","marks":[{"type":"strong"}]},{"text":" field is a workaround to make sure the appropriate parameters are passed when the “More” button is clicked to request a specific day’s appointments.","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The idMapping property is to work around an issue where the card list does not pass data individually for each button in that context, so a mapping is needed to ascertain the appropriate appointment ID to submit a request for.","type":"text"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"month: ","type":"text","marks":[{"type":"strong"}]},{"text":"An object with the following properties:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"disableDates (array): ","type":"text","marks":[{"type":"strong"}]},{"text":"An array of date strings in the format “MM-DD-YYYY” to disable on the calendar:","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"availableDateDatas (array): ","type":"text","marks":[{"type":"strong"}]},{"text":"An array of available appointment slot data in the following format:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"date (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The date, in the format “MM-DD-YYYY”","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"_id (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"A stringified JSON object containing the following properties:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"locationName (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The name of the currently selected location.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"providerId (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The ID of the provider record","type":"text"}]}]}]}]}]}]}]}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The stringified JSON ","type":"text"},{"text":"_id","type":"text","marks":[{"type":"strong"}]},{"text":" field is a workaround for a product issue to make sure the appropriate parameters are passed when a request for a specific day’s appointments is made.","type":"text"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"day: ","type":"text","marks":[{"type":"strong"}]},{"text":"An array of results in the following format:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"displayName (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The timeslot in the format \"h:mm AM/PM\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"dateTime (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The date in the format “MM-DD-YYYY”","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"data (object):","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"location (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"Location data to pass when submitting the appointment request","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"provider (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"Provider data to pass when submitting the appointment request","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"id (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The ID of the appointment slot","type":"text"}]}]}]}]}]}]}]},{"type":"paragraph","content":[{"text":"The default implementation of this handler serves up dummy appointment slots (with no IDs) that will submit the provider and location data used to populate the cards for the purposes of populating the UI and allowing testing.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"noProvidersFound","type":"text"}]},{"type":"paragraph","content":[{"text":"This handler is called when no providers are found to present to the patient.","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"patient (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The patient data (","type":"text"},{"text":"see Patient intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659563/Patient+Service#%5BinlineExtension%5DIntermediary-Model"}}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"referral (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The referral data (","type":"text"},{"text":"see Referral intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#Referral"}}]},{"text":").","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Returns: Nothing.","type":"text"}]},{"type":"paragraph","content":[{"text":"The default implementation of this handler does nothing.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"submitAppointmentRequest","type":"text"}]},{"type":"paragraph","content":[{"text":"This handler is called when a patient has selected an appointment slot and confirmed that they would like to request it.","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"patient (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The patient data (","type":"text"},{"text":"see Patient intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659563/Patient+Service#%5BinlineExtension%5DIntermediary-Model"}}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"referral (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The referral data (","type":"text"},{"text":"see Referral intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#Referral"}}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"appointmentSlot (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The appointment slot data (","type":"text"},{"text":"see Appointment Slot intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#Appointment-Slot"}}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"appointmentTypeId (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The appointment type ID, if available.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"isVirtualVisit (boolean): ","type":"text","marks":[{"type":"strong"}]},{"text":"Whether or not the appointment is a virtual visit.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Returns: A promise that resolves with an object with the following properties:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"success (boolean): ","type":"text","marks":[{"type":"strong"}]},{"text":"True if the submission of the appointment request was successful, false otherwise","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"confirmation (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"Any confirmation data that would be useful for ","type":"text"},{"text":"the appointmentSuccess handler","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#appointmentSuccess"}}]}]}]}]},{"type":"paragraph","content":[{"text":"The default implementation of this handler returns true for testing purposes, with no confirmation data.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"appointmentSuccess","type":"text"}]},{"type":"paragraph","content":[{"text":"This handler is called when submitAppointmentRequest returns true.","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"patient (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The patient data (","type":"text"},{"text":"see Patient intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659563/Patient+Service#%5BinlineExtension%5DIntermediary-Model"}}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"referral (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The referral data (","type":"text"},{"text":"see Referral intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#Referral"}}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"appointmentSlot (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The appointment slot data (","type":"text"},{"text":"see Appointment Slot intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#Appointment-Slot"}}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"confirmation (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"Any confirmation data passed along by ","type":"text"},{"text":"the submitAppointmentRequest handler","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#submitAppointmentRequest"}}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"isVirtualVisit (boolean): ","type":"text","marks":[{"type":"strong"}]},{"text":"Whether or not the appointment is a virtual visit.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Returns: Nothing.","type":"text"}]},{"type":"paragraph","content":[{"text":"The default implementation of this handler does nothing.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"appointmentFailure","type":"text"}]},{"type":"paragraph","content":[{"text":"This handler is called when submitAppointmentRequest returns false.","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"patient (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The patient data (","type":"text"},{"text":"see Patient intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659563/Patient+Service#%5BinlineExtension%5DIntermediary-Model"}}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"referral (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The referral data (","type":"text"},{"text":"see Referral intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#Referral"}}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"appointmentSlot (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The appointment slot data (","type":"text"},{"text":"see Appointment Slot intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#Appointment-Slot"}}]},{"text":").","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Returns: Nothing.","type":"text"}]},{"type":"paragraph","content":[{"text":"The default implementation of this handler does nothing.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"zipUpdated","type":"text"}]},{"type":"paragraph","content":[{"text":"This handler is called when the user answers the question as to whether or not they want to specify an alternate zip code to search in.","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"patient (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The patient data (","type":"text"},{"text":"see Patient intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659563/Patient+Service#%5BinlineExtension%5DIntermediary-Model"}}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"referral (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The referral data (","type":"text"},{"text":"see Referral intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#Referral"}}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"updatedZip (string): ","type":"text","marks":[{"type":"strong"}]},{"text":"The alternate zip code the user specified. Null if the user did not want to change the search zip code.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"requestedUpdate (boolean):","type":"text","marks":[{"type":"strong"}]},{"text":" True if the patient requested to specify a different zip code. False otherwise.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Returns: Nothing.","type":"text"}]},{"type":"paragraph","content":[{"text":"The default implementation of this handler does nothing.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"filtersApplied","type":"text"}]},{"type":"paragraph","content":[{"text":"This handler is called when the user applies filters to the results in the provider carousel.","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"patient (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The patient data (","type":"text"},{"text":"see Patient intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659563/Patient+Service#%5BinlineExtension%5DIntermediary-Model"}}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"referral (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The referral data (","type":"text"},{"text":"see Referral intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#Referral"}}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"filters (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The applied filter data.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Returns: Nothing.","type":"text"}]},{"type":"paragraph","content":[{"text":"The default implementation of this handler does nothing.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"selectedAppointmentType","type":"text"}]},{"type":"paragraph","content":[{"text":"This handler is called when an appointment type has been selected.","type":"text"}]},{"type":"paragraph","content":[{"text":"Parameters:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"patient (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The patient data (","type":"text"},{"text":"see Patient intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659563/Patient+Service#%5BinlineExtension%5DIntermediary-Model"}}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"referral (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The referral data (","type":"text"},{"text":"see Referral intermediary model","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#Referral"}}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"appointmentType (object): ","type":"text","marks":[{"type":"strong"}]},{"text":"The appointment type.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Returns: Nothing.","type":"text"}]},{"type":"paragraph","content":[{"text":"The default implementation of this handler does nothing.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Overriding Handlers","type":"text"}]},{"type":"paragraph","content":[{"text":"Any of the above handlers can be overridden with a custom version by using the registerHandler method exposed by the Referral Scheduling module. For example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"const { referralScheduling } = flow.get(\"project\");\n\nconst getAppointmentSlots = (projectId, locationName, providerId, start, end, timezone, scope) => {\n // Your custom handler\n};\n\nreferralScheduling.registerHandler(\"getAppointmentSlots\", getAppointmentSlots);","type":"text"}]},{"type":"paragraph","content":[{"text":"Your custom handler can accept any of the documented parameters and there is an expectation that it will return an appropriate value for handlers expected to return something.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Endpoints","type":"text"}]},{"type":"paragraph","content":[{"text":"The Referral Scheduling solution establishes the following endpoints:","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"[GET] /oeapi/[Hyphenated Project Name]/referral-scheduling/:channel/:token","type":"text"}]},{"type":"paragraph","content":[{"text":"This endpoint will render a page using the chatbot settings defined in the settings (or a default of the “outreach” chatbot settings included with the Chatbot module) that brings the user directly into ","type":"text"},{"text":"the Verification flow","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#Verification"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"The channel will be passed along in custom data based on the following mapping:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"e:","type":"text","marks":[{"type":"strong"}]},{"text":" “email”","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"s:","type":"text","marks":[{"type":"strong"}]},{"text":" “sms”","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"[any other values]: ","type":"text","marks":[{"type":"strong"}]},{"text":"null","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"[GET] /oeapi/[Hyphenated Project Name]/referral-scheduling/:token","type":"text"}]},{"type":"paragraph","content":[{"text":"This endpoint serves the same purpose as the above endpoint, but covers cases where there is no channel to specify. The channel will come through as null in the custom data.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"[GET/POST] /oeapi/[Project ID]/getAppointmentSlots/:scope/:patientId","type":"text"}]},{"type":"paragraph","content":[{"text":"These endpoints serve requests made by the provider carousel to get available appointments for a particular provider in several different UI contexts.","type":"text"}]},{"type":"paragraph","content":[{"text":"Allowed scopes are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"next: ","type":"text","marks":[{"type":"strong"}]},{"text":"Intended for getting the next available appointments for a provider from the next X (default 3) days that they have appointments.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"month: ","type":"text","marks":[{"type":"strong"}]},{"text":"Intended for getting all available appointments for the provider for a particular month.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"day: ","type":"text","marks":[{"type":"strong"}]},{"text":"Intended for getting all available appointments for the provider on a particular day.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Depending on the scope, appropriate parameters will be passed to ","type":"text"},{"text":"the getAppointmentSlots handler","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#getAppointmentSlots"}}]},{"text":" which is responsible for retrieving slots and formatting them in an appropriate manner based on the scope.","type":"text"}]},{"type":"paragraph","content":[{"text":"Specifying an unknown scope will result in a 400 error.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"[GET/POST] /oeapi/[Project ID]/getAppointmentSlotsByType/:type/:scope/:patientId","type":"text"}]},{"type":"paragraph","content":[{"text":"These endpoints serve the same purpose as the above endpoints, but with an extra parameter for the appointment type ID that will get passed through to ","type":"text"},{"text":"the getAppointmentSlots handler","type":"text","marks":[{"type":"link","attrs":{"href":"https://orbita.atlassian.net/wiki/spaces/OCS/pages/3323659609/Referral+Scheduling#getAppointmentSlots"}}]},{"text":" when available.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Context","type":"text"}]},{"type":"paragraph","content":[{"text":"A context to limit provider results to only a subset of the Blaze data on an environment can be set in session at msg.orbita.session.modules.referralScheduling.context.","type":"text"}]},{"type":"paragraph","content":[{"text":"It can be either a string or an array of strings. If set, an additional filter will be applied on the backend to all request to limit results to only those provider records with a value set at customData.context that matches the context set in session.","type":"text"}]}],"version":1}

Browser not supported