Hrvatska pošta API

Ce contenu n’est pas encore disponible dans votre langue.

Globe Pickup Points integrates with Hrvatska pošta, the Croatian postal operator, through its HP Shipping Service API. With this integration, you can:

Export orders to Hrvatska pošta directly from Shopify
Print shipping labels within Shopify in A6 or A6 on A4 format
Ship Paket 24 parcels to post offices, parcel lockers (paketomati) or the customer’s address
Collect cash on delivery in EUR
Track parcels on the Hrvatska pošta tracking page

The integration covers parcels within Croatia only.

Enabling Hrvatska pošta API integration

In your Shopify admin, open Globe Pickup Points and navigate to Shipping labels. Click Add carrier and select Hrvatska pošta.
Enter your Username and Password. These are the API credentials Hrvatska pošta issues to contract customers. Ask your Hrvatska pošta account manager for them, or write to npa-3pdx@posta.hr.
Keep Environment on Production. Development connects to the Hrvatska pošta test system.
Choose the Service: Paket 24 D+1, Paket 24 D+2 or Paket 24 D+3. It applies to every parcel. D+1 delivers on the next working day.
Choose How you hand parcels to HP:
- HP courier collects at my address (preselected) — a Hrvatska pošta courier collects the parcels at the sender address. If nobody hands the parcels over, Hrvatska pošta closes the shipment. Do not keep this option if you take the parcels to Hrvatska pošta yourself.
- I drop parcels off at a post office — enter the postcode of the post office in Post office or parcel locker for drop-off.
- I drop parcels off at a parcel locker — enter the 5-digit code of the parcel locker in Post office or parcel locker for drop-off. Parcels dropped off at a parcel locker can only go to a post office or a parcel locker, not to an address, and can weigh at most 30 kg.
Fill in the sender details. Sender company name (printed as the sender on every label), Sender street, Sender city, Sender ZIP (5 digits) and Sender phone are required. Sender house number and Sender email are optional. The house number can also be written into Sender street.
Click Show advanced settings to set:
- Parcel locker size — the compartment size declared for parcels that go to a parcel locker or that you drop off at one: XS (9 x 16 x 64 cm), S (9 x 38 x 64 cm), M (19 x 38 x 64 cm) or L (39 x 38 x 64 cm). M is preselected.
- Default weight (kg) — used when an order has no weight.
Configure fulfillment and tagging: Automatically fulfill orders (Never, Yes, send order shipped email with the tracking number or Yes, do not send order shipped email), Automatically tag orders with tracking number, Custom tag after export and Custom tag after print.
Under Shipping methods, map your Shopify shipping methods to the Hrvatska pošta types described in Service types.

Exporting and printing labels

You can export orders to Hrvatska pošta and print shipping labels directly from Shopify, either in bulk or individually. See Creating shipping labels.

Every label is one parcel with a single package.
The parcel weight is the order weight from Shopify, converted from grams to kilograms. If the order has no weight, Globe uses Default weight (kg). You can also enter the weight in the label panel under Advanced → Shipment weight (kg).
Hrvatska pošta has no second address line, so Globe adds address line 2 to the street.
The Shopify order number is printed on the label.

Before an order is sent, Globe checks the destination country, the pickup point, the recipient’s name, street, city, postcode and phone number, the weight and the COD amount. An order that fails a check is not sent, and the label panel shows the reason. Missing credentials, incomplete sender details or a missing drop-off code stop the whole export.

Each parcel receives a Hrvatska pošta parcel number. If Automatically fulfill orders is enabled, the order is fulfilled with this number and a link to the Hrvatska pošta tracking page: https://posiljka.posta.hr/hr/tracking/trackingdata?barcode=<parcel number>.

Globe does not retry an export on its own. When an export ends without a clear answer from Hrvatska pošta, the parcel may already exist. Check your Hrvatska pošta account before you create the label again.

Service types

Choose the Type for each order in the label panel, or map a type to each shipping method in the carrier settings. Every type uses the Paket 24 delivery time set in Service.

Type	Delivers to
Hrvatska pošta (post office or parcel locker if selected, otherwise address)	The post office or parcel locker the customer selected at checkout. Orders without a pickup point go to the shipping address.
Hrvatska pošta Paket 24 (address)	The customer’s shipping address. A pickup point on the order is ignored.
Hrvatska pošta Paket 24 (post office or parcel locker)	The post office or parcel locker on the order. An order without one is refused.

You can map the first type to pickup point and home delivery shipping methods alike.

The first and the third type refuse an order whose pickup point belongs to another carrier. Globe does not send such a parcel to the customer’s address instead. Choose a Hrvatska pošta point with the Modify pickup point action, or select Hrvatska pošta Paket 24 (address) to ship to the address.

Hrvatska pošta EasyReturn and pallet services are not available.

