Extensions

Clinical Documentation & Care Planning

Carry the person’s story and responsibilities into the next step.

Prepare forms

Configure approved questionnaires, clinical forms and author permissions for the care setting. Define required fields, terminology and review responsibility before use.

  • Clinical documentation owner
  • Questionnaire, form version and author roles
View the full workflow
01 / 04
01

Clinical Documentation & Care Planning

From the first action to the final record.

01

Prepare forms

Configure approved questionnaires, clinical forms and author permissions for the care setting. Define required fields, terminology and review responsibility before use.

Responsible team
Clinical documentation owner
Data & records
Questionnaire, form version and author roles
02

Document the encounter

Capture the assessment, observations, conditions and clinical narrative against the correct encounter. Keep structured responses and attachments linked to the patient and responsible author.

Responsible team
Clinician and nurse
Data & records
Notes, questionnaire responses, observations and attachments
03

Review & complete

Review required information and the care plan. Apply the approved completion and signature process for the selected release, then make the relevant record available to authorized receiving teams.

Responsible team
Author and clinical reviewer
Data & records
Completion status, reviewer and care-plan record
04

Amend & retain

Handle corrections with an identified author and reason. Agree retention and record access, and preserve relevant versions and audit evidence when documentation is used for coding or external exchange.

Responsible team
Records and governance team
Data & records
Amendment reason, audit evidence and retention decision
02

Your configuration

The data that makes this module yours.

  1. Download the template for your account’s selected release.
  2. Use the sample to understand formats; replace every example with approved data.
  3. Load parent records first, then use their exact identifiers in dependent files.
  4. Upload in the named setup step, fix validation errors and review the preview.
  5. Apply and save; test the workflow and record approval before activation.
Your organizationorganization.csvAccount configuration

Use the registered details of your organization. Do not enter patient records here.

Upload in the matching account setup step, review the preview, apply the values and Save and continue. The tenant version may define different columns; download its template inside setup.

Columns, formats and example values
ColumnRequiredFormatExample
Registered organization namelegal_nameYestextExample Healthcare Organization
Commercial registration numberregistration_numberYestextEXAMPLE-CR-001
CountrycountryYesSA / AE / BH / KW / QA / OM / EG / OTHERSA
Tax registration numbervat_numberOptionaltext—
Facilitiesfacilities.csvAccount configuration

Add every facility included in your subscription. These become real, separate facilities in your app.

Upload in the matching account setup step, review the preview, apply the values and Save and continue. The tenant version may define different columns; download its template inside setup.

Load / review first: Your organization

Columns, formats and example values
ColumnRequiredFormatExample
Facility namenameYestextExample Facility
Facility typetypeYeshospital / clinic / polyclinic / laboratory / otherclinic
Facility licenselicense_numberYestextEXAMPLE-LICENSE-001
AddressaddressYestextExample training address
PhonephoneYestext+966500000000
Time zonetimezoneYesAsia/Riyadh / Asia/Dubai / Asia/Qatar / Africa/Cairo / UTCAsia/Riyadh
Departmentsdepartments.csvAccount configuration

Create departments, consultation rooms, wards and beds. You can add more inside your app.

Upload in the matching account setup step, review the preview, apply the values and Save and continue. The tenant version may define different columns; download its template inside setup.

Load / review first: Facilities

Columns, formats and example values
ColumnRequiredFormatExample
Facility number (starting at 1)facilityYesinteger 1–10001
Department namenameYestextExample Department
Rooms, wards and bedslocations.csvAccount configuration

Create departments, consultation rooms, wards and beds. You can add more inside your app.

Upload in the matching account setup step, review the preview, apply the values and Save and continue. The tenant version may define different columns; download its template inside setup.

Load / review first: Facilities

Columns, formats and example values
ColumnRequiredFormatExample
Facility numberfacilityYesinteger 1–10001
Location namenameYestextExample Room
TypekindYesroom / ward / bedroom
Inside location (optional)parentOptionaltext—
Planned teamstaff.csvAccount configuration

Your verified account becomes the facility administrator. Invite staff in the account portal; staff seats are enforced.

Upload in the matching account setup step, review the preview, apply the values and Save and continue. The tenant version may define different columns; download its template inside setup.

Columns, formats and example values
ColumnRequiredFormatExample
NamenameYestextExample Staff
Work emailemailYesemailstaff@example.invalid
Clinical roleroleYesfacility_admin / doctor / nurse / pharmacist / reception / billing / memberdoctor
Roles & permissionsroles.csvAccount configuration

