Toptrans API
Globe Pickup Points integrates with Toptrans, a Czech and Slovak parcel and pallet carrier, enabling seamless order export and shipping label printing directly from Shopify. With this integration, you can:
- Export orders to your Toptrans ZP2 portal
- Print shipping labels within Shopify
- Support cash on delivery (COD) in CZK and EUR
Enabling Toptrans API integration
- In your Shopify admin, open Globe Pickup Points and navigate to Shipping labels. Add a new carrier and select Toptrans.
- Enter your Username and Password — these are the same credentials you use to log in to Toptrans ZP2.
- If you use cash on delivery, enter your bank account number in the format
123456789/0800. - Configure fulfillment and tagging options as needed.
- Map your Shopify shipping methods to the appropriate Toptrans transport urgency type.
Exporting and printing labels
You can export orders to Toptrans and print shipping labels directly from Shopify, either in bulk or individually.
Draft mode vs. auto-send
By default, orders are saved as drafts in ZP2. This lets you review and modify them in Toptrans before dispatching. If you enable the Auto-send option in the carrier settings, orders are immediately dispatched to Toptrans TOPIS after export — labels are generated and available for printing right away.
Service types
When exporting an order, select the transport urgency that matches your agreement with Toptrans:
| Type | Description |
|---|---|
| Standard | Standard delivery |
| TopTime | Time-guaranteed delivery |
| Top Privat | Private address delivery |
| Top Express | Express delivery |
| Rozvoz po avizaci | Delivery after prior notification |
| Osobní odběr | Personal pickup at Toptrans depot |
Advanced shipment options
The following per-shipment options can be set at the time of export. Default values can be configured in the carrier account settings.
| Option | Description |
|---|---|
| Package type | Type of packaging (e.g. Carton, Pallet, Pneu). Defaults to Carton. |
| Recipient notice | Call the recipient before delivery to arrange a delivery time. |
| Number of euro pallets | Number of euro pallets to collect from the recipient (0 = none). |
| Oversize | Mark the shipment as oversized. |
Cash on delivery (COD)
Toptrans supports COD in CZK and EUR only. Configure your bank account number in the carrier settings in the format 123456789/0800. If an order is placed in an unsupported currency with COD enabled, the export will be rejected — you will need to process the order manually or use a different payment method.
Label printing
Labels are printed on A4 paper. When printing, you can choose the starting position on the sheet (positions 1–14), allowing you to reuse partially used label sheets.
Troubleshooting
| Issue | Resolution |
|---|---|
| Authentication error | Check that your username and password match your Toptrans ZP2 login credentials. |
| COD rejected — unsupported currency | Only CZK and EUR are supported. Ensure the order currency matches your COD setup. |
| Order sent when it should be a draft | Verify that Auto-send is disabled in the carrier settings. |