Integrate an external fulfillment service with Managed Markets
On this page
Get your globally unique identifier for Managed Markets (GUID)
When you onboard to Managed Markets, you're given a globally unique identifier (GUID). If you're already using Managed Markets for live orders, then you can find your GUID in your Shopify admin by going to Markets > Managed Markets.
If you aren’t an existing Managed Markets user, then contact your sales representative to locate your GUID.
A GUID isn't the same thing as a merchant ID, a merchant account ID, or a merchant card processor account. If you need to provide one of these identifiers to a third party, then you can use your store ID instead. To get your store ID, contact Shopify Support.
Distinguish Managed Markets orders from domestic orders
Your fulfillment service must distinguish between domestic orders and international orders managed by Managed Markets. This is so domestic fulfillments are uninterrupted and international fulfillments will use the correct shipping and customs information.
You can correctly identify international orders managed by Managed Markets using the merchant_of_record_api_client_id. This attribute is available on the Shopify Order object. It can be accessed via Shopify webhooks, RESTful GET Orders calls or GraphQL queries. Version 2022-10 or later of the Shopify API is required for this field to be present. When Managed Markets is responsible for an order, this value will be set to 2745565185.
It's important that this attribute is set on every international order. Orders that don't have this set won't be managed by Managed Markets.
Fulfill Managed Markets orders with the correct label and customs information
All order information is available through Shopify’s first party Orders API. Shipping labels and customs information need to be retrieved using Global-e’s Shipping APIs. How to retrieve the correct shipping label and customs information can be found in this documentation.
It’s important that international orders use the correct shipping label and customs information. Incorrect labels can result in disruption to your payouts and a poor customer experience.
Integrate ZPL Labels for Managed Markets
Understanding ZPL Labels for Managed Markets
Zebra Programming Language (ZPL) labels are a widely-used print format designed specifically for Zebra printers. For merchants using Managed Markets, ZPL labels are available through Global-e and can be printed via compatible third-party logistics providers' (3PLs) APIs. Note that only Managed Markets labels can be provided in ZPL format, while labels purchased through Shopify will only be delivered in a PDF format.
Eligibility and Compatibility
- Only compatible 3PLs are eligible to access ZPL labels. For a list of compatible 3PLs, refer to Fulfilling orders using external fulfillment services.
- ZPL labels are designed for a 4"x 6" print format.
Setting Up and Support
To enable ZPL labels for Managed Markets shipments fulfilled through your 3PL, contact Shopify Support.
Management of existing orders
If your fulfillment service can cancel and recreate orders, then it must be created with the correct merchant_of_record_api_client_id so that the right label and customs information can be generated.