QuickBooks integration

Send your QuickBooks invoices to FBR

For accountants, small businesses and growing companies in Pakistan that keep their books in QuickBooks Online. Send your sales tax invoices to FBR and keep the accounting software you already use.

Updated

eInvoicePro API documentation, which a QuickBooks add-on uses to send invoices to FBR

How it works

How a QuickBooks invoice reaches FBR

QuickBooks keeps doing what it is good at: invoicing, reconciling and reporting. The FBR step happens just after you create an invoice, outside QuickBooks.

QuickBooks Online comes in local editions for several countries, each with that country’s tax rules built in. Pakistan is not one of them. Intuit serves Pakistan through its Global edition, where you set up sales tax by hand. That works for bookkeeping. But it does not give FBR what it checks on every invoice line: an HS code, an FBR sale type and rate, and FBR’s name for the unit. It also does not tell FBR whether the buyer is registered.

A link between QuickBooks and FBR fills that gap in five steps for every invoice:

  1. QuickBooks announces the invoice. QuickBooks Online can send a message to another system when an invoice is created, changed or voided. So a small add-on (often called a connector) hears about it within moments, not at the end of the day.
  2. The add-on reads the full invoice through QuickBooks’ API, because the message carries only the invoice’s ID. It collects the customer, lines, products and tax. Your QuickBooks administrator approves this access once.
  3. It adds what QuickBooks doesn’t hold from a matching list kept alongside (often called a mapping). The list gives each product its HS code and FBR unit, and each tax rate its FBR sale type. It also gives each customer a registration type and province.
  4. It sends the invoice to eInvoicePro’s API. eInvoicePro checks it against FBR’s rules, sends it to FBR and returns the FBR invoice number. If FBR rejects it, you get the exact reason.
  5. It saves the result on the QuickBooks invoice, so the FBR number and QR code can go on the customer’s copy.

Why that first message matters

FBR’s rule is that each invoice goes to FBR when you raise it. Exporting a month of invoices and sending them to FBR at month-end breaks that rule, however convenient it is. QuickBooks sends a message the moment an invoice is created. So a QuickBooks business can send every invoice to FBR straight away, without changing how its team works. Not every accounting system can do this.

You need no special QuickBooks plan, only one that lets your team give API access. QuickBooks Desktop works differently and this page does not cover it. If you use Desktop, tell us on a demo.

Before you start

First, check your sales come under FBR

QuickBooks is popular with consultancies, agencies and software houses. For many of them, the tax rules that apply come from a province, not from FBR.

You might hear

We use QuickBooks, so we need a QuickBooks-to-FBR connection.

What it means

FBR digital invoicing covers goods, services in Islamabad Capital Territory, and federal excise duty charged in sales tax mode. Most services elsewhere are taxed by PRA, SRB, KPRA or BRA, each with its own rules. First confirm which tax office your sales come under, then choose a connection.

You might hear

QuickBooks already works out our sales tax, so FBR will accept it.

What it means

FBR checks more than the amount. Each line needs an HS code that fits an FBR sale type, a rate in FBR’s own wording and a unit from FBR’s list. QuickBooks’ tax rate is only where the matching starts.

You might hear

We can send the month’s invoices to FBR when we close the books.

What it means

Digital invoicing was brought in to end exactly this month-end habit. FBR wants each invoice as it happens.

You might hear

If an invoice we sent to FBR is wrong, we just edit it in QuickBooks.

What it means

QuickBooks and FBR each keep their own copy, and no API call can edit FBR’s copy. You fix a genuine mistake by hand in FBR’s system, within 72 hours. So catching problems before you send matters far more than fixing them later.

Where to start

If your business sells services in Punjab or Sindh, start with our guides to PRA E-IMS and SRB POS. If you sell goods, or both, read on.

Your data

Where each FBR detail comes from

Part of an FBR invoice is already in QuickBooks. You add the rest once, in the matching list, instead of typing it on every invoice.

