Retrieving harmonizedSystemCode for Variants

Retired Boards Appdev Fulfillment Api

Topic summary

A developer needs to retrieve harmonizedSystemCode (HS codes) from product variants to pass to their warehouse system for international shipping rate calculations with carriers like FedEx and DHL.

Current situation:

  • GraphQL documentation shows how to create/update HS codes for variants
  • No clear documentation found for extracting/reading these codes from variants
  • The warehouse system is shared between retail and wholesale operations

Solution provided:

  • HS codes are accessible through the InventoryItem object in the Admin GraphQL API
  • A direct link to the harmonizedSystemCode field documentation was shared
  • This field can be queried to retrieve the needed codes for each variant
Summarized with AI on November 14. AI used: claude-sonnet-4-5-20250929.
1

Hi all –

The GraphQL documentation has examples of updating or creating the harmonizedSystemCode for variants, that’s great, but how do we extract that from the variant?

We are using a proprietary codebase to push orders to our Warehouse shared with the Wholesale side of the business, we cannot use something like ShipStation or any other Shopify partner for overseas shipping, so when we rate shop etc with FedEx, DHL we need to pass to our Warehouse system the HTS codes for each variant.

Is there a way to do this? I don’t see anything in the docs allowing access to the variant’s HTS codes.

2

Hi Fwallace,

The InventoryItem object has a field for harmonizedSystemCode - would you be able to access it from there?