Skip to main content

supplyAssignItemsToHtsCodes

Assigns shipment items to HTS (Harmonized Tariff Schedule) codes.

Authentication​

Requires authentication and the supply:manage_shipment_hts_codes permission.

Behavior​

  • Assigns shipment items to HTS codes by updating their hts_code and duty_rate fields.
  • Each assignment requires an HTS code, shipment ID, and a list of item IDs.
  • The duty rate from the HTS code record will be copied to each item.
  • The mutation is processed asynchronously and returns a process ID for tracking.

Validation Rules​

  • A maximum of 50 assignments can be processed per request.
  • Each HTS code must exist and belong to the specified shipment.
  • All items must exist and belong to the specified shipment.

Possible Errors​

  • You can process a maximum of 50 assignments at a time - The request exceeds the batch limit.
  • HTS code '{hts_code}' not found for shipment {id} - The specified HTS code does not exist for the shipment.
  • Items not found or don't belong to shipment - One or more items are invalid.
supplyAssignItemsToHtsCodes(
  input: AssignItemsToHtsCodesInput!
): AsynchronousActionResponse!

Arguments​

supplyAssignItemsToHtsCodes.input ● AssignItemsToHtsCodesInput! non-null input​

Parameters for AssignItemsToHtsCodes

Type​

AsynchronousActionResponse object​

Asynchronous action response type