Pickup Receipt Location Mappings
Link pickup receipts to locations, maintain terminal identifiers, and manage the associated vehicle and product mappings.
The Pickup Receipt Mappings (PIDX) page (pickup receipt location mappings) links pickup receipts to locations (POIs). Each mapping stores a terminal identifier, a validity date and a location. For every mapping, the associated vehicles and products can also be managed — each with its own identifier.
This page is intended for administrators who set up and maintain the data import for loading and pickup receipts.
Note: This page is only available if the module for importing loading/pickup receipts (PIDX) is enabled for the tenant.
1. Navigation
The management is accessible via the main menu under Master Data › Pickup Receipt Mappings (PIDX).
2. Layout of the Workspace
The page is structured as a split workspace with three areas whose size can be freely adjusted:
- Top – Location mappings: the main table with all pickup receipt location mappings.
- Bottom left – Vehicle mappings: the vehicles assigned to the mapping selected above.
- Bottom right – Product mappings: the products assigned to the mapping selected above.
The dividers between the areas can be dragged with the mouse to enlarge or shrink the areas. Via the full-screen button of the respective toolbar, the detail areas can be shown and hidden so that the main table occupies the entire surface.
The two detail tables always refer to the row selected in the main table. When the selection changes, they are automatically reloaded.
3. Overview Table of Location Mappings
The main table shows all location mappings in a paginated, sortable and searchable list. Clicking a column header sorts the list by that column in ascending or descending order.
| Column | Description |
|---|---|
| ID | Unique internal ID of the mapping |
| Valid from | Date from which the mapping applies |
| Terminal identifier | Identifier of the terminal (editable directly in the row, see Section 7) |
| Location ID | Internal ID of the assigned location |
| Organisation | Organisation/company of the location |
| Name / Name 2 | Designation of the location |
| Street | Street address |
| ZIP / City / Country | Postal code, city and country |
| PO box | PO box of the location |
| Latitude / Longitude | Geographic coordinates of the location |
| Reference | Reference string of the location |
| Service number | Number of the service provision |
Clicking a row selects the mapping and loads the associated vehicle and product mappings into the lower areas.
4. Group Filter
The filter bar lets you restrict the display to a specific organisation group. The desired group is selected via the group search field; the table then shows only the mappings of that group.
Note: The selected group determines not only the display but also which vehicles and products are automatically created as sub-mappings when a new mapping is created (see Section 5).
5. Creating or Editing a Mapping
Via «Add» a new mapping is created; via «Edit» an existing, selected mapping is opened. In both cases, a dialog appears with the following fields:
| Field | Description |
|---|---|
| Terminal identifier | Identifier of the terminal for this mapping |
| Valid from | Date from which the mapping is valid |
| Location | Selection of the assigned location via the location search |
Procedure
- Open Master Data › Pickup Receipt Location Mappings.
- Click «Add» or select an existing mapping and click «Edit».
- Enter the terminal identifier and the validity date.
- Select the desired location via the location search.
- Save.
Automatic Creation of Sub-Mappings
When a new mapping is created, the system automatically generates the associated vehicle and product mappings for all vehicles and products of the selected group. These then appear in the two detail tables and can be further maintained there.
Note: Only one mapping may exist per location and terminal identifier. If an already existing combination is used when saving, the system rejects this with an error message and the operation is not saved.
6. Copying a Mapping
With «Copy», an existing mapping is duplicated together with all associated vehicle and product mappings.
- Select exactly one mapping in the list.
- Click «Copy» in the toolbar — the dialog opens with the data of the source mapping.
- Adjust the desired fields (e.g. terminal identifier or location).
- Save — the copy is created as a new mapping together with all copied vehicle and product mappings.
Note: The button is only active if exactly one row is selected.
7. Editing the Terminal Identifier Directly in the Row
The Terminal identifier column can be edited directly in the table without opening the full dialog.
- Click in the input field of the Terminal identifier column of the desired row and change the value. Several rows can be edited one after another.
- As soon as changes are present, the «Save» button in the toolbar becomes active.
- Click «Save» — all changed terminal identifiers are applied together.
As long as unsaved changes are present, the Save button remains active. Only after saving are the values considered applied.
8. Deleting a Mapping
Mappings that are no longer needed can be removed from the overview.
- Select one or more mappings in the list.
- Click «Delete» in the toolbar.
- Confirm the security prompt.
The selected mappings are removed.
Note: Deletion is only available to users with the corresponding permission.
9. Vehicle Mappings
The area at the bottom left shows the vehicles assigned to the location mapping selected in the main table. The table is reloaded each time the selection in the main table changes and is not paginated.
| Column | Description |
|---|---|
| Vehicle ID | Internal ID of the vehicle |
| Name | Designation of the vehicle |
| RefId | Reference ID of the vehicle |
| License plate | Vehicle license plate |
| TPU license | License information (editable directly in the row) |
Editing the TPU License
The TPU license column can be edited directly in the row, like the terminal identifier. After changing one or more values, the Save button becomes active; on saving, all changes are applied together.
Deleting a Vehicle Mapping
Selected vehicle mappings can be removed via the area's delete function.
10. Product Mappings
The area at the bottom right shows the products assigned to the location mapping selected in the main table. This table, too, is reloaded each time the selection changes and is not paginated.
| Column | Description |
|---|---|
| Product ID | Internal ID of the product |
| Name | Designation of the product (translated in the respective display language) |
| Product reference | Reference string of the product |
| Product identifier | Identifier of the product (editable directly in the row) |
Editing the Product Identifier
The Product identifier column can be edited directly in the row. After changing one or more values, the Save button becomes active; on saving, all changes are applied together.
Deleting a Product Mapping
Selected product mappings can be removed via the area's delete function.
11. Toolbar of the Main Table
The toolbar above the location mappings provides the following functions:
- Add / Edit: Opens the dialog for creating or editing a mapping (see Section 5).
- Copy: Duplicates the selected mapping together with its sub-mappings (see Section 6).
- Delete: Removes the selected mappings (see Section 8).
- Save: Applies changes made directly in the row (see Section 7).
- Select all / Clear selection: Selects or deselects all mappings on the current page.
- Refresh: Reloads the current view.
- Quick search: Searches the displayed list across all columns.
- Templates / Layout functions: Apply saved layout templates, adjust column display and arrangement, or reset the layout.
- Full screen: Hides the lower detail areas so that the main table occupies the entire surface; clicking again shows them once more.
The layout settings are saved per user and are retained after logging out.
12. Notes
- The page is only available if the module for importing loading/pickup receipts (PIDX) is enabled.
- Creating, editing and deleting require the corresponding user permissions; without these, the associated buttons are not displayed.
- The selected organisation group controls both the displayed mappings and the vehicle and product mappings automatically created when adding.