Speedy API

Globe Pickup Points integrates with Speedy, the Bulgarian parcel carrier that runs DPD’s network in Bulgaria. With this integration, you can:

• Export orders to Speedy directly from Shopify
• Print shipping labels within Shopify
• Ship within Bulgaria to the customer’s address, a Speedy office or a Speedy locker
• Send cash on delivery parcels in EUR, also to offices and lockers

Beta

The Speedy integration is in beta, so if something does not work as described on this page, contact help@appfleece.com.

---

Enabling Speedy API integration

1. In your Shopify admin, open Globe Pickup Points and navigate to Shipping labels. Click Add carrier and select Speedy.
2. Enter your Speedy API Username and Password. Speedy issues them to contract customers; ask your Speedy account manager for them.
3. In Speedy service, select the service in your Speedy contract: Standard 24 hours (505) or Standard 24 hours parcel (515). Both are services for parcels within Bulgaria, and both deliver to addresses, offices and lockers.
4. In Shipping paid by, select who pays Speedy for the delivery: Sender (my Speedy contract) or Recipient (pays on delivery).
5. If you take parcels to a Speedy office or locker, enter its ID in Speedy office where you hand in parcels (for example 77). If a courier collects them at your address, leave it empty.
6. Optionally, click Show advanced settings:
   • Sender client ID — if your Speedy contract has more than one sending address, enter the client ID of the one to ship from. Leave it empty to ship from the default address of your Speedy account.
   • Client system ID — leave it empty unless Speedy gave you a client system ID.
   • Default weight (kg) — the default shipment weight in kilograms. If left blank, it is ignored.
7. 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.
   • Automatically tag orders with tracking number — adds the Speedy shipment number to the order as a tag.
   • Custom tag after export — a tag added to the order after every successful label export.
8. Map your Shopify shipping methods to the Speedy service types described in Service types. For a pickup-point shipping method, use Speedy (office or locker if selected, otherwise address) or Speedy to office or locker. Do not use Speedy to address for it: the parcel would go to the customer’s address.

Speedy office where you hand in parcels, Sender client ID and Client system ID take digits only. Globe sends no sender address to Speedy. The sender is the default address of your Speedy account, or the sending address you set with Sender client ID.

---

Exporting and printing labels

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

Globe creates one Speedy shipment with one parcel for each order. The Speedy shipment number is the tracking number. Globe stores it and fetches the label from Speedy each time you print, so you can print a label again later. The Shopify order number is printed on the label.

When automatic fulfillment is on, the fulfillment gets the shipment number, Speedy as the carrier and the tracking link https://www.speedy.bg/en/track-shipment?shipmentNumber=<shipment number>.

Speedy labels in Globe are for deliveries within Bulgaria. Before an order is sent, Globe checks the data Speedy requires:

• The recipient’s phone number, for every delivery: address, office or locker. Speedy takes it as +359… or starting with 0. Foreign numbers work in the + form.
• The recipient’s name, with at least 3 characters. A company name of 3 or more characters makes the company the recipient, with the customer as the contact person.
• For delivery to an address: the street, and a city or a four-digit postcode. The city can be written in Latin or Cyrillic. The street and address line 2 together can have at most 200 characters.

An order that fails a check is not sent to Speedy. The other orders of the batch go on.

The Speedy integration does not sync delivery statuses back to Shopify. Globe does not cancel Speedy shipments; cancel them in your Speedy account.

---

Service types

Select the service type when you export an order, or assign it to a shipping method in the carrier settings:

Service type	Where the parcel goes
Speedy (office or locker if selected, otherwise address)	To the Speedy office or locker the customer selected at checkout. An order without a pickup point goes to the customer’s address.
Speedy to address	Always to the customer’s address, also when the order has a pickup point.
Speedy to office or locker	To the Speedy office or locker on the order. An order without one is refused.

A pickup point of another network, or a DPD point outside Bulgaria, stops the export with Speedy (office or locker if selected, otherwise address) and with Speedy to office or locker. Globe never sends such an order to the customer’s address instead. To ship it to the address, create the label with Speedy to address.

The service selected in Speedy service applies to all three service types.

