Bring API
Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.
Globe Pickup Points integrates with Bring through the Mybring Booking API. With this integration, you can:
- Export orders to Bring directly from Shopify
- Print shipping labels within Shopify, as Bring sends them for label printers or on A4
- Ship to Bring pickup points and parcel lockers in Norway, Sweden and Denmark
- Ship to addresses by home delivery or business parcel, and by home mailbox parcel within Norway
- Ship from Norway within Norway, and from Sweden or Denmark to Sweden, Denmark, Norway and Finland
- Track parcels on Bring’s tracking pages
There is no cash on delivery. See Cash on delivery (COD).
Enabling Bring API integration
Section titled “Enabling Bring API integration”You need your own Bring customer number in Mybring, a Mybring user with booking rights for that customer number, and an API key for that user. Create the API key in Mybring under Settings, API.
- In your Shopify admin, open Globe Pickup Points and navigate to Shipping labels. Click Add carrier and select Bring.
- Enter your Mybring login (API user ID): the e-mail address you log in to Mybring with.
- Enter the API key. It belongs to the Mybring user from the previous step.
- Enter your Customer number for API bookings, as Mybring shows it under Settings, API. For parcels within Norway, use your main customer number. Bring books and invoices every parcel under it.
- Leave the Booking mode on Test bookings (for Bring’s approval). Bring approves your test labels before you switch to Live bookings. See Booking mode.
- Select the Sender country: Denmark (DK), Norway (NO) or Sweden (SE). See Routes.
- Fill in the sender address: Sender company name, Sender street, Sender ZIP, Sender city and Sender phone. The company name is printed on every label as the sender. Bring requires the phone: use the country code, for example
+4791234567. Sender ZIP has 4 digits in Norway and Denmark and 5 in Sweden. Sender name and Sender email are optional. - Set the Default length in centimeters, Default width in centimeters and Default height in centimeters. Bring needs the size of every parcel. Globe sends these dimensions with each one, rounded to whole centimetres.
- Select the Label size: Standard (10.2 x 19.2 cm) or A6 (10 x 15 cm). Choose A6 only if Bring has enabled A6 labels for your customer number.
- Optionally, click Show advanced settings and set the Default weight (kg). It is used when an order has no weight.
- Configure fulfillment and tagging options as needed. They apply to live bookings only:
- 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 Bring consignment number, Bring as the carrier and the tracking link Bring returns.
- Automatically tag orders with tracking number adds the consignment number as an order tag.
- Custom tag after export adds your own tag after every successful export.
- Map your Shopify shipping methods to a Bring product. The mapping is optional. You can change the product for each order when you create the label.
Booking mode
Section titled “Booking mode”Bring checks test bookings with your own customer number before you create live labels. The Booking mode starts on Test bookings (for Bring’s approval).
- Bring answers a test booking like a real one, with a consignment number, a tracking link and a label.
- Test bookings are not sent or invoiced. Their labels say TEST LABEL.
- Globe does not fulfil or tag orders for test bookings.
- In the label panel, a test booking shows
(test booking, not for shipping)after the service name.
To go live:
- With Test bookings (for Bring’s approval), create labels for a few orders with each Bring product you will use: pickup point, home, business parcel, mailbox parcel.
- Send Bring the PDF labels and the consignment numbers, and ask Bring to approve them. The label panel and the batch print page show both.
- Once Bring confirms, switch the Booking mode to Live bookings.
Routes
Section titled “Routes”The Sender country decides where Globe books Bring parcels:
| Sender country | Destinations | Pickup point chosen in checkout |
|---|---|---|
| Norway | Norway | Within Norway |
| Sweden or Denmark | Sweden, Denmark, Norway and Finland | Within and between Sweden and Denmark |
Bring needs a customs declaration for parcels leaving Norway, which Globe does not send. An order from Norway to another country is not exported. Book it in Mybring.
From Sweden or Denmark, Bring does not deliver to a chosen pickup point in Norway or Finland. Use Bring home delivery or business parcel for those orders.
An order to any other country is not exported.
Products
Section titled “Products”| Product in Globe | Delivery |
|---|---|
| Bring (pickup point or parcel locker if selected, otherwise home delivery) | To the Bring pickup point or parcel locker picked in checkout, otherwise home delivery to the address. Also used when no product is set. |
| Bring Pickup parcel / PickUp Parcel (pickup point; the nearest one if none selected) | To the Bring pickup point or parcel locker picked in checkout. Without one, to the point nearest the customer, which Bring picks. |
| Bring home delivery (Parcel home plus / Home Delivery Parcel) | To the address. |
| Bring Business parcel (business address) | To a business address. The company name on the shipping address is the recipient, the person is the contact. |
| Bring Home mailbox parcel (Norway only, up to 5 kg) | To the address, within Norway only. |
Globe books a different Bring service depending on the sender country:
| Product | From Norway | From Sweden or Denmark |
|---|---|---|
| Pickup point | Pickup parcel (5800), up to 35 kg | PickUp Parcel (0340), up to 20 kg |
| Home delivery | Parcel home plus (5600), up to 35 kg | Home Delivery Parcel (0349), up to 35 kg |
| Business | Business parcel (5000), up to 35 kg | Business Parcel (0330), up to 35 kg |
| Mailbox | Home mailbox parcel (3584), up to 5 kg | Not available |
Bring enables services per customer number. If your agreement does not include a service, Bring refuses the booking: ask Bring to add it, or choose another product.
Customer notifications
Section titled “Customer notifications”A parcel to a pickup point, home or a mailbox needs the customer’s phone number or e-mail address, so Bring can tell the customer about it. A parcel locker opens with a code Bring sends by SMS, so it needs a phone number. A business parcel needs neither. A national phone number works: Globe adds the country’s calling code.
Exporting and printing labels
Section titled “Exporting and printing labels”You can export orders to Bring and print shipping labels directly from Shopify, either in bulk or individually. For the label workflow itself, see Creating shipping labels.
Before the first booking of an export, Globe checks the Mybring login, API key and customer number with Bring once. If Bring refuses them, no order is booked.
Exporting an order books one Bring consignment with one package. Bring assigns the consignment number, which is the tracking number. Fulfillment uses the tracking link Bring returns with the booking, which depends on the country. Without one, Globe links https://tracking.bring.com/tracking/<consignment number>. The Shopify order number is sent as the sender’s reference.
The parcel weight comes from the order. If the order has no weight, the Default weight (kg) is used. If neither is set, the order is not exported. Globe checks the weight against the service’s limit before the booking. See Products.
Bring takes up to 35 characters per name, address line and city. Globe shortens a longer name or city. A longer street is split at a space into the second address line when that line is empty; otherwise the order is not exported.
If Globe cannot tell whether Bring booked a parcel, for example because Bring did not answer in time, the error asks you to check Mybring (order history) before you create the label again. Globe then stops before the next order of the batch. The orders it did not send can be exported again safely.
Bookings cannot be cancelled through the API. Bring invoices only parcels it scans, so a label that never goes on a parcel is not invoiced. Creating the label for the same order again books a second consignment: put only one of the labels on the parcel.
The integration does not sync delivery statuses back to Shopify.
Pickup points
Section titled “Pickup points”Globe sends the Bring pickup point ID from Bring’s Pickup Point API, for example 128275, with the point’s country. The customer selects the point at checkout; to offer Bring points, see Adding pickup point carriers.
Parcel lockers come in the same list: Pakkeboks in Norway, Paketbox in Sweden and lockers in Denmark. Globe books them as Pickup parcel or PickUp Parcel, like any other point. Bring’s Finnish points cannot be chosen for a booking.
The point must be in the customer’s country. For the countries where Bring delivers to a chosen point, see Routes.
An order with a point from another carrier’s network, a Bring point without a usable ID, or a Bring point Bring cannot deliver to from your sender country is not exported. It is never shipped to the customer’s address instead. Choose a Bring pickup point with the Modify pickup point action, or use Bring home delivery (Parcel home plus / Home Delivery Parcel).
Bring refuses a point it does not know, for example one that has closed. Choose another point.
Cash on delivery (COD)
Section titled “Cash on delivery (COD)”Globe does not book cash on delivery with Bring. An order with a COD amount is not exported, because a label without COD would hand the parcel over unpaid. Set the COD amount in the label panel to 0 if the order is already paid, or ship the order with another carrier.
Label printing
Section titled “Label printing”Bring labels can be printed in the following formats:
| Format | Labels |
|---|---|
| Label printer, as Bring sends it (10.2x19.2 cm, or 10x15 cm with A6 labels) | One label per page, at Bring’s size: 10.2 × 19.2 cm, 10.6 × 10.9 cm for the home mailbox parcel, 10 × 15 cm with A6 labels |
| A4, two labels per page | Labels at full size on A4 sheets in two columns: two standard labels side by side, home mailbox parcel labels two to a column |
Labels for several orders are combined into one PDF. Globe stores the label link Bring returns with each booking and downloads the label from Bring each time you print, so you can print a label again later. If a label cannot be downloaded, Globe prints the others and names the missing consignments. Print those in Mybring.
Troubleshooting
Section titled “Troubleshooting”| Issue | Resolution |
|---|---|
Bring settings are incomplete: … | The message lists the missing or invalid settings. Fill them in the carrier settings. Sender ZIP has 4 digits in Norway and Denmark and 5 in Sweden. |
Bring did not accept the Mybring login and API key | Check both. The API key belongs to the Mybring user whose login you entered (Mybring, Settings, API). |
Your Mybring user has no customer number … It can book with … or Bring does not accept customer number … for … | Check the Customer number. The first message lists the customer numbers your Mybring user can book with. Within Norway, use your main customer number. |
Your Mybring user has no customer number with booking rights | Ask your Mybring administrator to give the user booking rights for the customer number. |
Customer number … has no Bring agreement for … | Ask Bring to add the service, or choose another Bring product for the order. |
Bring has not enabled A6 labels for customer number … | Set the Label size to Standard (10.2 x 19.2 cm), or ask Bring to enable A6 labels. |
Order … goes from Norway to … or Bring needs a customs declaration for order … | Globe does not send customs declarations. Book the parcel in Mybring. |
Order … goes to … Globe books Bring parcels from … to Sweden, Denmark, Norway and Finland | Ship the order with another carrier. |
Bring's home mailbox parcel goes within Norway only or … does not go between these countries for order … | Choose another Bring product for the order. |
… is not a Bring product | Choose a Bring product for this shipping method in the carrier settings. |
… has a pickup point of another network … or Wrong carrier for this order | Choose a Bring pickup point with the Modify pickup point action, or use Bring home delivery. |
… has a Bring pickup point without a point id Globe can use | Choose the point again with the Modify pickup point action, or use Bring home delivery. |
… the Bring pickup point … is in …, but the shipping address is in … or … is not in the recipient's country | Choose a point in the customer’s country with the Modify pickup point action. |
Bring cannot deliver a parcel from … to a chosen pickup point in … | Use Bring home delivery or business parcel for the order. See Routes. |
Bring cannot deliver … to the pickup point … | Choose another Bring point, or another Bring product for the order. |
Bring does not know the pickup point … | The point may have closed. Choose another Bring point with the Modify pickup point action and create the label again. |
… goes to the Bring parcel locker …, which opens with a code Bring sends by SMS | Add the customer’s mobile number to the shipping address in Shopify, or choose a Bring pickup point that is not a locker. |
Order … has neither a phone number nor an e-mail address or Bring needs the customer's mobile number or e-mail address | Add a phone number or an e-mail address to the order in Shopify. |
the shipping address needs … or the street address does not fit Bring's two address lines of 35 characters each | Correct or shorten the shipping address in Shopify and create the label again. |
Order … has no weight | Set the product weight in Shopify, enter Shipment weight (kg) in the label panel, or set a Default weight (kg). |
Order … weighs … kg, and … takes at most … kg or The weight of order … does not fit … | If the weight is wrong, correct Shipment weight (kg) in the label panel. Otherwise choose another Bring product. |
The parcel of order … is too big for … | Check the default dimensions in the carrier settings, or choose another Bring product. |
Order … has cash on delivery (…) or This carrier's labels cannot carry cash on delivery | Set the COD amount to 0 if the order is already paid, or ship the order with another carrier. |
… Nothing was booked; try again in a minute, Globe could not connect to Bring … or Bring is limiting requests right now | Nothing was booked. Try again in a minute. |
Bring refused the parcel for order … | The message ends with Bring’s own reason. Correct the order or the settings and create the label again. |
… Check Mybring (order history) before creating the label again | Bring did not confirm the booking, but it may exist. Check Mybring before you export the order again. If it exists, put only one of the labels on the parcel. |
Globe stopped before sending order … to Bring | Nothing was created for this order. Create its label again once the cause named in the message is fixed. |
Bring booked consignment … for order …, but Globe could not save it | Do not create the label again. Print the label of that consignment in Mybring, or write to help@appfleece.com with the consignment number. |
Printed … of … Bring labels. Missing: … | Globe printed the other labels. Print again later, or print the missing ones in Mybring. |