Cart validation
When a Packstation or post office is the shipping address, the plugin checks on every cart calculation whether the order can be delivered there. This requires the setting Cart validator (default: on). If a check fails, a message appears in the cart and at checkout, and the order cannot be completed until the customer changes the shipping address.
The checks are:
- Products excluded from Packstation delivery via custom field
- Dimensions and weight (if Validate dimensions and weight is enabled)
- Completeness of the address: pickup location number, post number or e-mail address
- Optionally the existence of the number via the DHL API, see Location check
- Billing address: a Packstation as billing address is rejected
Excluding products
During installation the plugin adds the custom field set Packstation with the switch Delivery to packstation is possible to products (Catalogues → Products → product → Specifications → Custom fields).
| Switch | Default mode | Reversed |
|---|---|---|
| on | may ship to Packstation | may not ship to Packstation |
| off or not set | may not ship to Packstation | may ship to Packstation |
In default mode every product has to be explicitly released. If most products ship to Packstations, enable Reverse custom field setting "Delivery to packstation is possible" in the plugin settings; the custom field is then called Delivery to packstation is not possible and only the exceptions are marked.
Check assignments after switching
Reversing only changes the meaning of the switch, not the stored values. After switching, products have to be re-marked accordingly.
The custom field can be set via bulk edit, import or API (customFields.repertus_packstation_delivery_enabled). Variants inherit the value of the parent product unless they override it.
Affected line items get the note This article cannot be delivered to the selected pickup location in the cart, plus the summary message At least one article cannot be delivered to the selected pickup location. Please change your shipping address.
Dimensions and weight
With Validate dimensions and weight the plugin compares the product data (Product → Specifications → Measures & packaging) with the DHL limits:
| Pickup location | Max. size (L × W × H) | Max. weight per shipment |
|---|---|---|
| Packstation | 75 × 60 × 40 cm | 31.5 kg |
| Post office | 120 × 60 × 60 cm | 31.5 kg |
- Each product must fit into the compartment; rotating is allowed (the sorted edge lengths are compared).
- The total weight of all line items (weight × quantity) must not exceed 31.5 kg. The plugin assumes the order ships as one parcel.
- Products without weight/dimensions: with Block products with missing measurements they are rejected (message … cannot be validated for the selected pickup location); without the setting they are skipped. Missing measurements are written to the log file.
- Digital products and other non-physical line items are not checked.
The check also feeds the address manager: pickup locations the current cart does not fit get the badge Not available for this cart. The customer sees at address selection that a bulky product needs a post office instead of a Packstation, for example.
Messages at checkout
| Message | Cause | Fix for the customer |
|---|---|---|
| At least one article cannot be delivered to the selected pickup location. | Product excluded via custom field | Choose another shipping address or remove the product |
| At least one article exceeds the allowed dimensions for the selected pickup location. | Product too large | Choose a post office instead of a Packstation, or a post address |
| The cart is too heavy for the selected pickup location. | Total weight > 31.5 kg | Split the order or use a post address |
| At least one article cannot be validated for the selected pickup location. | Product without measurements while blocking is enabled | Merchant adds the measurements |
| Please add your post number to the shipping address … | Post number missing (or e-mail for post office) | Edit the address |
| Shipping address incomplete. Please add the number of the Packstation/post office. | Number missing | Edit the address |
| The Packstation/post office of your shipping address could not be found. | DHL does not know the number at this zip code | Correct number/zip code |
| Mismatch between type (Packstation/post office) and given number. | Wrong type selected | Correct the type |
| A Packstation/post office address cannot be used as billing address. | Billing address is a Packstation (e.g. created via API) | Change the billing address |
All texts can be adjusted via the snippets checkout.tonur.packstation.* and error.tonur.packstation.*.