# L/G finance view

An L/G (letter of guarantee) is a finance record that you can find in the Finance
list and inspect in its record view. Use this page to find an existing L/G, filter the
list, inspect its record, and choose an available record action.

| If you need to… | Go to |
| --- | --- |
| Find the finance list and understand its entry conditions | [Before you start](#before-you-start) |
| Choose a company or principal list and stage | [Find and filter the L/G list](#find-and-filter-the-lg-list) |
| Interpret the visible columns and list tools | [Read the L/G list](#read-the-lg-list) |
| Open and orient yourself in a saved record | [Open and read an L/G record](#open-and-read-an-lg-record) |
| Choose a record value | [Choice fields on the record](#choice-fields-on-the-record) |
| Review saving, approval, and stage actions | [Handle record actions and saving](#handle-record-actions-and-saving) |
| Review saved-record tabs | [Use supporting record areas](#use-supporting-record-areas) |
| Respond to a message | [Handle feedback and continue](#handle-feedback-and-continue) |
| Create an L/G | [Create an L/G](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-l-g) |
| Follow the L/G stage flow | [L/G lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/l-g-lifecycle) |

## Before you start

The finance L/G view is the Finance list and record area for reviewing existing L/Gs.

Before you start, confirm the following:

| Check | What to have or know | Why it matters |
| --- | --- | --- |
| List availability | Your subscription includes the L/G list. | The list is available only when the subscription does not exclude it. |
| Record | A saved L/G record is available. | The record view requires a loaded record before its record actions and saved-record areas apply. |
| Starting view | The company list opens with the **All** list selected. | Use **All** to review every entry in the current list scope. |

**Steps**

1. Open Finance.
2. Select **Bank Guaranties**.

**Result:** The company L/G list opens with **All** selected.

The visible headers depend on the list layout selected for the current account. Review
the values shown for the saved record before changing anything.

## Find and filter the L/G list

After the list opens, narrow existing L/Gs by who the list represents and by stage
before opening a row.

**Prerequisites**

- Your subscription includes the L/G list.
- You are in Finance and can open **Bank Guaranties**.

**Steps**

1. Select **Bank Guaranties** in Finance.
2. Choose the list that matches the records you need.

   | If you need to… | Select |
   | --- | --- |
   | Review company L/Gs | **Company LGs** |
   | Review principal L/Gs | **Principal LGs** |
   | Review all entries in the current list scope | **All** |

3. Select one stage filter.

   | Stage filter | Use it to show |
   | --- | --- |
   | **All** | L/Gs in every available stage |
   | **Draft** | Draft L/Gs |
   | **Awaiting Approval** | L/Gs awaiting approval |
   | **Approved** | Approved L/Gs |
   | **Active** | Active L/Gs |
   | **Due for Return** | L/Gs due for return |
   | **Expired** | Expired L/Gs |
   | **Returned** | Returned L/Gs |
   | **Closed** | Closed L/Gs |
   | **Cancelled** | Cancelled L/Gs |
   | **Liquidated** | Liquidated L/Gs |

   Selecting a stage refreshes the grid. **Principal LGs** is the finance-only principal
   view. In that view, **Draft**, **Awaiting Approval**, and
   **Approved** are hidden; use the available stage filters in the selected list instead.

![Choose the company or principal list and the L/G stage filter](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/79fc519b737e14734a18590a6768fbab.png)

**Result:** The selected L/G list and stage filter are on screen, and the refreshed
grid is ready for row selection in the next section.

## Read the L/G list

The L/G list is a grid of existing finance records. Read the headers first, then use
the row's stage and L/G type to decide which record to open.

The finance grid can show these columns:

| Column |
| --- |
| **L/G no.** |
| **Beneficiary** |
| **L/G issuer** |
| **Bank** |
| Requested value |
| Issued value |
| **Current value** |
| Issue date |
| **Expiry date** |
| **Job No** |
| **Stage** |
| **L/G type** |
| Increase amount |

Rows show stage and L/G type values, including `Draft`, `Bid bond`, `Performance bond`,
and `Down payment bond`.

The selected list layout determines which headers appear. The list also provides the
icon buttons **Refresh**, **Table Layout**, and **Settings**, plus the list actions
**Export** and **Delete**. Work from the headers and values visible in your grid.

![Read the finance grid headers, row values, and list tools](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/600147b517fe05b606080cdbab4c4bf7.png)

## Open and read an L/G record

An L/G record is the finance detail surface for one selected L/G. Open it after
identifying the row whose finance information you need.

**Prerequisites**

- The finance L/G list is open.
- A saved L/G row is visible.

**Steps**

1. Select a data cell in the L/G row you need.

   The selected cell opens the finance record for that L/G.

2. Read the labelled information available for the loaded record.

   | Record area | Labels that can appear |
   | --- | --- |
   | Dates and identity | **Expiry Date**, **Start Date**, **Expiration date**, **Activation Date**, **Returned On**, **LG Number** |
   | Party and type | **On Behalf of**, **LG Type**, **Bank** |
   | Confirmation and comments | **Confirmation Of The LG Requirement**, **Comment**, **Confirmation Of The Financial Viability** |
   | Extension | **Extension Period**, **No. Of Previous Extensions**, **Reason** |
   | Deduction | **LG Deduction Date**, **LG Deduction Percentage**, **Reason** |
   | Increase | **LG Increase Date**, **LG Increase Percentage**, **LG Increase Reason** |
   | Return | **Return Reason** |
   | Finance amounts | Requested, issued, current, cash-cover, and increase amount surfaces |

3. Check the record's current stage before choosing a stage or approval action.

A configurable field is required only where the company configuration makes it
mandatory. **Save**, **Save and Close**, record actions, and record tabs appear only
under their applicable loaded-record, permission, stage, and saved-record conditions.

**Result:** The selected row's finance record is open. Inspect the values shown for the
saved record before changing anything.

### Choice fields on the record

Choice fields limit the values you can use for the parties, L/G type, bank, and
confirmation questions. The available **Bank** input depends on the issuer branch.

| Control | Choices or input shown |
| --- | --- |
| **On Behalf of** | Principal vendor records allowed by the company or principal permission branch |
| **LG Type** | **Bid bond**, **Down payment guaranty**, **Performance bond**, or **Warranty bond** |
| **Bank** when the issuer branch is true | Bank accounts returned by the bank-account lookup, displayed with bank, account number, and total account information |
| **Bank** when the issuer branch is not true | A text field |
| **Confirmation Of The LG Requirement** | **Yes** or **No** |
| **Confirmation Of The Financial Viability** | **Yes** or **No** |

## Handle record actions and saving

After reading the record, use its visible action to move an eligible L/G through
approval or stage work, or to open a maintenance area. Visibility depends on the
loaded record, its stage, approval configuration, permissions, and pending extension
or increase conditions.

| Action group | Available controls |
| --- | --- |
| Saving | **Save** and **Save and Close**; both require edit permission, a non-embedded record surface, and changes |
| Approval | **Request approval**, **Approve**, **Cancel approval request**, and **Reject approval request** |
| Stage | **Due for Return**, **Returned**, **Closed**, **Liquidated**, **Active**, and **Draft** |
| Maintenance | **Enable Editing**, **LG Extensions**, **LG Deductions**, and **LG Increase** |
| List removal | **Delete** for the selected list record |

> **Important:** Approval and permission conditions control which actions appear. Use
> the action that is visible for the loaded record and your permission.

**Prerequisites**

- The L/G record is loaded.
- You have edit permission when you need to save.
- The record is not an embedded surface when you need **Save** or **Save and Close**.
- You understand the current stage shown on the record.

**Steps**

1. Select **Enable Editing** when the loaded record is read-only and the action is available.
2. Change the applicable record value or use the applicable maintenance action.
3. Select the save action that matches your goal.

   | If you need to… | Select |
   | --- | --- |
   | Keep the record view open | **Save** |
   | Save and leave the record view | **Save and Close** |

4. Read the feedback shown after the save request.

The available approval and stage actions are guarded by the current stage, approval
configuration, permissions, and record conditions.

**Result:** The record remains open or closes according to the save action and the
feedback shown.

## Use supporting record areas

Supporting record areas keep discussion, files, extensions, deductions, increases, and
history with a saved L/G. Open them after a saved record ID exists.

**Prerequisites**

- A saved L/G record is open.
- The record has a saved record ID.

**Steps**

1. Select the saved-record area that matches the work you need.

   | If you need to… | Select |
   | --- | --- |
   | Review discussion | **Comments** |
   | Review attachments | **Attachment** |
   | Review extensions | **LG Extensions** |
   | Review deductions | **LG Deductions** |
   | Review increases | **LG Increase** |
   | Review detailed changes | **Last Modifications** |

2. If you select **LG Extensions**, wait for its time-period data to load when the area requests it.

Two record accordions appear only when the record is not being passed as an embedded
input. The tabs themselves require a saved record ID.

**Result:** The selected supporting area is open for the saved L/G record.

## Handle feedback and continue

After an action, read the feedback to identify the correction or condition and choose
the next move.

**Prerequisites**

- The list or loaded record is on screen.
- Read the complete message before changing a value or selecting another action.

**Steps**

1. Read the message shown on screen.

    | Message | Response |
   | --- | --- |
   | `Forbidden characters detected. Please remove them and try again.` | Remove the forbidden characters, then repeat the list action. |
   | `Your request was completed successfully` | Continue from the completed action's resulting screen. |
   | `An error occurred while processing your request` | Stop and review the record values and action conditions before retrying. |
   | `You don’t have permission` | Use an action allowed by your permission, or ask for the required access. |
   | `Please Add Extension to activate the LG` | Add an extension before attempting activation. |
   | `LG has one or more extensions or deductions and cannot be reverted to the requested stage` | Keep the current stage and review its extensions or deductions. |
   | `LG still needs confirmation` | Complete the required confirmation before repeating the stage action. |
   | `Please choose a date after the current expiry date` | Choose a date after the current expiry date. |
   | `There is a pending increase you can edit` | Edit the pending increase before starting another increase. |

2. Verify the list or record state before taking another action.

**Result:** The correction or condition is identified, and the list or record is ready
for the next supported action.

## What to do next

For new-versus-existing entry and the creation procedure, go to [Create an L/G](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/create-l-g).
For stage meanings and the complete L/G stage lifecycle, go to [L/G lifecycle](https://pams-doc-test-fresh.atloria.app/p/pams-doc-test-fresh-N9B4TwWn3Q/user/l-g-lifecycle).
