{"title":"Synchronize customers and companies","url":"https://jonas-paprotka.de/docs/shopify/synchronize-customers/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/shopify/synchronize-customers, MicrosoftDocs/dynamics365smb-docs at 46907ac (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/shopify/synchronize-customers","source":{"name":"Business Central application docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-docs","commit":"46907ace177f8d31deba47a2fdb57c3336e66252","date":"2026-11-19"},"checked":"2026-11-19","description":"Import customers and companies from or export to Shopify.","date":"2026-10-14","meta":{"topic":"how-to"},"outline":[{"level":1,"title":"Synchronize customers and companies","slug":"synchronize-customers-and-companies","at":0,"chars":25269},{"level":2,"title":"Important settings when importing DTC customers from Shopify","slug":"important-settings-when-importing-dtc-customers-from-shopify","at":1953,"chars":8066},{"level":3,"title":"Customer setup per country/region","slug":"customer-setup-per-countryregion","at":4829,"chars":1688},{"level":3,"title":"Populate customer information in Business Central","slug":"populate-customer-information-in-business-central","at":6517,"chars":3502},{"level":2,"title":"Important settings when exporting DTC customers to Shopify","slug":"important-settings-when-exporting-dtc-customers-to-shopify","at":10019,"chars":3506},{"level":3,"title":"Populate customer information in Shopify","slug":"populate-customer-information-in-shopify","at":11377,"chars":2148},{"level":2,"title":"Export DTC customers to Shopify","slug":"export-dtc-customers-to-shopify","at":13525,"chars":1214},{"level":3,"title":"Initial sync of customers from Business Central to Shopify","slug":"initial-sync-of-customers-from-business-central-to-shopify","at":13560,"chars":693},{"level":3,"title":"Sync customers","slug":"sync-customers","at":14253,"chars":486},{"level":2,"title":"B2B Companies","slug":"b2b-companies","at":14739,"chars":7600},{"level":3,"title":"Important settings when importing B2B companies from Shopify","slug":"important-settings-when-importing-b2b-companies-from-shopify","at":14894,"chars":3549},{"level":3,"title":"Important settings when exporting B2B companies to Shopify","slug":"important-settings-when-exporting-b2b-companies-to-shopify","at":18443,"chars":2545},{"level":3,"title":"Export a B2B company to Shopify","slug":"export-a-b2b-company-to-shopify","at":20988,"chars":882},{"level":4,"title":"Initial sync of B2B companies from Business Central to Shopify","slug":"initial-sync-of-b2b-companies-from-business-central-to-shopify","at":21024,"chars":846},{"level":3,"title":"Sync a B2B company","slug":"sync-a-b2b-company","at":21870,"chars":469},{"level":2,"title":"Import and export customer information using Shopify metafields","slug":"import-and-export-customer-information-using-shopify-metafields","at":22339,"chars":2695},{"level":4,"title":"Supported metafield content types","slug":"supported-metafield-content-types","at":24543,"chars":491},{"level":2,"title":"Related information","slug":"related-information","at":25034,"chars":235}],"text":"# Synchronize customers and companies\nWhen you import an order from Shopify, getting the information about the customer is essential for further processing the document in Business Central. There are two main options for doing so, and several combinations:\n Use a special customer for all orders.\n Import the customer information from Shopify. This option is also available when you export customers to Shopify from Business Central.\nShopify allows you to run your business to business (B2B) and direct to customer (DTC) business from one place with the power and ease of Shopify's all-in-one platform. Shopify Connector also works with different flavors of e-commerce.\nWhile Shopify has two entities-customer and company-Business Central has only the customer entity, which affects how synchronization works.\nWhen you run DTC, the buyer is created in Shopify as a customer. The customer is then imported to Business Central as a Shopify customer, and linked or converted to a customer.\nIf you run B2B, the buyer is created in Shopify as a customer linked to a company. The customer is imported to Business Central as a Shopify customer, and the company is imported to Business Central as a Shopify company and linked or converted to a customer.\nTo export a customer from Business Central to Shopify, the steps are different depending on what you want to do:\n Export a customer as a Shopify customer for DTC.\n Export a customer as a company and customer pair for the B2B flow.\n> TIP\n> Before you configure customer synchronization, decide which system is the system of record for customer data. Most businesses manage customer records, payment terms, and credit limits in Business Central and export them to Shopify. If you run a direct-to-consumer store where new buyers sign up on the storefront, you typically import customers from Shopify into Business Central. Mixing both directions without a clear ownership rule can lead to conflicting records.\n## Important settings when importing DTC customers from Shopify\nWhether you import customers from Shopify in bulk or when you import orders, use the following settings to manage the process:\nField|Description\nCustomer Import from Shopify|Select All Customers if you plan to import customers from Shopify in bulk; either manually using the Sync Customers action or via the job queue for recurring updates. Regardless of the selection, the customer information will always be imported together with the order. However, the use of this information depends on the Customer Setup by Country/Region page and settings in the Customer Mapping Type field.\nCustomer Mapping Type|Define how you want the connector to perform the mapping.</br></br>- By EMail/Phone if you want the connector to use email account and telephone information to map the imported Shopify customer to a customer in Business Central.</br></br>- By Bill-to Info if you want the connector to use the address of the invoice recipient to map the imported Shopify customer to an existing customer in Business Central.</br></br>- Always take the default customer if you want the system to use a customer from the Default Customer No. field.\nShopify Can Update Customers|Select this field if you want the connector to update the customers it finds when either of the By EMail/Phone or By Bill-to Info options are selected in the Customer Mapping Type field. When you use the Sync Customers action, this setting also updates the customers you imported with Shopify orders. The customer field table<#populate-customer-information-in-business-central> describes which fields the connector updates.\nAuto Create Unknown Customers|Select this field if you want the connector to create missing customers when the By EMail/Phone or By Bill-to Info options are selected in the Customer Mapping Type field. A new customer is created using imported data and the Customer Template Code defined on the Shopify Shop Card or Shopify Customer Template pages. Notice that the Shopify customer must have at least one address. Orders created via Shopify POS sales channel are often missing address details. If this option isn't enabled, you must create a customer manually and link it to the Shopify customer.\nCustomer/Company Template Code|Use this field together with Auto Create Unknown Customers.</br></br>Choose the default template to use for automatically created customers. Make sure the selected template contains the mandatory fields such as Gen. Business Posting Group, Customer Posting Group, and value-added tax (VAT) or tax-related fields.</br></br>You can define templates per country/region on the Customer Setup by Country/Region page, which helps calculate taxes correctly.</br></br>See Set Up Taxes<synchronize-orders#address-dependent-tax-rates>.\nSee synchronize-orders#how-the-connector-chooses-which-customer-to-use\n### Customer setup per country/region\nWhen you enable a Shopify shop, the connector automatically populates the country/region setup with the countries and regions where the merchant allows shipping. You configure these settings in Shipping and Delivery<https://www.shopify.com/admin/settings/shipping> in Shopify. For each country or region, the connector adds province or state names and codes to the Shopify Tax Areas section.\nTo refresh or complete the list later, choose the import action on the page. The action adds missing country or region and province or state rows without overwriting the tax settings in existing rows.\nYou can do the following for each customer using the Customer Setup by Country/Region page:\n1. Specify the Default Customer No., which takes priority over the selection in the Customer Import from Shopify and Customer Mapping Type fields. It's used in the imported sales order.\n2. Define the Customer Template Code, which is used to create missing customers if Auto Create Unknown Customers is enabled. If the Customer Template Code is empty, then the function uses the Customer Template Code defined on the Shopify Shop Card. The system first tries to find a template for the Country/Region Code for the default address. If it doesn't find a template, it uses the first address.\n3. If the Customer Template Code isn't enough to ensure correct tax calculations, use Shopify Tax Areas to define Tax Area Code, Tax Liable, and VAT Bus. Posting Group by country/region and province.\n> NOTE\n> The country codes are ISO 3166-1 alpha-2 country codes. See Country Code<https://help.shopify.com/en/api/custom-storefronts/storefront-api/reference/enum/countrycode>.\n### Populate customer information in Business Central\nA customer in Shopify has a first name, family name, email, phone number, and one or more addresses. The connector normally uses the default Shopify address. If the customer doesn't have a default address, the connector uses the first available address. When an order uses By Bill-to Info customer mapping, the connector can use the address that matches the order's bill-to information to create the customer.\nThe connector uses the same fields when it creates a customer and when it updates a customer if Shopify Can Update Customers is selected. For a new customer, the connector applies the customer template before it populates the fields in the following table.\nField in Business Central|Source value|Behavior when updating the customer\nName|First and last name or company from the selected address, based on the Name Source field.|Replaces the existing value. If the selected source is blank, the connector uses the value from Name 2 Source, and then Contact Source.\nName 2|First and last name or company from the selected address, based on the Name 2 Source field.|Replaces the existing value when Name Source provides a value. If Name is blank, the connector assigns this value to Name instead.\nContact|First and last name from the selected address, based on the Contact Source field.|Replaces the existing value. If Name Source and Name 2 Source are blank, the connector assigns this value to Name instead.\nAddress|Address line 1 from the selected address.|Replaces the existing value. If the Shopify address line is empty, the connector clears this field.\nAddress 2|Address line 2 from the selected address.|Replaces the existing value. If the Shopify address line is empty, the connector clears this field.\nCountry/Region Code|Country/region from the selected address. The connector maps the country/region by ISO code.|Replaces the existing value.\nCounty|Province or state from the selected address. The County Source field on the Shopify Shop Card page specifies whether to use the province or state code or name.|Replaces the existing value. If the Shopify province or state is empty, the connector clears this field.\nPost Code|Postal or ZIP code from the selected address.|Replaces the existing value. If the Shopify postal or ZIP code is empty, the connector clears this field.\nCity|City from the selected address.|Replaces the existing value. If the Shopify city is empty, the connector clears this field.\nPhone No.|Phone number from the selected address. If the address doesn't have a phone number, the connector uses the customer phone number.|Replaces the existing value when Shopify provides a phone number. Otherwise, the connector keeps the existing value.\nE-Mail|Email address from the customer.|Replaces the existing value when Shopify provides an email address. Otherwise, the connector keeps the existing value.\nTax Area Code and Tax Liable|Values from the matching customer setup per country/region<#customer-setup-per-countryregion>. The connector uses the country/region code and province name to find the matching Shopify Tax Areas entry. If the Shopify address has no province, the connector matches only an entry with a blank province.|The connector updates both fields together, but only when the matching Shopify Tax Area entry has a Tax Area Code.\nVAT Bus. Posting Group|Value from the same matching Shopify Tax Areas entry.|Replaces the existing value only when the matching entry has a VAT Bus. Posting Group.\n## Important settings when exporting DTC customers to Shopify\nYou can export existing customers to Shopify in bulk. In each case, a customer and one default address are created. You can manage the process using the following settings:\nField|Description\nCan update Shopify Customers|Enable this option if you want to generate updates later from Business Central for customers that already exist in Shopify.\nThe following are requirements for exporting a customer:\n The customer must have a valid email address.\n When a country/region is selected on the customer card, make sure to fill in the ISO Code field. For local customers with a blank country/region, Shopify Connector uses the country/region specified on the Company Information page. That is especially important when you export customers with addresses that include provinces/states.\n If the customer has a phone number, the number must be unique because Shopify won't accept a second customer with the same phone number. The phone number must be in the E.164 format. Different formats are supported if they represent a number that can be dialed from anywhere in the world. The following formats are valid:\n   xxxxxxxxxx\n   +xxxxxxxxxxx\n   (xxx)xxx-xxxx\n   +x xxx-xxx-xxxx\nAfter you create the customers in Shopify, you can send them direct invitations to encourage them to activate their accounts.\n### Populate customer information in Shopify\nA customer in Shopify has a first name, family name, email, and/or phone number. You can enter first and family names from the customer card in Business Central.\nPriority|Field in the customer card|Description\n1|Contact Name|Highest priority, if the Contact Name field is filled and the Contact Source field in the Shopify Shop Card contains either the First Name and Last Name or Last Name and First Name option to define how to split the values.\n2|Name 2|If the Name 2 field is filled in and the Name 2 Source field in the Shopify Shop Card contains either the First Name and Last Name or Last Name and First Name option to define how to split the values.\n3|Name|Lowest priority, if the Name field is filled and the Name Source field in the Shopify Shop Card contains either the First Name and Last Name or Last Name and First Name options to define how to split the values.\nA customer in Shopify also has a default address. The address might contain a company and address in addition to their first name, family name, and/or phone number. You can populate the Company field based on data from the customer card in Business Central.\nPriority|Field in the customer card|Description\n1|Name|Highest priority, if the Name Source field in the Shopify Shop Card contains Company Name.\n2|Name 2|Lowest priority, if the Name 2 Source field in the Shopify Shop Card contains Company Name.\nThe connector converts address fields as described in the following table.\nField in Shopify|Source and conversion\nCountry/region|The connector converts the customer's Country/Region Code to the ISO Code for the country/region. If the customer's Country/Region Code is blank, the connector uses the country/region from the Company Information page.\nProvince or state|The County Source field on the Shopify Shop Card page specifies how the connector interprets the customer's County. If you choose Code, the connector matches County to County Code in Shopify Tax Areas. If you choose Name, it matches County to County in Shopify Tax Areas. A matching row provides the province or state code and name that Shopify requires.\n## Export DTC customers to Shopify\n### Initial sync of customers from Business Central to Shopify\n1. Go to the search ![Lightbulb that opens the Tell Me feature.] icon, enter Shopify Customers, and choose the related link.\n2. Choose the Add Customer action.\n3. In the Shop Code field, enter the code. If you open the Shopify Customers window from the Shop Card page, the shop code is populated automatically.\n4. Define filters on customers as required. For example, you can filter by Country/Region code.\n5. Choose OK.\nThe resulting customers are automatically created in Shopify with addresses.\n> NOTE\n> The initial sync of customers from Business Central to Shopify doesn't consider the Can Update Shopify Customers settings.\n### Sync customers\n1. Choose the ![Lightbulb that opens the Tell Me feature 1.] icon, enter Shopify shop, and then choose the related link.\n2. Select the specific shop for which you want to synchronize customers.\n3. Choose the Sync Customers action.\nAlternatively, use the Start Customer Sync action on the Shopify Customers window or search for the Sync Customers batch job.\nYou can schedule the task to be performed in an automated manner. See background#to-schedule-recurring-tasks.\n## B2B Companies\nIf you use B2B in Shopify, you can create companies in addition to customers. You can link one or more individual customers to a company.\n### Important settings when importing B2B companies from Shopify\nThe Shopify Connector imports all company locations, including billing address, payment terms, and tax IDs, which it uses for automatic entity mapping. You can view this information on the Shopify Company Locations page, which you open by choosing the Shopify Locations action on the Shopify Companies or Shopify Company Card page. The first imported location is used to create the customer and add address information and other fields on the Customer Card page. This location is marked as the Default.\nWhen you import a Shopify company, you get the associated payment terms for each company location. If the Shopify Connector is configured to update the customer, it uses the payment term from the default location. It's important that the corresponding record exists on the Shopify Payment Terms Mapping page.\nWhether you import companies from Shopify in bulk or when you import orders, use the settings in the following table to manage the process.\nField|Description\nCompany Import from Shopify|Select All Companies if you plan to import companies from Shopify in bulk, either manually using the Sync Companies action or via the job queue for recurring updates. Regardless of the selection, the customer information is always imported together with the order. However, the use of this information depends on the Customer Setup by Country/Region page and settings in the Company Mapping Type field.\nCompany Mapping Type|Define how you want the connector to do the mapping.</br></br>- By Email/Phone if you want the connector to map the imported Shopify companies to an existing customer in Business Central using the main contact's email and phone number.</br></br>- Select Always take the default Company if you want to use the company in the Default Company No. field. </br></br>- Select By Tax Id if you want the connector to use tax details to map the imported Shopify companies to an existing customer in Business Central. Use the Company Tax ID Mapping field to specify where to store tax details.\nCompany Tax ID Mapping|Specifies whether to store company tax details in the Registration Number or the VAT Registration No. field.\nShopify Can Update Companies|Select this field if you want the connector to update the customers it finds when the By Email/Phone option is selected in the Company Mapping Type field.\nAuto Create Unknown Companies|Select this field if you want the connector to create new customers when the By Email/Phone or By Tax ID option is selected in the Company Mapping Type field. A new customer is created using the imported data and the Customer/Company Template Code defined on the Shopify Shop Card or Shopify Customer Template pages.\nCustomer/Company Template Code|Use this field together with Auto Create Unknown Companies.</br></br>- Choose the default template to use for automatically created customers. Make sure the mandatory fields are filled in on the template, such as the Gen. Business Posting Group, Customer Posting Group, Value-added tax (VAT) or other tax-related fields.</br></br>- You can define templates per country/region on the Customer Setup by Country/Region page, which is useful for proper tax calculation.</br></br>See Set up Taxes<synchronize-orders#address-dependent-tax-rates>.\n> NOTE\n> The company must have a main contact. Otherwise, the connector skips the company.\n> The oldest location is used as source of information when creating or updating the customer in Business Central.\n> Only the main contact is imported.\n### Important settings when exporting B2B companies to Shopify\nYou can export existing customers to Shopify in bulk as a company. In each case, a company and one default location are created and one main contact. It's also possible to create a catalog.\nWhen you export a customer as a Shopify company, the Company ID field is filled in with the value in the No. field from the Customer Card page, which helps traceability. Also, the connector fills in the Company/Attention field on the new company location with the company name. The name is used on imported orders.\nField|Description\nCan update Shopify Companies|Enable this option if you want to generate updates later from Business Central for companies that already exist in Shopify.\nDefault Contact Permissions|Specify which permissions must be assigned to the main contact; you can choose between None, Ordering only, and Location admin.\nAuto Create B2B Catalog|Enable this option if you want to create a catalog that includes all products. A catalog is created for each exported company. When you export a customer as a Shopify company, if you configured the Shopify Connector to create a catalog, the Customer No. field is filled in for the catalog. This value ensures that the connector uses the specific customer to calculate prices, which eliminates the need to fill in the Customer Price Group, Customer Discount Group, and Allow Line Discount fields. You just need to turn on the Sync Prices toggle and select Sync Prices to start synchronizing catalog prices so that your customers get consistent pricing in Shopify and Business Central. See synchronize-prices#sync-prices-for-b2b-catalog\nCompany Tax ID Mapping|Specifies if company tax details are stored in the Registration Number or the VAT Registration No. field.\nThe Company Location feature in Shopify allows merchants to define default payment terms. When you export customer information as a Shopify company, payment term details transfer to Shopify and are stored in the default company location if:\n The Payment Term field in the Customer Card contains a value.\n A corresponding record is located in the Shopify Payment Terms Mapping page.\nShopify Connector lets you export customers from Business Central as additional B2B company locations in Shopify. When you use the Sell-to Customer and Bill-to Customer fields on the company location level, you get more flexibility and convenience for managing customer information across both applications.\nSee synchronize-orders#how-the-connector-chooses-which-customer-to-use.\n### Export a B2B company to Shopify\n#### Initial sync of B2B companies from Business Central to Shopify\n1. Go to the search ![Lightbulb that opens the Tell Me feature.] icon, enter Shopify Company, and choose the related link.\n2. Choose the Add Company action.\n3. In the Shop Code field, enter the code. If you open the Shopify Company window from the Shop Card page, the shop code is populated automatically.\n4. Define filters on the customer as required. For example, you can filter by Country/Region code.\n5. Choose OK.\nThe resulting company and customers are automatically created in Shopify.\n> NOTE\n> The initial sync of companies from Business Central to Shopify doesn't consider Can Update Shopify Company settings.\nWhen you select the Add customer as Shopify Location action, you can add customers as company locations. The customer you select must not already be exported.\n### Sync a B2B company\n1. Choose the ![Lightbulb that opens the Tell Me feature 1.] icon, enter Shopify shop, and then choose the related link.\n2. Select the specific shop for which you want to synchronize customers.\n3. Choose the Sync Company action.\nAlternatively, use the Start Company Sync action on the Shopify Company page or search for the Sync Company batch job.\nYou can schedule the task to run in an automated way. See background#to-schedule-recurring-tasks.\n## Import and export customer information using Shopify metafields\nShopify's platform includes data models for basic commerce concepts. However, commerce is diverse and often requires more complex or specific data models. The custom data platform lets you extend Shopify's data models and create your own by using metafields. Metafields are a flexible way to add and store additional information about a Shopify resource, such as customer, or company. The additional information stored in metafields can be almost anything related to a resource. Some examples are preferences, credit limits, loyalty programs, social media links, or segment information.\nYou can import and export data stored in metafields into Business Central. Also, there's an extensibility model that allows developers to map standard or custom fields, or other related entries in Business Central to metafields in Shopify.\nYou can edit metafields on the Shopify Metafields page, which you open from the Shopify Customers, Shopify Customer Card, Shopify Companies, or Shopify Company Card pages.\n> NOTE\n> You can edit the Shopify Metafields page in the following cases:\n > For a Shopify customer, if the Customer Import from Shopify field is set to None or With Order Import, and the Can Update Shopify Customers toggle is turned on.\n > For a Shopify company, if the Company Import from Shopify field is set to None or With Order Import, and the Can Update Shopify Companies toggle is turned on.\n> When you add a new record, the connector immediately sends a request to Shopify and stores the entry only when it gets a response with the Shopify ID for the metafield. You can't edit types that have AssistEdit functionality defined directly on the line.\nIf standard metafields are defined, you can use the Get Metafield Definitions action to get the list from Shopify. All supported metafields are imported. You only need to update the values.\n> NOTE\n> Clearing a metafield value or deleting a metafield record in Business Central doesn't clear or delete the metafield in Shopify. To remove the metafield, delete it in Shopify. A later synchronization from Shopify to Business Central removes the corresponding local metafield record.\n#### Supported metafield content types\n> NOTE\n> Metafields definitions with List of values aren't supported.\nDate and time:\n Date\n Date and time\nMeasurements:\n Dimension\n Volume\n Weight\nNumber:\n Decimal\n Integer\nText:\n Single line text\n Multi-line text\n> NOTE\n> Rich text isn't supported.\nReferences:\n Product\n Variant\n Collection\n File\n Metaobject\n Page\n Company\n Customer\nOther:\n True or false\n Color\n URL\n Money\n> NOTE\n> Link and Rating aren't supported.\nAdvanced:\n Mixed reference\n JSON\n## Related information\nshopify-connector-overview\nFAQ for the Shopify connector<shopify-faq>\nTroubleshoot the Shopify Connector<troubleshoot>\nWalkthrough: Setting Up and Using Shopify Connector<walkthrough-setting-up-and-using-shopify>"}