Look up commodity code
Reads a commodity code from HMRC’s public UK Trade Tariff: description, duty, preferences, quotas, VAT and import controls, for an origin and date.
@lainstack/uk-trade-tariff/look-up-commodity · Customs · Available on Lainstack Cloud
How to use it
Section titled “How to use it”Look up commodity code reads one commodity code from HMRC’s public UK Trade Tariff API. It needs no Connection. Use it to check a classification, duty and VAT rates, preferences, quotas or import controls before declaring goods.
- The code is 10 digits, or 8 digits (padded with 00). Spaces and dots are ignored. Anything else fails the step.
- With a country of origin (an ISO two-letter code, GB not UK), preferences and import controls show only what applies to goods from there. Without one, import controls and the supplementary unit come from the all-countries measures. An origin the tariff does not know fails the step.
asOfreads the rates in force on that date (YYYY-MM-DD) and defaults to today. An impossible date fails the step instead of silently using today’s rates.- Not found means the tariff does not list the code on that date. Its output is empty.
declarableis false for a code that cannot be declared. Check it before using the code in a declaration.- The Northern Ireland tariff (xi) follows the EU tariff and lists no UK VAT, so
vatRatesis empty there. measuresholds every import measure, for anything the summary fields leave out.- A rate limit (429) or server error fails the step as retryable. Requests time out after 20 seconds.
Settings
Section titled “Settings”| Setting | Key | Type | Details |
|---|---|---|---|
| Commodity code (required) | commodityCode |
Text | The 10-digit import code, or an 8-digit export code. Spaces and dots are ignored. |
| Country of origin | originCountry |
Text | Optional. A two-letter country code. Keeps only the measures that apply to goods from there, so preferences show what this origin can claim. |
| Rates on date | asOf |
Text | Optional. Read the rates in force on this date (YYYY-MM-DD), such as the date of an earlier import. Defaults to today. |
| Tariff | tariff |
One of UK Global Tariff, Northern Ireland (EU tariff) |
The Northern Ireland tariff lists no UK VAT measures, so VAT rates come back empty. Default uk. |
Outputs
Section titled “Outputs”| Output | Path | Type |
|---|---|---|
| Commodity Code | commodityCode |
Text |
| Description | description |
Text |
| Declarable | declarable |
Yes or no |
| Third Country Duty | thirdCountryDuty |
Text |
| Preferences | preferences |
List |
| Quotas | quotas |
List |
| Vat Rates | vatRates |
List |
| Supplementary Unit | supplementaryUnit |
Text |
| Import Controls | importControls |
List |
| Measures | measures |
List |
| Origin Country | originCountry |
Text |
| As Of | asOf |
Text |
| Exit | Port | Notes |
|---|---|---|
| Found | found |
|
| Not found | not_found |