Security roles and explicit permissions

Upload in Your products · configuration data. Apply, then Save and continue checks cross-file references. Launch imports supported records in one transaction and reconciles counts. Function settings are validated against the supported registry, applied natively and read back; prices, catalogue mappings and hardware require approval before activation.

Columns, formats and example values
ColumnRequiredFormatExample
Role namerole_nameYestextExample scheduling role
Permission identifierpermission_slugYestextcan_list_schedule
Users & department accessuser_access.csvAccount configuration

Facility organization memberships

Upload in Your products · configuration data. Apply, then Save and continue checks cross-file references. Launch imports supported records in one transaction and reconciles counts. Function settings are validated against the supported registry, applied natively and read back; prices, catalogue mappings and hardware require approval before activation.

Load / review first: Planned team · Departments · Roles & permissions

Columns, formats and example values
ColumnRequiredFormatExample
Staff emailstaff_emailYesemailstaff@example.invalid
Facility numberfacilityYesinteger 1–10001
Department namedepartmentYestextExample Department
Approved role namerole_nameYestextDoctor
Function settings · scheduling closuresproduct_settings.csvAccount configuration

Registry function settings applied to native scheduling closures with readback

Upload in Your products · configuration data. Apply, then Save and continue checks cross-file references. Launch imports supported records in one transaction and reconciles counts. Function settings are validated against the supported registry, applied natively and read back; prices, catalogue mappings and hardware require approval before activation.

Load / review first: Rooms, wards and beds

Columns, formats and example values
ColumnRequiredFormatExample
Facility numberfacilityYesinteger 1–10001
Selected feature IDfeatureYesschedulingscheduling
Function settingfunction_keyYesscheduling.closuresscheduling.closures
Closure namenameYestextExample closure
First closed datevalid_fromYesYYYY-MM-DD2026-12-01
Last closed datevalid_toYesYYYY-MM-DD2026-12-01
Closed fromstart_timeYesHH:MM08:00
Closed untilend_timeYesHH:MM17:00
Room (blank closes the whole facility)locationOptionaltextExample Room
Project scopeproject_scope.csvImplementation record

Freeze products, versions, facilities, delivery mode and acceptance scope.

Upload in Account setup → Implementation files & acceptance evidence. The data is saved in your account implementation records. Review with the named owner, record approval and attach the evidence. This register records decisions; it does not activate production configuration.

Columns, formats and example values
ColumnRequiredFormatExample
Catalogue product IDproduct_idYestextoutpatient
Agreed releasereleaseYestextTO-CONFIRM
Operating modemodeYesnative / connectednative
Facility scopefacility_scopeYestextall
Included in this projectincludedYestrue / falsetrue
Accountable roleowner_roleYestextProject owner
Acceptance evidenceacceptance_testYestextApproved end-to-end test
Approval referenceapproval_referenceYestextEXAMPLE-REF-001
Access & approvalsaccess_matrix.csvImplementation record

Map roles to permitted actions and verify access across facility boundaries.

Upload in Account setup → Implementation files & acceptance evidence. The data is saved in your account implementation records. Review with the named owner, record approval and attach the evidence. This register records decisions; it does not activate production configuration.

Load / review first: Facilities · Planned team

Columns, formats and example values
ColumnRequiredFormatExample
RoleroleYestextdoctor
Facility scopefacility_scopeYestextEXAMPLE-FACILITY-001
ResourceresourceYestextPatient record
ActionactionYestextread
AllowedallowedYestrue / falsetrue
Approverapprover_roleYestextSecurity owner
Test evidenceevidence_referenceYestextEXAMPLE-REF-001
Clinical workflow configurationclinical_workflows.csvImplementation record

Record locally approved pathways, responsibilities and exception handling.

Upload in Account setup → Implementation files & acceptance evidence. The data is saved in your account implementation records. Review with the named owner, record approval and attach the evidence. This register records decisions; it does not activate production configuration.

Load / review first: Departments · Access & approvals

Columns, formats and example values
ColumnRequiredFormatExample
Workflow IDworkflow_idYestextEXAMPLE-WF-001
Product IDproduct_idYestextoutpatient
Entry evententry_eventYestextPatient arrival
Responsible roleresponsible_roleYestextNurse
Required informationrequired_informationYestextVerified identity and visit context
Next eventnext_eventYestextClinical consultation
Handover ownerhandover_ownerYestextDoctor
Exception pathexception_pathYestextIdentity mismatch to review
Workflow approvalapproval_referenceYestextEXAMPLE-REF-001
Acceptance testsuat_cases.csvImplementation record