Pickup points

To offer Hrvatska pošta points at checkout, add Hrvatska pošta as a pickup point carrier in Globe — see Adding pickup point carriers. Globe loads the points from the public data on posta.hr:

Post offices — regular and part-time post offices. Seasonal and customs post offices are not listed, nor are post offices without published opening hours, such as temporarily closed ones.
Parcel lockers — Hrvatska pošta paketomati.

Globe sends the point’s 5-digit Hrvatska pošta code with the parcel: the postcode of a post office, or the code of a parcel locker, which starts with 6. Hrvatska pošta points that come through the Packeta pickup point carrier are accepted too.

Parcel locker deliveries have extra requirements:

The recipient’s phone must be a Croatian mobile number (091, 092, 095, 097, 098 or 099). Hrvatska pošta sends the PIN to it by SMS.
The parcel can weigh at most 30 kg.
The compartment size comes from Parcel locker size.

Post office and address deliveries need a phone number too, but any number is accepted.

Cash on delivery (COD)

Hrvatska pošta collects cash on delivery in EUR only, up to 13,300 EUR per parcel. An order with COD in another currency, or with a higher amount, is refused and no parcel is created. COD works for address, post office and parcel locker deliveries.

Globe prefills the COD amount with the order’s outstanding amount when it recognises the payment method as cash on delivery, for example Shopify’s Cash on Delivery (COD).
If Globe does not recognise your COD payment method, for example one with a Croatian name, no amount is prefilled and the label panel warns that the order is unpaid. Enter the amount yourself.
You can change the amount in the label panel under Advanced → COD amount.

Label printing

Labels are fetched from Hrvatska pošta as PDF when you print them. The following formats are available:

Format	Labels per page
A6	1
A6 on A4	4 (2×2)

On A6 on A4 sheets, printing always starts at the first position; a start position cannot be chosen. The format used by default can be set with Default print option in the carrier settings.

A6 labels print in the order you selected when every label is returned. On A4 sheets, Hrvatska pošta sorts the labels by parcel number. Labels of cancelled parcels, and of parcels that are not on this Hrvatska pošta account, are left out without an error.

Troubleshooting

Issue	Resolution
Username and password are not set, or Hrvatska pošta rejected them	Check Username and Password in the carrier settings. No parcel was created.
Hrvatska pošta login failed, or Globe could not connect to Hrvatska pošta	No parcel was created. Try again in a minute.
Sender address is incomplete	Fill in the sender fields the message lists. Sender ZIP must have 5 digits.
Settings are incomplete: post office postcode or parcel locker code for drop-off	Enter the 5-digit code in Post office or parcel locker for drop-off.
Hrvatska pošta delivers only within Croatia	The order ships to another country. Use another carrier for it.
The pickup point is not a Hrvatska pošta post office or parcel locker	The customer chose another carrier’s point. Choose a Hrvatska pošta point with the Modify pickup point action, or select Hrvatska pošta Paket 24 (address).
The order has no Hrvatska pošta post office or parcel locker, or its point has no 5-digit code	Choose the point with the Modify pickup point action, or select a type that ships to the address.
Parcels dropped off at a parcel locker cannot go to an address	To ship to an address, set How you hand parcels to HP to the post office or courier option.
The order has no weight	Set product weights in Shopify, enter the weight in the label panel, or set Default weight (kg).
Parcel lockers take at most 30 kg	The limit applies to locker delivery and to locker drop-off. Send a heavier parcel to a post office or an address, and set How you hand parcels to HP to the post office or courier option.
Parcel lockers need a Croatian mobile number, or the phone number is missing	Correct the phone number on the order. For a parcel locker it must be a Croatian mobile number (091, 092, 095, 097, 098 or 099).
Not a Croatian postcode, or the recipient’s name, street or city is missing	Complete the shipping address on the order. The postcode must have 5 digits.
Cash on delivery in another currency than EUR, or above 13,300 EUR	See Cash on delivery (COD).
A message that starts with “Hrvatska pošta:“	Hrvatska pošta refused the parcel. Its text, often in Croatian, names the rejected field. Correct the value and export again.
Hrvatska pošta did not answer in time, the connection broke off, or the parcel was not confirmed	The parcel may already exist. Check your Hrvatska pošta account before you create the label again.
Hrvatska pošta created the parcel, but Globe could not save it	Do not create the label again: Hrvatska pošta would create a second parcel. Write to help@appfleece.com with the parcel number.
The carrier did not return the label	Print again in a moment. Hrvatska pošta returns no label for a cancelled parcel or for a parcel that is not on this account. If printing keeps failing, check Username and Password.
Some labels are missing from the PDF	Hrvatska pošta leaves out labels of cancelled parcels and of parcels that are not on this account.

Add Hrvatska pošta pickup points to your Shopify store — pricing, demo & setup →