Skip to content
D
Documentation

Edit branch

reference
6 min readUpdated

Before you start

An existing branch is a branch record already present in the company configuration. Use this page to maintain its information and save the changed record.

The edit record opens from the branch list. It contains the branch form, contact information, saved-record areas, and default-margin settings for the selected branch.

If you need to…Go to
Open an existing branch from the listBranches
Review the branch form and its fieldsBranch information fields
Maintain contacts or the branch logoMaintain branch details and contacts
Review saved areas and marginsReview saved areas and default margins
Correct a validation or save problemFix validation and save problems
Create a branch that does not exist yetNew branch
Maintain the existing branch logo on its registered pageEdit branch logo

Find and open the branch

The Branches list is the entry point for selecting the branch record to edit.

Prerequisites

  • Sign in to the application.
  • Confirm that the branch already exists in Branches.
  • Have edit permission for the branch, or new permission with the branch ID set to 0.

Steps

  1. Open Configurations > Company > Branches.
  2. Select the data row for the branch you want to maintain.
  3. Select the row's edit action.

Result: The selected branch edit screen is open.

Understand the branch information

The branch edit screen is a form for maintaining one existing branch record. The main form contains branch identity, registration, financial-year, currency, address, and contact information.

AreaWhat you use it for
Main branch formMaintain branch information before saving the record.
Contact InformationAdd a Phone, Fax, Mobile, Email, Website, or Online Support contact.
DefaultOpen the default-margin panel.
Last ModificationsOpen the log-history panel.
SaveSave the branch record and remain on the record.
Save and CloseSave the branch record and return to the previous location.

When a branch logo is present, upload and delete actions appear beside it.

Branch information fields

A configurable field is required only when your company configuration enables that requirement.

FieldUse or rule
Display NameBranch name. It is configurable and has a required validator when empty.
Full NameFull branch name. Pattern validation applies.
StatementBranch statement.
Managing DirectorManaging director information.
Company Registration No.Company registration number.
VAT ID NumberValue-added tax identification number.
VatRateVAT rate from 0 through 100.
Financial Year StartSelect a day from 1 through 30 and a month from January through December. Day and month are required when empty under the form validators.
Reference CurrencyRequired currency selection. It is disabled when the branch has jobs.
Local currencySelect a currency from the available currency list. The choices are company-currency records returned at runtime, and each option displays the record's currency name. This selection is required.
StreetAddress street, shown when the branch has an address.
Zip CodeAddress postal code, shown when the branch has an address.
CountryAddress country, shown when the branch has an address.
StateAddress state, shown when the branch has an address.
CityAddress city, shown when the branch has an address.

The currency and country choices come from records available to the company at run time. Address fields appear when the branch has an address.

Note: Use the branch list to choose a different existing branch.

Maintain branch details and contacts

Contact information identifies the ways colleagues can reach the branch. Use Contact Information to add the contact types that apply, then enter each value in its corresponding field.

Prerequisites

  • The existing branch edit screen is open.
  • You know the branch details and contact values to record.

Steps

  1. Update the branch detail fields that need to change.

  2. Select Contact Information.

  3. Select the contact type.

    If you need to add…Select…
    A telephone numberPhone
    A fax numberFax
    A mobile numberMobile
    An email addressEmail
    A websiteWebsite
    Online support detailsOnline Support
  4. Enter the contact value in its corresponding field.

  5. For a Phone, Fax, or Mobile value, keep the value within the maximum length of 20.

  6. If you need to maintain the logo, select the upload icon and use Attach in the upload surface.

  7. If you need to remove the logo, select the delete icon beside the branch logo.

  8. Confirm the deletion when the application asks Are you sure you want to delete this item?.

Result: The changed details, applicable contact values, and completed logo operation are prepared on the branch record.

Review saved areas and default margins

Saved areas show the branch's default-margin settings or recorded modifications. A default margin defines the margin choice used for the branch; the available child controls depend on that choice.

When the branch has a company-branch ID, select Default for the default-margin panel or Last Modifications for the log-history panel. The Registrations tab, nominal commission, and nominal margin controls are not available on this screen.

Choice or areaWhat appears
DefaultThe default-margin panel.
Last ModificationsThe log-history child area.
Fixed margin choiceA fixed-percentage choice and its fixed margin value field.
Descending absolute choiceThe descending-absolute option.
Descending accumulative choiceThe descending-accumulative option.
Accumulative or decreased-percentage choiceThe degressive-margin child area.

The fixed margin value accepts 0 through 100 and appears only for the fixed-percentage choice. The degressive-margin child appears for accumulative or decreased-percentage choices. The accumulative-margin area does not offer a currency choice on this screen.

The saved-record tabs and default-margin choices

Fix validation and save problems

Use the message on screen to locate the correction.

MessageWhat to do
Name is requiredEnter a value in Display Name before saving.
Just '_' '-' And '.' Characters AcceptedCorrect the name so it satisfies the name pattern.
requiredComplete the financial-year day or month that is empty.
Branch does not existReturn to Branches and open an existing branch row.
Please insert degressive margin listAdd the required degressive margin list before saving the margin values.
Error: Server ErrorCheck the record and retry after the server error is resolved.
Error while saving data Check the values and save again.
Are you sure you want to delete this item?Confirm only when you intend to remove the logo item.
Logo Deleted SuccessfullyThe logo deletion completed.

If no success message appears and the record does not change, verify the values and retry the applicable save action rather than treating the save as complete.

Save branch changes

Use the table to choose the save action that matches where you want to continue.

If you need to…Select…Then confirm…
Save and remain on the branch recordSaveBranch saved Successfully
Save changed default-margin valuesThe margin area's Save actionData saved Successfully
Save the branch and leave the recordSave and CloseBranch saved Successfully

Prerequisites

  • The branch details and contacts are complete.
  • Any changed default-margin values are complete.
  • The form has no validation message.

Steps

  1. Select the save action from the table that matches where you want to continue.
  2. Confirm the corresponding success message from the table.

The unsaved-change guard applies when leaving the edit screen. If a save does not show its success message, correct the displayed problem and repeat the applicable save action.

Result: Save keeps you on the branch record with the changed values submitted. Save and Close returns you to the previous location after submitting the changed record.

Continue after editing

After the record is saved, continue from the saved branch outcome.

If you need to…Continue to…
Review or select another branchBranches
Create a branch that does not existNew branch
Maintain the existing branch logoEdit branch logo

Was this page helpful?

Need help using the product?

Edit branch — PAMS Fresh Generation