ShippyPro API

Globe Pickup Points integrates with ShippyPro, a multi-carrier shipping platform that lets you ship through the carrier contracts you have already connected inside your own ShippyPro account. With this integration, you can:

• Export orders to ShippyPro directly from Shopify
• Print shipping labels within Shopify
• Ship to pickup points or to the customer’s address, depending on the carrier service you pick
• Support cash on delivery (COD) and customs declarations (CN22) for cross-border shipments

Orders can be exported to 33 destination countries — the EU, the UK, Switzerland, Norway, the US, Canada and Australia.

---

Enabling ShippyPro API integration

1. In your Shopify admin, open Globe Pickup Points and navigate to Shipping labels. Add a new carrier and select ShippyPro.
2. Enter your API key — you can find it in your ShippyPro account. This is the only mandatory credential.
3. Click Fetch carriers. Globe verifies the key and downloads every carrier and service connected to your ShippyPro account, so you can map them to Shopify shipping methods.
4. Fill in the sender details printed on the label: Sender name, Sender company name, Sender street, Sender city, Sender ZIP, Sender country (a two-letter code such as CZ, SK, HU), Sender phone and Sender email.
5. Configure fulfillment and tagging options as needed — Automatically fulfill orders, Automatically tag orders with tracking number and Custom tag after export.
6. Map your Shopify shipping methods to the fetched carrier services.

There is no separate ShippyPro sandbox in Globe — the API key you enter creates real shipments on your account.

---

Exporting and printing labels

You can export orders to ShippyPro and print shipping labels directly from Shopify, either in bulk or individually. See Creating shipping labels for the full workflow.

Each export creates the shipment and returns a tracking number and a label in one call, so labels are ready to print immediately. Your Shopify order name is sent as the shipment reference and note. Once exported, the tracking number is used for fulfillment tracking — the carrier reported by ShippyPro is written to Shopify as the tracking company.

---

Carriers and services

ShippyPro does not have its own network. The carriers, services and rate cards come from your ShippyPro account, so the list you see when exporting is exactly what you have connected there. If you add a new carrier in ShippyPro, click Fetch carriers again in the Globe carrier settings to pull it in.

If your account returns no carrier list (for example when the ShippyPro API is temporarily unavailable), Globe falls back to manual entry and lets you paste the carrier definition as JSON. Use Copy sample to get the expected format.

---

Pickup points vs. home delivery

• If the order carries a pickup point selected at checkout and you export it on a pickup-point service, Globe sends the point ID to ShippyPro as a carrier option, so the parcel is routed to that point.
• Services whose name marks them as home delivery always ship to the customer’s shipping address, even when a point is attached to the order.

The pickup points themselves can come from any provider you use at checkout, or from the ShippyPro PUDO provider, which queries the pickup points of the carriers in your ShippyPro account live. See Adding pickup point carriers.

When exporting, Globe warns you with a Type selection mismatch banner if the selected ShippyPro carrier does not look like the carrier that owns the pickup point on the order — for example a Packeta point exported on a GLS service. The export is not blocked, so review the banner before continuing.

---

Parcel weight and dimensions

ShippyPro requires a real weight. Globe never invents one: if the order has no weight set in Shopify, the export is rejected. Add product weights in Shopify and export again.

Parcel dimensions are optional. Parcel length (cm), Parcel width (cm) and Parcel height (cm) are advanced options rather than carrier settings, and when no value is set, 1 cm is sent for each dimension. If the selected carrier service offers an insurance option, the shipment is insured for the order total.

---

Customs

For cross-border shipments, Globe builds a CN22 declaration from the order line items — description, quantity, unit value, weight, HS code and country of origin taken from the product’s inventory item. Where the product data is incomplete, these carrier settings fill the gaps:

Setting	Used for
Sender country	Country of origin when a product has none
Contents type	Type of goods declared on the CN22 (Merchandise, Gift, Documents, Commercial Sample, Returned Goods)
DDP countries	Destination countries shipped as DDP (duties paid by you); every other destination is sent as DDU

Content description (the description of the shipment contents, Goods by default) and HS code (the tariff code used when a product has none) are not carrier settings — they are advanced options you fill in per shipment in the export dialog.

---

Cash on delivery (COD)

ShippyPro supports COD. When the order has an amount left to collect, Globe sends the COD amount together with the order currency, and ShippyPro passes it to the end carrier. Orders with nothing to collect are exported as regular shipments. Whether COD is actually available — and in which currencies — depends on the carrier contract behind the selected service in your ShippyPro account.

---

Delivery status

Delivery-status sync is not available for ShippyPro — parcel statuses are not written back into Shopify, so progress has to be followed in ShippyPro or on the end carrier’s tracking page. The tracking number and tracking link are still attached to the fulfillment. Return labels are not supported either; create them in ShippyPro directly.

---

Label printing

Labels are requested from ShippyPro at print time in the chosen size, and all labels in a batch are merged into a single multi-page PDF:

Format	Description
A6	Label rendered at 10.5 × 14.8 cm
A4 (4-up)	Label rendered at 21 × 29.7 cm

Because ShippyPro renders the label itself, the exact layout on the page comes from the end carrier’s own label template. Labels can be reprinted at any time — Globe fetches a fresh download URL for each shipment, and falls back to the label URL stored at export time.

---

Troubleshooting

Issue	Resolution
”Invalid API key — please check your ShippyPro credentials”	The key was rejected by ShippyPro. Copy it again from your ShippyPro account and save the carrier.
”ShippyPro API key is not configured”	The API key field is empty on the carrier account. Fill it in and save.
”No carriers configured. Use the ‘Fetch carriers’ button”	The carrier list has never been downloaded. Open the carrier settings and click Fetch carriers.
”Please select a carrier before exporting.”	The service chosen for the order is not in the fetched list — usually after the list changed. Re-fetch carriers and map the shipping method again.
”Order has no weight set.”	ShippyPro requires a non-zero weight. Add product weights in Shopify, then export again.
Export rejected with a carrier error message	ShippyPro passes the end carrier’s validation error through, together with its suggested fix — typically an incomplete address, an unsupported destination, or a service not enabled on your account.
Parcel shipped to the address instead of the pickup point	The carrier service has no pickup-point option stored. Click Fetch carriers again to refresh the carrier options, then re-export.
”Could not retrieve label for order …”	Neither the fresh label URL nor the stored one could be downloaded. Wait a moment and print the batch again; if it keeps failing, re-export the order.