---

Speedy offices and lockers

Speedy offices and lockers are both addressed by their Speedy office ID. The Speedy integration accepts Speedy points from two pickup point lists:

• DPD pickup points in Bulgaria. Every DPD point in Bulgaria is a Speedy office or locker. The point ID is BG followed by the Speedy office ID padded to five digits: BG08009 is Speedy office 8009.
• Speedy offices from Packeta (Packeta carrier BG Speedy PP). These are Speedy offices only, without lockers. The point ID is the Speedy office ID.

DPD points in other countries are not Speedy points and are refused.

Speedy lockers take parcels up to 20 kg. The limit of an office is between 32 and 1200 kg, depending on the office. Speedy refuses heavier parcels.

---

Cash on delivery (COD)

Speedy collects cash on delivery in Bulgaria in EUR only. The COD amount is taken from the order when it uses a cash on delivery payment method. COD works for deliveries to addresses, offices and lockers.

An order with cash on delivery in another currency, BGN included, is stopped before it is sent to Speedy.

---

Label printing

Speedy labels are PDF files. The following formats are available:

Format	Positions per sheet
10x15 cm	1
A6 on A4	4 (on a single A4 sheet)
A4	1 (the label in the top half of an A4 page)

You cannot choose a starting position on the A4 sheet. With 10x15 cm and A4, the labels follow the order of your selection. With A6 on A4, Speedy sorts them by shipment number.

---

Troubleshooting

When Speedy refuses a shipment, nothing is created at Speedy, and Globe shows Speedy’s message with a hint for the common cases.

Issue	Resolution
Speedy settings are incomplete	Fill in Username and Password. Speedy office where you hand in parcels, Sender client ID and Client system ID take digits only.
Speedy rejected the username or password	Check Username and Password in the integration settings. After this error, Globe does not send the remaining orders of the batch.
The phone number is missing or in a form Speedy does not take	Add or correct the phone number in Shopify (+359…, a number starting with 0, or a foreign number with +) and create the label again.
Speedy needs the recipient’s name with at least 3 characters	Correct the name in the shipping address in Shopify.
The shipping address is outside Bulgaria, incomplete or too long	Speedy labels in Globe are for addresses in Bulgaria. The address needs the street, and a city or a four-digit postcode. The street and address line 2 together can have at most 200 characters, the city at most 50.
Invalid site	Speedy could not match the city and the postcode, for example because the postcode belongs to another city. Check the city and postcode of the shipping address.
The pickup point is not a Speedy office or locker	The point belongs to another network, or it is a DPD point outside Bulgaria. Choose a Speedy office or locker with the Modify pickup point action, or create the label with Speedy to address to ship to the customer’s address.
The order has no Speedy office or locker, or no Speedy office ID	Choose the office or locker with the Modify pickup point action, or create the label with Speedy to address.
The office or locker is closed or unknown at Speedy	Choose another Speedy office or locker with the Modify pickup point action.
Speedy collects cash on delivery only in EUR	The order is in another currency. See Cash on delivery (COD). If Speedy itself refuses the COD, check the amount and your Speedy contract.
The price cannot be determined for provided shipment parameters	Your Speedy contract has no price for this service and payer. Change Speedy service or Shipping paid by in the integration settings.
The order has no weight	Set the product weight in Shopify, enter the weight when you create the label, or fill in Default weight (kg).
Speedy is limiting requests, or Globe could not connect to Speedy	Nothing was created. Try again in a minute.
Speedy did not answer in time, the connection broke off, or Speedy did not confirm the shipment	The shipment may already exist. Check your Speedy account before you create the label again.
Globe stopped before sending an order to Speedy	An earlier order of the batch had no clear outcome, or Globe could not save its shipment. Nothing was created for this order, so you can create its label again.
Speedy created the shipment, but Globe could not save it	Do not create the label again: Speedy would create a second shipment. Print or cancel the shipment named in the message in your Speedy account.
Printed X of Y Speedy labels, or Error printing Speedy labels	The message lists the missing shipment numbers and the reason, for example a shipment number Speedy does not know. If the reason is a connection problem, print again.