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.

ColumnDescription
IDUnique internal ID of the mapping
Valid fromDate from which the mapping applies
Terminal identifierIdentifier of the terminal (editable directly in the row, see Section 7)
Location IDInternal ID of the assigned location
OrganisationOrganisation/company of the location
Name / Name 2Designation of the location
StreetStreet address
ZIP / City / CountryPostal code, city and country
PO boxPO box of the location
Latitude / LongitudeGeographic coordinates of the location
ReferenceReference string of the location
Service numberNumber 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:

FieldDescription
Terminal identifierIdentifier of the terminal for this mapping
Valid fromDate from which the mapping is valid
LocationSelection of the assigned location via the location search

Procedure

  1. Open Master Data › Pickup Receipt Location Mappings.
  2. Click «Add» or select an existing mapping and click «Edit».
  3. Enter the terminal identifier and the validity date.
  4. Select the desired location via the location search.
  5. 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.

  1. Select exactly one mapping in the list.
  2. Click «Copy» in the toolbar — the dialog opens with the data of the source mapping.
  3. Adjust the desired fields (e.g. terminal identifier or location).
  4. 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.

  1. 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.
  2. As soon as changes are present, the «Save» button in the toolbar becomes active.
  3. 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.

  1. Select one or more mappings in the list.
  2. Click «Delete» in the toolbar.
  3. 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.

ColumnDescription
Vehicle IDInternal ID of the vehicle
NameDesignation of the vehicle
RefIdReference ID of the vehicle
License plateVehicle license plate
TPU licenseLicense 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.

ColumnDescription
Product IDInternal ID of the product
NameDesignation of the product (translated in the respective display language)
Product referenceReference string of the product
Product identifierIdentifier 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.