Optimize global HS code management in Shopify API

Executive summary:

• Enable global HS codes in Shopify API.
• Reduce redundancy in product classification.
• Benefit merchants operating internationally.

What changed

Shopify has made the countryCode field in CountryHarmonizedSystemCodeInput nullable. This allows entries to represent global HS codes when set to null, facilitating their use as universally applicable codes across different countries.

Why it matters

For Shopify Plus merchants, this change streamlines product classification processes, reducing the need to input redundant country-specific data when global HS codes suffice. It aligns Shopify's offerings with international trade practices, providing a more efficient way to handle product listings globally.

Role-specific impact

• Marketers: Simplifies global marketing strategies by reducing the need to manage multiple country-specific codes.
• Developers: Easier API implementation when dealing with harmonized system codes, as the need to include the country code can be skipped.
• Store admins: Reduces administrative overhead and potential for entry errors in product setups.

Use-case example

Real-world scenario & metric

A fashion retailer operates in the EU and North America, using global 6-digit HS codes. Previously, they had to input country codes for each market. With this update, they can use a single global code, cutting data entry time by 30%.

Implementation checklist

1. Review current product HS code entries.
2. Determine where global codes can apply.
3. Update API calls to set countryCode as null where appropriate.

FAQ

Q: Do existing integrations need an update?
A: No, existing setups remain functional as this is a non-breaking change.

Q: Can country-specific codes still be used?
A: Yes, including the countryCode remains possible when needed.

Resources

For more details, see the CountryHarmonizedSystemCodeInput documentation.

Need guidance? Talk to Makro.