InPost API
Globe Pickup Points integrates with InPost Poland through the ShipX API. With this integration, you can:
- Export orders to InPost directly from Shopify
- Print shipping labels within Shopify
- Ship to InPost Paczkomat lockers and PaczkoPunkt points in Poland
- Ship by InPost Kurier to addresses in Poland, including express by 10:00, 12:00 or 17:00
- Collect cash on delivery in PLN
- Track parcels using the InPost tracking page
Enabling InPost API integration
Section titled “Enabling InPost API integration”You need an InPost account in Manager Paczek (manager.paczkomaty.pl) with your company and invoice data filled in. InPost Kurier standard and express need a courier contract with InPost. On a prepaid account, use InPost Kurier C2C for courier parcels.
- In your Shopify admin, open Globe Pickup Points and navigate to Shipping labels. Click Add carrier and select InPost Poland.
- Enter your ShipX API token and Organization ID. Generate the token in Manager Paczek under Moje konto → API. The organization ID is the number shown next to the token.
- Select the Environment: Production for real parcels, or Development with a token from the InPost sandbox (sandbox-manager.paczkomaty.pl).
- Under How InPost gets your parcels, choose how you hand parcels over:
- Courier pickup at my address: an InPost courier collects the parcels, on a regular pickup agreed with InPost or one you order in Manager Paczek.
- I drop them at any Paczkomat or PaczkoPunkt
- I drop them at a PaczkoPunkt
- I bring them to an InPost branch
- Select the Parcel size for Paczkomat parcels and InPost Kurier C2C. See Parcel sizes.
- Select the Courier service for orders without a Paczkomat: InPost Kurier standard (courier contract) or InPost Kurier C2C (prepaid account). The AUTO product uses it for orders without an InPost point.
- Set the Default length, Default width and Default height in millimetres. InPost Kurier standard and express need parcel dimensions.
- Fill in the sender details, or leave them all empty to print the data of your InPost account (Manager Paczek, Moje konto → Dane). If you fill them in, fill in all of them: Sender company name, Sender name, Sender street, Sender house number, Sender city, Sender ZIP, Sender phone and Sender email. Sender phone is a Polish number with 9 digits, with or without
+48. - Configure fulfillment and tagging options as needed:
- Automatically fulfill orders: Never, Yes, send order shipped email with the tracking number or Yes, do not send order shipped email. When enabled, the order is fulfilled after export with the InPost tracking number, InPost as the carrier and a link to the tracking page.
- Automatically tag orders with tracking number adds the tracking number as an order tag.
- Custom tag after export adds your own tag after every successful export.
Products
Section titled “Products”| Product in Globe | Delivery |
|---|---|
| InPost (Paczkomat if selected, otherwise courier to the address) | To the InPost point the customer picked in checkout, otherwise by the courier service from the settings to the address |
| InPost Paczkomat or PaczkoPunkt (pickup point) | To the InPost point picked in checkout |
| InPost Kurier standard (address) | Courier to the address, courier contract needed |
| InPost Kurier C2C (address, prepaid account) | Courier to the address |
| InPost Kurier express by 10:00, 12:00 or 17:00 (address) | Express courier to the address, courier contract needed |
InPost enables services per account. If your account does not have a service, Globe tells you before anything is sent. Ask InPost to enable it, or choose another product.
Courier services cannot be handed over at any Paczkomat or PaczkoPunkt, and InPost Kurier C2C cannot be handed over at an InPost branch. Courier pickup and PaczkoPunkt work for every service.
Exporting and printing labels
Section titled “Exporting and printing labels”You can export orders to InPost and print shipping labels directly from Shopify, either in bulk or individually. For the label workflow itself, see Creating shipping labels.
Exporting an order creates one InPost shipment. InPost confirms the shipment within a few seconds and assigns the tracking number. Parcels are tracked at https://inpost.pl/sledzenie-przesylek?number=<tracking number>. The Shopify order number is printed on each label as the reference.
If InPost does not confirm a shipment in time, Globe cancels it and nothing is sent. Once a shipment is confirmed, it cannot be cancelled through the API.
Labels are downloaded from InPost each time you print, so a label can be printed again later.
The integration does not sync delivery statuses back to Shopify.
Parcel sizes
Section titled “Parcel sizes”Paczkomat parcels and InPost Kurier C2C are booked by size, up to 25 kg:
| Size | Label in Globe |
|---|---|
| A | Small (A, 8 × 38 × 64 cm) |
| B | Medium (B, 19 × 38 × 64 cm) |
| C | Large (C, 41 × 38 × 64 cm) |
| D | Extra large (D, 50 × 50 × 80 cm, InPost Kurier C2C only) |
InPost charges by size, and the parcel has to fit the locker box. InPost Kurier standard and express use the default dimensions in millimetres instead and take parcels up to 50 kg. Globe checks the shipment weight before export.
Pickup points
Section titled “Pickup points”Globe sends the InPost point name, for example KRA010 for a Paczkomat or POP-WAW364 for a PaczkoPunkt. InPost delivers to points in Poland only. The customer selects the point at checkout; to offer InPost points, see Adding pickup point carriers. Packeta’s InPost lockers in Poland are accepted too.
An order with a point from another carrier’s network is not exported. Choose an InPost point with the Modify pickup point action, or use a courier product.
InPost sends the pickup code to the customer’s e-mail and phone, so orders to a point need both. The phone can be Polish or foreign with the country code, for example +420 777 123 456.
Cash on delivery (COD)
Section titled “Cash on delivery (COD)”InPost collects cash on delivery in PLN only. Globe adds insurance of at least the COD amount to every COD shipment, as InPost requires. An order in another currency is not exported: ship it with another carrier, or set the COD amount in the label panel to 0 if the order is already paid.
Label printing
Section titled “Label printing”InPost labels can be printed in the following formats:
| Format | Labels |
|---|---|
| A6 (10x15 cm) | One label per page |
| A4 | Paczkomat labels on A4 sheets, up to four per sheet; courier labels stay A6 |
Labels for several orders are combined into one PDF. If InPost does not return some labels, Globe prints the others and tells you which shipments are missing.
Troubleshooting
Section titled “Troubleshooting”| Issue | Resolution |
|---|---|
InPost settings are incomplete | The message lists the missing settings. Fill them in the carrier settings. |
InPost rejected the API token | Check the ShipX API token in the carrier settings. It is the token from Manager Paczek (Moje konto → API). |
InPost did not accept organization … for this API token | Check the Organization ID. It is shown next to the token in Manager Paczek. |
… is not enabled on your InPost account | Ask InPost to enable the service, or choose another InPost product. |
InPost Kurier standard and express need an InPost courier contract | On a prepaid account, choose InPost Kurier C2C. |
… parcels cannot be handed over at … | Choose another option under How InPost gets your parcels, or another InPost product. See Products. |
Order … has no InPost Paczkomat or PaczkoPunkt | The order has no InPost point, or its point belongs to another carrier’s network. Choose an InPost point with the Modify pickup point action, or use a courier product. |
InPost Poland delivers within Poland only | InPost Poland ships only to addresses and points in Poland. Ship the order with another carrier. |
InPost cannot use the receiver's phone number … | InPost takes a Polish number (9 digits, with or without +48) or a number with the country code from the countries InPost lists, for example +420 777 123 456. Correct the phone in the order’s shipping address and create the label again. |
Order … has no e-mail address | InPost sends the pickup code to the customer’s e-mail and phone. Add the e-mail to the order. |
InPost Kurier needs street, house number, postcode and city | Correct the address in Shopify and create the label again. |
… needs the parcel dimensions | Set the Default length, Default width and Default height in millimetres in the carrier settings. |
Order … weighs … kg | If the weight is wrong, correct Shipment weight (kg) in the label panel. Otherwise use another product or carrier. |
InPost collects cash on delivery only in PLN | Ship the order with another carrier, or set the COD amount to 0 if the order is already paid. |
InPost does not accept new shipments for this account (debt collection) | Pay the last InPost invoice, or top up a prepaid account in Manager Paczek. |
InPost did not confirm the shipment … so Globe cancelled it | Nothing was sent. Create the label again in a few minutes. |
… Check … before creating the label again | InPost did not confirm the shipment in time, or Globe could not read its answer, but the shipment may exist. Check Manager Paczek before you export the order again. |
| A label is missing from the PDF | Globe prints the other labels and lists the missing shipments. Print again later, or download the label in Manager Paczek. |