PROMS App · Procedural guide

Navigating the Overview and search pages

How to sign in, confirm access, review the Overview page and use the Financial Plan, Project Financial Report and Prepayment search pages.

Audience: UNHCR personnel and funded partnersUpdated: 30 September 2026
1
Introduction
Purpose and audience

This guide explains how to enter the PROMS App and use the Overview, Financial Plan, Project Financial Report and Prepayment search pages. It is intended for UNHCR personnel and authorised funded partner users who need to find records, understand page controls, review status information and export or print available results.

The guide focuses on navigation before detailed record processing begins. Actions available to an individual user depend on the active role, security context and current record status.

2
Overview
What the guide covers

Overview page

Confirm your role and security context, apply overview filters, read totals and status counts and open recently modified records.

Financial Plan search

Use cascading filters, configure columns, recognise actions, print one Financial Plan and export the displayed result set.

Project Financial Report search

Find PFRs, review invoice status in Cloud ERP, configure the result table, print a PFR and export results.

Prepayment search

Find prepayments, configure columns, open invoice details and export the displayed result set.

ImportantAlways confirm the Selected Role in the blue bar before taking action. The active role determines the permissions applied by PROMS.
3
Contents
Guide sections
  1. Introduction
  2. Overview
  3. Contents
  4. Lifecycle
  5. Sign-in to PROMS App
  6. Overview page
  7. Financial Plan Search Page
  8. Project Financial Report Search Page
  9. Prepayment Search Page
  10. Conclusion and support
4
Lifecycle
From access to record review and export
AccessSign inUse the route for UNHCR or partners.
→
ContextConfirm roleCheck the selected role and operation access.
→
OverviewReview workloadRead totals, statuses and recent changes.
→
SearchFind recordsApply filters and review results.
→
OutputOpen, print or exportUse only actions available to your role.

The three search pages follow a common pattern: select filters, run Search, configure visible columns, select an available action and navigate or export the results. Once users understand one search page, the controls on the other pages will be familiar.

5
Sign-in to PROMS App
Access routes for UNHCR personnel and funded partners

Sign in as a UNHCR user

Instruction: Open the PROMS App and select Sign in to your account. Continue with your normal organisational credentials.

Expected result: After successful authentication, PROMS opens the Overview page under your assigned user profile.

PROMS sign-in page with the Sign in to your account control.
Select “Sign in to your account” to enter the PROMS App.

Sign in as a funded partner user

Instruction: Enter the email address and password registered for your Aconex account. When prompted, open Oracle Authenticator on your phone and enter the six-digit code displayed in the application.

Expected result: Once the authentication code is accepted, continue into PROMS. Partner users should see the role HCR PFM PARTNERS.

Partner authentication screen for entering registered credentials.
Enter the email address and password registered for Aconex.
Oracle Authenticator verification screen requesting a six-digit code.
Enter the six-digit code from Oracle Authenticator.
6
Overview page
Profile, filters, totals and direct links to records

Understand the purpose of the Overview page

The Overview page is the landing page for PROMS. It combines profile and access information with filters, summary totals, status breakdowns, notifications and links to records requiring attention. Use it to confirm that you are working in the correct role and operation before opening a search page or record.

Read the blue bar

The blue bar remains visible throughout PROMS. The left side displays the application and current page name. The text after “PROMS –” changes when you move between pages. The centre shows the Selected Role. The right side contains the language control and notification bell.

Left side of the PROMS blue bar showing the dynamic page name.
Left side of the blue bar showing the current PROMS page.
Right side of the PROMS blue bar with selected role, language and notifications.
Right side of the blue bar showing role, language and notification controls.

Select the language and check notifications

Open the Language dropdown to select English, French or Spanish. Select the notification bell to open the list of actions waiting for you. Review the list before starting work so that pending items are not missed.

