# Create Program

Create Program screen helps to create a new program. This document provides step-by-step instructions to create a new program. The user with a Program Manager and Administrator role can create a new program.

## Prerequisites

The user must have a Program Manager role to create a new program.

Note:

Refer the [Create User and Assign Role](/products/pbms/previous-generation/functionality/administration/role-based-access-control/user-guides/assign-roles-to-users.md) guide to know how to assign role for a User.

## Procedure

### Programs

1. Click the main menu icon ![](/files/xKhS7qdJDqpzfMgT2JTm) and select ***Programs***.
2. The ***Programs*** screen is displayed.

<figure><img src="/files/LMRhCbOZ06EcLsGVkduv" alt=""><figcaption><p>Choose Programs in the menu</p></figcaption></figure>

<figure><img src="/files/s9ToDKYWXUwutZpITpVP" alt=""><figcaption><p>Programs screen</p></figcaption></figure>

***Programs*** screen provides a dashboard view that lists all the available Program Names, Target Type, Number of Enrolled Beneficiaries against each program, State (whether active/inactive), and the Beneficiaries list.

In ***Programs*** screen, the available features and their descriptions are:

<table><thead><tr><th width="130">Feature</th><th>Description</th></tr></thead><tbody><tr><td>Create</td><td>Click the <em><strong>Create</strong></em> button to create new program</td></tr><tr><td><img src="/files/du4n3xOn8CRpqMrhE8Y2" alt="" data-size="original"></td><td>Click the <em><strong>Export All</strong></em> button to download the details in excel format</td></tr><tr><td>&#x3C;</td><td>Click the <em><strong>Left</strong></em> arrow to go the previous screen</td></tr><tr><td>></td><td>Click the <em><strong>Right</strong></em> arrow to go the next screen</td></tr><tr><td>Filters</td><td><p>Click the <em><strong>Filters</strong></em> link and select the appropriate options.</p><p>The valid values are:</p><ul><li>Archived</li><li>Add Customer Filter</li></ul><p>The advanced filter option allows you to define conditions and criteria to refine the search results.</p><ul><li>Select the <em><strong>Add Customer filter</strong></em> and then select the appropriate option in the first drop-down to display the specific data based on the option selected.</li><li>Select the criteria in second and third drop-down to refine the search results.</li><li>Click the <em><strong>Apply</strong></em> button to display the data based on the search</li></ul><p><em>Note: To enhance the search, click the <strong>Add a condition</strong> button and follows the steps given in <strong>Add Customer Filter</strong> option</em></p></td></tr><tr><td>Group By</td><td><ul><li>Click the <em><strong>Group By</strong></em> link, select <strong>Add Custom Group</strong> and then select the appropriate options in the drop-down to display the specific data based on the option selected.</li><li>Click the <em><strong>Apply</strong></em> button to display the data based on the search</li></ul></td></tr><tr><td>Favorites</td><td><ul><li><p>Click the <em><strong>Favorites</strong></em> link, select <strong>Save current search</strong> and then check the appropriate options. The valid values are:</p><ul><li>Use by default</li><li>Share with all users</li></ul></li><li>Click the <em><strong>Save</strong></em> button to display the data based on the search</li></ul></td></tr><tr><td>Search</td><td>This field is filled when the available option are selected in Filers, Group By, Favorites</td></tr></tbody></table>

#### Create Program

3. Click the ***Create Program*** button. The ***Set Program Settings*** screen is displayed.

<figure><img src="/files/dw7YCtAf5arTzEM4qSqI" alt=""><figcaption><p>Set program settings</p></figcaption></figure>

#### Set Program settings

In ***Set Program Settings*** screen, the field and their descriptions are:

| Field                    | Description                                                                                            |
| ------------------------ | ------------------------------------------------------------------------------------------------------ |
| Program Name             | Enter the Program name                                                                                 |
| Target Type              | <p>Choose one of the Target Type. The valid values are:</p><ul><li>Groups</li><li>Individual</li></ul> |
| Currency                 | <p>Select the appropriate currency option. The valid values are:</p><ul><li>EUR</li><li>USD</li></ul>  |
| Is Reimbursement Program | Check the option if the reimbursement program is required                                              |

