# Introduction URL: https://docs.globe.appfleece.com Globe Pickup Points is a complete shipping solution for Shopify. Automate your shipping process by connecting to 50+ carriers, offering 5M+ pickup points at checkout, and printing labels directly from Shopify for Packeta, GLS, DPD, PPL, Balíkovna, Pošta bez hranic, Magyar Posta, FoxPost, Toptrans and more. Pickup point selection is available during checkout for Shopify Plus stores, in the cart using the cart widget for all plans, and after the order is placed on the thank you and order status pages as a fallback. --- What Globe offers 50+ carriers: DHL, UPS, GLS, DPD, Packeta, PPL, FedEx, InPost, Colissimo, and many more — all in one place 5M+ pickup points: Interactive maps at checkout so customers choose from thousands of convenient locations worldwide One-click label printing: Generate and print shipping labels directly from Shopify admin for supported carriers — no extra fees Real-time synchronization: Live carrier API sync for accurate pickup point data, shipping rates, and delivery tracking Express payment compatible: Works seamlessly with Shop Pay, Apple Pay, Google Pay, and other express checkout methods Bring your own pickup points: Integrate your own pickup point network via API OMS & WMS integration: Built-in sync for Baselinker and Picqer, plus order attributes and CSV export for MetaKocka, Mailstep, Fulfillment.cz, EkoSklad, Shipmall and other logistics tools --- Getting started Follow these steps to integrate Globe Pickup Points with your Shopify store: 1. Configure shipping rates: Set up your shipping rates in Shopify as you normally would. 2. Map shipping rates to carriers: Use the Globe app to link your Shopify shipping rates with supported carriers for accurate delivery options. 3. Add the Globe app block: Embed the Globe app block into your checkout, thank you, and order status pages to let customers select a pickup point. On any Shopify plan, you can also add the cart widget to let customers choose a pickup point directly from the cart. 4. Enable map selection: If you'd like to offer map-based pickup point selection, set up your Google Maps API key. The setup is fast and intuitive, allowing you to get started in minutes. Once integrated, your store will be ready to offer a more flexible and user-friendly delivery experience. --- Explore the documentation The documentation is organized into clear sections to help you make the most of Globe: Guides: Step-by-step tutorials for common tasks and setup, including shipping label creation and printing. FAQ: Answers to frequently asked questions. Settings: Configuration options and customization. Integrations: Details on connecting with carriers and external tools — start with all carrier integrations. Reference: Developer-focused resources, including APIs and metafields. Explore these sections to unlock the full potential of Globe Pickup Points. --- Need help? For questions or support, reach out to our team. We're here to help you streamline your shipping and delight your customers with convenient pickup options. Visit our website to learn more. --- # Can I use a custom design for missing point email reminders? URL: https://docs.globe.appfleece.com/faq/can-i-use-a-custom-design-for-missing-point-email-reminders Yes, you can customize the design of missing point email reminders sent to your customers. By default, Globe uses a notification template that resembles Shopify’s default notification design. However, additional customization options are available. --- Default customization options You can customize the following elements directly within the app: Logo: Add your store’s logo to the email. Button color: Match the call-to-action button with your brand colors. Texts: Edit all text content to suit your store’s tone and messaging, including translations for multilingual customers. --- Creating a fully custom design If you require a completely custom design for your email reminders: 1. Prepare an email template formatted in HTML and CSS. 2. Ensure it includes all necessary details, such as: - Customer instructions for selecting a pickup point. - A call-to-action button or link that we will point to the order status page. - Your store’s branding elements. 3. Send the formatted email template to our support team. Our team will set up the custom template for you and ensure it’s fully integrated with the email reminder system. --- # How can I include the pickup point details in the confirmation email? URL: https://docs.globe.appfleece.com/faq/how-can-i-include-the-pickup-point-details-in-the-confirmation-email Including pickup point details in the order confirmation email is a great way to provide customers with a clear record of their selected location. --- Adding pickup point details to the confirmation email For Shopify Plus stores, you can customize the Order confirmation email to display pickup point details. Follow these steps: 1. Navigate to Settings > Notifications > Customer notifications in your Shopify admin. 2. Select Order confirmation from the list of notifications. 3. Click Edit code. --- Replacing the shipping address with pickup point data 1. Locate the following line in your email template: 2. Replace it with the following Liquid code: `html {% assign PickupPoint = metafields.Globe.PickupPoint %} {% assign globe_config = shop.metafields.globe.config %} {% assign ispickupmethod = false %} {% if PickupPoint and globe_config %} {% assign ordercountry = shippingaddress.country_code | downcase %} {%- comment -%} Gather all shipping method titles into one lowercase haystack {%-endcomment-%} {% assign method_titles = "" %} {% if shipping_method.title %} {% assign methodtitles = shippingmethod.title %} {% endif %} {% for sm in shipping_methods %} {% assign methodtitles = methodtitles | append: "||" | append: sm.title %} {% endfor %} {% assign methodtitles = methodtitles | downcase | strip | replace: '&', '&' %} {% for entry in globe_config %} {% assign entry_name = entry.name | downcase | strip %} {% assign entry_country = entry.country | downcase %} {% if entryname != "" and entrycountry == ordercountry or entrycountry == "all" %} {% if entryname != "" and methodtitles contains entry_name %} {% assign ispickupmethod = true %} {% break %} {% endif %} {% endif %} {% endfor %} {% endif %} {% if PickupPoint and ispickupmethod %} {{ PickupPoint.name }} {{ PickupPoint.addressObject.street }} {{ PickupPoint.addressObject.city }} {{ PickupPoint.addressObject.zip }} {{ shipping_address.country }} {% else %} {{ shippingaddress | formataddress }} {% endif %} --- # How does your app handle automatic subscription orders? URL: https://docs.globe.appfleece.com/faq/how-does-your-app-handle-automatic-subscription-orders Globe is designed to simplify the delivery process for subscription orders by automatically using the last selected pickup point. This ensures that recurring orders are seamlessly delivered to pickup points without requiring customers to reselect their preferred location each time. --- How it works Automatic Pickup Point Selection: - For subscription orders, Globe automatically assigns the last used pickup point from the customer's previous order. - This functionality works with most Shopify subscription apps. No Customer Action Needed: - Customers do not need to select a pickup point for each recurring subscription order, streamlining the process for both customers and merchants. --- Handling closed pickup points In the event that a previously used pickup point becomes unavailable (e.g., due to closure), we recommend the following steps: 1. Remove the pickup point: Ensure the current pickup point is removed from the subscription order. 2. Request a new selection: Contact the customer and ask them to select a new pickup point via the order status page. 3. Remember the new point: Once the customer selects a new pickup point, Globe will automatically save this information and use it for all future subscription orders. --- By automatically managing pickup point selections for subscription orders, Globe helps ensure consistent deliveries with minimal effort. If changes are needed, the process is straightforward, ensuring both you and your customers have a hassle-free experience. --- # What languages does Globe support? URL: https://docs.globe.appfleece.com/faq/what-languages-does-globe-support There are two different surfaces, and they are localized differently — this matters when something "isn't translated". Customer-facing (checkout, thank-you page, cart widget) Everything your customers see — the pickup point selector at checkout, on the thank-you / order status page and in the cart widget — is localized into all the European languages Shopify supports, including Slovak, Slovenian, Romanian, Bulgarian, Greek, the Nordic languages and more. The language follows your storefront/checkout language automatically; there is nothing to configure in Globe. Merchant admin (the Globe app itself) The app administration you work in is available in English, Czech, German, Polish, Spanish, French and Hungarian. This only affects you and your staff — never your customers. Order status texts Order status wording in Shopify's own notifications and on the order status page (e.g. "In transit", "Delivered") comes from Shopify, not from Globe. If those show in the wrong language, check your store's language settings in Shopify admin (Settings → Languages) and your notification templates. Seeing something untranslated for a customer? Message us in the in-app chat with a screenshot and the store language — if it is a string of ours, we'll fix the translation. --- # What to do to limit the number of unselected pickup point orders? URL: https://docs.globe.appfleece.com/faq/what-to-do-to-limit-the-number-of-unselected-pickup-point-orders Unselected pickup point orders can create delays and additional work for merchants. Follow these steps to minimize the number of such orders and ensure a smoother workflow. --- Automatic selection with Shopify Flow Use Shopify Flow to automatically select the nearest pickup point to the customer's address when they don't choose one. This keeps orders fulfillment-ready without blocking checkout or waiting for email follow-up. See Automatic pickup point selection with Shopify Flow for setup instructions and the one-click template. --- Use email reminders Globe can automatically sends email reminders to customers about 5–10 minutes after an order is placed without a selected pickup point. These emails prompt the customer to choose a pickup point via the order status page. Merchants can customize these reminders to include: - Logo - Call-to-action button with a custom color - Translations for different languages --- Add a sentence to shipping rate descriptions For non-Shopify Plus users, it’s essential to communicate when the pickup point selection will occur. Add a note to your shipping rate descriptions such as: “You will choose your pickup point in the next step.” This ensures customers understand the process and reduces confusion. --- Contact the customer directly If email reminders are not effective, follow up with customers by: Email: Send a personalized message requesting they select their pickup point. Phone: Call the customer to expedite the selection process. Provide a link to the order status page in your communications to make it easy for customers to complete the selection. --- Ensure app blocks are set up Merchants should verify that the Globe Pickup Points app blocks are added to: Thank You Page: Prompt customers to select a pickup point immediately after checkout. Order Status Page: Allow customers to return and make the selection if it was missed initially. --- Customize email notifications (Optional) Merchants can customize Shopify’s order confirmation emails with Liquid to include: A sentence with a link like: “Please review your pickup point.” (This works for all Shopify plans) For Shopify Plus Stores: Include pickup point data in the confirmation email as the selection happens at checkout. See How can I include the pickup point details in the confirmation email?. --- Block checkout (Shopify Plus) For the strictest control, you can block checkout entirely when a customer selects a pickup point shipping method but has not chosen a specific pickup point. This prevents incomplete orders from being placed in the first place. See Blocking orders without pickup point for setup instructions. --- Block checkout (Cart widget) If you are using the Globe cart widget, a dedicated checkout validation rule is available for all Shopify plans. It blocks the order at the final checkout step if no pickup point was selected in the cart. See Blocking orders without pickup point for setup instructions. --- By combining email reminders, clear communication in shipping rate descriptions, and app blocks on post-checkout pages, you can significantly reduce the number of unselected pickup point orders. --- # When is a Google Maps API key required? URL: https://docs.globe.appfleece.com/faq/when-is-a-google-maps-key-required How the interactive pickup point map behaves depending on the store's Google Maps API key setup: Stores WITHOUT their own Google Maps API key (non-Plus surfaces — thank-you page, order status page, cart widget): The interactive map works out of the box using Globe's built-in key for the first 100 map views per calendar month. The usage meter is visible in the app under Settings → Google API. Once the 100 free views are used up, customers select pickup points from the list until the counter resets at the start of the next month or the merchant adds their own key. For stores with real traffic, recommend adding their own key. Shopify Plus stores (checkout pickup point selector): The 100 free views do NOT apply in checkout. A Plus store always needs its own Google Maps API key for the interactive map in the checkout selector — without it, checkout shows the list selection only. When a Plus merchant reports the map missing at checkout, the first thing to check is whether a Google Maps API key is filled in under Settings. Google Places API key (all plans): Optional on top of the Maps key. It improves address search in the map (autocomplete, better accuracy) and runs server-side, so it must be a separate key without website restrictions. Search works without it, just less accurately and without suggestions. Setup instructions for both keys: see Google Maps API Keys. --- # Where can I view the selected pickup point in administration? URL: https://docs.globe.appfleece.com/faq/where-can-i-view-the-selected-pickup-point-in-administration The easiest and most comprehensive way to view the selected pickup point in Shopify is by using the Globe Pickup Points app block. Additional options, like order attributes and metafields, provide detailed insights and flexibility. --- Adding and using the app block (Recommended) Open any order in your Shopify admin. Shopify will suggest adding the Globe Pickup Points app block below the order summary. Once added, you can pin the app block to keep it visible for all orders. The app block provides: - Pickup point details, including the carrier logo. - Information if the order is missing a pickup point (and whether an email reminder has been sent). - Confirmation if the order is not a pickup point order. --- Viewing order attributes If you’ve set up order attributes in Globe, they will appear on the right side of the order page under the “Additional Details” section. Attributes can include details such as name, address or ID These attributes are particularly useful for integrations with third-party systems or fulfillment workflows. --- Viewing the metafield in JSON format Open the order in your Shopify admin. Locate the metafield associated with the order to view the pickup point details in JSON format. This option is helpful for advanced users or developers who need raw data for custom workflows. --- Modify pickup point The Modify pickup point action allows you to manage the pickup point data directly from the order page. To use this feature: Open an order in Shopify admin. Under More actions, select Modify pickup point. This block enables you to: - View the current pickup point details. - Update the existing pickup point. - Remove the pickup point if necessary. This block is especially useful for manually managing or correcting pickup point data. --- # Adding pickup point carriers URL: https://docs.globe.appfleece.com/guides/adding-pickup-point-carriers Setting up pickup point carriers in Globe Pickup Points is a crucial step in providing your customers with flexible delivery options. This guide walks you through the process of adding a carrier, configuring settings, and tailoring the experience to meet your store’s needs. --- Adding a carrier To enable a pickup point carrier, follow these steps: 1. Open Globe Pickup Points: Navigate to the Globe app in your Shopify admin. 2. Add a New carrier: - Click Add carrier. 3. Select Your Carrier: - Choose the desired carrier from the list (e.g., UPS, Packeta, Zasilkovna, DHL, etc.). 4. Map Shipping Methods: - Select specific shipping methods from your store’s shipping rates. - Alternatively, specify shipping methods using keywords (e.g., "pickup," "locker"). --- Configuring carrier settings Once your carrier is added, you can customize additional settings to optimize your workflow: Order attributes Add custom order attributes to pass data to third-party systems. Example: Use to include the pickup point ID in your order. For details, see Order attributes. Order tags Configure tags for orders: - Selected Pickup Point Orders: Automatically tag orders where a pickup point is selected. - Unselected Pickup Point Orders: Tag orders where the customer has not yet selected a pickup point. Order notes Choose whether to update the order note with pickup point details, such as name, address, and ID. Shipping address update Replace the shipping address fields with pickup point details (e.g., replace address line with point name or city with point city). For details, see Shipping address update. --- Restricting pickup point types Some carriers support the option to restrict pickup point types — you'll find the restriction section at the bottom of the carrier's settings in Globe. This allows you to display only specific types of pickup points, such as: Automated Lockers: For carriers with self-service lockers. Branches Only: To exclude other types like lockers or P.O. boxes. This setting ensures that customers only see the pickup point types you want to offer. It works per carrier network — for example PPL distinguishes ParcelShop, ParcelBox and AlzaBox; Nova Post distinguishes its point types as well. Offering point types as separate shipping options You can also let customers choose the point types as separate shipping options at checkout — a common request when the types differ in price or payment support (for example offering AlzaBox separately from PPL ParcelShop/ParcelBox). This is available today, no special feature needed: 1. In Shopify admin (Settings → Shipping and delivery), split the carrier into two shipping rates, e.g. "PPL ParcelShop / ParcelBox" and "AlzaBox". 2. In Globe, add the same carrier twice — once for each shipping rate — and map each instance to its rate. 3. In each instance's settings, use the pickup point type restriction at the bottom: leave only AlzaBox enabled on one, and ParcelShop + ParcelBox on the other. Each option then shows only its own pickup points on the map, with the price coming from its own Shopify shipping rate. The same pattern works for any carrier that exposes multiple point types. The "ParcelShop / ParcelBox" instance — AlzaBox unchecked here and enabled on the second PPL instance instead. --- Email reminders Globe allows you to configure automated email reminders for orders with unselected pickup points. These emails use Shopify's default notification template and can be customized to align with your brand: Languages: Add email reminders in different languages. Logos: Include your store logo in the email. Button Colors: Set a custom color for the selection button to match your branding. For custom email design, see Can I use a custom design for missing point email reminders?. --- Finalizing your setup Once you've configured your carrier settings: 1. Test your configuration by simulating an order. 2. Ensure pickup point data is correctly applied to order attributes, tags, and notes. 3. Verify email reminders and other settings to ensure a smooth customer experience. --- # Adding pickup point selector to checkout & post-purchase URL: https://docs.globe.appfleece.com/guides/adding-pickup-point-selector-to-checkout-and-post-purchase Globe provides three methods for displaying pickup points to your customers, depending on your Shopify plan and store setup. --- Checkout With Shopify Plus, customers select their pickup point during checkout using a list or interactive map. This ensures pickup points are confirmed before completing the purchase. Note: Express payment methods like Apple Pay are an exception. In these cases, customers select their pickup point after completing payment. Customers select a pickup point during checkout (Shopify Plus stores). --- Thank You & Order Status Pages For stores on Basic, Shopify, or Advanced plans, customers select their pickup point immediately after completing checkout on the thank you or order status pages. This process is designed to be fast and seamless, maintaining a smooth post-purchase experience. If a customer skips the pickup point selection, you can: Direct them to the order status page via email or a link. Enable automatic email reminders through the Globe app to prompt them to choose a pickup point. Customers choose a pickup point on the thank you page (Basic, Shopify, and Advanced plans). --- Cart widget The cart widget is a theme app extension that embeds a delivery selector on your cart page or cart drawer. Customers choose between home delivery and a pickup point, browse an interactive map, and confirm their selection — all without leaving the cart. Note that customers who use the Buy Now button, express payment methods (Apple Pay, Google Pay), or direct checkout links bypass the cart entirely. The Thank You and Order Status page selection above acts as the fallback for those cases. Stores with complex shipping setups may also not benefit from the cart widget. --- # Automatic pickup point selection with Shopify Flow URL: https://docs.globe.appfleece.com/guides/automatic-pickup-point-selection-with-flow Automatically select the nearest pickup point when a customer doesn't choose one. If a customer completes checkout without selecting a pickup point on the checkout, thank you, or order status pages, you can use Shopify Flow to automatically assign the nearest pickup point to their shipping address. This reduces manual follow-up and ensures orders can be processed and transmitted to your ERP or fulfillment system without delay. --- How it works When an order is placed with a pickup point shipping method but no pickup point has been selected, the Flow triggers and: 1. Uses the customer's shipping address 2. Finds the nearest available pickup point 3. Automatically assigns it to the order The order is then complete with a pickup point, ready for fulfillment. --- Getting started Option 1: Use the template (recommended) Get started with one click using our pre-built Flow template: Open Globe Flow template This opens the Shopify Flow editor with the template loaded. Review the trigger and action, then save and turn on the Flow. Option 2: Create a Flow manually 1. Open the Shopify Flow app in your Shopify admin. 2. Create a new Flow. 3. Set the trigger (e.g. when an order is created). 4. Add a condition to check that the order uses a pickup point shipping method and has no pickup point selected. 5. Add the action Select nearest pickup point (by Globe Pickup Points). 6. Save and enable the Flow. --- When to use this This approach works well when: You prefer not to block checkout (see Blocking orders without pickup point for the alternative) Email reminders alone don't resolve unselected pickup points quickly enough You want orders to be fulfillment-ready without manual intervention The nearest pickup point is typically acceptable for your customers Consider combining Flow with email reminders so customers are prompted to choose before Flow auto-selects. --- # Automatic shipping label creation with Shopify Flow URL: https://docs.globe.appfleece.com/guides/automatic-shipping-label-creation-with-flow Automatically create a shipping label the moment an order is ready — no manual clicks required. Using Shopify Flow, you can trigger Globe's label export automatically based on any condition: order creation, payment capture, fulfillment request, tag added, or any other Flow event. The action uses exactly the same logic as clicking Create shipping labels manually: it reads the default carrier and service type from your carrier account configuration, respects all order metafield overrides, and honours your auto-fulfillment settings. --- How it works When the Flow runs, the action: 1. Reads the order's shipping method and destination country 2. Matches them against your configured carrier accounts to determine the correct carrier and service type 3. Applies any namespace metafield overrides (weight, declared value, COD, currency…) 4. Exports the shipment to the carrier's system — identical to a manual export 5. If your carrier account has Auto-fulfill or Fulfill on carrier handover enabled, fulfillment is created automatically If no carrier account matches the order's shipping method and country, the action completes without creating a label. If the carrier's API returns an error, Shopify Flow marks the run as failed and the error message is shown directly in the Flow run history. --- --- Getting started Step 1 — Verify your carrier mapping Before setting up the Flow, confirm that your carrier accounts are correctly mapped to your Shopify shipping methods. Go to Integrations → [Carrier] → Shipping method mapping and verify that the order's shipping method and destination country resolve to the correct carrier and service type. You can verify this by opening any representative order and clicking Create shipping labels — the panel should pre-select the expected carrier. The Flow action uses the same logic. Step 2 — Create a Flow 1. Open the Shopify Flow app in your Shopify admin. 2. Create a new Flow. 3. Set the trigger — for example: - Order created — to create the label immediately on order placement - Order paid — to wait for payment confirmation first - Fulfillment order created — to create when a fulfillment request is received 4. Add any conditions you need (e.g. filter by shipping method, country, order value). 5. Add the action Create shipping labels provided by Globe Pickup Points. 6. Connect the Order field to the order from the trigger. 7. Save and enable the Flow. --- When to use this This approach is ideal when: You want a zero-touch shipping workflow — labels created the moment an order is paid You use consistent shipping methods that map cleanly to a single carrier and service type You want to combine label creation with other Flow actions (e.g. send a Slack notification, add an order tag) You want failed exports to be visible and trackable in Shopify Flow If your orders require manual carrier or service type selection (e.g. mixed carriers on the same shipping method), continue using the manual Create shipping labels panel. --- # Cart widget URL: https://docs.globe.appfleece.com/guides/cart-widget Give customers a way to choose their pickup point directly in the cart — before they reach checkout. The Globe cart widget adds a delivery selector to your cart page or cart drawer, so customers can pick between home delivery and a pickup point without ever leaving the cart. --- How it works The widget adds two card-style options to your cart: Home delivery — the customer wants a standard delivery to their address. Selecting this clears any previously saved pickup point. Pickup points — the customer wants to collect from a pickup point. Clicking this card opens an interactive map and list, powered by Leaflet and OpenStreetMap (no Google Maps API key required). From the map, customers can search by address, use their location, and browse markers for all nearby pickup points. Once they choose a point, the card updates to display the selected point's name and address, along with a Change button. The selection is saved to the cart and flows into the order automatically. Customers choose between Home delivery and Pickup points directly in the cart. --- Setup 1. Make sure at least one carrier is configured in Globe. See Adding pickup point carriers if you haven't done this yet. 2. Enable the widget in your Shopify theme: - In Shopify admin, go to Online Store → Themes → Customize. - Open App embeds in the left panel. - Find Cart pickup points and toggle it on. - Click Save. You can also reach the theme editor directly from Globe — go to Settings → Cart Widget and click Open theme editor. Enable the Cart pickup points app embed in your theme. 3. In the Globe app, go to Settings → Cart Widget and configure the placement (see below). --- Placement The widget injects itself into your cart at a CSS selector you specify. Different themes use different HTML structures, so you need to point the widget at the right element in your theme. Common selectors: | Theme type | Selector to try | |---|---| | Full cart page | | | Cart drawer | | | Generic | | Not sure which selector your theme uses? Click Get help next to the CSS selector field in Globe — it walks you through how to find the right selector using your browser's DevTools. You can also contact support and we'll identify it for you. You can add multiple placement targets if your theme has both a full cart page and a cart drawer — the widget will appear in both. Configure the CSS selector and layout for each placement target. --- Customisation Translations Customize the four labels customers see: the heading, "Home delivery", "Pickup points", and the "Change" button. Translations can be set per language — the widget automatically detects the customer's browser language and shows the matching text. The app only shows languages that are published in your Shopify store. Colors Eight color settings let you match the widget to your store's design: heading color, text color, card background, card border (normal), card border (selected), icon color, button background, and button text color. Layout Choose between horizontal (the two cards sit side by side) or vertical (the cards stack on top of each other). Horizontal works well on wide cart layouts; vertical is better suited for narrow cart drawers. --- Widget text translations — customise the heading, option labels and subtexts per store language. Checkout address prefill When a customer selects a pickup point in the cart, Globe can automatically pre-fill the checkout shipping address form with that pickup point's address. This saves the customer from re-entering the address and reduces friction. Enable this in Settings → Cart Widget → Checkout address prefill. If your theme uses a non-standard checkout button, enter the button's CSS selector in the Custom checkout button selector field (supports multiple selectors separated by commas, e.g. ). --- Prerequisites Globe app installed with an active subscription At least one pickup point carrier configured in Globe The Cart pickup points app embed toggled on in your theme editor --- # Checkout Shipping (CCS) URL: https://docs.globe.appfleece.com/guides/checkout-shipping Show pickup points as individual shipping rates directly in the Shopify checkout. Each nearby pickup point appears as a selectable option, sorted by distance — no map, no extra steps. --- Availability | Plan | Monthly | Annual | |---|---|---| | Shopify Advanced | Included | Included | | Shopify (Grow) | Available as a paid add-on | Included | | Other plans | Not available | Not available | --- Setup Step 1 — Enable CCS in Globe Go to Settings → Checkout Shipping (CCS), turn on Enable Carrier Calculated Shipping, and save. Globe registers the carrier rate with Shopify automatically. Step 2 — Configure your Shopify shipping rates Set up shipping rates for each carrier in Shopify Admin → Settings → Shipping and delivery. You can set a flat price, free shipping above a certain order value, or weight-based pricing — exactly as you would for any shipping method. Once configured, open the carrier in Globe (Pickup Points → carrier name → CCS section), enable CCS, and click Sync prices from Shopify. Globe reads all your configured rates and conditions automatically. Step 3 — Repeat for each carrier Enable CCS and sync prices for every carrier you want to appear at checkout. --- What customers see Each pickup point appears as a separate shipping rate, sorted nearest first. The label and description are fully customizable — see Checkout appearance below. --- Checkout appearance You can change how pickup points are labelled in checkout under Settings → Checkout Shipping (CCS) → Checkout appearance. The default format is: Available template variables: , , , , , , , , The description field can be left empty if you don't want a second line. --- Limitations Not all carriers support CCS. Incompatible carriers are marked in Globe. Shopify Plus stores should use the Checkout App Block instead — CCS is disabled for Plus stores. Keyword-based shipping methods are not supported for pricing sync. Use explicitly named methods in Shopify. --- Requesting CCS activation (Grow plan) On the Shopify (Grow) annual plan, CCS may need to be activated by Shopify Support. Send them this message: Subject: Enable Carrier Calculated Shipping Hi, please enable Carrier Calculated Shipping (CCS) for my store [your-store.myshopify.com]. I'm on the Shopify Grow annual plan. --- Troubleshooting No pickup points appear CCS is enabled in Settings and on the carrier. Prices have been synced (click Sync prices from Shopify on the carrier settings page). Your Shopify plan supports CCS. Rates appear but price is wrong Re-sync prices after changing your Shopify shipping rates. --- # Custom pickup point networks — what we can take on URL: https://docs.globe.appfleece.com/guides/custom-pickup-point-networks A merchant who wants their OWN locations (their shops, showrooms, partner drop-off points) offered as pickup points does not have to build anything. There are two routes, and the public Custom pickup points API is only one of them. Route 1 — they host a live endpoint. The documented self-service path: Globe calls their HTTPS endpoint with the customer's coordinates and their endpoint returns nearby points as JSON. Suits merchants with a dev team and locations that change constantly. Route 2 — they hand us the data and we run it. We take a source they already maintain and load it into Globe ourselves: a CSV in their Shopify Files, a spreadsheet export, a link to their own locations API, or a one-off list. We set up a scheduled sync (typically daily) against that source, so re-uploading the file is all they ever have to do. This is a real, routine part of the service — several merchant networks run this way today — and it is the answer most merchants actually want. This is the important part for drafting: never tell a merchant that custom or own pickup points are "not supported", "not possible", or "would need you to build an endpoint" just because route 2 is not in the public docs. It is available. When someone sends a CSV or a link to their locations, the correct reply offers to set it up and asks the few things we need. What to ask them (this is the whole intake): 1. Where the source lives — a stable URL is ideal. Note that re-uploading a file in Shopify Files mints a new URL, so ask whether the path stays the same. 2. How often it changes — decides the sync schedule, and whether a daily sync is enough. 3. Which countries the locations are in. 4. Whether they need their own location ID on the order. We can key the points on their ID so it lands on the order for fulfilment, instead of a generated one — worth asking, because it is far cheaper to set up at the start than to re-key later. Setting it up is operator/developer work, not something the merchant does in the admin, so the draft offers it and sets with the concrete action. The points are visible only to that merchant's own stores. One consequence worth knowing: a merchant whose custom network is already live has a pickup provider configured for it. If their account data shows one, the network exists — that is never a shop to tell "we don't do that". --- # What breaks when a store changes its domain URL: https://docs.globe.appfleece.com/guides/domain-dependent-settings Globe runs through Shopify — the admin, checkout UI extensions and theme app extensions are all keyed to the Shopify store, not to the storefront domain. So a merchant moving from oldshop.cz to newshop.eu keeps their carriers, pickup points, shipping rates, labels and orders untouched, and nothing in the Globe admin needs re-entering. Two things are the exception, and both are invisible unless you go and look. Their own Google Maps API key A merchant who added their own Google Maps API key has it restricted, in the Google Cloud console, to a list of HTTP referrers — that restriction is the point of the key. The old domain is on that list and the new one is not, so on the day they switch, the map stops loading for their customers while everything else keeps working. Call the query shop data tool with resource "shop" and read the field hasCustomGoogleMapsKey. When that field is true, the domain change has a required step and it is theirs to perform: 1. Open the Google Cloud console → APIs & Services → Credentials. 2. Open the key used for Globe. 3. Under Application restrictions → Websites, add the new domain with a wildcard path, and the same again with the www prefix. 4. Leave the old domain in place until the migration is finished, then remove it. The full walkthrough is in Google Maps API key — step 6 is the referrer list. When hasCustomGoogleMapsKey is false they are on our built-in key, which carries no per-merchant referrer restriction, and there is nothing to do. A custom sender domain for pickup-point reminder emails If the shop sends pickup-point reminder emails from its own domain, that domain was verified with a DNS TXT record at _globe-verify.THEIRDOMAIN. Moving the storefront to a new domain does not move the record. They either keep sending from the old (still-verified) domain, or verify the new one in Settings → Sender domains and add the TXT record it shows them at their new DNS provider. Call the query shop data tool with resource "carriers" and read the email reminder settings on the carrier. If no reminder emails are configured, this does not apply. What is NOT affected Say so plainly — merchants expect a long list and are relieved by a short one: Carrier accounts, credentials and label export Pickup point providers, mapped shipping rates and prices The cart widget, checkout UI extension and thank-you page selector Existing orders, their saved pickup points and their labels Checkout rules and validation Answering the ticket A merchant announcing a migration is asking a yes/no question with a short tail. Lead with the reassurance, then name only the steps that actually apply to their shop — check hasCustomGoogleMapsKey and their reminder-email config before you answer, rather than listing both exceptions as hypotheticals. --- # Why can't I create a shipping label? URL: https://docs.globe.appfleece.com/guides/shipping-label-troubleshooting When a carrier rejects a label, Globe shows the carrier's error next to the order in the label dialog. Most failures come down to a handful of causes — this page lists them from most to least common, with the fix for each. --- 1. Recipient name or address is too long The most common cause of all. Carriers enforce strict character limits per field (typically around 30–35 characters for the name and for each address line), and they reject the whole label when a field is over the limit — often with a vague error. Fix: open the order in Shopify, edit the shipping address, and shorten the too-long field — usually the customer's company name or a long street line. Move overflow into the second address line if needed, then create the label again. 2. Products have no weight Some carriers reject parcels with zero weight, or calculate the service from weight and fail without it. Fix: set weights on your product variants in Shopify (Products → variant → Shipping → Weight), then create the label again. For existing orders the weight is taken from the ordered items, so fixing the products fixes future orders too. 3. Phone number requirements (GLS and others) Carriers send delivery notifications by SMS, so the phone number on the order matters: GLS requires a mobile number — a landline (or a malformed number) makes the label fail. The country code usually has to match the destination country — an order shipped to Austria needs an Austrian (+43) number, an order to Hungary a Hungarian (+36) one, and so on. A number from a different country is rejected by many carriers. Fix: edit the phone number on the order's shipping address to the customer's mobile number with the correct country prefix, then retry. 4. Missing or invalid pickup point on the order A pickup-point label needs a valid pickup point on the order. If the customer never selected one, or the selected point no longer exists in the carrier's network, the export fails — Globe shows a specific error for this case. Fix: check the order's pickup point (see where it is stored). Ask the customer for the right point or select a replacement, then retry. To reduce these orders at the source, see limiting unselected pickup point orders. --- Still stuck? Message us in the in-app chat and include: the order number (e.g. ), and the exact error text shown in the label dialog. With those two things we can usually point you to the fix right away. --- # Creating shipping labels URL: https://docs.globe.appfleece.com/guides/shipping-labels-creation-and-printing Globe Pickup Points allows you to create and print shipping labels for supported carriers directly from your Shopify admin. This guide covers the general workflow for label creation and printing, without going into technical or competitive details. --- Supported carriers Label creation and printing is available for Packeta (Zásilkovna), PPL CZ, GLS (MyGLS), DPD (Czechia, Slovakia, Hungary, Austria, Latvia, Portugal), Balíkovna (Česká pošta), Slovenská pošta, Magyar Posta, FoxPost, SPS, One by Allegro, Toptrans, DHL Express and UPS, plus the Pošta bez hranic, Boxpi, Spring GDS and ShippyPro aggregators. See all carrier integrations for what each one supports — pickup-point labels, cash on delivery and delivery-status sync. --- Prerequisites Set up your carrier accounts in Globe with valid API credentials Map your Shopify shipping methods to the appropriate carrier Complete sender and (if needed) banking information Set weights on your product variants in Shopify — the parcel weight is calculated from the ordered items --- Creating and printing labels Step 1 — Select order(s) You have two options for how to start: From the Orders list: Check one or more orders you want to create labels for. From a single order detail: Open the order you want to process. Step 2 — Open More Actions In the Orders list (one or more orders selected): Click the ⋯ (three dots) button to open the actions menu. On a single order detail page: Click the More Actions button at the top of the page. Step 3 — Create Shipping Labels In the actions menu, select Create Shipping Labels. This opens the Globe label creation panel where you can review and confirm the order details and select the appropriate service type for each shipment. Orders split into multiple fulfillments offer a label per fulfillment — or tick "Create one label for all fulfillments". Step 4 — Export to carrier Use the carrier export option to send the shipment data to your chosen carrier. This generates the shipping label on the carrier's side. Step 5 — Print labels Once the export is complete, the shipping labels are ready. Print labels for individual or multiple orders directly from the panel. --- Advanced: Overriding export values with order metafields Globe reads order metafields with namespace to override the values used during label export. When present, a metafield takes highest priority — above the label creation panel and carrier defaults. Supported metafields Namespace: **** | Key | Shopify type | Description | |---|---|---| | | Weight | Package weight. | | | Decimal | Declared shipment value. | | | Single-line text | Currency code (e.g. , ). Overrides the Shopify currency. | | | Decimal | Cash on Delivery amount. Set to to suppress auto-detected COD. | | | Single-line text | Description of goods for customs declarations (e.g. ). | Priority chain (highest to lowest): metafield → configured defaults → Shopify order data. Setting metafields Set metafields directly on the order via the Shopify admin Custom data section, or automatically using Shopify Flow with the Update order metafield action. Flow supports dynamic values via its variable syntax, making it suitable for rule-based overrides based on destination country, product tags, shipping method, or other order properties. --- Troubleshooting & best practices Ensure your API credentials and sender information are correct Test with a small number of orders before bulk operations For any issues, consult the carrier-specific documentation or contact support --- Summary Globe's shipping label system provides a simple, unified workflow for creating and printing labels across multiple carriers, helping you streamline your shipping operations. --- # Shopify POS support URL: https://docs.globe.appfleece.com/guides/shopify-pos-support Select pickup points directly from your Point of Sale device. Globe integrates with Shopify POS, so staff can choose a pickup point right after a purchase — without switching to Shopify admin. --- How it works When a customer completes a purchase at your POS with a pickup point shipping method: On the confirmation page: A button appears for staff to select the pickup point immediately. Later: Staff can also go into orders manually and choose the preferred pickup point for any order. This keeps the workflow on the POS device and avoids the need to open Shopify admin on a separate screen. --- Enabling Globe for POS 1. In your Shopify admin, go to Point of Sale. 2. Open Settings. 3. Click Point of Sale apps. 4. Turn on Globe for your staff. Once enabled, your staff can select pickup points directly from the POS device. --- # Balikovna API URL: https://docs.globe.appfleece.com/integrations/balikovna-api Globe integrates with Balikovna (Czech Post B2B), enabling seamless order management and parcel shipping directly from Shopify. With this integration, you can: Send your orders to your Balikovna portal Print shipping labels within Shopify --- Enabling Balikovna API integration 1. In your Shopify admin, open Globe Pickup Points and add or edit your Balikovna provider. 2. Enter your API credentials from Czech Post B2B. 3. Configure export and fulfillment options as needed. 4. Map your Shopify shipping methods to Balikovna. --- Exporting and printing labels You can export orders to Balikovna and print shipping labels directly from Shopify, either in bulk or individually. The process is streamlined for both order management and label generation. --- Service types Balikovna supports various domestic and international service types, including pickup point and post office delivery. You can select the appropriate type during export based on your needs. --- Troubleshooting | Issue | Resolution | | --- | --- | | | Czech Post requires a sender e-mail on every parcel and takes it from the contacts of your submission location (podací místo) on your Czech Post contract — it is not set in Globe. Add a contact e-mail to the submission location in Podání Online (or ask your Czech Post representative to do it). Once it is there, the export goes through without any change in Globe. | | | Only a wrapper for the whole batch. The real reason is in the lines listed with it (for example or ). | | | Czech Post rejected the parcel weight — it is outside the range allowed for the selected service. Check the order weight in Shopify, or enter the real weight of the parcel in the label panel before exporting. | | | The submission location number (číslo podacího místa) does not exist on your contract. Check your submission locations in Podání Online — the most common value is . | --- # Base (Baselinker) URL: https://docs.globe.appfleece.com/integrations/baselinker Globe Pickup Points integrates seamlessly with Baselinker, allowing you to automatically download pickup point data with orders and view it directly in your Baselinker admin. This simplifies order processing and ensures accurate delivery information. --- Automatic pickup-point sync (API key) Add your Baselinker API key once and Globe keeps the pickup point up to date in Baselinker automatically — every time it is added or changed after the order, the change is pushed straight to the matching Baselinker order. 1. In the Globe Pickup Points app, go to Settings → Integrations. 2. Paste your Baselinker API token and click Test connection. 3. Save — that's it. Pickup points now sync to Baselinker automatically. You can generate the token in Baselinker under Account & other → My account → API. --- Setting up Baselinker integration To integrate Baselinker with Globe Pickup Points, follow these steps: 1. Navigate to the Globe Pickup Points app in your Shopify admin. 2. Open the desired provider or create a new one. 3. Enable the Create order attributes option in the provider settings. This ensures pickup point data is passed along with the order. 4. Click on Load from template and select Baselinker to pre-fill the configuration with the required fields. 5. Save your settings. Once configured, Baselinker will automatically download pickup point data for orders, ensuring you have all the necessary information at a glance. --- Viewing pickup point data in Baselinker After setup, pickup point details will appear in Baselinker as part of the order data. This includes essential information such as: Pickup point name and address Pickup point ID Provider details (e.g., Packeta, DHL, etc.) This integration eliminates the need for manual data entry, reducing errors and streamlining your order workflow. --- Benefits of the Baselinker integration Automatic Data Sync: Pickup point details are automatically downloaded into Baselinker with each order, ensuring up-to-date and accurate information. Streamlined Workflow: Simplifies the process of managing orders with pickup points, saving time and effort. Template-Based Setup: Quickly configure the integration using the Baselinker template provided in Globe. --- Start using the Baselinker integration today to automate your order workflow and enhance your delivery operations! --- DHL Postnummer (Packstation) This is only relevant if you ship to DHL Packstation points using a Postnummer (the recipient's DHL post number). If you have connected your API key (above), the Postnummer is synced to Baselinker's automatically together with the pickup point — including when it is added or changed later. No extra setup is needed. Without the API key, you can still get the Postnummer onto the order by adding the following mapping to the ** parameter in Baselinker's advanced integration settings**. Note that this only applies when Baselinker imports the order and does not update on later changes: This copies the value sent by Globe into Baselinker's . The short video below walks through where to add it: Your browser does not support the video tag. --- # Boxpi API URL: https://docs.globe.appfleece.com/integrations/boxpi-api Globe Pickup Points integrates with Boxpi, a cross-border logistics aggregator. One API connection gives you more than 60 carrier services across 16 European markets, without a separate contract for every national carrier. With this integration, you can: Export orders to Boxpi directly from Shopify Print shipping labels within Shopify Ship to parcel lockers, parcel shops and post offices, or to the customer's address Support cash on delivery (COD) Sync delivery statuses back to Shopify --- Enabling Boxpi API integration 1. In your Shopify admin, open Globe Pickup Points and navigate to Shipping labels. Add a new carrier and select Boxpi. 2. Enter your API key — contact Boxpi customer service to obtain it. Live and test environments use different API keys. 3. Select the Environment — Production for live shipments, Development for testing against Boxpi's test API. The API key must belong to the environment you select. 4. Configure fulfillment and tagging options as needed (Automatically fulfill orders, Automatically tag orders with tracking number, Custom tag after export, Default weight (kg)). 5. Map your Shopify shipping methods to the Boxpi services you want to use. --- Exporting and printing labels You can export orders to Boxpi and print shipping labels directly from Shopify, either in bulk or individually. See Creating shipping labels for the general workflow. Each order is registered as one Boxpi package. Registration with the end carrier is asynchronous — Globe waits a few seconds for the tracking code to be assigned. If it has not arrived yet, the export still succeeds and the Boxpi package ID is used in the meantime; the delivery-status check replaces it with the real end-carrier tracking number as soon as it appears. A recipient phone number is required by Boxpi for every shipment. Orders without one are rejected before they are sent. --- Carrier services Boxpi is an aggregator — the end carrier is chosen per order by the service you map the shipping method to. Service IDs follow the pattern , for example , or . The middle part tells you how the parcel is delivered: | Service | Delivery | |-------------|---------------------------------------------| | COURIER | To the customer's address | | POINT | To a parcel shop or parcel locker | | POSTOFFICE | To a post office | 62 services are available across Austria, Belgium, Bulgaria, Croatia, Czechia, France, Germany, Greece, Hungary, Italy, Luxembourg, Netherlands, Poland, Romania, Slovakia and Slovenia — including GLS, DPD, DHL, InPost, Packeta, PPL, SPS, Speedy, Sameday, Cargus, FAN Courier, BoxNow, Express One, BRT and the Austrian and Slovak posts. --- Pickup points vs. home delivery POINT / POSTOFFICE services — the destination is addressed solely by the pickup point the customer selected at checkout; street address fields are ignored. If no pickup point is present on the order, the export is rejected. COURIER services — street, city and ZIP code are required. Address line 2 is sent as the house number when it is 10 characters or shorter, otherwise it is appended to the street. The province/region from the order is passed as the country area, which Romanian and Bulgarian couriers require. Boxpi validates the pickup point against its own point lists. Point IDs from a direct carrier integration do not reliably match Boxpi's IDs, so shipping methods that are exported through Boxpi must use the Boxpi pickup points in the checkout selector — see Adding pickup point carriers. --- Cash on delivery (COD) Boxpi supports COD. The amount is taken from the order and sent in the order's currency — CZK and HUF are rounded to whole units, other currencies to two decimals. The numeric part of the order name is used as the COD variable symbol. Boxpi validates the currency against the selected service. If COD in that currency is not allowed for the carrier you mapped, the export is rejected and Boxpi's own error message is shown on the order. Enable Automatically update delivery status in Shopify and then Automatically mark Cash on Delivery orders as paid to have COD orders marked as paid in Shopify once the parcel is delivered. --- Delivery status Boxpi is one of the carriers where delivery-status sync is available. With Automatically update delivery status in Shopify enabled, Globe polls Boxpi and keeps the Shopify fulfillment status in sync, so you can filter orders by status in the Shopify admin: | Status in Shopify | Description | |-----------------------|------------------------------------------------------------------------------| | Tracking added | Registered at Boxpi or the carrier, not yet physically handed over. | | In transit | Received at the Boxpi warehouse or by the carrier, on its way. | | Out for delivery | Out for home delivery, or ready for pickup at the point. | | Failed delivery | Rejected by the carrier, cancelled, lost, returning or returned. | | Delivered | Delivered, or delivered with the cash on delivery collected. | The optional Fulfill only when carrier receives the package setting defers the Shopify fulfillment until Boxpi confirms the parcel has physically reached the carrier, instead of creating it at export time. --- Label printing Boxpi labels are generated as PDFs and can be printed in the following formats: | Format | Positions per sheet | |------------|-------------------------| | A6 | 1 | | A4 | 4 (2×2 on a single A4 sheet) | When printing A4, you can select a starting position (positions 1–4) to reuse partially used label sheets. Labels are created asynchronously on Boxpi's side, so a label exists only once the package is registered at the carrier. Globe retries automatically for a few seconds when you print immediately after export. Return labels are not supported by this integration — returns have to be arranged in the Boxpi portal. --- Troubleshooting | Issue | Resolution | |----------------------------------------------|--------------------------------------------------------------------------------------------------------------| | Boxpi authentication failed | Check the API key and make sure it matches the selected environment — live and test keys are different. | | | The shipping method is mapped to a value that is not a Boxpi service. Re-map it to a service. | | | The order uses a POINT or POSTOFFICE service but has no pickup point. Check that the customer selected one at checkout. | | | Boxpi requires a phone number for every shipment. Add it to the order before exporting. | | | Courier services need street, city and ZIP. Complete the shipping address and export again. | | Package rejected by carrier | The end carrier refused the shipment — Globe shows the carrier's own error. Fix the data and export the order again. | | Label not ready in time | Registration at the carrier is still in progress. Wait a moment and print again. | | Pickup point not accepted | The point ID does not exist in Boxpi's list for that carrier. Make sure the checkout offers Boxpi pickup points for this shipping method. | --- # Shopify shipping carrier API integrations URL: https://docs.globe.appfleece.com/integrations/carrier-api-integrations Globe connects your Shopify store to shipping carriers in two ways: Pickup points at checkout — customers pick a parcel locker, parcel shop or post office from a wide range of carriers. See the full carrier list. Direct carrier API integrations — for the carriers below, Globe also exports orders to the carrier and prints shipping labels inside Shopify, so you never re-key an order into a separate carrier portal. Each carrier has its own setup guide. For the label workflow itself — selecting orders, choosing a service, batch printing and metafield overrides — see Creating shipping labels. Automatic delivery-status sync For labels created in Globe, the app can also track the parcel with the carrier and update the Shopify order automatically — the fulfillment status moves as the parcel does (in transit, delivered, failed delivery), and cash-on-delivery orders are marked as paid once the carrier confirms delivery. Enable it per carrier with Automatically update delivery status in the carrier's settings. Currently supported for: Packeta (Zásilkovna), PPL, GLS (MyGLS), DPD, Balíkovna, Pošta bez hranic and Boxpi. --- Carriers Packeta (Zásilkovna) — pickup points and home delivery across Europe, with 2-way delivery-status sync PPL CZ — Czech and cross-border delivery, return labels and customs support MyGLS — GLS ParcelShop and home delivery from a Central European GLS account DPD — Czechia, Slovakia, Hungary, Austria, Latvia and Portugal Balíkovna — Česká pošta pickup points, post offices and home delivery Slovenská pošta — Slovak post offices, BalíkoBOX lockers and home delivery SPS — Slovak Parcel Service, Balíkovo pickup points and parcel terminals Magyar Posta (MPL) — Hungarian post offices, parcel lockers and home delivery FoxPost — Hungarian parcel lockers and home delivery One by Allegro — Czech Intime pickup points, One Box parcel boxes and home delivery Toptrans — Czech parcels and pallet freight DHL Express — worldwide express with Service Points and full customs support UPS — worldwide home and business delivery with customs support Aggregators One connection, many end carriers — useful when you ship across several markets and don't want a contract with every national carrier. Pošta bez hranic — around 130 courier products across 25 countries Boxpi — 60+ carrier services across 16 European markets Spring GDS — cross-border consolidation to 49 destinations ShippyPro — ship through the carriers already connected to your ShippyPro account Order & warehouse management Pass pickup-point data to your OMS, WMS or fulfillment partner so the warehouse always has the correct delivery details. Globe pushes the pickup point over the platform's API for: Base (Baselinker) Picqer Other platforms read the data Globe writes to the Shopify order — enable Create order attributes on your carrier and the pickup point travels with the order into their import. This is how MetaKocka, Mailstep, Fulfillment.cz, EkoSklad and Shipmall work. The attribute names are configurable, so you can match whatever field names your partner expects — see Order attributes, or Point metafield if your partner reads the raw JSON. Data export CSV export — custom, Liquid-templated CSV exports of orders with pickup-point data --- Don't see your carrier? Globe offers pickup points for many more carriers without a direct API integration, and you can add your own with the custom pickup points API. Browse the complete carrier list, or install Globe on Shopify. --- # CSV export URL: https://docs.globe.appfleece.com/integrations/csv-export The CSV Export feature in Globe Pickup Points allows you to create custom CSV templates for exporting orders, including pickup point data. This is especially useful for carriers that support CSV imports, such as DHL or PPL, enabling seamless parcel management and label generation. Setting up a custom CSV export Follow these steps to create and use a custom CSV export template: 1. Navigate to Export in the left-side menu. 2. Click on Add export to create a new export template. 3. Define the column names and use Liquid templating to specify the values. 4. Save your configuration. 5. Go to the Orders page and select the orders you wish to export. 6. Under More actions, select Export with Globe. 7. Choose your custom template, click Export, and follow the link to download your CSV. Liquid variables and conditions You can use order and point variables in the export values. All available values are based on the following example. For instance, you could use for customer's name. Liquid conditions are also supported, you can use for example: --- # DHL Express API URL: https://docs.globe.appfleece.com/integrations/dhl-express-api Globe Pickup Points integrates with DHL Express over the MyDHL API, enabling worldwide express shipping directly from Shopify. With this integration, you can: Export orders to DHL Express and receive a tracking number immediately Print shipping labels within Shopify Deliver to the customer's address or to a DHL Express Service Point Send full customs data (HS codes, DDP or DAP terms) on international shipments DHL Express is enabled per store on request. If you do not see it when adding a new carrier, contact support and we will enable it for your store. --- Enabling DHL Express API integration 1. In your Shopify admin, open Globe Pickup Points and navigate to Shipping labels. Add a new carrier and select DHL Express. 2. Select the Environment — Production for live shipments, or Development (Test) for the MyDHL test environment. Test and production credentials are different. 3. Enter your Username and Password — your DHL Express API credentials from the DHL Developer Portal or your DHL account manager. 4. Enter your Account number — the DHL Express account the shipments are billed to. 5. Fill in the sender details used as the shipper on every label: Sender name, Sender address (street and number), Sender city, Sender postal code, Sender country, Sender phone and Sender email. Only countries supported by this integration are offered in the country list. 6. Enter a Default content description — a short description of the shipment contents for customs (for example or ). This is mandatory: an order with no description, either default or per order, is not exported. 7. Optionally, under advanced settings, set a Default HS code and a Default weight (kg) used when the products have none. 8. Configure Automatically fulfill orders, Automatically tag orders with tracking number and Custom tag after export as needed. 9. Map your Shopify shipping methods to the DHL Express services enabled on your account. --- Exporting and printing labels You can export orders to DHL Express and print shipping labels directly from Shopify, either in bulk or individually. See Creating shipping labels for the general workflow. Each order is sent as a single package. DHL returns the tracking number and the label PDF in the same response, so labels are ready to print immediately after export. If Automatically fulfill orders is enabled, the fulfillment is created with the tracking number and a link to DHL tracking. One thing this integration does not do: no courier pickup is booked. Shipments are created without a pickup request — arrange collection with DHL as you normally do. --- Service types | Service | Description | |------------------------------------------------|---------------------------------------------| | DHL Express Worldwide | Standard door-to-door express delivery | | DHL Express Worldwide – Service Point (D2SVP) | Delivery to a DHL Express Service Point | | DHL Express 12:00 | Time-definite delivery by 12:00 | | DHL Express 10:30 | Time-definite delivery by 10:30 | | DHL Express 9:00 | Time-definite delivery by 09:00 | | DHL Economy Select | Economy service | Globe picks the DHL product code that matches the lane — domestic, intra-EU or worldwide — from the service you selected. The service still has to be active on your DHL account; DHL rejects shipments for products you are not contracted for. --- Service Point vs. home delivery Service Point (D2SVP) — the parcel is delivered to the DHL Express Service Point the customer selected at checkout. Globe sends the point's 6-character MyDHL facility ID together with DHL's Service Point value-added service, so the label carries the SPD marking. The Service Point is set as the receiver and the customer's own address is sent as the buyer, which DHL requires for this service. Home delivery — every other service delivers to the customer's shipping address. A Service Point export needs a genuine DHL Express point, taken from the DHL Express pickup point map (configured with the same MyDHL credentials — see Adding pickup point carriers). Orders with no pickup point, or with a point from a different carrier's network, are rejected during export. --- Customs and duties Shipments that cross a customs border — anything other than domestic or EU to EU — are exported with a full electronic declaration built from the order's line items: description, quantity, unit price, weight, HS code and country of manufacture. HS codes come from the product's harmonized system code in Shopify and fall back to your Default HS code; the country of manufacture comes from the product's country of origin and falls back to your sender country. In the Customs & duties section of the carrier settings: | Setting | Effect | |------------------------------------|-----------------------------------------------------------------------------| | DDP countries | Destinations shipped on DDP terms (duties and taxes billed to you). Everything else uses DAP. | | Send values ex-VAT for countries | For the selected destinations, the declared value is sent without VAT. | Per order, you can override HS code and Content description in the label dialog before exporting. --- Cash on delivery (COD) COD is sent to DHL as the cash collection value-added service. The amount is the outstanding amount on the order, in the order's currency, collected in cash. COD must be enabled on your DHL Express account and available on the destination lane — DHL Express offers it in a limited number of countries only, so confirm with DHL before you offer it in your checkout. If the service is not available, DHL rejects the whole shipment. --- Delivery status Delivery-status sync is not available for DHL Express — statuses are not written back into Shopify. The tracking number and tracking link are still attached to the fulfillment, so the parcel can be followed on dhl.com. Return labels are not supported either. --- Label printing Labels are generated as PDF at 300 DPI in the following formats: | Format | Positions per sheet | |------------|-------------------------| | A6 | 1 | | A6 on A4 | 4 | When printing A6 on A4, you can select a starting position on the sheet (positions 1–4) to reuse partially used sheets. Labels are stored at export time, so reprinting does not call DHL again. --- Troubleshooting | Issue | Resolution | |---------------------------------------------------------------|-------------------------------------------------------------------------------------------------| | Authentication error | Check that Username, Password and Account number match the selected Environment — test credentials do not work against production. | | Content description is required | Set a Default content description in the carrier settings, or fill Content description on the order. | | Service Point: no pickup point selected | The order uses the Service Point service but has no pickup point. The customer did not select one at checkout. | | Service Point: pickup point must be a 6-character facility ID | The selected point does not come from the DHL Express network. The customer must select a DHL Express Service Point. | | Unknown product type | The shipping method is mapped to a service that no longer exists. Re-map the shipping method in the carrier settings. | | Shipment rejected by DHL | The full DHL error message is shown in the export result — usually a product not enabled on your account, an invalid postal code or a missing phone number. | | No label data found when printing | The stored label is missing for those orders. Re-export the orders to generate new labels. | --- # DPD API URL: https://docs.globe.appfleece.com/integrations/dpd-api Globe Pickup Points integrates with DPD, enabling seamless order management and parcel shipping directly from Shopify. With this integration, you can: Send your orders to your DPD portal Print shipping labels within Shopify --- Enabling DPD API integration 1. In your Shopify admin, open Globe Pickup Points and add or edit your DPD provider. 2. Enter your API credentials from DPD. 3. Configure export and fulfillment options as needed. 4. Map your Shopify shipping methods to DPD. --- Exporting and printing labels You can export orders to DPD and print shipping labels directly from Shopify, either in bulk or individually. The process is streamlined for both order management and label generation. --- Service types DPD supports various domestic and international service types, including pickup point and home delivery. You can select the appropriate type during export based on your needs. --- Shipment visibility in DPD portals DPD operates two separate customer portals, so it is important to know where to look for your shipments: DPD Shipping — a tool for creating shipments and labels manually. Shipments created via the API (i.e. by Globe) do not appear here. DPD Business — a dashboard with an overview of all your shipments, including those created by Globe. If you do not have access to the DPD Business portal, ask your DPD sales representative to set it up for you. --- # FoxPost API URL: https://docs.globe.appfleece.com/integrations/foxpost-api Globe Pickup Points integrates with FoxPost, a Hungarian parcel carrier with an extensive network of parcel lockers (APM) and home delivery (HD). With this integration, you can: Export orders to FoxPost directly from Shopify Print shipping labels within Shopify Support both parcel locker and home delivery shipments Track parcels using the FoxPost tracking page --- Enabling FoxPost API integration 1. In your Shopify admin, open Globe Pickup Points and navigate to Shipping labels. Add a new carrier and select FoxPost. 2. Enter your Username, Password, and API key — these are provided by FoxPost when you register as a business sender. 3. Configure fulfillment and tagging options as needed. 4. Map your Shopify shipping methods to FoxPost parcel sizes. --- Exporting and printing labels You can export orders to FoxPost and print shipping labels directly from Shopify, either in bulk or individually. Once exported, each parcel receives a CLFOX tracking number (e.g. ). This number is used for fulfillment tracking and can be looked up on the FoxPost tracking page. --- APM (parcel locker) vs. home delivery FoxPost supports two delivery types, determined automatically based on the customer's shipping method: APM — the parcel is delivered to a FoxPost parcel locker. The destination locker ID is taken from the pickup point selected by the customer at checkout. HD (Home Delivery) — the parcel is delivered to the customer's address. If the order is assigned to a FoxPost parcel locker but no locker destination is found, the export will be rejected. --- Parcel sizes When exporting an order, select the parcel size that matches the physical dimensions of the shipment: | Size | Description | |----------|-------------------------| | XS | Extra small parcel | | S | Small parcel | | M | Medium parcel | | L | Large parcel | | XL | Extra large parcel | --- Cash on delivery (COD) FoxPost supports COD in HUF only. The COD amount is automatically taken from the order total when the order uses a cash on delivery payment method. Orders in other currencies with COD will have the COD amount set to 0. --- Label printing FoxPost labels can be printed in the following formats: | Format | Positions per sheet | |------------|-------------------------| | A6 | 1 | | A7 | 8 (on a single A4 sheet) | | 85×85 mm | 1 | When printing A7 labels, you can select a starting position on the A4 sheet (positions 1–8) to reuse partially used sheets. --- Troubleshooting | Issue | Resolution | |-----------------------------------|----------------------------------------------------------------------------------------------| | Authentication error | Verify your username, password, and API key in the carrier settings. | | | The recipient's phone number is invalid. FoxPost requires a valid Hungarian phone number in international format (e.g. ). | | APM export rejected | The order is assigned to a FoxPost parcel locker but no locker ID was found. Check that the customer selected a pickup point at checkout. | --- # Magyar Posta API URL: https://docs.globe.appfleece.com/integrations/magyar-posta-api Globe Pickup Points integrates with Magyar Posta (MPL), the Hungarian national postal carrier, enabling seamless order export and shipping label printing directly from Shopify. With this integration, you can: Export orders to Magyar Posta over the MPL API v2 Print shipping labels within Shopify, with the mandatory EFJ manifest included in the same PDF Ship to PostaPont locations, post offices, parcel lockers or the customer's address Support cash on delivery (COD) and parcel value insurance Deliver to Hungary and 24 other European countries --- Enabling Magyar Posta API integration 1. In your Shopify admin, open Globe Pickup Points and navigate to Shipping labels. Add a new carrier and select Magyar Posta. 2. Enter your API key and API secret — you can find both in your Magyar Posta account. Use Test connection to verify them before saving; Globe requests an OAuth2 token and reports straight away whether the credentials are valid. 3. Enter your Agreement — your Magyar Posta agreement number. 4. Enter your Account number — your Magyar Posta customer accounting code. Exports are rejected if the agreement number or the account number is missing. 5. Enter your Bank account number — Magyar Posta uses it to forward collected COD amounts. Enter all 24 digits with no dashes or spaces; if your account number has 16 digits (2×8), add to the end (e.g. becomes ). 6. Choose Package retention (days) — the number of days Magyar Posta holds the parcel: 0, 5 or 10. 7. Fill in the sender block: Sender name, Sender street, Sender ZIP, Sender city, Sender phone (international format, e.g. ) and Sender email. 8. Configure Automatically fulfill orders and Automatically tag orders with tracking number as needed. 9. Map your Shopify shipping methods to the appropriate Magyar Posta product. --- Exporting and printing labels You can export orders to Magyar Posta and print shipping labels directly from Shopify, either in bulk or individually. See Creating shipping labels for the full workflow. Each exported parcel receives a tracking number, which is used for fulfillment tracking and can be looked up on the Magyar Posta tracking page. If the order has no weight, Globe sends a default of 100 g. Manifest (EFJ) and daily closing Magyar Posta couriers require an EFJ manifest (Elektronikus Feladójegyzék) to be handed over together with the parcels — without it they may refuse to accept the shipment. Globe handles this for you: when you print labels, it closes the shipments at Magyar Posta and appends the manifest to the same PDF. The printed file contains, in order: 1. The shipping labels 2. The delivery note — the paper receipt the courier signs 3. The posting list summary (and a pallet posting list, if the batch contains pallets) The generated PDF is stored, so reprints are instant and never fail with an "already closed" error. If the manifest cannot be generated, Globe still returns the labels and warns you that the manifest has to be produced separately before the courier arrives. --- Products Map each Shopify shipping method to the Magyar Posta product agreed in your contract: | Product | MPL service code | Description | |-----------------|----------------------|------------------------------------------| | Business Parcel | | Contractual business parcel service | | Postal Parcel | | Standard postal parcel service | --- Pickup points vs. home delivery The delivery mode is derived automatically from the pickup point the customer selected at checkout: | Customer's choice | MPL delivery mode | |----------------------------------|-----------------------| | PostaPont | | | Post office | | | Parcel locker (Csomagautomata) | | | No pickup point — shipping address | (home delivery) | Parcel locker shipments are always submitted with parcel size L, because Magyar Posta requires a size for locker deliveries. --- Cash on delivery (COD) Magyar Posta supports COD. When an order uses a cash on delivery payment method, Globe adds the COD extra service and sends the order's COD amount with the shipment. Collected amounts are settled by bank transfer to the bank account number configured on the carrier — make sure it is entered as 24 digits. Orders placed in HUF are additionally insured for their order value (capped at the Magyar Posta maximum of 2,000,000 HUF). Orders in other currencies are exported without value insurance. --- Delivery status Delivery-status sync is not available for Magyar Posta — parcel statuses are not written back to the order. Shopify fulfillments still carry the MPL tracking number and the link to the Magyar Posta tracking page. Return labels are not supported either. --- Label printing Magyar Posta offers the widest choice of label formats of any carrier in Globe. Pick the one that matches your printer and stationery: | Format | Description | |--------------|---------------------------------------------------------------------| | | Full-size A4 address label, 210 × 297 mm | | | A5 label placed at the top of an A4 sheet | | | Two A5 landscape labels on one A4 sheet | | | A5 landscape label without the two additional tabs | | | A5 landscape label with the two additional tabs | | | A5 portrait label without the two additional tabs | | | A6 label, 148.5 × 105 mm | | | Four A6 labels on one A4 sheet | | | Label and posting list for a single parcel on one A4 sheet | Labels are always produced as PDF and printing always starts at the first position — there is no partially used sheet offset for Magyar Posta. The recipient's phone number and email address are printed on the label. --- Troubleshooting | Issue | Resolution | |-----------------------------------------------|------------------------------------------------------------------------------------------------------------------| | Authentication error | The API key or API secret is wrong. Re-enter them and press Test connection — it must report a successful connection. | | Configuration error — missing agreement or account number | Both Agreement and Account number are mandatory. Fill them in and export again. | | Missing recipient city / ZIP / address / name | The Shopify shipping address is incomplete. Complete the address on the order before exporting. | | Validation error with a parameter and code | Magyar Posta rejected the shipment data. The message names the offending field — fix it on the order or in the carrier settings and export again. | | No tracking numbers found — cannot print labels | The order was never exported successfully. Export it first, then print. | | Warning: manifest generation failed | The labels printed but the EFJ manifest is missing. Print again, or produce the manifest before the courier arrives — Magyar Posta may refuse parcels without it. | | COD amount not settled | Check the Bank account number — it must be exactly 24 digits, without dashes or spaces. | --- # MetaKocka URL: https://docs.globe.appfleece.com/integrations/metakocka Globe Pickup Points integrates seamlessly with MetaKocka, allowing you to automatically download pickup point data with orders and view it directly in your MetaKocka admin. This simplifies order processing and ensures accurate delivery information. --- Setting up MetaKocka integration To integrate MetaKocka with Globe Pickup Points, follow these steps: 1. Navigate to the Globe Pickup Points app in your Shopify admin. 2. Open the desired provider or create a new one. 3. Enable the Create order attributes option in the provider settings. This ensures pickup point data is passed along with the order. 4. Click on Load from template and select MetaKocka to pre-fill the configuration with the required fields. 5. Save your settings. Once configured, MetaKocka will automatically download pickup point data for orders, ensuring you have all the necessary information at a glance. --- Viewing pickup point data in MetaKocka After setup, pickup point details will appear in MetaKocka as part of the order data. This includes essential information such as: Pickup point name and address Pickup point ID Provider details (e.g., Packeta, DHL, etc.) This integration eliminates the need for manual data entry, reducing errors and streamlining your order workflow. --- Benefits of the MetaKocka integration Automatic Data Sync: Pickup point details are automatically downloaded into MetaKocka with each order, ensuring up-to-date and accurate information. Streamlined Workflow: Simplifies the process of managing orders with pickup points, saving time and effort. Template-Based Setup: Quickly configure the integration using the MetaKocka template provided in Globe. --- Start using the MetaKocka integration today to automate your order workflow and enhance your delivery operations! --- # MyGLS API URL: https://docs.globe.appfleece.com/integrations/mygls-api Globe Pickup Points integrates with MyGLS, enabling seamless order management and parcel shipping directly from Shopify. Shopify natively tracks GLS, and Globe enhances this with accurate failed delivery tracking and cash on delivery payment verification. --- Enabling MyGLS API integration 1. In your Shopify admin, open Globe Pickup Points and add or edit your MyGLS provider. 2. Enter your API credentials from MyGLS. 3. Configure export and fulfillment options as needed. 4. Map your Shopify shipping methods to MyGLS. --- Exporting and printing labels You can export orders to MyGLS and print shipping labels directly from Shopify, either in bulk or individually. The process is streamlined for both order management and label generation. --- Service types MyGLS supports various domestic and international service types, including pickup point and home delivery. You can select the appropriate type during export based on your needs. --- Enhanced 2-way sync with MyGLS While Shopify provides basic MyGLS tracking, Globe enhances the two-way sync by accurately tracking delivery statuses that Shopify doesn't handle properly. Most importantly, Globe correctly marks failed deliveries and returned parcels as failed in Shopify. Delivery statuses The following delivery statuses are synced between MyGLS and Shopify, allowing you to filter orders by status directly in your Shopify admin: | Status in Shopify | Description | |------------------------------|---------------------------------------------------| | Tracking added | The parcel has not yet been handed over to MyGLS, or the status is unknown. | | In transit | The parcel is on its way to the destination. | | Out for delivery | The parcel is out for home delivery or ready for pickup at the collection point. | | Failed delivery | The parcel was not picked up, canceled, or encountered an error. | | Delivered | The parcel has been delivered or collected. | These statuses can be used to filter orders in Shopify, making it easier to locate parcels quickly. For detailed tracking information, you can still click through to the tracking details in your MyGLS portal, but these synced statuses provide an overview directly within Shopify. --- Enhanced cash on delivery tracking Globe provides enhanced cash on delivery (CoD) tracking for MyGLS. Globe verifies the actual delivery status to prevent incorrectly marking orders as paid when parcels have been returned or delivery failed. When a CoD parcel is successfully delivered, the order is automatically marked as paid in Shopify. This ensures your accounting and order statuses are always accurate without manual intervention. To make sure this works as expected, you must add the MyGLS tracking number to the fulfillment and select MyGLS as the carrier. Additionally, the Cash on Delivery (COD) payment gateway should be used. --- # NoParcels URL: https://docs.globe.appfleece.com/integrations/noparcels NoParcels is a multi-carrier shipping platform used by fulfilment partners in the Baltics and Poland (Omniva, LP Express / Unisend, Venipak, DPD, InPost and others). If your 3PL prints labels in NoParcels, it needs to know which pickup point the customer chose in Globe. NoParcels reads three custom order attributes for that, and Globe writes them onto every order with a pickup point. --- Attributes NoParcels reads — a fixed carrier code per provider, see the table below. — the pickup point's country as a two-letter code in capitals, for example . — the carrier's own point ID, the same identifier NoParcels lists for the location (for example Omniva , LP Express , DPD , InPost ). --- Setting up the NoParcels attributes 1. Open the Globe Pickup Points app in your Shopify admin and go to Pickup points. 2. Open the provider your fulfilment partner ships through, for example Omniva. 3. Enable Create order attributes in the provider's advanced settings. 4. Add the three attributes from the block above. Attributes that are already there can stay — NoParcels ignores the ones it does not know. 5. Save, then repeat for every other provider. Only changes between providers. --- Carrier codes | Globe provider | | | --- | --- | | Omniva | | | Venipak | | | Unisend (LP Express) | | | DPD | | | InPost | | | Packeta | | NoParcels matches against its own carrier list. If your fulfilment partner ships through a carrier that is not in the table, ask your NoParcels account manager for the code they expect and use it as the attribute value. --- When the attributes appear on the order Globe writes the attributes a few seconds after the order is created, so they are not part of the initial webhook. NoParcels picks them up when it imports or refreshes the order, and the pickup point is then shown on the shipment. See Order attributes for how attribute templates work and the Metafield reference for every field you can use. --- # One by Allegro API URL: https://docs.globe.appfleece.com/integrations/one-by-allegro-api Globe Pickup Points integrates with One by Allegro (formerly WEDO), a Czech carrier delivering to parcel boxes, Intime pickup points and home addresses through the OneDelivery 3.0 API. With this integration, you can: Export orders to One by Allegro directly from Shopify Print shipping labels within Shopify Ship to a parcel box, a pickup point or the customer's address Collect cash on delivery --- Enabling One by Allegro API integration 1. In your Shopify admin, open Globe Pickup Points and navigate to Shipping labels. Add a new carrier and select One by Allegro. 2. Enter your Token ID and API password. You can find both in the One by Allegro client zone under API settings. If you don't have them, contact One by Allegro support (eshop-onecz@allegro.com). 3. Click Test connection to confirm the credentials are accepted before you save. 4. Fill in the sender address — Sender — company name, Sender — street, Sender — street number, Sender — city and Sender — postcode. The sender address is printed on every label and used for parcel pickup, and it is sent with every shipment (One by Allegro does not fall back to a default address stored on your account). The integration always submits Czechia as the sender country. 5. Fill in Default length in millimeters, Default width in millimeters and Default height in millimeters. These are mandatory — One by Allegro rejects shipments without package dimensions. 6. Optionally set a Default weight (kg) used when a product has no weight in Shopify. 7. Configure fulfillment and tagging options as needed. 8. Map your Shopify shipping methods to One by Allegro. --- Exporting and printing labels You can export orders to One by Allegro and print shipping labels directly from Shopify, either in bulk or individually. See Creating shipping labels for the full workflow. Each exported order becomes one shipment with a single package. The returned package number is used as the tracking number, and the tracking link points to the One by Allegro tracking page. If automatic fulfillment is enabled, Shopify is fulfilled with the tracking number and the carrier name One by Allegro. The API accepts only letters, digits, spaces, commas and periods in the parcel description and reference fields. Globe sanitizes these automatically — the description is and the order name is used as reference number 1, shortened to 20 characters. --- Delivery methods One by Allegro resolves the delivery method at export time from the Product type you select. The default is AUTO, which is what most merchants should keep. | Product type | Behaviour | |------------------|--------------------------------------------------------------------------------------------------------------| | AUTO | Uses the One by Allegro pickup point selected at checkout — a parcel box becomes BOX, a branch becomes PUDO. If the order has no One by Allegro point, the parcel is sent to the delivery address. | | TO_DOOR | Delivery to the customer's address. Any selected pickup point is ignored. | | BOX | Delivery to a One Box parcel box. Requires a One by Allegro point on the order. | | PUDO | Delivery to a staffed pickup point (Intime branch). Requires a One by Allegro point on the order. | If you choose BOX or PUDO explicitly and the order has no One by Allegro pickup point on it, the export is rejected for that order. Point codes come from the pickup point the customer selected in the Globe selector — see Adding pickup point carriers. All shipments are exported with the Standard service. Czech and Slovak recipient phone numbers are automatically converted to international format ( / ) so that carrier SMS notifications can be sent. --- Package weight and dimensions One by Allegro rejects shipments without package dimensions, so the defaults in the carrier settings are required, not optional. Weight — taken from the Shopify order. If the order has no weight, the Default weight (kg) from the carrier settings is used. If neither is available, the export fails for that order. Dimensions — always taken from the Default length / width / height in millimeters fields. If any of them is empty or zero, the export fails with a message telling you to fill them in. --- Cash on delivery (COD) One by Allegro supports COD. When an order uses a cash on delivery payment method, the COD amount is taken from the order and sent in the order's currency together with the shipment. There is no separate bank account field in the carrier settings — payouts are handled through your One by Allegro contract. --- Delivery status Delivery status sync is not available. One by Allegro is not part of Globe's delivery-status synchronization, so parcel statuses are not written back to Shopify. The tracking number and tracking link are still attached to the fulfillment, so customers can follow the parcel on the carrier's tracking page. --- Label printing Labels are returned by One by Allegro as a single PDF covering the whole printed batch, in one of two formats: | Format | Description | |------------|-----------------------------| | PDF_A6 | One label per page (default) | | PDF_A4 | One label per A4 page | The OneDelivery API has no support for printing from a chosen position on a sheet, so partially used label sheets cannot be reused with this carrier. --- Returns and cancellation Return labels are not supported through this integration. Shipments cannot be cancelled. The OneDelivery API has no cancel or delete endpoint. Once an order has been exported, the shipment stays in your One by Allegro account — simply do not hand the parcel over, or resolve it in the One by Allegro portal. --- Troubleshooting | Issue | Resolution | |------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------| | | Check the Token ID and API password in the carrier settings and use Test connection. A 401 response means the credentials are invalid. | | | The product type is set to BOX or PUDO but the order has no One by Allegro pickup point. Use AUTO or TO_DOOR, or check that the customer selected a One by Allegro point at checkout. | | | Set the product weight in Shopify, enter the weight manually during export, or fill in Default weight (kg). | | | Fill in the default length, width and height (in millimeters) in the One by Allegro settings — the API requires them on every shipment. | | Recipient does not receive carrier notifications | Only Czech and Slovak numbers get an automatic country prefix. For other countries, store the phone number in full international format on the order. | | | The API responded with something other than a PDF. Retry the print; if it keeps failing, contact One by Allegro support with the shipment number. | | Order exported by mistake | Shipments cannot be deleted through the API. Do not hand the parcel over and resolve the shipment in the One by Allegro portal. | --- # Packeta API URL: https://docs.globe.appfleece.com/integrations/packeta-api Globe Pickup Points integrates with Packeta, enabling seamless order management and parcel tracking directly from Shopify. With this integration, you can: Send your orders to your Packeta portal Print shipping labels within Shopify Synchronize delivery statuses between Packeta and Shopify Track cash on delivery payments automatically --- Enabling Packeta API integration Follow these steps to enable the Packeta API integration in Globe Pickup Points: 1. Navigate to Globe Pickup Points in your Shopify admin and open your Shipping labels in the menu. Add new carrier and select Packeta. 2. Ensure your API key and API password are filled in correctly. These credentials can be obtained from your Packeta account. 3. Cnfigure the following options: - Sender label: Specify your sender label if you have multiple senders in your Packeta account. - Automatic fulfillment: Choose to automatically mark the order as fulfilled and send a customer email with the tracking link. 4. Optionally, assign your Shopify store shipping methods to the corresponding Packeta carriers. --- Exporting orders to Packeta You can export orders to Packeta directly from Shopify in two ways: 1. From the Orders Page: Select multiple orders and trigger the export in bulk. 2. From the Order Detail Page: Open a specific order and trigger the export manually. Once exported, the parcel details will be visible in your Packeta portal, and you can print shipping labels directly within Shopify. --- 2-way sync with Packeta The Packeta integration includes a two-way sync, ensuring the delivery status of your parcels is updated in Shopify as they progress through the shipping process. This helps you keep track of orders without switching between platforms. Delivery statuses The following delivery statuses are synced between Packeta and Shopify, allowing you to filter orders by status directly in your Shopify admin: | Status in Shopify | Description | |------------------------------|---------------------------------------------------| | Tracking added | The parcel has not yet been handed over to Packeta, or the status is unknown. | | In transit | The parcel is on its way to the destination. | | Out for delivery | The parcel is out for home delivery or ready for pickup at the collection point. | | Failed delivery | The parcel was not picked up, canceled, or encountered an error. | | Delivered | The parcel has been delivered or collected. | These statuses can be used to filter orders in Shopify, making it easier to locate parcels quickly. For detailed tracking information, you can still click through to the tracking details in your Packeta portal, but these synced statuses provide an overview directly within Shopify. --- Cash on delivery tracking With Packeta's integration, Globe automates cash on delivery (CoD) tracking. When a CoD parcel is delivered, the order is automatically marked as paid in Shopify. This ensures your accounting and order statuses are always up-to-date without manual intervention. To make sure this works as expected, you must add the Packeta tracking number to the fulfillment and select Packeta or Zasilkovna as the carrier. Additionally, the Cash on Delivery (COD) payment gateway should be used. --- Customer returns (Z-BOX) Your customers can return a parcel through Packeta without printing anything — including drop-off at a Z-BOX. 1. Open the order in Shopify and run the Create shipping labels action. 2. Select your Packeta account and the product Vrácení zásilky zákazníkem (customer return). 3. Confirm the creation. Packeta immediately emails the customer a drop-off code with instructions — the dialog warns you before you confirm. The customer hands the parcel over with the code at any Packeta pick-up point or drops it into a Z-BOX. There is no label to print — after creation, Globe shows the drop-off code next to the order. Details worth knowing: The customer has 5 calendar days from Packeta's email to hand the parcel over. After that Packeta cancels the return and you have to create a new one. Available for orders delivered to the Czech Republic, Slovakia, Hungary and Romania — the countries with Packeta's own pick-up network. The order must have a customer email address; that is where the code is sent. The return is delivered back to the address set in your Packeta client section (invoice address) and billed by Packeta according to their price list. Returns are a deliberately manual, one-order-at-a-time action — they are not available in bulk export or Flow automation. --- Troubleshooting | Issue | Resolution | | ------------------- | ----------------------------------------------------------------------------- | | Invalid sender | Open your Packeta account at https://client.packeta.com/senders, choose which sender to use with Globe from the list, and specify the sender name in the Globe app under Shipping labels. This is only required if you use more than one sender in Packeta. The sender name is the value in the Indication column (Označení in the Czech interface) — see the screenshot below. | | The client account is not approved for posting parcels | Contact Packeta and ask them to approve your account for posting parcels. | Packeta → User information → Senders — the “Indication” (Označení) column. --- # Picqer URL: https://docs.globe.appfleece.com/integrations/picqer Globe Pickup Points integrates seamlessly with Picqer, automatically synchronizing pickup point data to your Picqer orders. This eliminates manual data entry and ensures accurate delivery information for your warehouse operations. --- What is Picqer integration? The Picqer integration automatically updates your Picqer orders with pickup point information when a customer selects a pickup location in your Shopify checkout. This happens in the background, ensuring your warehouse team always has the correct delivery details. Supported Carriers The Picqer integration currently works with the following carriers: PostNL - Including PakjeGemak locations and Parcel Machines DHL - DHL Parcel pickup points DPD - DPD Parcelshops --- How it works 1. Customer selects a pickup point in your Shopify store 2. We process the order and store the pickup point data 3. Background sync to Picqer - Globe automatically finds the corresponding order in Picqer and updates it with the pickup point details 4. Automatic retry - If the order isn't in Picqer yet, Globe will retry up to 3 times with 1-minute intervals This process happens automatically in the background and doesn't slow down your order processing. --- Setting up Picqer integration To integrate Picqer with Globe Pickup Points, follow these steps: 1. Get your Picqer API credentials 1. Log in to your Picqer account 2. Navigate to Settings → API 3. Generate or copy your API key 4. Note your account subdomain (e.g., if your Picqer URL is , your subdomain is ) 2. Configure in Globe Pickup Points 1. Navigate to the Globe Pickup Points app in your Shopify admin 2. Open the carrier settings for PostNL, DHL, or DPD 3. Scroll to the Advanced Settings section 4. Enable Picqer - automatically update pickup point 5. Enter your Picqer subdomain (just the subdomain, not the full URL) - ✅ For example: 6. Enter your Picqer API Key 7. Save your settings --- Troubleshooting Orders not syncing to Picqer Check your subdomain Make sure you entered only the subdomain (e.g., ) Don't include or Verify API key Ensure your API key is valid in Picqer settings Check that the API key has the necessary permissions Check order reference Picqer uses your Shopify order number (e.g., ) to find orders Make sure your orders are being created in Picqer with the correct reference --- Start using the Picqer integration today to automate your warehouse operations and eliminate manual pickup point data entry! --- # Pošta bez hranic API URL: https://docs.globe.appfleece.com/integrations/posta-bez-hranic-api Globe Pickup Points integrates with Pošta bez hranic, enabling seamless order management and parcel shipping directly from Shopify. With this integration, you can: Send your orders to your Pošta bez hranic portal Print shipping labels within Shopify --- Enabling Pošta bez hranic API integration 1. In your Shopify admin, open Globe Pickup Points and add or edit your Pošta bez hranic provider. 2. Enter your API credentials from Pošta bez hranic. 3. Configure export and fulfillment options as needed. 4. Map your Shopify shipping methods to Pošta bez hranic. --- Exporting and printing labels You can export orders to Pošta bez hranic and print shipping labels directly from Shopify, either in bulk or individually. The process is streamlined for both order management and label generation. --- Service types Pošta bez hranic supports various domestic and international service types, including pickup point and home delivery. You can select the appropriate type during export based on your needs. --- 2-way sync with Pošta bez hranic The Pošta bez hranic integration includes a two-way sync, ensuring the delivery status of your parcels is updated in Shopify as they progress through the shipping process. This helps you keep track of orders without switching between platforms. Delivery statuses The following delivery statuses are synced between Pošta bez hranic and Shopify, allowing you to filter orders by status directly in your Shopify admin: | Status in Shopify | Description | |------------------------------|---------------------------------------------------| | Tracking added | The parcel has not yet been handed over to Pošta bez hranic, or the status is unknown. | | In transit | The parcel is on its way to the destination. | | Out for delivery | The parcel is out for home delivery or ready for pickup at the collection point. | | Failed delivery | The parcel was not picked up, canceled, or encountered an error. | | Delivered | The parcel has been delivered or collected. | These statuses can be used to filter orders in Shopify, making it easier to locate parcels quickly. For detailed tracking information, you can still click through to the tracking details in your Pošta bez hranic portal, but these synced statuses provide an overview directly within Shopify. --- Cash on delivery tracking With Pošta bez hranic's integration, Globe automates cash on delivery (CoD) tracking. When a CoD parcel is delivered, the order is automatically marked as paid in Shopify. This ensures your accounting and order statuses are always up-to-date without manual intervention. To make sure this works as expected, you must add the Pošta bez hranic tracking number to the fulfillment and select Pošta bez hranic as the carrier. Additionally, the Cash on Delivery (COD) payment gateway should be used. --- # PPL CZ API URL: https://docs.globe.appfleece.com/integrations/ppl-api Globe Pickup Points integrates with PPL Czechia, enabling seamless order management and parcel shipping directly from Shopify. With this integration, you can: Send your orders to your PPL portal Print shipping labels within Shopify --- Enabling PPL API integration 1. In your Shopify admin, open Globe Pickup Points and add or edit your PPL provider. 2. Enter your API credentials from PPL. You can get these from PPL support. 3. Configure export and fulfillment options as needed. 4. Map your Shopify shipping methods to PPL. --- Exporting and printing labels You can export orders to PPL and print shipping labels directly from Shopify, either in bulk or individually. The process is streamlined for both order management and label generation. --- Service types PPL supports various domestic and international service types, including pickup point and home delivery. You can select the appropriate type during export based on your needs. --- 2-way sync with PPL The PPL integration includes a two-way sync, ensuring the delivery status of your parcels is updated in Shopify as they progress through the shipping process. This helps you keep track of orders without switching between platforms. Delivery statuses The following delivery statuses are synced between PPL and Shopify, allowing you to filter orders by status directly in your Shopify admin: | Status in Shopify | Description | |------------------------------|---------------------------------------------------| | Tracking added | The parcel has not yet been handed over to PPL, or the status is unknown. | | In transit | The parcel is on its way to the destination. | | Out for delivery | The parcel is out for home delivery or ready for pickup at the collection point. | | Failed delivery | The parcel was not picked up, canceled, or encountered an error. | | Delivered | The parcel has been delivered or collected. | These statuses can be used to filter orders in Shopify, making it easier to locate parcels quickly. For detailed tracking information, you can still click through to the tracking details in your PPL portal, but these synced statuses provide an overview directly within Shopify. --- Cash on delivery tracking With PPL's integration, Globe automates cash on delivery (CoD) tracking. When a CoD parcel is delivered, the order is automatically marked as paid in Shopify. This ensures your accounting and order statuses are always up-to-date without manual intervention. To make sure this works as expected, you must add the PPL tracking number to the fulfillment and select PPL as the carrier. Additionally, the Cash on Delivery (COD) payment gateway should be used. --- Known limitations Shipments created via API do not appear in the PPL system. Unfortunately, the PPL system does not support displaying shipments created via API. We have raised this limitation with PPL several times, and the latest information we have is that they are preparing a new system that will support it. The shipment is sent correctly and has a valid tracking number — it simply does not show up in their current system. You can track the shipment using the tracking number directly or monitor the delivery status in Shopify thanks to the two-way sync. --- Troubleshooting | Issue | Resolution | | ------------------- | ----------------------------------------------------------------------------- | | Invalid sender name | Check that you have correctly entered all items in the configuration page. | | Name must not be empty | Check your PPL account connection in the app. Likely, the Name field is empty. | | Invalid customer | Your account needs to be approved for sending by PPL. Contact PPL support. | --- # ShippyPro API URL: https://docs.globe.appfleece.com/integrations/shippypro-api Globe Pickup Points integrates with ShippyPro, a multi-carrier shipping platform that lets you ship through the carrier contracts you have already connected inside your own ShippyPro account. With this integration, you can: Export orders to ShippyPro directly from Shopify Print shipping labels within Shopify Ship to pickup points or to the customer's address, depending on the carrier service you pick Support cash on delivery (COD) and customs declarations (CN22) for cross-border shipments Orders can be exported to 33 destination countries — the EU, the UK, Switzerland, Norway, the US, Canada and Australia. --- Enabling ShippyPro API integration 1. In your Shopify admin, open Globe Pickup Points and navigate to Shipping labels. Add a new carrier and select ShippyPro. 2. Enter your API key — you can find it in your ShippyPro account. This is the only mandatory credential. 3. Click Fetch carriers. Globe verifies the key and downloads every carrier and service connected to your ShippyPro account, so you can map them to Shopify shipping methods. 4. Fill in the sender details printed on the label: Sender name, Sender company name, Sender street, Sender city, Sender ZIP, Sender country (a two-letter code such as , , ), Sender phone and Sender email. 5. Configure fulfillment and tagging options as needed — Automatically fulfill orders, Automatically tag orders with tracking number and Custom tag after export. 6. Map your Shopify shipping methods to the fetched carrier services. There is no separate ShippyPro sandbox in Globe — the API key you enter creates real shipments on your account. --- Exporting and printing labels You can export orders to ShippyPro and print shipping labels directly from Shopify, either in bulk or individually. See Creating shipping labels for the full workflow. Each export creates the shipment and returns a tracking number and a label in one call, so labels are ready to print immediately. Your Shopify order name is sent as the shipment reference and note. Once exported, the tracking number is used for fulfillment tracking — the carrier reported by ShippyPro is written to Shopify as the tracking company. --- Carriers and services ShippyPro does not have its own network. The carriers, services and rate cards come from your ShippyPro account, so the list you see when exporting is exactly what you have connected there. If you add a new carrier in ShippyPro, click Fetch carriers again in the Globe carrier settings to pull it in. If your account returns no carrier list (for example when the ShippyPro API is temporarily unavailable), Globe falls back to manual entry and lets you paste the carrier definition as JSON. Use Copy sample to get the expected format. --- Pickup points vs. home delivery If the order carries a pickup point selected at checkout and you export it on a pickup-point service, Globe sends the point ID to ShippyPro as a carrier option, so the parcel is routed to that point. Services whose name marks them as home delivery always ship to the customer's shipping address, even when a point is attached to the order. The pickup points themselves can come from any provider you use at checkout, or from the ShippyPro PUDO provider, which queries the pickup points of the carriers in your ShippyPro account live. See Adding pickup point carriers. When exporting, Globe warns you with a Type selection mismatch banner if the selected ShippyPro carrier does not look like the carrier that owns the pickup point on the order — for example a Packeta point exported on a GLS service. The export is not blocked, so review the banner before continuing. --- Parcel weight and dimensions ShippyPro requires a real weight. Globe never invents one: if the order has no weight set in Shopify, the export is rejected. Add product weights in Shopify and export again. Parcel dimensions are optional. Parcel length (cm), Parcel width (cm) and Parcel height (cm) are advanced options rather than carrier settings, and when no value is set, 1 cm is sent for each dimension. If the selected carrier service offers an insurance option, the shipment is insured for the order total. --- Customs For cross-border shipments, Globe builds a CN22 declaration from the order line items — description, quantity, unit value, weight, HS code and country of origin taken from the product's inventory item. Where the product data is incomplete, these carrier settings fill the gaps: | Setting | Used for | |-------------------------|---------------------------------------------------------------------------| | Sender country | Country of origin when a product has none | | Contents type | Type of goods declared on the CN22 (Merchandise, Gift, Documents, Commercial Sample, Returned Goods) | | DDP countries | Destination countries shipped as DDP (duties paid by you); every other destination is sent as DDU | Content description (the description of the shipment contents, by default) and HS code (the tariff code used when a product has none) are not carrier settings — they are advanced options you fill in per shipment in the export dialog. --- Cash on delivery (COD) ShippyPro supports COD. When the order has an amount left to collect, Globe sends the COD amount together with the order currency, and ShippyPro passes it to the end carrier. Orders with nothing to collect are exported as regular shipments. Whether COD is actually available — and in which currencies — depends on the carrier contract behind the selected service in your ShippyPro account. --- Delivery status Delivery-status sync is not available for ShippyPro — parcel statuses are not written back into Shopify, so progress has to be followed in ShippyPro or on the end carrier's tracking page. The tracking number and tracking link are still attached to the fulfillment. Return labels are not supported either; create them in ShippyPro directly. --- Label printing Labels are requested from ShippyPro at print time in the chosen size, and all labels in a batch are merged into a single multi-page PDF: | Format | Description | |-------------|--------------------------------------------------------| | A6 | Label rendered at 10.5 × 14.8 cm | | A4 (4-up) | Label rendered at 21 × 29.7 cm | Because ShippyPro renders the label itself, the exact layout on the page comes from the end carrier's own label template. Labels can be reprinted at any time — Globe fetches a fresh download URL for each shipment, and falls back to the label URL stored at export time. --- Troubleshooting | Issue | Resolution | |-----------------------------------------------------------|------------------------------------------------------------------------------------------------------------------| | "Invalid API key — please check your ShippyPro credentials" | The key was rejected by ShippyPro. Copy it again from your ShippyPro account and save the carrier. | | "ShippyPro API key is not configured" | The API key field is empty on the carrier account. Fill it in and save. | | "No carriers configured. Use the 'Fetch carriers' button" | The carrier list has never been downloaded. Open the carrier settings and click Fetch carriers. | | "Please select a carrier before exporting." | The service chosen for the order is not in the fetched list — usually after the list changed. Re-fetch carriers and map the shipping method again. | | "Order has no weight set." | ShippyPro requires a non-zero weight. Add product weights in Shopify, then export again. | | Export rejected with a carrier error message | ShippyPro passes the end carrier's validation error through, together with its suggested fix — typically an incomplete address, an unsupported destination, or a service not enabled on your account. | | Parcel shipped to the address instead of the pickup point | The carrier service has no pickup-point option stored. Click Fetch carriers again to refresh the carrier options, then re-export. | | "Could not retrieve label for order …" | Neither the fresh label URL nor the stored one could be downloaded. Wait a moment and print the batch again; if it keeps failing, re-export the order. | --- # Slovenská pošta API URL: https://docs.globe.appfleece.com/integrations/slovenska-posta-api Globe Pickup Points integrates with Slovenská pošta, the Slovak postal operator, through its WebEPH API, enabling order export and shipping label printing directly from Shopify. With this integration, you can: Export orders to your Slovenská pošta (Moje zásielky) account Print shipping labels within Shopify in A6 or A4 format Ship to post offices, BalíkoBOX parcel lockers or to the customer's address Support cash on delivery paid to your IBAN The integration is offered for Slovakia and the sender address is always a Slovak address. --- Enabling Slovenská pošta API integration 1. In your Shopify admin, open Globe Pickup Points and navigate to Shipping labels. Add a new carrier and select Slovenská pošta. 2. Enter your User ID and API key — these are the WebEPH API credentials from your Slovenská pošta account. The WebEPH API must be activated for the account before it will authenticate. 3. Fill in the sender block: Sender name, Sender street, Sender city and Sender ZIP are required. Sender organization, Sender phone and Sender email are optional. 4. Choose the Reception method — Submit at post office or Submit to courier — depending on how you hand the parcels over. 5. Choose the Payment type for postage: Postage credit, Payment machine, Postage stamps, Paid by transfer, Paid in cash, Postal service item, Invoice or Online. 6. Tick Contract if you have a contract with Slovenská pošta. 7. If you ship cash on delivery, fill in the COD IBAN. 8. Optionally configure Shipment insurance, Default insurance value, Default weight (kg), Automatically fulfill orders, Automatically tag orders with tracking number and Custom tag after export. 9. Map your Shopify shipping methods to the Slovenská pošta products you have agreed with the carrier. --- Exporting and printing labels You can export orders to Slovenská pošta and print shipping labels directly from Shopify, either in bulk or individually — see Creating shipping labels. Each export creates one hárok (submission sheet) per product type: orders are grouped by the selected product, a hárok is opened for each group, the parcels are added to it, and the hárok is then registered automatically. If registration fails, the parcels are still created and the hárok can be registered later in Moje zásielky. Order weight is converted from grams to kilograms, with a minimum of 0.1 kg. If your orders have no weight, set a Default weight (kg) in the carrier settings. Each parcel receives a Slovenská pošta parcel number (for example ). If Automatically fulfill orders is enabled, the order is fulfilled with this number and a link to the Slovenská pošta tracking page. Slovenská pošta has a WebEPH test system, but it is switched on at the server level rather than per carrier account — production stores always talk to the live Moje zásielky API, and there is no sandbox toggle in the carrier settings. --- Products Select the product that matches your agreement with Slovenská pošta. All orders exported with the same product go on the same hárok. | Product | Description | |-----------------------------------------|---------------------------------------------------| | Doporučený list | Registered letter | | Poistený list | Insured letter | | Úradná zásielka | Official (authority) item | | Balík | Standard parcel | | Expres kuriér | Express courier | | EMS zásielka | EMS express item | | EPG – obchodný balík | EPG business parcel | | Balík – zmluvní zákazníci | Parcel for contract customers | | Balík – zmluvní zákazníci – Consignment | Contract-customer parcel, consignment | | Balíček | Small parcel | | Easy Expres 1 | Easy Expres, 1-day delivery | | Easy Expres 10 | Easy Expres, 10-day delivery | | Prime zásielka | Prime item | | List | Ordinary letter | --- Pickup points vs. home delivery The delivery type follows the customer's shipping method: Pickup point — when the customer selects a Slovenská pošta pickup point (a post office or a BalíkoBOX locker) at checkout, the recipient address on the parcel is replaced with the address of the pickup point, and the parcel is submitted with the pickup service. The point name is appended to the city so it is visible on the label. Home delivery — the parcel is addressed to the customer's shipping address. A second address line is appended to the street. Recipient name, street, city and ZIP are mandatory. Orders missing any of them are rejected during export. --- Parcel number ranges (contract customers) If Slovenská pošta assigned you your own range of parcel numbers, fill in the advanced fields Parcel number range – from and Parcel number range – to (for example ). Globe then assigns numbers from that range and stores the following one in Next parcel number after each export, which you can also correct manually. Numbers use the format — a two-letter prefix, eight digits, an optional check digit and a two-letter suffix. Globe computes the check digit for you. When the range runs out, exports fail until you enter a new range. Leave these fields empty to let Slovenská pošta assign the numbers. --- Cash on delivery (COD) COD is supported. The COD amount is taken from the order's outstanding amount in the order currency and is sent as a bank deposit to the COD IBAN configured on the carrier account, with the variable symbol derived from the digits of the order number. Without a valid IBAN, the API rejects the parcel. Insurance Insurance is added when the order value is greater than zero and either the product is Poistený list or Shipment insurance is enabled in the carrier settings. The insured amount is the order value in the order currency, or the Default insurance value if you set one. --- Delivery status Delivery-status sync is not available for Slovenská pošta — parcel statuses are not written back to Shopify, and COD payments are not marked as paid automatically. The parcel number and the link to the Slovenská pošta tracking page are still attached to the fulfillment. Return labels and cancelling an already exported parcel from Globe are not supported either; cancel parcels in Moje zásielky. --- Label printing Slovenská pošta labels are returned as PDF and can be printed in the following formats: | Format | Labels per sheet | Start position | |------------|----------------------|--------------------| | A6 | 1 (one label per page) | – | | A4 | 4 (2×2 grid) | 1–4 | When printing A4 sheets, choose the starting position to reuse partially used label sheets. The format used by default can be set with Default print option in the carrier settings. --- Troubleshooting | Issue | Resolution | |------------------------------------------|--------------------------------------------------------------------------------------------------| | Authentication failed | Check the User ID and API key, and make sure the WebEPH API is activated in your Slovenská pošta account. | | Missing required sender fields | Sender name, Sender street, Sender city and Sender ZIP must all be filled in. | | Missing recipient name, address, city or ZIP | The Shopify shipping address is incomplete. For pickup-point orders, check that the customer actually selected a point at checkout. | | Invalid parcel number format | Use the format , for example , in the parcel number range fields. | | Parcel number range exhausted | All assigned numbers have been used. Request a new range from Slovenská pošta and update Parcel number range – from/to and Next parcel number. | | Validation error on export | The API rejected a value on the parcel — most often a missing COD IBAN, or an insurance or COD amount that the product does not allow. | | No parcel IDs found in orders | The order was not exported successfully, so there is nothing to print. Export it again before printing. | | Label type unavailable | The label is not ready for that parcel yet. Wait a moment and print again. | | Could not connect to SK Posta API | The WebEPH API is temporarily unreachable. Retry the export or print later. | --- # Spring GDS API URL: https://docs.globe.appfleece.com/integrations/spring-gds-api Globe Pickup Points integrates with Spring GDS, a cross-border consolidator that hands your parcels over to local final-mile carriers such as PostNL, Royal Mail, DPD, Hermes, Colis Privé and Packeta. With this integration, you can: Export orders to Spring GDS directly from Shopify Ship to 49 destination countries using 34 services Print shipping labels within Shopify Send full customs data (HS codes, country of origin, DDP/DDU) on international shipments --- Enabling Spring GDS API integration 1. In your Shopify admin, open Globe Pickup Points and navigate to Shipping labels. Add a new carrier and select Spring GDS. 2. Enter your API key — you can find it in your Spring GDS account. 3. Fill in the sender details used on every label: Sender name, Sender company name (optional), Sender street, Sender city, Sender ZIP, Sender country, Sender phone and Sender email. 4. If you ship internationally, add your customs identifiers. All of them are optional: - Sender VAT number — your VAT number. For Norway use VOEC, for Switzerland UID, for Singapore GST. - Sender EORI number — used in the Spring Clear customs solution. - Sender IOSS number — used in the Spring Clear IOSS+ and Union OSS solution. - Sender GB EORI number — starts with , required for DDP shipments to the United Kingdom via Spring Clear. 5. Choose the Tracking URL sent to customers in the fulfillment email: Spring GDS Tracking or Final Mile Carrier Tracking. 6. Configure fulfillment and tagging options as needed. 7. Map your Shopify shipping methods to the Spring GDS services you have agreed with Spring. --- Exporting and printing labels You can export orders to Spring GDS and print shipping labels directly from Shopify, either in bulk or individually. See Creating shipping labels for the full workflow. Each exported shipment receives a Spring GDS tracking number. Depending on the Tracking URL setting, fulfillments are created either with the Spring GDS tracking page or with the tracking link of the final-mile carrier that Spring returns for that shipment. --- Service types Spring GDS exposes 34 services. Pick the one that matches your Spring contract and destination — the full list is available in the export dialog and in the shipping method mapping. | Service group | Examples | |----------------------------|------------------------------------------------------------------------------| | Spring network | Spring Tracked (TRCK), Spring Signature (SIGN), Spring Untracked (UNTR) | | Spring Collect | Spring Collect (CLLCT) — the only pickup point service | | PostNL | Packet Tracked / Registered / Non Tracked, Parcel EU, GlobalPack EMS and UPU, EPG, Benelux variants with and without signature | | Royal Mail | Tracked 24 and Tracked 48, with or without signature | | Final-mile partners | DPD DE, Hermes, Colis Privé, Italian Post Crono and Crono Express, Sending Mainland and Islands, Spring Com Standard and Express, Packeta, Austrian Post Eurodis, Express | --- Pickup points vs. home delivery Spring Collect (CLLCT) is the only Spring GDS service that delivers to a pickup point. When an order is exported with this service, Globe attaches the PUDO location ID of the point the customer selected at checkout. All other services deliver to the customer's shipping address. If an order exported as Spring Collect has no pickup point selected, no PUDO location is sent with the shipment. Use a home delivery service instead, or make sure the customer picks a point at checkout. --- Customs and duties Spring GDS is a cross-border carrier, so Globe always sends a customs declaration with the shipment. Product lines carry the HS code and country of origin from your Shopify inventory items; where those are missing, the HS code entered for that shipment at export time and your sender country are used. The Customs & duties section of the carrier account controls: | Setting | Effect | |---------------------------------|-----------------------------------------------------------------------------| | DDP countries | Destinations shipped as DDP (Delivered Duty Paid). Everything else is sent as DDU. | | Send values ex-VAT for countries | Order and shipping values for these destinations are sent without VAT. | | Preferential origin countries | Adds the preferential origin tag to every product line. Required for the UK under the EU-UK Trade and Cooperation Agreement. | | Declaration type | Sale of Goods (default), Documents, Gift, Returned Goods or Commercial Sample. | Two further values are not carrier settings at all — HS code (6–10 digits, overridden by product-level HS codes from Shopify when available) and Content description (for example Goods or Clothing) are advanced options you fill in per shipment in the export dialog. --- Test mode Each Spring GDS carrier account has a Test mode checkbox. When enabled, both shipment creation and label retrieval go to the Spring GDS test environment instead of production. Disable it before you start shipping real orders — test shipments are not dispatched. --- Cash on delivery (COD) Spring GDS does not support cash on delivery. No COD amount is sent with the shipment, regardless of the payment method on the order. If you need COD, use a different carrier for those orders. --- Delivery status Delivery-status sync is not available for Spring GDS — it is not part of the two-way delivery status sync that carriers such as Packeta, PPL, DPD or GLS have, so parcel statuses are not written back to Shopify. The tracking number and tracking link are still attached to the fulfillment, and further status updates come from Shopify's own tracking or from the Spring GDS portal. Return labels are also not supported for Spring GDS. --- Label printing Spring GDS returns PDF labels, which Globe can print in two formats: | Format | Positions per sheet | |-------------|-------------------------| | A6 | 1 | | A6 on A4 | 4 | When printing A6 on A4, you can select a starting position (1–4) to reuse partially used sheets. --- Troubleshooting | Issue | Resolution | |------------------------------------------|--------------------------------------------------------------------------------------------------| | Spring GDS API key is not configured | The carrier account has no API key. Add it in the carrier settings — it is also required for printing. | | Fatal error from Spring GDS | Spring rejected the shipment. The message returned by Spring is shown with the failed order — most often an invalid service code for the destination, or missing customs data. | | No tracking number returned | The shipment was accepted but Spring did not return a tracking number. Re-export the order and check the service is enabled on your Spring account. | | No labels could be retrieved | The label is not yet available for the tracking number. Wait a moment and print again. | | Spring Collect exported without a pickup point | The order has no pickup point selected at checkout. Choose a home delivery service, or have the customer select a point. | | Test shipments never arrive | Test mode is still enabled on the carrier account. Disable it for production shipping. | --- # SPS API URL: https://docs.globe.appfleece.com/integrations/sps-api Globe Pickup Points integrates with SPS (Slovak Parcel Service) through the WebShip SOAP API, enabling order export and shipping label printing directly from Shopify. With this integration, you can: Export orders to SPS WebShip directly from Shopify Print shipping labels within Shopify Ship to Balíkovo pickup points, SPS parcel terminals or the customer's address Support cash on delivery (COD) with payouts to your bank account --- Enabling SPS API integration 1. In your Shopify admin, open Globe Pickup Points and navigate to Shipping labels. Add a new carrier and select SPS. 2. Enter your Username and Password — these are your WebShip credentials. Contact your SPS sales representative to obtain web service access. 3. If you use cash on delivery, enter the COD IBAN and COD SWIFT/BIC of the bank account SPS should pay the collected money into. 4. Optionally set a Default insurance value applied to all shipments. If you leave it blank, the order total is used. 5. Configure fulfillment and tagging options as needed — Automatically fulfill orders, Automatically tag orders with tracking number and Custom tag after export. 6. Map your Shopify shipping methods to the SPS services you have agreed with the carrier. There is no SPS test environment — WebShip has a single production endpoint, so the credentials you enter create real shipments. --- Exporting and printing labels You can export orders to SPS and print shipping labels directly from Shopify, either in bulk or individually. See Creating shipping labels for the full workflow. Each shipment is created and its label rendered in a single API call, so labels are ready to print immediately after export. The parcel reference sent to SPS is your Shopify order name without the leading , shortened to 35 characters if needed. Once exported, the parcel receives an SPS shipment number that is used for fulfillment tracking and can be looked up on the SPS tracking page. If the order has a customer email address, Globe also asks SPS to notify the recipient by email. --- Service types When mapping shipping methods or exporting an order, select the SPS service that matches your agreement: | Service | Description | |-------------------------|--------------------------------------------------------| | SPS Standard | Standard home or business delivery | | SPS Express | Express delivery | | SPS 9:00 | Guaranteed delivery by 9 AM | | SPS 12:00 | Guaranteed delivery by 12 PM | | SPS Saturday Delivery | Delivery on Saturday | | SPS Balíkovo | Delivery to a Balíkovo pickup point | | SPS Parcel Terminal | Delivery to an SPS parcel terminal (locker) | Orders can be exported to 11 destination countries: Slovakia, Czechia, Austria, Hungary, Germany, Poland, Romania, Croatia, Slovenia, Bulgaria and Serbia. --- Pickup points vs. home delivery SPS Balíkovo and SPS Parcel Terminal send the parcel to the pickup point the customer selected at checkout. Globe passes the point ID to SPS and puts the customer's name on the label as the contact person. All other services deliver to the customer's shipping address. If a Balíkovo or Parcel Terminal service is used but the order carries no pickup point, the shipment is created to the customer's street address instead of a pickup point. Make sure your pickup-point shipping methods are mapped to the Balíkovo or Parcel Terminal service and that the selector is active at checkout — see Adding pickup point carriers. --- Insurance value SPS requires an insurance value on every shipment. Globe resolves it in this order: 1. Insurance value set on the individual shipment at export time 2. Default insurance value from the carrier settings 3. The order total, if neither is set --- Cash on delivery (COD) SPS supports COD. When an order has an outstanding amount to collect, Globe sends the COD amount together with the order currency and the COD IBAN and COD SWIFT/BIC from your carrier settings, so SPS knows where to remit the money. Orders with nothing left to collect are exported as regular shipments. --- Delivery status Delivery-status sync is not available for SPS — parcel statuses are not written back into Shopify, so progress has to be checked on the SPS tracking page or in your SPS portal. The shipment number and tracking link are still attached to the fulfillment. Return labels are not supported either; arrange returns directly with SPS. --- Label printing SPS labels are generated as PDFs at export time and can be printed in the following formats: | Format | Labels per sheet | |------------|----------------------| | A6 | 1 | | A6 on A4 | 4 (2×2 grid) | When printing A6 on A4, you can select a starting position on the sheet (positions 1–4) to reuse partially used label sheets. --- Troubleshooting | Issue | Resolution | |---------------------------------------------|----------------------------------------------------------------------------------------------------------------| | "Username or password is not configured" | Both the WebShip username and password are mandatory. Fill them in on the carrier account and save. | | Authentication error from WebShip | Verify your WebShip credentials and confirm with your SPS sales representative that web service access is enabled for the account. | | Export rejected with an SPS error message | WebShip validates the shipment and returns the reason — usually an incomplete address, an unsupported destination ZIP, or a service that is not enabled on your account. Fix the order and export again. | | "SPS did not return a tracking number" | SPS accepted the request but sent no shipment number. Check the SPS portal for a duplicate shipment before exporting again. | | Parcel shipped to the home address instead of a pickup point | The order was exported on a Balíkovo or Parcel Terminal service without a pickup point attached. Check that the customer selected a point at checkout and that the shipping method mapping is correct. | | "No label URLs found for these SPS orders" | The labels are no longer available for that batch. Re-export the orders to generate new labels. | | Labels cannot be retrieved from SPS WebShip | The label PDFs could not be downloaded from SPS. Wait a moment and print the batch again. | --- # Toptrans API URL: https://docs.globe.appfleece.com/integrations/toptrans-api Globe Pickup Points integrates with Toptrans, a Czech and Slovak parcel and pallet carrier, enabling seamless order export and shipping label printing directly from Shopify. With this integration, you can: Export orders to your Toptrans ZP2 portal Print shipping labels within Shopify Support cash on delivery (COD) in CZK and EUR --- Enabling Toptrans API integration 1. In your Shopify admin, open Globe Pickup Points and navigate to Shipping labels. Add a new carrier and select Toptrans. 2. Enter your Username and Password — these are the same credentials you use to log in to Toptrans ZP2. 3. If you use cash on delivery, enter your bank account number in the format . 4. Configure fulfillment and tagging options as needed. 5. Map your Shopify shipping methods to the appropriate Toptrans transport urgency type. --- Exporting and printing labels You can export orders to Toptrans and print shipping labels directly from Shopify, either in bulk or individually. Draft mode vs. auto-send By default, orders are saved as drafts in ZP2. This lets you review and modify them in Toptrans before dispatching. If you enable the Auto-send option in the carrier settings, orders are immediately dispatched to Toptrans TOPIS after export — labels are generated and available for printing right away. --- Service types When exporting an order, select the transport urgency that matches your agreement with Toptrans: | Type | Description | |-----------------------|------------------------------------------| | Standard | Standard delivery | | TopTime | Time-guaranteed delivery | | Top Privat | Private address delivery | | Top Express | Express delivery | | Rozvoz po avizaci | Delivery after prior notification | | Osobní odběr | Personal pickup at Toptrans depot | --- Advanced shipment options The following per-shipment options can be set at the time of export. Default values can be configured in the carrier account settings. | Option | Description | |--------------------|----------------------------------------------------------------| | Package type | Type of packaging (e.g. Carton, Pallet, Pneu). Defaults to Carton. | | Recipient notice | Call the recipient before delivery to arrange a delivery time. | | Number of euro pallets | Number of euro pallets to collect from the recipient (0 = none). | | Oversize | Mark the shipment as oversized. | --- Cash on delivery (COD) Toptrans supports COD in CZK and EUR only. Configure your bank account number in the carrier settings in the format . If an order is placed in an unsupported currency with COD enabled, the export will be rejected — you will need to process the order manually or use a different payment method. --- Label printing Labels are printed on A4 paper. When printing, you can choose the starting position on the sheet (positions 1–14), allowing you to reuse partially used label sheets. --- Troubleshooting | Issue | Resolution | |-------------------------------|----------------------------------------------------------------------------------------| | Authentication error | Check that your username and password match your Toptrans ZP2 login credentials. | | COD rejected — unsupported currency | Only CZK and EUR are supported. Ensure the order currency matches your COD setup. | | Order sent when it should be a draft | Verify that Auto-send is disabled in the carrier settings. | --- # UPS API URL: https://docs.globe.appfleece.com/integrations/ups-api Globe Pickup Points integrates with UPS, a worldwide parcel carrier, enabling order export and shipping label printing directly from Shopify. With this integration, you can: Export orders to UPS directly from Shopify Print shipping labels within Shopify Ship 15 UPS domestic, European and worldwide services Send international parcels with customs data generated automatically from your Shopify products UPS is enabled per store on request. If you do not see UPS in the carrier list, contact Globe support and we will enable it for your store. --- Enabling UPS API integration 1. In your Shopify admin, open Globe Pickup Points and navigate to Shipping labels. Add a new carrier and select UPS. 2. Enter your Account number — your UPS shipper account number, shown in your UPS billing account details. 3. Fill in the sender details: Sender name, Sender street, Sender city, Sender ZIP, Sender country and Sender phone. Sender email is optional. 4. Sender state/province is a state or province code (for example , ). It is required when shipping from the United States or Canada and can be left empty elsewhere. 5. Click Connect UPS Account. A UPS window opens where you sign in with your UPS credentials and authorise Globe. Once you return, the connection is stored and the access token is refreshed automatically — you do not need to enter an API key or password anywhere. 6. Configure fulfillment and tagging options as needed. 7. Map your Shopify shipping methods to the UPS services you have on your account. You can disconnect the UPS account at any time from the same screen; exporting is blocked until it is connected again. --- Exporting and printing labels You can export orders to UPS and print shipping labels directly from Shopify, either in bulk or individually. For the label workflow itself, see Creating shipping labels. Each shipment receives a UPS tracking number, and the label image is stored with the order so it can be reprinted later without contacting UPS again. If Globe no longer has the stored image, it is fetched back from the UPS label recovery service using the tracking number. Parcels are tracked at . --- Service types Select the service that matches your UPS contract when exporting an order: | Code | Service | Typical use | |----------|--------------------------------|--------------------------------------| | 03 | UPS Ground | Domestic ground (US) | | 11 | UPS Standard | Road delivery within Europe | | 01 | UPS Next Day Air | Domestic next-day air | | 02 | UPS 2nd Day Air | Domestic two-day air | | 12 | UPS 3 Day Select | Domestic three-day air | | 13 | UPS Next Day Air Saver | Domestic next-day, end of day | | 14 | UPS Next Day Air Early | Domestic next-day, early morning | | 59 | UPS 2nd Day Air A.M. | Domestic two-day, morning delivery | | 07 | UPS Worldwide Express | International express | | 08 | UPS Worldwide Expedited | International, day-definite | | 54 | UPS Worldwide Express Plus | International, early morning | | 65 | UPS Worldwide Saver | International express, end of day | | 96 | UPS Worldwide Express Freight | International palletised freight | | 71 | UPS Worldwide Economy DDU | Economy, duties unpaid | | 72 | UPS Worldwide Economy DDP | Economy, duties paid | Not every service is available on every account or from every origin country — UPS rejects a shipment using a service your account is not contracted for. --- Home and business delivery only UPS labels created in Globe are always addressed to the customer's home or business address taken from the Shopify order. Delivery to UPS Access Point locations is not supported — a pickup point selected at checkout is not transmitted to UPS, and the parcel will be delivered to the shipping address instead. Do not map a pickup point shipping method to a UPS service. Return labels are also not supported. --- Advanced shipment options These options are set per shipment in the export dialog. They are not carrier settings — the UPS carrier account has no place to store defaults for them, so set them on the shipments that need them. | Option | Description | |---------------------|----------------------------------------------------------------------------------------| | Packaging type | Customer Supplied Package (default), UPS Letter, Tube, PAK, UPS Express Box, UPS 25KG Box, UPS 10KG Box | | Content description | Shipment description printed on the label and used on customs forms. Defaults to . | | HS code | HS code used on the customs forms of that shipment, when a product has no HS code in Shopify. | --- Customs and international shipments Customs forms (a commercial invoice) are added automatically when the sender country and the destination country differ and the shipment is not an intra-EU movement. Globe builds the invoice from the order line items: Product title, quantity, unit price and SKU HS code from the product's Shopify inventory item, falling back to the HS code entered for that shipment in the export dialog Country of origin from the product's Shopify inventory item, falling back to the sender country Item weight from Shopify, converted to the shipment weight unit The invoice number is the Shopify order number, the reason for export is , and the currency is the order currency. Weights are sent in kilograms, except for senders in the United States, Puerto Rico and the US Virgin Islands, where pounds are used. --- Cash on delivery (COD) UPS does not support cash on delivery in Globe. No COD amount is sent to UPS, so a COD order exported to UPS ships as an ordinary prepaid parcel and no money is collected on delivery. Use a carrier that supports COD for those orders, or switch the customer to a prepaid payment method before exporting. --- Delivery status The UPS integration does not sync delivery statuses back to Shopify. The tracking number and tracking link are still attached to the fulfillment (when automatic fulfillment is enabled), so delivery progress can be followed on ups.com. --- Label printing UPS returns a 4×6 inch label image, which Globe converts to PDF and rotates to portrait for printing. The following formats are available: | Format | Positions per sheet | |------------|-------------------------| | A6 | 1 | | A6 on A4 | 4 | When printing A6 labels on A4, you can select the starting position on the sheet (positions 1–4) to reuse partially used sheets. --- Troubleshooting | Issue | Resolution | |-----------------------------------------------|---------------------------------------------------------------------------------------------------------| | UPS account is not connected | Open the carrier settings and click Connect UPS Account to complete the UPS sign-in. | | UPS authentication failed — token may have expired | The stored UPS authorisation could not be refreshed. Disconnect and connect the UPS account again. | | Invalid or expired session during connecting | The UPS sign-in must be completed within 10 minutes. Close the window and start the connection again. | | Shipment creation failed with a UPS message | The message comes straight from UPS. Most often the service is not enabled on your account, the recipient address is incomplete, or the account number does not match the sender address. | | Missing or invalid state/province | US and Canadian senders and recipients need a valid state or province code. Fill in Sender state/province and check the customer's address. | | No labels could be retrieved from UPS | The stored label image is missing and label recovery failed. Check that the shipment has a tracking number and that the UPS account is still connected. | | COD order delivered without collecting money | Expected — UPS shipments in Globe are never COD. See Cash on delivery (COD) above. | --- # Custom pickup points via API URL: https://docs.globe.appfleece.com/reference/custom-pickup-points-api You can use Globe to integrate your own pickup points into the app. This is especially useful if you deliver to your own stores or operate a custom pickup point network. To enable custom pickup points yourself, you need to set up an API that returns pickup point data in a structured format. This guide explains how to build and configure your API to work seamlessly with Globe. --- How it works When a customer searches for pickup points near a specific location, Globe will send a request to your API endpoint. Your API should process the request and return a list of pickup points in the required format. Request structure Globe will send a request with the following details: Headers: - : - : (use this to verify requests come from Globe) - any other headers from your settings in Globe Body: A JSON object with these fields: - **** (float): Latitude of the customer's location. - **** (float): Longitude of the customer's location. - **** (string): ISO 3166-1 alpha-2 country code of the customer's location (e.g., for the Czech Republic). - **** (string): The domain of the shop associated with the request. --- Response structure Your API should return a JSON response with the following structure, containing a maximum of 50 items sorted by distance from the requested location. If your API returns more than 50 items, only the first 50 will be processed by Globe. Fields **** (string): Unique identifier for the pickup point. **** (float): Longitude of the pickup point's location. **** (float): Latitude of the pickup point's location. **** (string): The name of the pickup point. **** (string, optional): General location or neighborhood. **** (string): Street address. **** (string): City name. **** (string): ZIP or postal code. **** (string): ISO 3166-1 alpha-2 country code (e.g., for the Czech Republic). **** (string, optional): URL of a 50x75 pixel image representing the pickup point pin on the map. **** (object, optional): Operating hours for each day of the week. Days not included are assumed to be closed. Example: --- Error handling If an error occurs while processing the request, your API should return an appropriate HTTP status code and a JSON object with an error message. For example: Common errors : Missing or invalid parameters. : Unexpected server issues. --- Example API implementation Below is an example of how you could implement the required API in Node.js: --- Testing your API Once your API is implemented, you can test it using tools like Postman or curl: Example request Example response --- Next steps 1. Deploy Your API: Host your API on a secure HTTPS-enabled server. 2. Add Your Custom Endpoints in Globe: Add a new carrier with a custom API endpoint. 3. Test Integration: Verify the pickup points are displayed correctly in the Globe app. If you have questions or need assistance, contact our support team. --- # Point metafield URL: https://docs.globe.appfleece.com/reference/metafield Pickup Points details are saved to Order metafields. You can use the Shopify API to query and integrate in your other applications. Definition Metafield data You can query the order metafields to fetch pickup point data. --- # Pickup point delivery option generator URL: https://docs.globe.appfleece.com/reference/pickup-point-delivery-generator Shopify has introduced a new Pickup Point Delivery Option Generator, currently in beta and available exclusively for Shopify Plus stores. This feature allows merchants to dynamically display pickup point delivery options at checkout using Shopify Functions. Globe Pickup Points supports this functionality and can integrate seamlessly with it, ensuring your pickup point data is handled correctly. You can read more about this feature in the Shopify documentation. --- How it works with Globe If your store chooses to use Shopify’s Pickup Point Delivery Option Generator, Globe Pickup Points will still manage your pickup point configuration, including: Carrier Mapping: Your Shopify shipping methods will remain synced with Globe carriers, ensuring delivery options are accurate. Order Attributes: Pickup point data (such as name, address, and ID) will be stored as order attributes for easy order management. This integration allows Globe to work alongside Shopify’s functionality while retaining the settings and workflows you’ve already configured. --- Enabling the Integration To enable Shopify’s Pickup Point Delivery Option Generator with Globe Pickup Points, follow these steps: 1. Contact Our Team: Reach out to our support team and let us know you’d like to enable this feature. 2. Custom App Setup: We will guide you through creating a custom app to support the functionality. 3. Deploy the Required Code: Our team will help deploy the necessary Shopify Function. 4. Configuration: Globe will continue to manage your pickup point settings as usual, ensuring a seamless integration. --- # Get help URL: https://docs.globe.appfleece.com/reference/support Globe has its own support panel inside the app — open it from any screen in the Globe admin and you can reach us without leaving Shopify. Real-time chat with the Globe team, including file and screenshot uploads Documentation search built in, so you can look something up without switching tabs Updates tab with the latest changes shipped to the app Available in English, Czech, German, Spanish, French, Hungarian and Polish Replies also arrive by email, so you never miss an answer even after closing the Shopify admin. Our official hours are Monday through Friday, from 9 AM to 5 PM UK time, but don't be surprised if you catch us online more often! 😊 Maximizing Support Efficiency To expedite the handling of your queries, please ensure you provide as much relevant information as possible when you reach out. This includes any pertinent details, context, and screenshots. This will help us address your concerns quickly and effectively. --- # Webhooks URL: https://docs.globe.appfleece.com/reference/webhooks Globe can send HTTP POST notifications to your server when key events occur in your store. Use webhooks to build custom automations — update your WMS, trigger fulfilment workflows, send notifications, or sync data with external systems. --- Setup 1. Go to Settings → Webhooks in the Globe admin. 2. Click Add webhook, enter an HTTPS endpoint URL, and choose the events you want to receive. 3. Copy the secret shown after creation — it is displayed only once. Store it securely. --- Payload envelope Every webhook is a request with . The body always follows this structure: | Field | Description | |---|---| | | Event type (see below) | | | Your Shopify store domain | | | ISO 8601 timestamp of when Globe sent the request | | | Unique UUID for this delivery attempt — use for deduplication | | | Event-specific payload (see events below) | --- Events Fired when a shipping label is successfully generated for an order. Key fields in : , , , , , , carries values that only one carrier can produce, so the rest of the payload keeps the same shape for every carrier. Packeta sends — the 9-digit consign code that opens a Z-BOX when you drop the parcel in. It is filled in when the carrier account has Show consign code (Z-BOX) enabled, and otherwise. Carriers with no extras of their own send an empty object. --- Fired when a pickup point is selected or changed on an order. Key fields in : , , The field contains the full pickup point object including name, address, GPS coordinates, and carrier-specific data. --- Fired approximately 5 minutes after order creation when the order requires a pickup point but none has been selected yet. Key fields in : , , --- Fired when the carrier confirms that a cash-on-delivery order has been paid. Key fields in : , , --- Fired when the carrier reports a change in delivery status. Key fields in : , , , , --- Fired when Globe sends a pickup-point selection reminder email to the customer. Key fields in : , , , --- Inspecting payloads To explore the exact payload structure for each event, use webhook.site: 1. Open webhook.site and copy your unique URL. 2. Add it as a webhook endpoint in Globe (Settings → Webhooks). 3. Trigger the event naturally in your store — place a test order, export a label, etc. 4. The full request body will appear on webhook.site in real time. --- Verifying requests Each request includes the following headers: | Header | Description | |---|---| | | — HMAC-SHA256 signature of the raw request body, signed with your secret | | | Unix timestamp in seconds — reject requests older than 5 minutes to prevent replay attacks | | | Event type | | | Delivery UUID | Node.js verification example: --- Retries & reliability Globe retries failed deliveries up to 7 times with exponential backoff: Your endpoint must return a status within 10 seconds. After that the request is treated as failed. If an endpoint fails repeatedly, Globe temporarily suspends deliveries for 24 hours and retries automatically. After 3 suspension cycles with no successful delivery the subscription is disabled. You can re-enable it at any time from Settings → Webhooks. --- # Blocking orders without pickup point URL: https://docs.globe.appfleece.com/settings/blocking-orders-without-pickup-point Ensure customers cannot complete checkout without selecting a pickup point. When enabled, checkout is strictly blocked if the customer has chosen a pickup point shipping method but has not selected a specific pickup point. --- Why use this? Without a hard block, some customers may complete orders without selecting a pickup point. This leads to: Incomplete orders requiring manual follow-up Processing blocks in your workflow Orders that cannot be transmitted to your ERP or fulfillment system Extra manual intervention and support requests Enabling pickup point validation ensures every order with a pickup point shipping method has a selected pickup point before payment. --- Shopify Plus stores The checkout UI extension included with Globe intercepts checkout progress in real time and blocks the customer from proceeding if no pickup point is selected. The block happens on-screen before the customer reaches the payment step. How to enable 1. In your Shopify admin, go to Settings → Checkout. 2. Scroll down to the Checkout rules and validation section. 3. Find the Pickup point validation rule by Globe Pickup Points. 4. Enable the validation. Once enabled, customers will not be able to complete their order until they select a pickup point. --- Cart widget stores A dedicated Shopify checkout validation rule blocks the order at the final checkout step if no pickup point was selected in the cart widget. This works on all Shopify plans. How to enable 1. In your Shopify admin, go to Settings → Checkout. 2. Scroll down to the Checkout rules and validation section. 3. Find the Pickup point validation (Cart widget) rule by Globe Pickup Points. 4. Enable the validation. Once enabled, customers will not be able to complete their order until they select a pickup point in the cart. The error message directs them back to the cart to make their selection. --- # Cash on delivery rounding URL: https://docs.globe.appfleece.com/settings/cash-on-delivery-rounding Simplify cash payments and eliminate decimal inconsistencies with automatic cash on delivery rounding. This feature adjusts cash on delivery (CoD) orders by rounding up their total and adding a small fee to ensure clean, easy-to-handle payment amounts. --- How It Works The cash on delivery rounding feature adjusts order totals for CoD payments by rounding the total amount up. This ensures simple and clean payment amounts for cash transactions. The rounding behavior depends on the currency: EUR (Euro): Orders are rounded up to the nearest 0.05. This eliminates small cent amounts, simplifying cash handling. - Example: €23.37 → €23.40, €23.32 → €23.35. HUF (Hungarian Forint): Orders are rounded up to the nearest 5. This complies with Hungarian cash-handling standards. - Example: 766 HUF → 770 HUF, 773 HUF → 775 HUF. All Other Currencies (e.g., CZK): Orders are rounded up to the nearest whole number. - Example: 760.43 CZK → 761 CZK, 599.99 CZK → 600 CZK. The rounding difference is added as a small fee, ensuring transparency for both your store and your customers. --- Examples Here’s how the rounding works for different currencies: | Currency | Original Order Total | Rounded Total | Rounding Fee | |----------|-----------------------|---------------|--------------| | EUR (€) | 23.37 | 23.40 | +0.03 | | EUR (€) | 23.32 | 23.35 | +0.03 | | HUF | 766 | 770 | +4 | | HUF | 773 | 775 | +2 | | CZK | 760.43 | 761 | +0.57 | | CZK | 599.99 | 600 | +0.01 | --- Key Benefits 1. Simplified Cash Handling: By removing fractional amounts or awkward decimals, rounding ensures easier payment processing for cash transactions. 2. Compliance with Regional Rules: Aligns with local cash-handling practices, such as rounding in the eurozone or Hungary. --- Setting It Up To enable cash on delivery rounding, follow these steps: 1. Go to Settings > Payments in your Shopify admin. 2. Enable the Cash on Delivery (CoD) payment gateway for your store. 3. Specify the currencies where rounding should apply in your Globe app settings. 4. Save the changes. Orders using CoD in the selected currencies will now include rounding automatically. --- Benefits at a Glance Reduce operational complexity: Simplify cash payments for your team and customers. Avoid WMS errors: Ensure compatibility with systems that require whole or rounded amounts. Enhance customer trust: Keep rounding fees transparent and fair. --- # Google Maps API Keys URL: https://docs.globe.appfleece.com/settings/google-maps-api-key Globe Pickup Points supports two optional Google API keys to enhance the pickup point selection experience for your customers: 1. Google Maps JavaScript API key (recommended) - Displays an interactive map with pickup point locations 2. Google Places API key (optional) - Used for address search in the map with autocomplete and more accurate results Both keys are optional, but the Google Maps API key is recommended for the best customer experience. Without them, customers can still select pickup points from a dropdown list. Creating your Google Maps JavaScript API key This key enables the interactive map display showing pickup point locations. 1. Go to the Google Cloud Platform Console. 2. If you don't already have a project, create one by clicking 'New Project' and follow the on-screen instructions to set it up. 3. Once your project is ready, navigate to the 'APIs & Services' dashboard and click on 'Enable APIs and Services'. 4. In the search box, type Google Maps JavaScript API and select it. Then click 'Enable' to activate the API for your project. 5. After enabling the API, go to the 'Credentials' tab and click on '+ Create Credentials'. Select 'API key' from the dropdown menu. Your new API key will be created and displayed on the screen. 6. Restrict your API key to prevent unauthorized use: - Click 'Edit API Key' (or the pencil icon next to your key) - Under 'Application restrictions', select 'Websites' - Add the following referrer domains to restrict API key usage to your Shopify store: - (replace with your actual domain) - - (replace with your actual domain) - - - Include any additional domains your shop operates on - Under 'API restrictions', select 'Restrict key' and choose only 'Maps JavaScript API' 7. Click 'Save' to apply your settings. For detailed instructions, refer to the official Google guide on getting an API key. Creating your Google Places API key This key is used for address search in the map — customers can type an address and get autocomplete suggestions as they type. Pickup points are then displayed near the entered address. Without this key, search still works but without autocomplete and with less accuracy. 1. In the same Google Cloud Platform Console, use the same project you created for the Maps API. 2. Navigate to the 'APIs & Services' dashboard and click on 'Enable APIs and Services'. 3. In the search box, type Places API (New) and select it. Then click 'Enable' to activate the API for your project. 4. After enabling the API, go to the 'Credentials' tab and click on '+ Create Credentials'. Select 'API key' from the dropdown menu. 5. Important: Give this key a descriptive name like "Places API Key" to distinguish it from your Maps JavaScript API key. 6. Restrict this API key: - Click 'Edit API Key' - Under 'Application restrictions', select 'None' (this key is used server-side only, not in the browser) - Under 'API restrictions', select 'Restrict key' and choose only 'Places API (New)' 7. Click 'Save' to apply your settings. Adding your API keys to Globe Pickup Points After creating your API keys, integrate them into the Globe Pickup Points app: 1. Log in to your Shopify admin panel. 2. Navigate to the Globe Pickup Points app. 3. Go to the Settings page. 4. You'll find two separate fields: - Google Maps API key (recommended) - Paste your Maps JavaScript API key here to enable the interactive map - Google Places API key (optional) - Paste your Places API key here for address search in the map with autocomplete. Without it, search still works but is less accurate and has no address suggestions. 5. You can add one or both keys depending on which features you want to enable. 6. Click Save to apply the changes. By setting up these API keys, you enable an enhanced map-based pickup point selector with location search capabilities, significantly improving your customers' experience. --- --- # Order attributes URL: https://docs.globe.appfleece.com/settings/order-attributes Enhance your integration capabilities by configuring custom order attributes for each provider. This feature is essential when connecting with third-party applications that require specific data attributes to function correctly. Example use case Consider a scenario where you need to identify the pickup point in an order. You can define an attribute called with the following mapping: With this configuration, each order will automatically include the ID of the chosen pickup point, simplifying the management and tracking of orders across various locations. Mapping order attributes Order attributes can be mapped using keys available in our Metafield reference. This flexibility allows you to tailor the data attached to each order according to your operational needs and the requirements of connected applications. --- # Shipping address update URL: https://docs.globe.appfleece.com/settings/shipping-address-update Globe Pickup Points allows you to dynamically replace the shipping address fields in your orders with pickup point data. This feature provides flexibility for merchants who need their orders to reflect the pickup point details, enabling seamless integration with third-party applications or fulfillment systems. --- Example use case Consider a scenario where you need to use the pickup point details in place of the shipping address for certain orders. For example, you can configure the following mappings: Replace the address line with the pickup point name. Replace the city field with the pickup point's city. Replace the postal code with the pickup point's ZIP code. Here’s an example of how you could configure these fields using Liquid: With this setup, the order’s shipping address fields will automatically reflect the selected pickup point's details. --- Configuring address replacement To replace the shipping address with pickup point data, follow these steps: 1. Navigate to the provider settings for the desired carrier in Globe Pickup Points. 2. Enable Update shipping address with pickup point data. 3. Use Liquid variables to map the pickup point data to the appropriate shipping address fields. For example: - Address Line 1: {{ point.name }} - City: {{ point.addressObject.city }} - ZIP Code: {{ point.addressObject.zip }} - Country Code: {{ point.addressObject.country }} 4. Save your configuration. Once configured, orders using the selected carrier will automatically have their shipping address replaced with the corresponding pickup point details. --- Benefits of address replacement 1. Streamlined Integration: Ensures compatibility with systems that rely on the shipping address fields for order processing or delivery. 2. Improved Data Accuracy: Automatically populates the address fields with verified pickup point data, reducing errors. 3. Customizable: Use Liquid templating to configure the address replacement according to your specific needs. --- Example configuration Here’s a practical example of how you might configure the replacement: ---