0099·The unit of measurement is not allowed for this HS code
Product classificationCommon
What this means
Each HS code has an allowed set of units of measurement, and FBR rejects anything outside it. This catches integrations that use their own internal unit vocabulary rather than FBR's.
Why it happens
- An internal unit name was submitted instead of FBR's description string.
- Case does not match. The unit strings are compared literally, so a lowercase variant of a valid unit fails.
- The unit is valid generally but not for this particular code — several codes accept only one specific unit.
- A generic count unit was used for goods that FBR requires to be measured by weight or volume.
How to fix it
- 1Query the HS-code-to-unit reference endpoint for the specific code and use only what it returns.
- 2Copy the unit description exactly, preserving capitalisation.
- 3Store the FBR unit alongside your own internal unit rather than translating at submission time.
- 4Where a code accepts only one unit, make that the fixed value for the item.
How Ordyoo handles this
Each catalogue item carries an FBR unit field, populated from the units FBR reports as valid for that item's HS code. Your internal unit stays independent, so warehouse and statutory vocabularies do not have to agree.
Scenarios where this appears
Sandbox scenarios that commonly produce 0099.
Related errors
Stop debugging FBR payloads by hand
Ordyoo builds and submits compliant invoices so most of these rejections never reach you. Start free.