# 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: Order attributes and CSV export for Baselinker, Mailship, 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 (Packeta, PPL, DPD, Balíkovna, MyGLS, Pošta bez hranic, Magyar Posta, TopTrans, FoxPost) and external tools. Reference: Developer-focused resources, including APIs, metafields, and changelogs. 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 %} {% 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 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. --- # 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. 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. --- 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. --- 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. --- # 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 PPL CZ DPD Balikovna (Czech Post) MyGLS Pošta bez hranic Magyar Posta TopTrans CZ FoxPost --- 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 --- 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. 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. --- # 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. --- # Shopify shipping carrier API integrations URL: https://docs.globe.appfleece.com/integrations/carrier-api-integrations Globe Pickup Points connects your Shopify store to shipping carriers in two ways: Pickup points at checkout — let customers pick a parcel locker or pickup point from a wide range of carriers. See the full list of supported carriers. Direct carrier API integrations — for the carriers below, Globe also exports orders to the carrier and prints shipping labels directly inside Shopify, so you never have to re-key orders into a separate carrier portal. This page lists every carrier and platform integration Globe offers. Each links to a setup guide. --- Direct carrier API integrations Export orders and print shipping labels from Shopify, with delivery-status sync where the carrier supports it. | Carrier | What you can do | |---|---| | Packeta (Zásilkovna) API | Export orders, print labels, 2-way delivery-status sync, cash-on-delivery tracking | | PPL CZ API | Export orders, print labels, 2-way delivery-status sync | | DPD API | Export orders, print labels (pickup-point and home delivery) | | Balíkovna API | Export orders, print labels (Czech Post B2B; pickup-point and post-office delivery) | | MyGLS API | Export orders, print labels, enhanced sync for failed deliveries and cash-on-delivery verification | | Pošta bez hranic API | Export orders, print labels, 2-way delivery-status sync | | Toptrans API | Export orders to ZP2, print labels, cash on delivery in CZK and EUR (parcels and pallets) | | FoxPost API | Export orders, print labels, parcel lockers (APM) and home delivery with tracking | --- Order & warehouse management Pass pickup-point data automatically to your OMS/WMS so your fulfillment team always has the correct delivery details. | Platform | What you can do | |---|---| | Base (Baselinker) | Auto-sync pickup-point data (name, address, ID, carrier) onto Baselinker orders | | MetaKocka | Auto-sync pickup-point details onto MetaKocka orders | | Picqer | Auto-sync pickup-point data to Picqer orders (PostNL, DHL, DPD) | --- Data export | Tool | What you can do | |---|---| | CSV export | Build custom, Liquid-templated CSV exports of orders with pickup-point data — useful for carriers that import CSV (e.g. DHL, PPL) | --- Don't see your carrier? Globe offers pickup points for many more carriers even 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 to get started. --- # 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: --- # 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. --- # 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. | --- # 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. --- # 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. --- 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 client account is not approved for posting parcels | Contact Packeta and ask them to approve your account for posting parcels. | --- # 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. | --- # 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. | --- # Page with a banner URL: https://docs.globe.appfleece.com/missing-pickup-point --- # 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. Defition 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 Our customer support team is ready to assist you through the chat widget. While official hours are Monday through Friday, from 9 AM to 5 PM UK time, 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 : , , , , , --- 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: ---