PROMS language dropdown with available interface languages.
Select the preferred interface language from the blue bar.
PROMS notification panel listing actions pending for the user.
Open the notification panel to review pending actions.

Check your profile name

The upper part of the left panel displays the name of the person currently signed in. Confirm that this is your profile before proceeding.

Overview page profile panel showing the signed-in user name.
The profile panel identifies the signed-in user.

Choose the correct role

Open the Role dropdown to review the roles assigned to you. Partner users should have the role HCR PFM PARTNERS. UNHCR personnel with more than one role must select the role that corresponds to the work they intend to perform.

Overview page with the Role dropdown selected.
Open the Role dropdown from the profile panel.
Expanded Role dropdown listing the roles available to the signed-in user.
Review and select from the roles assigned to the account.

Review the security context

Expand Security Context to see the UNHCR operations or business units available to your account. The security context defines which operational records you can see and work with.

Security Context control on the Overview page.
Expand Security Context in the profile panel.
Expanded Security Context listing accessible business units.
Review the operations available under the active role.

Review account shortcuts

Use Last Login to identify when the previous PROMS session occurred. Checked out FPNs lists Financial Plans checked out during your last session. Link to Aconex opens the Aconex Lobby Account. The Last Login time also provides the reference point used by the Recently Modified counters.

Overview profile panel highlighting Last Login.
Review the date and time of the previous PROMS login.
Overview profile panel showing Checked out FPNs and Link to Aconex.
Open checked-out FPNs or follow the link to Aconex.

Locate and use the overview filters

The Overview filter area contains Operation, Budget Year and Partner, followed by Search. Leave all filters blank and select Search to display all records available through your role and security context. Alternatively, select one or more filters to narrow the totals and status tables.

Partner users see records linked to their own partnership agreement; the Partner value is fixed to their organisation.

Overview page filter row showing Operation, Budget Year, Partner and Search.
The Overview page filter controls.
Overview page showing selection of filters before search.
Select one or more filters and run Search.

Read summary totals and status breakdowns

Summary Totals shows the number of Financial Plans, Prepayments and Project Financial Reports available for the selected criteria. The three Status Breakdown tables then divide each document type by status. Changing the filters and running Search refreshes these figures.

Overview page summary totals and status breakdown tables for Financial Plans, Prepayments and PFRs.
Summary Totals and the three Status Breakdown tables respond to the selected filters.

Open records from a status count

Each total and status count is a hyperlink. Select a count to move directly to the corresponding search results, such as all approved Financial Plans or all verified PFRs. The destination table is already limited to the selected category.

Status breakdown table showing totals and counts by status.
Review the total and count shown for each status.
Status count hyperlink used to open filtered records.
Select a linked count to open the matching records.

Open recently modified records

Recently Modified identifies records changed by another user since your last login. The feature is available for Financial Plans, Prepayments and PFRs. Select the relevant count to open the records and determine whether review or follow-up is required.

Overview page showing Recently Modified counts.
Review the Recently Modified count for each document type.
Recently Modified hyperlink opening the associated record list.
Select the count to open the recently modified records.
7
Financial Plan Search Page
Find, review, print and export Financial Plans

Understand the Financial Plan search page

Use this page to locate Financial Plans (FPNs), review their status and details, open an available action, print one selected plan or export the displayed table. The controls shown depend on the active role and record status.

Read the blue bar

The page name on the left changes to PROMS – Financial Plan. The Selected Role, language and notification controls remain available. Confirm the role before using record actions.

Financial Plan page showing the persistent PROMS blue bar.
The blue bar identifies the Financial Plan page and the active role.

Understand the filters and disabled fields

The page contains Budget Year, Operation, Partner and Contract Number. Partner and Contract Number may initially be disabled. Select Budget Year to activate Contract Number. Select Operation to activate Partner. Contract Number is editable, so you can paste a known contract number directly.

Financial Plan filter row showing Budget Year, Operation, Partner, Contract Number and Search.
Partner and Contract Number are initially disabled until their controlling filters are selected.

