FoxPost API
Globe Pickup Points integrates with FoxPost, a Hungarian parcel carrier with an extensive network of parcel lockers (APM) and home delivery (HD). With this integration, you can:
- Export orders to FoxPost directly from Shopify
- Print shipping labels within Shopify
- Support both parcel locker and home delivery shipments
- Track parcels using the FoxPost tracking page
Enabling FoxPost API integration
- In your Shopify admin, open Globe Pickup Points and navigate to Shipping labels. Add a new carrier and select FoxPost.
- Enter your Username, Password, and API key — these are provided by FoxPost when you register as a business sender.
- Configure fulfillment and tagging options as needed.
- Map your Shopify shipping methods to FoxPost parcel sizes.
Exporting and printing labels
You can export orders to FoxPost and print shipping labels directly from Shopify, either in bulk or individually.
Once exported, each parcel receives a CLFOX tracking number (e.g. CLFOX177200702681811). This number is used for fulfillment tracking and can be looked up on the FoxPost tracking page.
APM (parcel locker) vs. home delivery
FoxPost supports two delivery types, determined automatically based on the customer’s shipping method:
- APM — the parcel is delivered to a FoxPost parcel locker. The destination locker ID is taken from the pickup point selected by the customer at checkout.
- HD (Home Delivery) — the parcel is delivered to the customer’s address.
If the order is assigned to a FoxPost parcel locker but no locker destination is found, the export will be rejected.
Parcel sizes
When exporting an order, select the parcel size that matches the physical dimensions of the shipment:
| Size | Description |
|---|---|
| XS | Extra small parcel |
| S | Small parcel |
| M | Medium parcel |
| L | Large parcel |
| XL | Extra large parcel |
Cash on delivery (COD)
FoxPost supports COD in HUF only. The COD amount is automatically taken from the order total when the order uses a cash on delivery payment method. Orders in other currencies with COD will have the COD amount set to 0.
Label printing
FoxPost labels can be printed in the following formats:
| Format | Positions per sheet |
|---|---|
| A6 | 1 |
| A7 | 8 (on a single A4 sheet) |
| 85×85 mm | 1 |
When printing A7 labels, you can select a starting position on the A4 sheet (positions 1–8) to reuse partially used sheets.
Troubleshooting
| Issue | Resolution |
|---|---|
| Authentication error | Verify your username, password, and API key in the carrier settings. |
INVALID_PHONE | The recipient’s phone number is invalid. FoxPost requires a valid Hungarian phone number in international format (e.g. +36301234567). |
| APM export rejected | The order is assigned to a FoxPost parcel locker but no locker ID was found. Check that the customer selected a pickup point at checkout. |