What FBR asks for and where a QuickBooks Online business finds it
What FBR asks for Where it comes from What to watch
Your NTN or CNIC Saved once in eInvoicePro, with your FBR credentials Not needed on each QuickBooks invoice
Buyer NTN or CNIC No standard field in the Global edition. Use a custom field on the customer if your plan allows one, or the matching list Digits only, no dashes. Many small customers won’t have one
Buyer registration type Not in QuickBooks Check each customer’s number with FBR once, and save the answer in the matching list
Buyer province The customer’s billing address A province, not a city: FBR rejects “Karachi” and accepts “Sindh”
Invoice number QuickBooks’ invoice number Letters, digits and hyphens only. Never reuse a number
HS code Not on QuickBooks products and services Pick it once for each product or service from FBR’s list, and save it in the matching list
Unit of measure Not stored in FBR’s wording Choose FBR’s own unit name for each product. Some HS codes accept only one
Sale type, rate and SRO The tax rate on each line Match each QuickBooks tax rate to an FBR sale type. Take the rate from FBR
Value excluding tax Line amounts If you enter amounts with tax included, take the tax out line by line
Discount Often one discount on the whole invoice FBR records discount per line, so spread a whole-invoice discount across the lines

You build the same matching list whichever option you choose below. So none of this work is wasted if you start simple and automate later.

Your options

Three options for QuickBooks users

The right one depends on how many invoices you raise, and whether someone can look after a small add-on.

1. Raise tax invoices in eInvoicePro

Keep QuickBooks for your books. Create FBR invoices in eInvoicePro’s screens, which check the buyer and give you the FBR number and QR code straight away.

Best when: you raise a few tax invoices a day.

Downside: you enter each invoice twice.

2. Prepare invoices in bulk

Export invoices from QuickBooks into eInvoicePro’s bulk template. It checks every row before anything reaches FBR, then sends each invoice one by one.

Best when: you raise invoices in batches during the day.

Downside: it meets FBR’s real-time rule only if you run it as you invoice.

3. Connect QuickBooks to the API

A small add-on watches for new QuickBooks invoices and adds the FBR details from your matching list. It sends each one through eInvoicePro’s API within moments and saves the result back in QuickBooks.

Best when: you invoice all day, or typing invoices twice is costing you hours.

Downside: a one-time build, and someone to watch failed invoices.

Build or buy

Build the FBR side yourself, or use a ready connection?

QuickBooks’ API makes reading invoices easy. The hard part is everything FBR needs after that.

Build it yourself

QuickBooks API + your own FBR code

  • Your team builds NTN/CNIC checks, FBR’s invoice format, token handling and line-by-line error reading
  • FBR does not block duplicates. If a reply is lost and you simply resend, the same invoice can reach FBR twice
  • Every FBR technical change means someone in your business must update the code and test it again
  • Many small teams have no developer on staff to look after it for six years
Ready connection

QuickBooks → eInvoicePro → FBR

  • The add-on converts QuickBooks data and sends each invoice in one API call
  • If the network drops and you resend, built-in duplicate checks stop the invoice going twice from your side
  • When FBR changes something, eInvoicePro’s API handles it. Your QuickBooks add-on stays the same
  • A rejected invoice comes back with a clear reason and FBR’s exact reply, and is resent on its own

Using QuickBooks? Book a demo

See how eInvoicePro sends invoices to FBR, and ask us anything about using it with QuickBooks Online.

Watch out

QuickBooks traps to avoid

None of these appear in a demo with three tidy invoices. All of them appear in your first real month.

Amounts

  • If you enter prices with tax included, FBR’s value before tax must be worked out line by line
  • A discount on the whole invoice must be spread across the lines without changing the totals
  • Rounding each line can leave the lines a rupee off the invoice total
  • Foreign-currency invoices need a clear rule for how you report them

Customers and products

  • Customers added only for bookkeeping often have no tax ID or province
  • A customer entered twice gets two separate registration checks
  • Services and goods sold from one product list need different HS codes and sale types
  • New products added mid-month reach FBR with no HS code, unless something stops them first

