Integrate an external fulfillment service with Managed Markets

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

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.