Support
Support and diagnostic tools for Xplanis staff: resending shipment webhooks via CSV upload.
The Support page provides special diagnostic and maintenance tools that are available exclusively to Xplanis staff with Superadmin permissions. It is used to carry out targeted support measures during ongoing operations – for example, when shipment notifications to a connected third-party system need to be triggered again.
Note: This page is only visible and accessible to users with Superadmin rights. Regular users do not see these functions.
1. Navigation
The Support page is accessible via the global settings. It is only shown if the logged-in user has the required Superadmin permission.
2. Resend Shipment Webhooks
This function allows webhook notifications for selected shipments to be triggered again. This is useful, for example, when a connected third-party system has not received or processed a notification and the shipment information needs to be transmitted again.
When resending, the notification is regenerated based on the current shipment data. This means that the originally sent message is not repeated; instead, a new message is generated with the current state of the shipment.
Procedure
- Prepare a CSV file with the desired shipments and triggers (see Section 2.1).
- In the Support area, select the prepared
.csvfile using the file selection field. - Click the «Resend» button.
- Wait for the processing to complete. During sending, the area is locked so that no duplicate operations can be triggered.
Once completed, the number of resent notifications is reported back.
2.1 CSV File Format
The file to be uploaded must be a CSV file with exactly two columns. The first line must contain the following header:
ShipmentId,Trigger| Column | Meaning |
|---|---|
| ShipmentId | Unique ID of the shipment for which the notification is to be resent |
| Trigger | Trigger or event for which the notification is generated |
Each additional line describes a notification to be resent.
Note: Duplicate entries are detected automatically and processed only once.
2.2 Behaviour and Restrictions
- The notifications are processed in batches to ensure reliable processing even of larger quantities.
- If the shipment check module is active for a group, shipments that have not yet been checked are skipped during resending.
- Only shipments that are found in the system are taken into account.
3. Download Sample CSV
To help prepare the file in the correct format, a sample CSV is available for download. The corresponding link opens a template file in a new browser tab.
The sample file shows:
- the required two-column structure with the header
ShipmentId,Trigger, - how the individual entries are recorded.
Tip: Use the sample file as a starting point to avoid errors when constructing the header and the columns.
4. Summary: Available Functions
| Function | Description | Requirement |
|---|---|---|
| Resend shipment webhooks | Trigger notifications for the shipments recorded in the CSV again with current data | Superadmin permission, correctly formatted CSV file |
| Download sample CSV | Download a template file with the required format | Superadmin permission |