> For the complete documentation index, see [llms.txt](https://razortheory.gitbook.io/financial-assurance-module-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://razortheory.gitbook.io/financial-assurance-module-documentation/product-end-user-documentation/engagements/how-to-add-new-engagement.md). # Creation of Engagement {% hint style="info" %} Creation of Engagement is available for **UNICEF Focal Point** user. See more details about user rights in the ["User roles and permissions" ](/financial-assurance-module-documentation/product-end-user-documentation/overview/user-roles-and-permissions.md)article. {% endhint %} User can **Add** **New Engagement** by clicking the "Add New Engagement" button, placed in the upper right-hand corner of the Engagements screen. ![Add New Engagement button](https://3140720386-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJxF2RKg63Q700gpAQ8%2F-LK1sD2-EPJjPvOHrRz_%2F-LK1saQXiJsOd8Kt8PS1%2F5.png?alt=media\&token=13293471-0632-412a-8330-360504eef486) The following screen is opened after the user clicks the "Add New Engagement" button: ![Add New Engagement screen](https://3140720386-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJxF2RKg63Q700gpAQ8%2F-LK1sD2-EPJjPvOHrRz_%2F-LK1tU325llGYwJhDPga%2F6.png?alt=media\&token=e9d72b4d-e621-4796-a9ff-0748b9646c47) {% hint style="info" %} User can create 4 different types of Engagements: Audit, Micro Assessment, Spot Check and Special Audit. Each Engagement type has some differences comparing to the other ones, and they will be discussed in details in the corresponding sections. {% endhint %} There are **3 sections** displayed on the screen: * Engagement Overview tab * Attachment tab * Status panel with "Create" button. Click on each tab below for more details: {% tabs %} {% tab title="Engagement Overview tab" %} Engagement Overview tab includes the following **sections**: * Engagement Overview * Partner Details * Audit Staff Team Members * Specific Procedure To Be Performed (only for Special Audit) ## Engagement Overview section Displayed fields in this section vary depending on the type of the Engagement, that was chosen (Audit, MA, SC, Special Audit). **Example** (Audit type is selected): ![Engagement Overview for Audit Engagement](https://3140720386-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJxF2RKg63Q700gpAQ8%2F-LK1sD2-EPJjPvOHrRz_%2F-LK1usnUjBWJ8DQO3OxL%2F7.png?alt=media\&token=12629776-581d-45be-b58d-e77325e41289) {% hint style="info" %} If Audit or Spot check Engagement type is selected, user can see the tool-tip, that on mouse hover reminds to attach the required documents. {% endhint %} ![Tool-tip with the reminder](https://3140720386-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJxF2RKg63Q700gpAQ8%2F-LK1sD2-EPJjPvOHrRz_%2F-LK1w-RQOqdy_nBn-9xF%2F8.png?alt=media\&token=a10ece03-2a74-4587-8b35-f4e345cdacaa) Some fields (PO Date, Vendor Name, Contract Expiry Date) are filled in automatically after entering the Purchase Order Number. ## Partner Details section The most part of this section is filled in automatically after choosing the Partner. ![Partner Details section](https://3140720386-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJxF2RKg63Q700gpAQ8%2F-LK1wf8GLnjdNfoy6NyR%2F-LK1xz0cFLIuPS9jqpYq%2F9.png?alt=media\&token=fd111c54-98b6-4a70-8cf4-6a5447743b80) ## Audit Staff Team Members section The list of auditors is compiled in accordance with the entered Purchase Order Number. User can select exiting auditor in the Audit Staff Team Members list or add a new Auditor via the "+" button in the upper right-hand corner of the list: ![Add New Auditor button](https://3140720386-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJxF2RKg63Q700gpAQ8%2F-LKV58j6azporH5oWrXB%2F-LKV6cXZ_4EzB-u0sOTB%2F10.png?alt=media\&token=52f1197b-9e70-4eea-a505-be38c64e0d5a) Add New Audir Staff Team Member modal window is presented in the following screenshot: ![Add New Audit Staff Team Member](https://3140720386-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJxF2RKg63Q700gpAQ8%2F-LKV58j6azporH5oWrXB%2F-LKV6vN4akL5y0CfviQy%2F11.png?alt=media\&token=35d290f5-a4b0-446d-9caa-90e3184d3783) User can grant the access to the particular auditor in the modal window during the creation or via check-box in the list of Auditors: !["Has Access" check-box](https://3140720386-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJxF2RKg63Q700gpAQ8%2F-LKV58j6azporH5oWrXB%2F-LKV9bxLq6TFgIiWoJoc%2F12.png?alt=media\&token=c5d4cb00-d743-4433-8db7-3c47c1a89410) **Editing/Deleting** There is an opportunity to edit or delete Audit Staff Team Member via the "Edit" and "Delete" buttons correspondingly ( "Edit" and "Delete" buttons appear after user hover the mouse over the particular line from the Audit Staff Team Members list). ![Edit button](https://3140720386-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJxF2RKg63Q700gpAQ8%2F-LKV58j6azporH5oWrXB%2F-LKVARGIHeivKqe42Hah%2F13.png?alt=media\&token=155bf078-685a-4a20-9f8b-e989c2fbd673) ![Delete button](https://3140720386-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJxF2RKg63Q700gpAQ8%2F-LKV58j6azporH5oWrXB%2F-LKVAdcRi32V-JTd9WX4%2F14.png?alt=media\&token=ca5bbf50-7c90-4824-9c77-c19840074e1d) **Searching** Search in the Audit Staff Team Members list is available via "Search" icon in the upper right-hand corner near the "+" button: ![Search button](https://3140720386-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJxF2RKg63Q700gpAQ8%2F-LKV58j6azporH5oWrXB%2F-LKVBmMZwhp0kn9_TJlC%2F15.png?alt=media\&token=e8a1b520-17a6-44a1-b0e6-211cce9f5c3d) User can choose the number of the rows, displayed per page (The default value is 10 rows per page). ## Specific Procedure To Be Performed {% hint style="info" %} This section is available **only** in case the **Special Audit** type is selected. {% endhint %} User can add New Specific Procedure To Be Performed via "+" button: ![Add New Procedure button](https://3140720386-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJxF2RKg63Q700gpAQ8%2F-LKV58j6azporH5oWrXB%2F-LKVECd_yKFPNEz_CGqR%2F18.png?alt=media\&token=47115653-3919-486e-9bdf-1780b157a940) Add New Procedure modal window is presented in the screenshot: ![Add New Procedure](https://3140720386-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJxF2RKg63Q700gpAQ8%2F-LKV58j6azporH5oWrXB%2F-LKVEXwaWU1qlG8L_HiW%2F19.png?alt=media\&token=3e54f78c-6fa4-40bf-b0d6-405c0f211305) {% endtab %} {% tab title="Attachments tab" %} ![Atachments tab](https://3140720386-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJxF2RKg63Q700gpAQ8%2F-LKV58j6azporH5oWrXB%2F-LKVF0z0SlETGr681IkI%2F20.png?alt=media\&token=630fa76d-9a23-4e02-8ec8-126ad18effff) Attachments tab has the Related Documents section, that allows to Add new documents via "+" button: ![Add related document button](https://3140720386-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJxF2RKg63Q700gpAQ8%2F-LKV58j6azporH5oWrXB%2F-LKVImeNoMBfsciLoFFW%2F21.png?alt=media\&token=edf7d8a2-b99d-4d8c-b2c2-0a689c0e3140) ![Attach File modal window](https://3140720386-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJxF2RKg63Q700gpAQ8%2F-LKV58j6azporH5oWrXB%2F-LKVIyrgO_fH03HfeZ_N%2F22.png?alt=media\&token=020d4acc-7df6-4565-877a-94e82dfcc264) The attached file can be edited and deleted by "Edit" and "Delete" buttons respectively. ![Edit button](https://3140720386-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJxF2RKg63Q700gpAQ8%2F-LKV58j6azporH5oWrXB%2F-LKVLkpTnNuR3tOpyNq-%2F23.png?alt=media\&token=698f5d3d-f53c-4381-8a72-5dd321388340) ![Delete button](https://3140720386-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJxF2RKg63Q700gpAQ8%2F-LKV58j6azporH5oWrXB%2F-LKVM-WHfogyVuuT9DQ3%2F24.png?alt=media\&token=290c5e5a-7c80-41bc-ba9c-c6c9640dc1e3) {% endtab %} {% tab title="Status panel" %} Status panel includes 7 status fields. Under the status name user can find the date of the status change. ![Status panel](https://3140720386-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJxF2RKg63Q700gpAQ8%2F-LKVNayVdDa-ZuDUWBec%2F-LKVPNt5hMop2ttzM3Dc%2F28.png?alt=media\&token=40928be6-33fb-4709-9b0f-a2e44a67a154) New Engagement has **IP Contacted** status. Other statuses are activated after the Auditor fills in the corresponding fields in the Engagement's Report (see more details [here](/financial-assurance-module-documentation/product-end-user-documentation/engagements/edit-by-auditor.md)). {% endtab %} {% endtabs %} When the required information is entered, the user can click the "Create" button at the bottom of the status panel on the right side of the screen to create the Engagement. ![Create button](https://3140720386-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJxF2RKg63Q700gpAQ8%2F-LKVNayVdDa-ZuDUWBec%2F-LKVO2IareF023fehBxH%2F27.png?alt=media\&token=a8a839ff-64bc-4cd6-ba15-8474eb29b84b) {% hint style="info" %} If no Audit Staff Team Members are granted the access to the Engagement, the following error will appear when user will try to Create Engagement: {% endhint %} ![The error message when no auditors are assigned to the Engagement](https://3140720386-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJxF2RKg63Q700gpAQ8%2F-LKV58j6azporH5oWrXB%2F-LKVMTQEeyQT9MPUUwCy%2F25.png?alt=media\&token=87677e4b-989f-4a79-a194-51ca30b475b0) **Created** Engagement has the reference number, that is displayed at the top of the screen and its status is **"IP Contacted".** ![Reference Number](https://3140720386-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJxF2RKg63Q700gpAQ8%2F-LKWL8FdrHLCb-CWWrhI%2F-LKWLUKE4ZY0wTqnCw5l%2F41.png?alt=media\&token=1b58b3d3-a1f0-4fdd-83e3-a865604218a5) ## Modification after creation After the Engagement was created, UNICEF Focal point user is able to edit the following sections of the Engagement: * Audit Staff Team Members * Attachments (Related Documents) ## **Email notification** The following email of granted access is sent to the Auditor after the Engagement was created: ![Email of granting the access to the Engagement](https://3140720386-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LJxF2RKg63Q700gpAQ8%2F-LKV58j6azporH5oWrXB%2F-LKVNSlxiyObcZ3ofAny%2F26.png?alt=media\&token=bd62ed44-bf4b-403c-9ff8-19a39eeb2747)