Boxpi API
Globe Pickup Points integrates with Boxpi, a cross-border logistics aggregator. One API connection gives you more than 60 carrier services across 16 European markets, without a separate contract for every national carrier. With this integration, you can:
- Export orders to Boxpi directly from Shopify
- Print shipping labels within Shopify
- Ship to parcel lockers, parcel shops and post offices, or to the customer’s address
- Support cash on delivery (COD)
- Sync delivery statuses back to Shopify
Enabling Boxpi API integration
Section titled “Enabling Boxpi API integration”- In your Shopify admin, open Globe Pickup Points and navigate to Shipping labels. Add a new carrier and select Boxpi.
- Enter your API key — contact Boxpi customer service to obtain it. Live and test environments use different API keys.
- Select the Environment — Production for live shipments, Development for testing against Boxpi’s test API. The API key must belong to the environment you select.
- Configure fulfillment and tagging options as needed (Automatically fulfill orders, Automatically tag orders with tracking number, Custom tag after export, Default weight (kg)).
- Map your Shopify shipping methods to the Boxpi services you want to use.
Exporting and printing labels
Section titled “Exporting and printing labels”You can export orders to Boxpi and print shipping labels directly from Shopify, either in bulk or individually. See Creating shipping labels for the general workflow.
Each order is registered as one Boxpi package. Registration with the end carrier is asynchronous — Globe waits a few seconds for the tracking code to be assigned. If it has not arrived yet, the export still succeeds and the Boxpi package ID is used in the meantime; the delivery-status check replaces it with the real end-carrier tracking number as soon as it appears.
A recipient phone number is required by Boxpi for every shipment. Orders without one are rejected before they are sent.
Carrier services
Section titled “Carrier services”Boxpi is an aggregator — the end carrier is chosen per order by the service you map the shipping method to. Service IDs follow the pattern CARRIER-SERVICE-COUNTRY, for example GLS-COURIER-SK, PACKETA-POINT-CZ or SPS-POSTOFFICE-SK. The middle part tells you how the parcel is delivered:
| Service | Delivery |
|---|---|
| COURIER | To the customer’s address |
| POINT | To a parcel shop or parcel locker |
| POSTOFFICE | To a post office |
62 services are available across Austria, Belgium, Bulgaria, Croatia, Czechia, France, Germany, Greece, Hungary, Italy, Luxembourg, Netherlands, Poland, Romania, Slovakia and Slovenia — including GLS, DPD, DHL, InPost, Packeta, PPL, SPS, Speedy, Sameday, Cargus, FAN Courier, BoxNow, Express One, BRT and the Austrian and Slovak posts.
Pickup points vs. home delivery
Section titled “Pickup points vs. home delivery”- POINT / POSTOFFICE services — the destination is addressed solely by the pickup point the customer selected at checkout; street address fields are ignored. If no pickup point is present on the order, the export is rejected.
- COURIER services — street, city and ZIP code are required. Address line 2 is sent as the house number when it is 10 characters or shorter, otherwise it is appended to the street. The province/region from the order is passed as the country area, which Romanian and Bulgarian couriers require.
Boxpi validates the pickup point against its own point lists. Point IDs from a direct carrier integration do not reliably match Boxpi’s IDs, so shipping methods that are exported through Boxpi must use the Boxpi pickup points in the checkout selector — see Adding pickup point carriers.
Cash on delivery (COD)
Section titled “Cash on delivery (COD)”Boxpi supports COD. The amount is taken from the order and sent in the order’s currency — CZK and HUF are rounded to whole units, other currencies to two decimals. The numeric part of the order name is used as the COD variable symbol.
Boxpi validates the currency against the selected service. If COD in that currency is not allowed for the carrier you mapped, the export is rejected and Boxpi’s own error message is shown on the order.
Enable Automatically update delivery status in Shopify and then Automatically mark Cash on Delivery orders as paid to have COD orders marked as paid in Shopify once the parcel is delivered.
Delivery status
Section titled “Delivery status”Boxpi is one of the carriers where delivery-status sync is available. With Automatically update delivery status in Shopify enabled, Globe polls Boxpi and keeps the Shopify fulfillment status in sync, so you can filter orders by status in the Shopify admin:
| Status in Shopify | Description |
|---|---|
| Tracking added | Registered at Boxpi or the carrier, not yet physically handed over. |
| In transit | Received at the Boxpi warehouse or by the carrier, on its way. |
| Out for delivery | Out for home delivery, or ready for pickup at the point. |
| Failed delivery | Rejected by the carrier, cancelled, lost, returning or returned. |
| Delivered | Delivered, or delivered with the cash on delivery collected. |
The optional Fulfill only when carrier receives the package setting defers the Shopify fulfillment until Boxpi confirms the parcel has physically reached the carrier, instead of creating it at export time.
Label printing
Section titled “Label printing”Boxpi labels are generated as PDFs and can be printed in the following formats:
| Format | Positions per sheet |
|---|---|
| A6 | 1 |
| A4 | 4 (2×2 on a single A4 sheet) |
When printing A4, you can select a starting position (positions 1–4) to reuse partially used label sheets.
Labels are created asynchronously on Boxpi’s side, so a label exists only once the package is registered at the carrier. Globe retries automatically for a few seconds when you print immediately after export.
Return labels are not supported by this integration — returns have to be arranged in the Boxpi portal.
Troubleshooting
Section titled “Troubleshooting”| Issue | Resolution |
|---|---|
| Boxpi authentication failed | Check the API key and make sure it matches the selected environment — live and test keys are different. |
Invalid Boxpi carrier ID | The shipping method is mapped to a value that is not a Boxpi service. Re-map it to a CARRIER-SERVICE-COUNTRY service. |
Pickup point must be selected for pickup point delivery | The order uses a POINT or POSTOFFICE service but has no pickup point. Check that the customer selected one at checkout. |
Recipient phone number is missing | Boxpi requires a phone number for every shipment. Add it to the order before exporting. |
Missing required address fields | Courier services need street, city and ZIP. Complete the shipping address and export again. |
| Package rejected by carrier | The end carrier refused the shipment — Globe shows the carrier’s own error. Fix the data and export the order again. |
| Label not ready in time | Registration at the carrier is still in progress. Wait a moment and print again. |
| Pickup point not accepted | The point ID does not exist in Boxpi’s list for that carrier. Make sure the checkout offers Boxpi pickup points for this shipping method. |