# Targets and budgets

## Targets and budgets

Targets and budgets groups booking, sales, and financial planning in separate main
tabs. Use it to review planning rows for teams, vendors, account managers, and
product types, and to work with COGS, SG&A, depreciation, FORX, and net profit
budgets.

| If you need to… | Go to |
|---|---|
| Choose the planning year and open a planning area | [Find the target or budget area](#find-the-target-or-budget-area) |
| Identify the fields and columns in a planning table | [Understand the target and budget tables](#understand-the-target-and-budget-tables) |
| Open an editor or work with distribution groups | [Maintain targets and budgets](#maintain-targets-and-budgets) |
| Understand branch-specific rows and vendor history | [Handle branch and product-group variations](#handle-branch-and-product-group-variations) |
| Resolve a validation, loading, import, export, or save message | [When validation or loading fails](#when-validation-or-loading-fails) |
| Continue with branch setup | configuration-company-branchs-view |
| Continue with product-type setup | configuration-company-product-types-view |
| Continue with account-manager setup | configuration-account-managers-view |
| Continue with team setup | teams |

## Before you start

This page is available when the subscription includes it. The **Year** field,
year-creation action, planning tabs, and branch columns can each depend on the
subscription, permissions, feature availability, selected year, and branch data.

**Prerequisites**

- Have access to the configuration area and the subscription that includes the
  target and budget surface.
- Know the year you need to review. The available values in **Year** come from the
  company's year data, and the initially selected value is the last returned year.
- Have permission to create a year if you need **Next Year**. The action is
  available only when the subscription includes it, creation permission is present,
  and the maximum year has not been reached.
- Confirm that the relevant feature is available. **Teams**, **Vendors**,
  **Account Managers**, and **Product Types** require **Booking Target**; **COGS**,
  **SG&A**, **Depreciation**, **FORX**, and **Net profit** require the Finance Target
  feature.
- Expect branch columns to reflect the branch collections available for the company.

> **Note:** A subsection can be unavailable even when the page itself opens. The
> booking and finance subsection conditions are separate from the page entry
> condition.

## Find the target or budget area

The target and budget area groups booking planning, sales planning, and financial
budget work. **Booking Target** groups booking planning by team, vendor, account
manager, and product type. **Sales Target** provides the sales-target subsection,
and **Financial Budget** groups the financial budget subsections.

**Prerequisites**

- Meet the conditions in [Before you start](#before-you-start).

**Steps**

1. Open the Targets and budgets page.
2. In **Year**, choose the year to review.
3. Select the main tab for your work.

   | If you need to work with… | Select |
   |---|---|
   | Booking planning | **Booking Target** |
   | Sales planning | **Sales Target** |
   | Financial planning | **Financial Budget** |

4. If you selected **Booking Target**, select the booking subsection.

   | If you need to work with… | Select |
   |---|---|
   | Team targets | **Teams** |
   | Vendor targets | **Vendors** |
   | Account-manager targets | **Account Managers** |
   | Product-type targets | **Product Types** |

5. If you selected **Financial Budget**, select the budget subsection.

   | If you need to work with… | Select |
   |---|---|
   | Cost of goods sold | **COGS** |
   | Selling, general, and administrative costs | **SG&A** |
   | Depreciation | **Depreciation** |
   | Foreign exchange | **FORX** |
   | Net profit | **Net profit** |

**Result:** The selected year and target or budget subsection are on screen.

On entry, **Year** and **Booking Target** are visible. Selecting **Booking Target**
shows the four booking subsections, and selecting **Financial Budget** shows the five
financial-budget subsections. **Reference Commission** is absent on arrival.

## Understand the target and budget tables

Each subsection presents a planning table for one business dimension. The row
identity comes from the selected subsection; branch columns can change with the
company's branch data. Work from the headers and labels visible in the selected
table rather than from technical names.

| Subsection | Planning table or surface | Known reader-facing fields or actions |
|---|---|---|
| **Vendors** | Vendor target table | Company rows, branch-dependent columns, an icon-only edit action, and **Last Modifications** when its history surface is available |
| **Teams** | Team target table | Team rows, branch-dependent columns, and an icon-only edit action |
| **Account Managers** | Account-manager target table | Account-manager rows, branch-dependent columns, and an icon-only edit action |
| **Product Types** | Product-type target table | Product-type rows, branch-dependent columns, **Manage groups**, and an icon-only edit action |
| **Sales Target** | Sales-target surface | Sales-target rows and an icon-only edit action |
| **COGS**, **SG&A**, **Depreciation**, **FORX** | Financial budget tables | Budget rows, branch-dependent columns, and an icon-only edit action |
| **Net profit** | Net-profit table | Net-profit rows and the values available for that selected subsection |

The page has one named year field, **Year**. The editors also provide these labelled
fields:

| Field | Entry rule |
|---|---|
| **Reference Margin** | Number from 0 through 100 |
| **Set target** for a product type | Required number with a minimum of 0 |
| **Set budget** for SG&A | Required number with a minimum of 0 |
| **Set budget** for depreciation | Required number with a minimum of 0 |
| **Set budget** for FORX | Required number with a minimum of 0 |
| **Set target** for product-type sales | Required number with a minimum of 0 |
| **Set margin (%)** | Required number from 0 through 100 |
| **Name** in the distribution-groups editor | Required text |
| **Product types** in the group editor | Product-type selection |

Some editor values appear without a field label: the two principal-target values,
the team rule selectors, the team amount, the team total, and the account-manager
target value. **Reference Commission** does not appear on arrival.

The product-type, budget, and branch-related tables use dynamic column sets. Six sets
are built from branch collections, so the complete list cannot be stated in advance.
A branch column appears according to the branch data available to the company.

Icon-only edit actions open the relevant target or budget editor for vendors, teams,
account managers, product types, sales targets, COGS, SG&A, depreciation, and FORX.
The action is available when its subsection is selected, a branch is open, and
editing is allowed.

![Booking subsection tabs and the selected planning table](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/0cd69369c86896a89609e71e9b5c2523.png)

## Maintain targets and budgets

The maintenance surface opens an editor for the selected row. Enter values only in
the fields that belong to that editor; the field rules differ between target, margin,
budget, and group work.

**Prerequisites**

- Open the relevant year and subsection as described in [Find the target or budget
  area](#find-the-target-or-budget-area).
- Open a branch before using an icon-only edit action or **Manage groups**.
- For group work, have the product types that belong together ready to select.

**Steps**

1. In the selected table, select the row's icon-only edit action.
2. Enter the value in the editor that matches your planning work.

   | Planning work | Editor field |
   |---|---|
   | Vendor target | The editor's principal-target value |
   | Team target | The editor's team rule, amount, or total value |
   | Account-manager target | The editor's account-manager target value; the value has a minimum of 0 |
   | Product-type target | **Set target** |
   | Product-type sales target | **Set target** |
   | Product-type margin | **Set margin (%)** |
   | COGS | The COGS budget editor |
   | SG&A | **Set budget** |
   | Depreciation | **Set budget** |
   | FORX | **Set budget** |
   | Net profit | The net-profit editor |

3. For product-type, sales-target, or COGS work, select **Manage groups** to open
   the product-type redistribution groups.
4. In the distribution-groups editor, select **Group**.
5. In **Name**, enter the group name.
6. In **Product types**, select the product types that belong to the group.
7. Select **Next Year** when the subscription, permission, and maximum-year
   conditions allow a new target year.

   If the year already exists, the page reports "You already have a booking target for <year>"
   instead of creating another one.

8. Select **Export** to export the current list.

These messages can appear while you maintain or export target and budget data:

| Situation | Message |
|---|---|
| A supported save succeeds | `Data saved Successfully` |
| A supported delete succeeds | `Data Deleted Successfully` |
| A group or year is added more than once | `This year has been added before.` |
| Import completes | `Data Importing completed` |
| The selected list has no export data | `NO Data to Export` |

**Result:** The selected editor or group surface contains the values you entered, or
the selected list is ready for export. A successful maintenance result is represented
by `Data saved Successfully` or `Data Deleted Successfully` when the corresponding
operation completes.

![Product-type target fields and group entry point](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/674ae07fc5fbae0e4c9bcacf8b350026.png)

## Handle branch and product-group variations

Branch variation is the branch-specific part of a target or budget table. Product
groups collect product types for redistribution work, while **Last Modifications**
provides the vendor history surface.

**Steps**

1. Select the subsection that contains the planning rows.
2. Open a branch before selecting its icon-only edit action.
3. In **Product Types**, **Sales Target**, or **COGS**, select **Manage groups**.
4. Select **Group**.
5. In **Name**, enter the group name.
6. In **Product types**, select at least one product type.
7. In **Vendors**, select **Last Modifications** to open the vendor history surface.

Branch panels and their columns vary with the company's available branches. The vendor
history surface shows a loading indicator while its rows load.

**Result:** The selected branch, product-group editor, or vendor-history surface is on
screen.

![Vendor rows and the Last Modifications history surface](https://atloriaassets.blob.core.windows.net/assets/a438221c-c1af-407c-b9e6-a56c986db846/2da9d2b9be66c4c227096fa3b68c0a92.png)

## When validation or loading fails

Use the message on screen to choose the corrective action.

If the team list cannot load, the visible message is "Error in get teams list for <year>".

| What you see | What it means | What to do |
|---|---|---|
| `Forbidden characters detected. Please remove them and try again.` | A value contains a forbidden character. | Remove the forbidden character and submit the affected entry again. |
| `Error in loading previous years` | Previous-year data did not load. | Reopen the year area and check whether the year data is available. |
| The team list cannot load for the displayed year. | The team list could not load for the displayed year. | Check the selected year and retry the team subsection. |
| `You reached Maximum Years` | The maximum number of years is reached. | Continue with an existing year instead of selecting **Next Year**. |
| A booking target already exists for the displayed year. | A booking target already exists for the displayed year. | Select the existing year and maintain its target instead of creating another one. |
| `Check validation` | The current editor values fail validation. | Review the required fields and their minimum or maximum rules, then correct the values. |
| `Group must have at least one product type` | The group contains no selected product type. | Select at least one value in **Product types**. |
| `Error in saving data` | The save operation returned a save error. | Review the editor values and retry. |
| `Data Importing completed` | The import operation reports completion. | Review the resulting list before continuing. |
| `NO Data to Export` | The selected list has no data to export. | Select a populated list and select **Export** again. |

## Confirm the result and continue

After maintenance, confirm the result using the message or visible list state that
appears after the action. Look for `Data saved Successfully`,
`Data Deleted Successfully`, `Data Importing completed`, or `NO Data to Export`.

Continue with the configuration page that supplies the planning dimension:

| Continue with… | Page |
|---|---|
| Branch records | configuration-company-branchs-view |
| Product types | configuration-company-product-types-view |
| Account managers | configuration-account-managers-view |
| Teams | teams |

**Result:** You know which visible planning surface to review next and which
maintenance outcomes remain dependent on the operation you perform.
