FAN Courier API

Globe Pickup Points integrates with FAN Courier, a Romanian courier with FANbox parcel lockers, PayPoints and FAN offices. With this integration, you can:

• Export orders to FAN Courier directly from Shopify
• Print shipping labels within Shopify
• Ship within Romania to the customer’s address, a FANbox, a PayPoint or a FAN office
• Collect cash on delivery in RON
• Track parcels on the FAN Courier tracking page

Beta

The FAN Courier integration is in beta, so if something does not work as described on this page, write to help@appfleece.com.

---

Enabling FAN Courier API integration

1. In your Shopify admin, open Globe Pickup Points and navigate to Shipping labels. Click Add carrier and select FAN Courier.
2. Enter your selfAWB username and selfAWB password — the username and password you use to log in to selfAWB. FAN Courier gives API access to customers with a signed contract. If you have a contract but no selfAWB login, write to selfawb@fancourier.ro.
3. Enter the Client ID (branch) of the FAN Courier branch you ship from, shown in selfAWB. The branch address is the sender on every label. If your account has only one branch, leave the field blank and Globe uses that branch.
4. Turn on ePOD (10.5x14.8 cm labels) only if ePOD is active on your FAN Courier contract. With ePOD, FAN Courier prints a 10.5×14.8 cm label for thermal printers and confirms delivery by email instead of on paper. Without ePOD, the label is the A5 AWB form.
5. Configure fulfillment and tagging options as needed:
   • Automatically fulfill orders — fulfills the order in Shopify with the AWB number and the tracking link, with or without the order shipped email.
   • Automatically tag orders with tracking number — adds the AWB number as an order tag.
   • Custom tag after export and Custom tag after print — add your tag after each successful export or print.
6. Choose the Default print option (see Label printing).
7. Click Show advanced settings to set:
   • Parcel dimensions (cm) — length x width x height, for example 30x20x10. FAN Courier requires dimensions on every AWB, and Globe sends these for all parcels from this account. If left blank, 30x20x10 is sent.
   • Default weight (kg) — the default shipment weight in kilograms. If left blank, it is ignored.
8. Map your Shopify shipping methods to FAN Courier service types (see Service types). The mapping is optional, and you can change the service type when you create a label.

---

Exporting and printing labels

You can export orders to FAN Courier and print shipping labels directly from Shopify, either in bulk or individually. For the label workflow itself, see Creating shipping labels.

Globe creates one AWB with one parcel for each exported order. FAN Courier labels in Globe cover deliveries within Romania only. The AWB number is the tracking number, and parcels are tracked at https://www.fancourier.ro/awb-tracking/?tracking=<AWB number>.

Each AWB is built from the order and your settings:

• Sender — your FAN Courier branch. Shipping is paid by the sender.
• Weight — required. Set product weights in Shopify, enter the weight in Shipment weight (kg) in the label creation panel, or set Default weight (kg). FAN Courier keeps whole kilograms, so Globe rounds the weight to the nearest kilogram, with a minimum of 1 kg.
• Dimensions — Parcel dimensions (cm) from the carrier settings, with each side rounded up to a whole centimetre.
• Phone — required. Romanian numbers are sent in the national form, for example 0723456789.
• Address — for address delivery, the shipping address needs a street and a Romanian county. A six-digit postcode is sent when the address has one.
• Order number — printed on the label and sent as the AWB’s cost centre, which FAN Courier lists in the shipping slip report.

Globe does not repeat an AWB request that timed out, because FAN Courier may already have created the AWB. See Troubleshooting for what to do then.

---

Service types

Select the service type in the Type field when you create a label, or map it to your shipping methods:

Service type	Delivers to
FAN Courier (pickup point if selected, otherwise address)	The FAN Courier point the customer chose at checkout. An order without a pickup point goes to the customer’s address.
FAN Courier Standard (address)	The customer’s address, even when the order has a pickup point.
FAN Courier pickup point (FANbox, PayPoint or FAN office)	The FAN Courier point on the order. An order without one is refused.

With the first and the third service type, an order whose pickup point belongs to another network is refused, never shipped to the customer’s address instead. To ship it to the address, choose FAN Courier Standard (address). When an order with a pickup point is set to FAN Courier Standard (address), the label creation panel shows a warning before you export it.

Globe picks the FAN Courier service from the destination and from whether the order is cash on delivery:

Destination	Service	Service with COD
Customer’s address	Standard	Cont Colector
FAN office	Standard	Cont Colector
FANbox	FANbox	FANbox Cont Colector
PayPoint	CollectPoint	CollectPoint Cont Colector

---

Pickup points

Pickup point deliveries go to FAN Courier’s own points, which the customer picks at checkout from Globe’s FAN Courier pickup points.

Point	ID starts with	Max weight	Max size
FANbox (parcel locker)	F	30 kg	44×45×40 cm
PayPoint	P	10 kg	60×90×60 cm
FAN office	S	—	—

