HS codes and item setup for FBR digital invoicing: step-by-step guide

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

FieldWhat it meansCommon mistake
HS codeThe tariff code that describes the goodsUsing one code for everything, or leaving an old code in place
Product descriptionA clear name for what you soldNames like “Misc”, “Goods” or an internal short code
Unit of measure (UoM)The unit FBR accepts for that HS codeSending cartons or dozens without checking the allowed unit
Sale typeStandard rate, reduced rate, exempt, zero-rated, Third Schedule and so onSetting every item to standard rate
RateThe sales tax rate for that sale type on that dateTyping a rate by hand and never reviewing it
SRO schedule and item serialThe legal reference, where the sale type needs oneLeaving these empty on reduced-rate or exempt items

How to set up your items in 9 steps

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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.
  8. 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.
  9. 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.

ColumnExample entryNote
Item codeST-0001Your own internal code
FBR descriptionFull product nameShould make sense to someone outside your company
HS codeFormat seen in practice: 0000.0000Confirm against the tariff and FBR’s list
FBR unitAs allowed for the HS codeNot always the unit you sell in
Sales unitCartonWhat your staff bill in
Conversion factor24FBR quantity = sales quantity x factor
Sale typeGoods at standard rateUse FBR’s wording
RateFrom FBR’s rate list on the invoice dateReview after each relevant change
SRO schedule and item serialOnly where requiredKeep a copy of the source notification
Reviewed by and dateName, dateAdd 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.

ErrorFBR messageWhat to check
0019, 0044Please 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.
0052Please provide valid HS Code against invoice noCheck 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.
0099Provide uom.The FBR unit is empty. Complete it in the item record.
0096, 0097For 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, 0078Provide SRO/Schedule No. / Provide Item Sr. No.The sale type needs its legal reference. Add both from the relevant notification.
0093Selected Sale Type are not allowed to Manufacturer.Check the sale type against your business activity as registered with FBR.
0104The 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.