Connection

  • Editing an invoice makes QuickBooks send another message. Don’t send that invoice to FBR twice
  • Voiding or deleting an invoice in QuickBooks does not cancel it at FBR
  • QuickBooks allows 500 API requests a minute and 10 a second per company, so space out a sudden rush of invoices
  • If API access expires or is withdrawn, someone must approve it again. Decide who
  • Test invoices from a QuickBooks test company must never reach FBR’s live system

Going live

A realistic four-week plan to go live

For a QuickBooks business, most of the time goes into cleaning up customer and product data. The connection itself is small.

  1. Week 1

    Clean up and match

    Give every product and service an HS code and FBR unit. Match every QuickBooks tax rate to an FBR sale type. Give every regular customer a tax ID, registration type and province. Merge duplicate customers while you are at it.

  2. Weeks 2–3

    Prove it in FBR’s test system

    Connect QuickBooks to eInvoicePro in test mode, so invoices go to FBR’s test system (the sandbox). Run real invoices through the scenarios FBR has given your business. When your test invoices pass, FBR issues your live token automatically.

  3. Week 4

    Run side by side

    Let new QuickBooks invoices pass through FBR’s checks without sending them, alongside normal work. Each day, compare the results with QuickBooks’ sales reports and fix whatever the checks find.

  4. Go live

    Send as you invoice

    Switch to live sending and print the FBR number and QR code on the customer copy. In the first weeks, make one person responsible for the list of failed invoices.

Bookkeeper or accountant

Matches tax rates to FBR sale types, cleans up customer records, and approves the test invoices before going live.

Developer or QuickBooks partner

Builds and hosts the add-on, looks after QuickBooks API access, and watches for failed invoices after going live.

eInvoicePro

Checks every invoice against FBR’s lists, sends it to FBR and returns FBR’s invoice number and QR data for the QuickBooks invoice. Our team helps you set it up.

FAQ

Frequently Asked Questions

Still have a question?

Ask our team on WhatsApp. Tell us what you sell and where, and we will point you to the right setup.

Ask on WhatsApp
Does QuickBooks support FBR digital invoicing?

Not on its own. QuickBooks Online has no Pakistan edition and no FBR connection. You connect QuickBooks to eInvoicePro, which adds FBR’s checks, sends each invoice to FBR and returns the FBR number.

Is this for QuickBooks Online or Desktop?

QuickBooks Online. It can tell another system about new invoices and shares them through an API. QuickBooks Desktop connects differently. If you use Desktop, raise it on a demo.

We only sell services. Do we need FBR digital invoicing?

Only if FBR taxes your services. FBR digital invoicing covers goods, services in Islamabad Capital Territory and federal excise duty in sales tax mode. The provinces tax most other services, through PRA, SRB, KPRA or BRA.

Can we keep invoicing exactly as we do now?

Yes, almost exactly. With the API option, your team keeps creating invoices in QuickBooks. The add-on sends each one to FBR moments later and saves the result. The only change comes first: you fill in the FBR details for your products and customers once.

What happens if FBR rejects a QuickBooks invoice?

FBR does not accept the invoice, and the reason comes back against the field or line that caused it. Fix the cause and send that invoice again. The common causes are a product’s HS code or a customer’s details. Editing it in QuickBooks alone changes nothing at FBR.

We have very few invoices. Is a connection worth it?

Not at first. If you raise only a few tax invoices a day, eInvoicePro’s screens are simpler. The product and customer details you set up there are the same ones a connection needs later.

Does the integration cost qualify for the section 64D tax credit?

Yes, if you are required to integrate and the cost is a one-off investment. Section 64D gives a 10% credit on one-off investment in the electronic resources used to connect to FBR. The credit applies in the tax year they are fully set up. Subscriptions do not count.

Ready to simplify your FBR digital invoicing?

Join 2000+ businesses that use eInvoicePro to make invoices and send them to FBR.

Chat with us