• Globe checks the weight and the Parcel dimensions (cm) against these limits before it creates the AWB. Each side is rounded up to a whole centimetre, and the parcel may be turned any way to fit. Globe checks no weight or size limit for FAN offices.
• The AWB carries the point’s ID with the county and locality FAN Courier lists for the point, which Globe looks up when you create the label. The customer’s street address is not sent.
• A FANbox delivery needs the customer’s Romanian mobile number (07xxxxxxxx) and email for the pickup code.

---

Cash on delivery (COD)

FAN Courier collects cash on delivery in RON only, up to 10,000 RON per order. Globe refuses other COD orders before an AWB is created.

When the order was placed with a cash on delivery payment method, Globe fills in the COD amount from the order. You can change it in COD amount in the label creation panel.

COD orders use the Cont Colector variant of the service (see Service types), which pays the collected money into the bank account of the FAN Courier branch you ship from.

Destination	Cash on delivery
Customer’s address	Supported
FAN office	Supported
FANbox	The customer pays by card at the locker. Card payment (mPOS) must be active on your FAN Courier contract, otherwise FAN Courier refuses the AWB.
PayPoint	Refused when the PayPoint takes no payments. Globe checks this before it creates the AWB.

---

Label printing

FAN Courier labels can be printed in the following formats. Set the one used by default with Default print option.

Print option	What prints
10.5x14.8 cm (ePOD, else A5)	ePOD AWBs as a 10.5×14.8 cm label, other AWBs as the A5 AWB form
A5	The A5 AWB form
A4	The A5 AWB form on an A4 page

Each print option has one print position per sheet, so there is no starting position to choose. An AWB is ePOD when it was created with ePOD (10.5x14.8 cm labels) turned on. When your selection mixes ePOD and other AWBs, Globe prints them in one PDF, with pages of the same size together.

Globe downloads the labels from FAN Courier each time you print. If FAN Courier does not return some of them, Globe prints the rest and lists the missing AWBs. Orders whose label is missing are not counted as printed and do not get the Custom tag after print.

---

Troubleshooting

Issue	Resolution
Username and password are not set, or FAN Courier rejected them	Enter the username and password you use to log in to selfAWB in selfAWB username and selfAWB password. If you have a contract but no selfAWB login, write to selfawb@fancourier.ro.
FAN Courier could not be reached, or the login failed with an HTTP code	Globe could not connect to FAN Courier, so no AWB was created. Try again later.
Your account has several branches, the client ID is not a number, or FAN Courier returned no branch	Enter the client ID of the branch you ship from, as shown in selfAWB, in Client ID (branch). Use digits only. With several branches, the message lists them with their client IDs.
FAN Courier labels in Globe cover deliveries within Romania only	The shipping address is outside Romania. Ship orders to other countries with another carrier.
The pickup point is not a FAN Courier FANbox, PayPoint or office	The point belongs to another network, or its ID is not a FAN Courier ID. Choose a FAN Courier point with Modify pickup point, or choose FAN Courier Standard (address) to ship to the customer’s address.
The order has no FAN Courier pickup point, but FAN Courier pickup delivery was chosen	Choose a FAN Courier point with Modify pickup point, or a service type that delivers to the address.
FAN Courier no longer lists the pickup point, or the point does not match its county and locality	Choose another FAN Courier point with Modify pickup point.
The order has no weight	Set the product weight in Shopify, enter the weight in Shipment weight (kg) in the label creation panel, or set Default weight (kg) in the carrier settings.
The order is too heavy, or the parcel dimensions do not fit a FANbox or PayPoint	Check the limits under Pickup points and your Parcel dimensions (cm). Choose another point with Modify pickup point, or ship to the address with FAN Courier Standard (address).
FAN Courier collects cash on delivery only in RON, or at most 10000 RON	See Cash on delivery (COD). Ship these orders with another carrier.
The PayPoint takes no payments, or card payment (mPOS) is not active for a FANbox	A FANbox collects COD by card only, which needs card payment (mPOS) on your FAN Courier contract. A PayPoint that takes no payments cannot collect COD. Choose another point with Modify pickup point, or ship to the address.
The order has no recipient phone number, or a FANbox delivery has no Romanian mobile number and email	Add the customer’s phone number to the order. A FANbox delivery needs a Romanian mobile number (07xxxxxxxx) and an email address.
The county is not a Romanian county FAN Courier knows, the street is missing, or The selected recipient.locality is invalid.	Edit the shipping address in Shopify. The province must be a Romanian county and the street must be filled in. If FAN Courier does not know the city, check its spelling and the six-digit postcode.
The message asks you to check selfAWB before creating the label again	FAN Courier may have created the AWB without Globe recording it: the answer did not arrive in time, was lost or unreadable, or Globe could not save it. Look for the AWB in selfAWB before you create the label again. A new export creates a second AWB.
Other messages starting with FAN Courier:	FAN Courier refused the AWB, and the text after the colon is its reason. Correct the order and create the label again.
Printed X of Y FAN Courier labels, or Error printing FAN Courier labels	FAN Courier did not return some or all of the labels, and the message gives FAN Courier’s reason. In a partial print, the PDF holds the labels that came back and the message lists the missing AWBs.