Run Search and check the results

Select the required Budget Year and Operation. If necessary, choose a Partner or paste a Contract Number. Select Search and confirm that the results match the criteria used. Leaving available filters blank broadens the results to all records permitted by your access.

Financial Plan page showing the Partner filter activated after an Operation is selected.
Selecting an Operation activates the Partner filter.
Financial Plan page showing a contract number entered before Search.
Paste a Contract Number to locate a specific agreement.

Locate the table controls

Above the results table, View and Action appear on the left. The Print and Export icons appear on the right. First select the relevant row when an action applies to one record.

Financial Plan table controls showing View and Action.
View and Action controls are located above the table on the left.
Financial Plan Print and Export icons.
Print and Export controls are located above the table on the right.

Add or remove table columns

Open View and select the columns needed for your review. The visible column selection also determines which fields are included when the table is exported. Remove columns that are not needed to keep the table readable.

Financial Plan page with the View control opened.
Open View to configure the result table.
Financial Plan View menu listing selectable table columns.
Select the Financial Plan columns required for review or export.

Use the Action menu

Select a row and open Action to see the operations currently available. These can include Lock, Unlock, Edit, Make Prepayment and Create a PFR. The same choices appear as icons in the row-level Action column.

Financial Plan Action menu with available record actions.
Open the Action menu for the selected Financial Plan.
Financial Plan result table showing row-level action icons.
The Action column provides the corresponding row-level icons.

Recognise the action icons and when to use them

Lock and Unlock are reserved for UNHCR personnel. The person who locks a document is responsible for unlocking it; the PROMS App Administrator can unlock a document when necessary. Edit opens the Financial Plan for permitted changes. Make Prepayment and Create PFR are partner-initiated actions. View is available across roles.

A dark icon indicates that the action is available. A grey icon indicates that the current role or record status does not permit the action.

Financial Plan Action column highlighting Lock, Unlock and Edit icons.
Lock, Unlock and Edit icons in the Action column.
Financial Plan Action column highlighting Prepayment, PFR and View icons.
Start Prepayment, Start PFR and View icons in the Action column.

Financial Plan search page columns

ColumnWhat the column shows
ActionIcons for the row-level actions available to the current role and record status.
Financial PlanThe Financial Plan number for the record.
BudgetThe budget originating from COMPASS.
FPN StatusThe current stage of the Financial Plan negotiation process.
Sub StatusAdditional information when a processing or business issue exists.
Organization NameThe partner organisation linked to the agreement.
Contract NumberThe contract number for the partnership agreement.
Accumulated ExpensesExpenses accumulated against the Financial Plan.
PO NumberThe related purchase order number.
Negotiated BudgetThe final budget after negotiation, rather than the original COMPASS budget.
Modified ByThe user who most recently modified the Financial Plan.
Modified DateThe date on which the Financial Plan was most recently modified.

Print one Financial Plan

Select one Financial Plan and select Print. Wait for the PDF to be generated, then open it from the browser download history. A Financial Plan PDF can be downloaded during the process. Once negotiation is completed, the final PDF is automatically saved in the Aconex Document Register and UNHCR shares it with the partner through a transmittal.

Financial Plan result table with one record selected for printing.
Select the Financial Plan to be printed.
Financial Plan page with the Print control selected.
Select Print to generate the PDF.
Browser download history showing the generated Financial Plan PDF.
Open the generated file from the browser download history.
Generated Financial Plan PDF preview.
Review the generated Financial Plan PDF.

Export the full table

Select Export to create an Excel file containing the records currently displayed by the search and the columns selected through View. Unlike Print, Export applies to the result set rather than one record.

Financial Plan result table with the Export control highlighted.
Export the filtered Financial Plan table and its visible columns.

Navigate pages and change visible rows

