Areas

The Areas page is used to manage geographic delivery and pickup areas based on postal codes. An area groups one or more postal code ranges into a named unit and can be assigned a validity period. Defined areas are then available as a selection elsewhere in the application (e.g. for work areas or planning areas).

Note: Managing areas is reserved for administrative users. It is only accessible to the Administrator and Superadministrator roles.

1. Navigation

Area management is accessible via the main menu under Dispatching › Areas.

In the overview, you will find the page in the Areas & Rules category.

2. Areas Overview (Table)

The overview lists all defined areas in a sortable, searchable and paginated table. Each row represents one area.

Default Columns

Note: The All ZIPs column shows the total result calculated from the postal code range, Contains ZIP and Excludes ZIP. Consecutive postal codes are combined into ranges for better readability (e.g. 3000–3010). This column cannot be filtered. The Valid from and Valid until columns can be sorted but cannot be filtered either.

Sorting and Search

By default, the list is sorted in descending order by the Id column. Clicking a column header sorts the list in ascending or descending order by that column. The search field in the toolbar lets you search the table using full-text search.

Multiple Selection

Several areas can be marked at the same time — even across pages. The marked areas form the basis for batch actions such as deletion.

3. Group Filter

The page has no group selection of its own. It displays the areas of the group selected in the global group switcher in the application header. If you change the group there, the table is reloaded automatically.

Restricting the display to the current group (without associated groups) is also controlled for this page via the header.

4. Create or Edit an Area

New areas can be created and existing areas edited via the toolbar. In both cases, a dialog (Add area or Edit area) opens, divided into a left and a right panel.

Create an Area

1. Click «Add» in the toolbar.
2. Fill in the fields in the dialog (see below).
3. Create the area with «Save».

Edit an Area

1. Mark exactly one area in the list.
2. Click «Edit» in the toolbar (alternatively by opening the row).
3. Adjust the desired fields.
4. Apply the changes with «Save».

Left Panel: Input Fields

At the top of the left panel, you see a summary of the area: the area name, the validity («from – to») and the number of postal codes under All ZIPs. The input fields follow below in two groups.

Group General

Group All ZIPs

Right Panel: All ZIPs and Description

The right panel contains two expandable sections:

• All ZIPs: preview of the result of your entries. It shows the number of postal codes contained in the area and the postal code ranges formed from them, and is updated immediately whenever the postal code fields change.
• Description: here you can enter a freely formulated descriptive text for the area (maximum 100 characters).

Validation Rules

The system checks the following conditions. Violations are already shown directly on the affected field during input and are checked again when saving:

• The Area name is mandatory and may not exceed 50 characters.
• Valid from is mandatory.
• Valid until must be equal to or after Valid from.
• Until ZIP must be greater than From ZIP.
• A postal code contained in Contains ZIP may not be in Excludes ZIP at the same time. The affected postal codes are named in the error message.
• The Description may not exceed 100 characters.

Note: The postal codes entered in Contains ZIP and Excludes ZIP are automatically normalized and sorted in ascending order when saving.

5. Delete Areas

Areas that are no longer needed can be removed from the overview.

1. Mark one or more areas.
2. Click Remove in the toolbar.
3. Confirm the security prompt.

Deleting several areas at the same time (batch operation) is supported. After deletion, the table is refreshed.

6. Toolbar

The toolbar of the areas overview provides the following actions:

Note: The buttons for adding, editing and deleting are only shown if the logged-in user has the corresponding permissions.

7. Excel Export

The areas overview can be exported as an Excel file. The export takes into account all records available on the server side — not just the currently displayed page.

8. Templates

The current column and filter configuration can be saved as a template and later restored with a click. Marked templates appear as separate buttons in the toolbar and can thus be applied quickly.

9. Use of Areas in Other Sections

Defined areas are available as a selection elsewhere in the application. In selection and search fields (e.g. for work areas or planning areas), matching areas are offered as suggestions.

The suggestions are filtered according to the following criteria:

• by the entered search text,
• by the associated group,
• by the validity as of the current date (only currently valid areas are suggested).

Already selected areas can be excluded from the suggestions so that no double selection occurs.

10. Summary: Available Actions