
HS Codes and Item Setup for FBR Digital Invoicing: A Step-by-Step Guide (2026)
In short: Every item line on an FBR digital invoice needs an HS code, a unit of measure, a rate and a sale type, so many setup problems start in your item list and not in your software. Clean the list first. Give each item a checked HS code, a unit FBR accepts for that code and the right sale type, then test your main items in the sandbox before you go live. This guide gives you the steps, a template and the fixes for common rejections.
Why your item list matters so much
FBR publishes Chapter XIV of the Sales Tax Rules, and rule 150R lists description, quantity, HS code and unit of measurement among the particulars of an invoice. FBR’s technical document for digital invoicing (version 1.12) also marks these fields as required on each invoice item, along with the rate, sale type and value fields.
This means one wrong item record can affect every invoice that uses it. A company with 2,000 items does not have 2,000 small problems. It has one item list that needs proper work once, and then a simple rule to keep it clean. Good FBR digital invoicing software helps, but it cannot decide what your product is. Someone in your business has to do that.
What each item needs
| Field | What it means | Common mistake |
|---|---|---|
| HS code | The tariff code that describes the goods | Using one code for everything, or leaving an old code in place |
| Product description | A clear name for what you sold | Names like “Misc”, “Goods” or an internal short code |
| Unit of measure (UoM) | The unit FBR accepts for that HS code | Sending cartons or dozens without checking the allowed unit |
| Sale type | Standard rate, reduced rate, exempt, zero-rated, Third Schedule and so on | Setting every item to standard rate |
| Rate | The sales tax rate for that sale type on that date | Typing a rate by hand and never reviewing it |
| SRO schedule and item serial | The legal reference, where the sale type needs one | Leaving these empty on reduced-rate or exempt items |
How to set up your items in 9 steps
- Export your full item list. Put it in Excel with the item code, name, sales unit, current tax treatment and sales quantity for the last 12 months.
- Remove what you no longer sell. Merge duplicates and mark dead items as inactive. There is no point classifying items you will never invoice again.
- Group similar items. Sizes, colours and brands of the same product can often be reviewed together. This turns thousands of lines into a list you can actually finish.
- Find a candidate HS code for each group. Start with the Pakistan Customs Tariff on the FBR website, where the FY 2026-27 tariff is published. Choose by what the item is made of and what it does, not only by its trade name. Supplier invoices and import goods declarations are useful clues, but check them.
- Check the code against FBR’s lists. FBR’s technical document describes reference services for this, including the item code list and a service that returns the units for an HS code. Ask your integrator to run your items against these and give you a list of failures.
- Set the FBR unit and conversion. Keep your normal sales unit for your staff, and store the FBR unit separately with a conversion factor. For example, if one carton holds 24 pieces and FBR needs pieces, one carton should go to FBR as 24.
- Map the sale type and rate. Decide the sale type for each group. FBR’s rate service works by date, transaction type and supplier province, so avoid hard-coded rates where you can. Add the SRO schedule and item serial where they apply.
- Get doubtful items reviewed. Mark any item you are unsure about and take that short list to your tax adviser or customs agent. Note why you chose the code. Six months later, that note is worth a lot.
- Test before going live. Send your 20 highest-volume items through the sandbox, plus one example of each special case, such as exempt items, reduced-rate items and returns. Fix the item record, not just the single invoice.
Template: the columns your item list should have
You can copy these columns into Excel. The examples only show the kind of entry, so do not use them as tax advice for your own products.
| Column | Example entry | Note |
|---|---|---|
| Item code | ST-0001 | Your own internal code |
| FBR description | Full product name | Should make sense to someone outside your company |
| HS code | Format seen in practice: 0000.0000 | Confirm against the tariff and FBR’s list |
| FBR unit | As allowed for the HS code | Not always the unit you sell in |
| Sales unit | Carton | What your staff bill in |
| Conversion factor | 24 | FBR quantity = sales quantity x factor |
| Sale type | Goods at standard rate | Use FBR’s wording |
| Rate | From FBR’s rate list on the invoice date | Review after each relevant change |
| SRO schedule and item serial | Only where required | Keep a copy of the source notification |
| Reviewed by and date | Name, date | Add a short reason for doubtful items |
Keep control after go-live. Let only one or two people change the HS code, unit or sale type. Do not allow a new item to be invoiced until these fields are complete, and keep a dated record of every change.
Common item-related errors and what to check
These codes and messages come from FBR’s technical document version 1.12. The fix column is our practical guidance. For a wider list, see our guide to FBR digital invoicing error codes.
| Error | FBR message | What to check |
|---|---|---|
| 0019, 0044 | Please provide HSCode / Provide HS Code. | The item has no HS code, or the code is not reaching the invoice. Check the item record and the field mapping. |
| 0052 | Please provide valid HS Code against invoice no | Check the code against FBR’s list. Users on a public software forum have also reported this error when the HS code did not suit the sale type. |
| 0099 | Provide uom. | The FBR unit is empty. Complete it in the item record. |
| 0096, 0097 | For selected HSCode only KWH UOM is allowed. / Provide UOM KG. | The code needs a specific unit. Change the FBR unit and set the conversion. |
| 0077, 0078 | Provide SRO/Schedule No. / Provide Item Sr. No. | The sale type needs its legal reference. Add both from the relevant notification. |
| 0093 | Selected Sale Type are not allowed to Manufacturer. | Check the sale type against your business activity as registered with FBR. |
| 0104 | The calculated percentage sales tax does not match. | Check the rate, the value excluding tax and rounding in your software. |
Special cases to plan for
Sector scenarios
FBR’s technical document links sandbox scenarios to your business activity and sector. Most businesses in other sectors get a general set, while some sectors have their own. For example, steel has SN003, SN004 and SN011, textile has SN009 and petroleum has SN012. Check the table in the document for your exact combination, because this decides what you need to test.
Services
The document has separate scenarios for services (SN018 and SN019). Do not borrow a goods code just to make an invoice pass. Ask your integrator and tax adviser what code and unit apply to your service.
Retail sales to end consumers
Scenarios SN026 to SN028 cover retail sales to end consumers and apply only where the taxpayer is registered as a retailer. A wholesaler with some counter sales should check this before assuming these scenarios fit.
Bundles and kits
If you sell several items at one price, such as a gift pack or a machine with accessories, decide with your adviser whether to invoice the parts or the bundle. Then keep the same approach in your software.
Items listed in the Third Schedule need their printed retail price in the item master as well as the HS code. See how to report Third Schedule goods in FBR digital invoicing.
Need help cleaning your item list for FBR?
Switcher Techno provides FBR digital invoicing software and integration for Pakistani businesses, with local support from Karachi and Lahore. Send us a sample of your item list and we will tell you what needs attention.
Frequently asked questions
Is an HS code compulsory on an FBR digital invoice?
Yes, according to the FBR documents we checked. FBR publishes Chapter XIV of the Sales Tax Rules, and rule 150R lists HS code and unit of measurement among the invoice particulars. FBR technical document version 1.12 also marks hsCode as a required field on each invoice item.
Where do I find the right HS code for my product?
Start with the Pakistan Customs Tariff on the FBR website, where the FY 2026-27 tariff is published. Your supplier invoice or import goods declaration can give a useful clue, but check the description yourself. Ask a tax adviser or customs agent about any item you are unsure of.
Can several products share one HS code?
Yes. An HS code describes a class of goods, so different sizes or brands of the same product will often share a code. Your item codes stay separate, while the HS code can repeat across them.
What if FBR does not accept the unit I sell in?
Keep your normal sales unit for billing and add a separate FBR unit with a conversion factor. For example, you may sell in cartons while the invoice needs a different unit. The software should convert the quantity when it sends the invoice.
Can I simply copy the HS code from my supplier?
You can use it as a starting point, but do not rely on it alone. You are responsible for the invoices you issue, and a supplier may use a code that fits their own product range or a different description. Check it against the tariff and FBR lists.
Do HS codes and rates need checking after the Budget?
Yes. FBR publishes the tariff by financial year, and sale type rates can depend on the date. Review your item list after the Budget and after any relevant notification, and record what you changed and when.
This article is general guidance for Pakistani businesses as at 5 November 2026, based on FBR documents checked that day, including technical document version 1.12. FBR rules and technical documents change, so check the latest version and confirm your position with a qualified tax adviser. It is not tax or legal advice.