Use the controls at the lower left to move through result pages. Use the rows-per-page control at the lower right to increase or reduce the number of records displayed. The available options include 15, 30, 50, 70 and 100 rows.

Financial Plan pagination controls and rows-per-page selector.
Use pagination and the rows-per-page selector at the bottom of the table.
8
Project Financial Report Search Page
Find, review, print and export Project Financial Reports

Understand the PFR search page

Use the Project Financial Report (PFR) search page to find reports, review status and invoice information, open permitted actions, print one report or export the result table. The search and table controls follow the same logic as the Financial Plan page.

Read the blue bar

The blue bar identifies the Project Financial Report page and continues to show the Selected Role, language and notifications. Confirm the role before selecting a record or action.

Use the filters and recognise disabled fields

The filters are Budget Year, Operation, Partner and Contract Number. Budget Year activates Contract Number, while Operation activates Partner. For partner accounts, Partner is fixed to the user’s organisation.

PFR filter row showing Budget Year, Operation, Partner, Contract Number and Search.
The PFR search page uses the same four cascading filters.

Run Search and check the results

Choose the filters required for the task and select Search. Confirm that the result rows reflect the selected year, operation, partner or contract. Clear optional filters and search again when a broader result set is required.

Locate the table controls and configure columns

Use View to add or remove table columns. Select all fields needed for on-screen review and export. Print and Export are positioned above the results, following the same pattern as on the Financial Plan page.

PFR page with the View control opened.
Open View on the PFR search page.
PFR View menu listing selectable table columns.
Select additional columns, including PFR Type where required.

Use the Action menu and recognise icons

The PFR Action column contains Lock or Unlock, Edit and View. Lock and Unlock remain reserved for UNHCR personnel. Edit becomes active when the current role and workflow status permit changes. View is available to all users. Dark icons are available; grey icons are unavailable.

PFR result table highlighting Lock, Unlock and Edit actions.
Lock or Unlock and Edit actions on a PFR row.
PFR result table highlighting the View action.
View is available for users who need read-only access.

PFR search page columns

ColumnWhat the column shows
ActionLock or Unlock, Edit and View icons available for the record.
PartnerThe name of the partner organisation.
PFRThe Project Financial Report number.
Amount in LCYThe report amount in local currency.
PFR StatusThe current step of the PFR process.
Invoice NumberThe invoice number linked to the PFR.
Inv. StatusA hyperlink that opens the current invoice status in Cloud ERP.
Supplier Site StatusAn explanation of a supplier-site or business error, when present.
Modified ByThe user who most recently modified the PFR.
Modified DateThe date on which the PFR was most recently modified.
PFR TypeWhether the report is Periodic or Final.

Check invoice status in Cloud ERP

Locate Inv. Status in the result row and select the linked value. A panel opens with the invoice status held in Cloud ERP. Review the information and close the panel when finished.

PFR result table highlighting the invoice status field.
Locate the linked invoice status in the PFR table.
PFR result table with the invoice status hyperlink selected.
Select the invoice status link.
PFR invoice status panel displaying information from Cloud ERP.
Review the invoice information returned from Cloud ERP.

Print one PFR

Select one PFR and select Print. Save the generated PDF and open it from the browser download history. A PFR PDF can be downloaded during submission and review. The final approved PFR is automatically uploaded to the Aconex Document Register; UNHCR is responsible for sharing it with the partner through a transmittal.

PFR result table with one report selected for printing.
Select one PFR and start the print action.
Browser save control for the generated PFR PDF.
Save the generated PFR PDF.
Generated PFR PDF preview.
Review the generated PFR PDF.

Export the full table

Select Export to create an Excel file containing the filtered PFR results and the columns selected through View.

PFR search page with the Export control highlighted.
Export the displayed PFR table to Excel.

Navigate pages and change visible rows

Use the pagination controls at the lower left to move between result pages. Use the rows-per-page control at the lower right to change how many PFRs appear on one page.