Record complete positive, negative, boundary, access and failure tests per product.

Upload in Account setup → Implementation files & acceptance evidence. The data is saved in your account implementation records. Review with the named owner, record approval and attach the evidence. This register records decisions; it does not activate production configuration.

Load / review first: Project scope · Clinical workflow configuration

Columns, formats and example values
ColumnRequiredFormatExample
Test IDtest_idYestextUAT-001
Product IDproduct_idYestextoutpatient
ScenarioscenarioYestextVisit from arrival to financial follow-up
PreconditionspreconditionsYestextApproved setup and synthetic data
Exact actionsactionsYestextTO-CONFIRM
Expected resultexpected_resultYestextTO-CONFIRM
Actual resultactual_resultYestextNOT-RUN
StatusstatusYesnot_run / pass / fail / blockednot_run
Evidence referenceevidence_referenceYestextEXAMPLE-REF-001
Approverapprover_roleYestextProduct owner
Open the full implementation handbook: assumptions, migration, interfaces, acceptance and cutover
03

Illustrative operating cases

Two cases. Every handover explained.

01Illustrative scenario

Structured consultation and completed care plan

A clinician uses an approved form to document a visit for downstream care and coding.

Prepare first
Form version, required fields, clinical terminology, author and reviewer permissions.
  1. Open the correct patient and encounter and choose the approved form.
  2. Capture structured findings, clinical narrative, observations and attachments.
  3. Review completeness and apply the release-specific completion process.
  4. Make the accepted documentation available to the authorized care and coding teams.

Acceptance evidence

The form version, author, encounter and required information can be identified without inferred findings.

02Illustrative scenario

Correction after documentation is completed

An author discovers a missing or incorrect item in a previously completed record.

Prepare first
Authorized amendment route, reason recording, retention and affected downstream references.
  1. Identify the original note, encounter and information requiring correction.
  2. Have the authorized author or reviewer record the correction and reason.
  3. Preserve the original context and the supported amendment evidence.
  4. Review whether orders, coding or communicated reports need follow-up.

Acceptance evidence

The correction has an owner and reason and does not silently erase the original documentation context.

04

Worked operating scenarios

When the normal path changes.

Incorrect encounter or author

Route the correction to an authorized reviewer, preserve the original context and verify downstream coding and report references.

Required field is missing

Identify the responsible author and complete the missing information; do not substitute an assumed clinical finding.

05

Delivery boundary

Know what connects, and what needs approval.

Documentation supplies clinical context to orders, handovers and coding. External document exchange, signatures and retention policies must match the accepted release and organization rules.

Operating modes
Native
Product readiness
Scope review required for your release
Supported release
Confirm in the accepted scope

Your questions, answered.

What does MANSOQ Clinical Documentation & Care Planning cover?

Required clinician and nursing documentation, observations, forms, care plans and handovers as defined for the selected care workflow. Prepare forms: Configure approved questionnaires, clinical forms and author permissions for the care setting. Define required fields, terminology and review responsibility before use. Document the encounter: Capture the assessment, observations, conditions and clinical narrative against the correct encounter. Keep structured responses and attachments linked to the patient and responsible author. Review & complete: Review required information and the care plan. Apply the approved completion and signature process for the selected release, then make the relevant record available to authorized receiving teams. Amend & retain: Handle corrections with an identified author and reason. Agree retention and record access, and preserve relevant versions and audit evidence when documentation is used for coding or external exchange.

Explore the details
What setup data does Clinical Documentation & Care Planning need?

Configure the selected release using the account templates, then validate references and preview before import. Required planning and setup files include Clinical workflow configuration (clinical_workflows.csv); Roles & permissions (roles.csv); Users & department access (user_access.csv); Function settings · scheduling closures (product_settings.csv); Acceptance tests (uat_cases.csv). Each file’s field guide identifies whether it imports setup records or documents a migration/decision.

Explore the details
How does Clinical Documentation & Care Planning handle exceptions?

Incorrect encounter or author Route the correction to an authorized reviewer, preserve the original context and verify downstream coding and report references. Required field is missing Identify the responsible author and complete the missing information; do not substitute an assumed clinical finding.

Explore the details
How does Clinical Documentation & Care Planning connect with other systems?

Documentation supplies clinical context to orders, handovers and coding. External document exchange, signatures and retention policies must match the accepted release and organization rules.

Explore the details
Explore all frequently asked questions