In ***Set Program Settings*** screen, you can find the below tabs.

* [Configure the Default Eligibility Criteria](#configure-the-default-eligibility-criteria)
* [Configure the Cycle Manager](#configure-the-cycle-manager)
* [Configure the Entitlement Manager](#configure-the-entitlement-manager)
* [PMT Configuration](#pmt-configuration)
* [Map Portal Form](#map-portal-form)

#### **Configure the Default Eligibility Criteria**

4. Click the ***Configure the Default Eligibility Criteria*** tab, the fields available in the tab are displayed.

<figure><img src="/files/FMfDNzm71sUZTRX17BQR" alt=""><figcaption><p>Configure the Default Eligibility Criteria</p></figcaption></figure>

<table><thead><tr><th width="185">Field</th><th>Description</th></tr></thead><tbody><tr><td>Eligibility manager</td><td>Default option is selected by default</td></tr><tr><td>Admin Area</td><td>Enter the admin area</td></tr><tr><td>Filter</td><td></td></tr><tr><td>Match all records</td><td>Retrieves the data which matches all records</td></tr><tr><td><img src="/files/1mivrUOUcSWIX0uCPAAX" alt="" data-size="original"></td><td><p>Click the <em><strong>Records</strong></em> button. The <em><strong>Selected records</strong></em> screen is displayed.</p><p><em>Note:</em></p><ul><li><em>By default the list of three records are listed in the <strong>Selected records</strong> screen.</em></li><li><em>Click the <strong>Cancel</strong> button to close the <strong>Selected records</strong> screen.</em></li></ul></td></tr><tr><td><img src="/files/lj2ypRZ4PR24ZC3jTGc7" alt="" data-size="original"></td><td>Click the <em><strong>Refresh</strong></em> button to refresh the screen</td></tr><tr><td>Add filter</td><td><p>Click the <em><strong>Add filter</strong></em> button to set eligibility criteria using Domain Filters. You may set multiple eligibility criteria.</p><ol><li>Click the <em><strong>Add filters</strong></em> button. The multiple criteria fields are displayed.</li><li>Select the multiple criteria such as ID, condition and count.</li><li>Click the <strong>x</strong> button to remove the entry in the criteria fields.</li><li>Click the <strong>+</strong> button to add new multiple criteria field.</li><li>Click the <strong>...</strong> option to display fields in <em><strong>Any of</strong></em> section. The multiple criteria fields are displayed.</li></ol><p><em>Note: You can click the <strong>...</strong> option to add n number of <strong>Any of</strong> section</em></p><ol start="6"><li>The value chosen in the multiple criteria fields are displayed in the <em><strong>Code editor</strong></em>.</li><li>In the Match records chose one of the followings:</li></ol><ul><li>Select <em><strong>All</strong></em> to display the data belongs to <em><strong>All</strong></em> section</li><li>Select <em><strong>Any</strong></em> to display the data belongs to <em><strong>Any</strong></em> <em><strong>of</strong></em> section</li></ul></td></tr></tbody></table>

<figure><img src="/files/uLO5gFjkzB8BOCHCXzYf" alt=""><figcaption><p>Selected records screen</p></figcaption></figure>

#### **Configure the Cycle Manager**

5. Click the ***Configure the Cycle Manager*** tab, the fields available in the tab are displayed.

<figure><img src="/files/SYItYCfGNuNcl46XiSm1" alt=""><figcaption><p>Configure the cycle manager</p></figcaption></figure>

<table><thead><tr><th width="247">Field</th><th>Description</th></tr></thead><tbody><tr><td>Auto-approve Entitlements</td><td><p>Check the option if the auto-approve entitlements is required.</p><p><em>Note:</em></p><p><em>Set entitlements via rules, without any manual approvals.</em></p></td></tr><tr><td>Approver Group</td><td><p>Select the approver group in the drop-down.</p><p><em>Note:</em></p><p><em>The group name of the user who has permission to approve cycles. See</em> <a href="/pages/DOjYAVg3gShpIUinAaFG"><em>Create User and Assign Role</em></a><em>.</em></p></td></tr><tr><td>One-time Distribution</td><td><p>Check the option if the distribution happens one-time</p><p>Note:</p><ul><li>If one-time distribution option is checked, the recurrence distribution option is not displayed.</li><li>If one-time distribution option is not checked, the recurrence distribution option is displayed.</li></ul></td></tr><tr><td>Recurrence</td><td><p>You can choose recurrence option, if the time period is repeated for a cycle</p><p>Enter the number and select the appropriate option in the drop-down. The valid values are:</p><ul><li>Days</li><li>Weeks</li><li>Months</li><li>Years</li></ul></td></tr><tr><td>Day of Month</td><td><p>Select the appropriate option in the drop-down. The valid values are:</p><ul><li><p>Date of month</p><ul><li>Enter the date of month if date of month option is selected in the drop-down</li></ul></li><li><p>Day of month</p><ul><li>Enter the day of month if day of month option is selected in the drop-down</li></ul></li></ul></td></tr></tbody></table>

#### **Configure the Entitlement Manager**

6. Click the ***Configure the Entitlement Manager*** tab, the fields available in the tab are displayed.

<figure><img src="/files/oiORH2yQG362ZdHB0nIz" alt=""><figcaption><p>Configure the entitlement manager</p></figcaption></figure>

| Field                                 | Description                                                                                                                                                                                                                                                      |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Entitlement manger                    | <p>Select the parameters for entitlements. The valid values are:</p><ul><li>Default</li><li>In-Kind</li><li>Cash</li></ul>                                                                                                                                       |
| ID Type to store in entitlements      | Enter the ID Type to store in entitlements                                                                                                                                                                                                                       |
| Amount Per Cycle                      | Enter the amount of disbursement of a group or individual per cycle.                                                                                                                                                                                             |
| Amount Per Individual In Group        | Enter the amount of disbursement per individual in a group when the program target type is "group".                                                                                                                                                              |
| Maximum number of individual in group | <p>Enter the maximum number of individuals who get disbursements per group.</p><p><em>Note:</em></p><p><em>It is an optional field</em></p>                                                                                                                      |
| Transfer Fee(%)                       | <p>Enter the fee incurred for disbursement as a percentage of disbursement.</p><p><em>Note:</em></p><p><em>It is an optional field</em></p>                                                                                                                      |
| Transfer Fee Amount                   | <p>Enter the fee incurred for disbursement as an absolute amount.</p><p><em>Note:</em></p><p><em>It is an optional field</em></p>                                                                                                                                |
| Entitlement Validation Group          | <p>Enter the group name of the user who has permission to approve entitlements.</p><p><em>Note:</em></p><p><em>See</em> <a href="/pages/DOjYAVg3gShpIUinAaFG"><em>Create User and Assign Role</em></a> <em>guide to know how to assign role for a User.</em></p> |

#### **PMT Configuration**

7. Click the ***PMT Configuration*** tab, the field available in the tab is displayed.

<figure><img src="/files/KQlg6CqFxX6qoHbRqnYr" alt=""><figcaption><p>PMT Configuration</p></figcaption></figure>

| Field      | Description                        |
| ---------- | ---------------------------------- |
| Enable PMT | Check the option to enable the PMT |

#### **Map Portal Form**

8. Click the ***Map Portal Form*** tab, the fields available in the tab are displayed.

<figure><img src="/files/DtxI7Li4OgLHzw8slCSD" alt=""><figcaption><p>Map portal form</p></figcaption></figure>

| Feature                               | Description                                                                |
| ------------------------------------- | -------------------------------------------------------------------------- |
| Multiple Form Submission Program Form | Check the option if the multiple form submission program form is required. |
| Program Form                          | Enter the name of the program form                                         |

9. Click the ***Next*** button.
10. The ***Set Program Settings*** dialog box is displayed.
11. Select the option ***Yes,*** to import the matching registrants to this program
12. Select the option ***No***, not to import the matching registrants to this program
13. Click the ***Back*** button to go previous screen
14. Click the ***Create*** button to create New Program
15. Click the ***Cancel*** button to go to the Program dashboard screen

You can view newly created Program listed in the Program dashboard screen.

<figure><img src="/files/7AR42nEEB03cxFUMYGSY" alt=""><figcaption><p>Created new program listed in program dashboard screen</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.openg2p.org/resources/guides/user-guides/pbms/create-a-program.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