9
Prepayment Search Page
Find prepayments, review invoice details and export results

Understand the Prepayment search page

Use the Prepayment search page to locate prepayment records, review current processing information, open available actions, inspect invoice details and export the result set. This page does not provide the single-record Print function used for Financial Plans and PFRs.

Read the blue bar

The blue bar identifies the Prepayment page and retains the Selected Role, language and notification controls. Check the role before opening an action.

Use the filters and recognise disabled fields

The filters are Budget Year, Operation, Partner and Contract Number. The same dependencies apply: Budget Year activates Contract Number, and Operation activates Partner. Contract Number remains editable, allowing a known number to be pasted directly.

Prepayment filter row showing Budget Year, Operation, Partner, Contract Number and Search.
The Prepayment page uses the same cascading filter pattern.

Run Search and check the results

Select the required criteria and choose Search. Review the result table to confirm that the records correspond to the chosen year, operation, partner or contract.

Locate the table controls and configure columns

Open View to choose which prepayment columns appear. The selected fields also determine the content of the exported Excel file. Use the Export control above the table when the result set is ready.

Prepayment page with the View control opened.
Open View on the Prepayment page.
Prepayment View menu listing selectable table columns.
Select the Prepayment columns required for review or export.

Use the Action menu and recognise icons

The Prepayment Action column includes Edit, View and Invoice Details. Edit is active only when the current role and status permit changes. View is available for read-only access. Invoice Details opens the information associated with the prepayment and its Cloud ERP processing.

Prepayment result table showing the Action column.
Locate the Prepayment Action column.
Prepayment Action column highlighting Edit and View actions.
Recognise the Edit and View icons.

Open invoice details

Select the Invoice Details icon for the required record. A panel opens on the right side of the screen and brings together the prepayment information, including available Cloud ERP details. Review the panel and close it when finished.

Prepayment result table with the Invoice Details icon highlighted.
Select the Invoice Details icon for the required prepayment.
Prepayment invoice details panel displayed on the right side of the screen.
Review the complete prepayment and invoice information.

Prepayment search page columns

ColumnWhat the column shows
ActionEdit, View and Invoice Details controls available for the record.
Invoice NumberThe invoice number associated with the prepayment.
Creation DateThe date on which the prepayment record was created.
Prepayment AmountThe value of the prepayment.
Prepayment StatusThe current processing status of the prepayment.
Financial Plan NumberThe Financial Plan linked to the prepayment.
Sub StatusAdditional information when a processing or business issue exists.
Contract NumberThe contract number for the partnership agreement.
Modified ByThe user who most recently modified the prepayment.
Modified DateThe date on which the prepayment was most recently modified.
Accumulated ExpensesThe accumulated expenses linked to the relevant Financial Plan.

Export the full table

Select Export to create an Excel file containing the records returned by the current filters and the columns selected through View. The Prepayment page provides Export but not the single-record Print function.

Navigate pages and change visible rows

Use the controls at the lower left to move between result pages. Use the rows-per-page selector at the lower right to change the number of records visible on the page.

10
Conclusion and support
Key reminders and help routes

Before working

  • Confirm the Selected Role.
  • Review Security Context.
  • Check notifications and recent changes.

When searching

  • Leave filters blank for all accessible records.
  • Select Budget Year before Contract Number.
  • Select Operation before Partner.

When using actions

  • Dark icons are available; grey icons are not.
  • Print applies to one selected FPN or PFR.
  • Export applies to the filtered table and visible columns.

If access, role selection, security context or a locked document prevents you from continuing, contact the designated PROMS focal point or PROMS App Administrator. Provide the page name, active role, operation, record number and the action you were attempting. Do not include passwords or authentication codes in a support request.

Final reminderYour active role and security context determine both the records you can see and the actions you can perform.
PROMS App Overview and Search Pages
Source material: supplied PROMS navigation, overview, sign-in and financial-report guidance documents.