Zoho Books integration

Filing Zoho Books invoices with FBR

For startups, trading businesses and small teams on Zoho Books, on its own or inside Zoho One. Get every invoice to FBR without hiring a developer.

Updated

eInvoicePro API documentation: where a Zoho Books automation sends invoices on their way to FBR

How it works

How a Zoho Books invoice reaches FBR

Your team keeps invoicing in Zoho Books. The FBR step runs on its own a moment later.

Zoho makes separate editions of Books for almost twenty countries, each with local tax rules built in. Pakistan is not one of them. So Pakistani businesses use the Global edition, where you type in every tax yourself, as a name and a percentage. That adds up an invoice perfectly well. But it tells FBR nothing that FBR looks for: the item’s HS code, the FBR sale type behind each tax, FBR’s name for the unit, or whether the customer is registered.

So you fill those gaps once. From then on, each invoice goes through four steps:

  1. Something spots the new invoice: a workflow rule that calls a web address, a Zoho Flow that starts on invoice created, or a small program that checks Zoho’s API every few minutes.
  2. FBR’s details are added from the custom fields and the tax matching you set up: HS code and FBR unit for each item, FBR sale type for each tax, and registration type and province for each customer.
  3. eInvoicePro takes it from there. Its API checks the invoice against FBR’s rules, sends it to FBR, and replies with the FBR invoice number or the exact reason FBR turned it down.
  4. The FBR number comes back to Zoho, in a custom field on the invoice, so your invoice template prints it next to the QR code.

Why it runs as you invoice

FBR wants every invoice sent at the time it is issued. Zoho’s automations start the moment an invoice is created. So a Zoho Books business meets the rule without anyone changing how they work. Just make sure the automation runs on every invoice, not on a weekly batch.

Many Zoho Books users sell services. FBR’s digital invoicing covers goods, FED charged in sales tax mode, and only a small set of services: those supplied in Islamabad Capital Territory. The provinces tax most service income. If you sell services in Punjab or Sindh, see PRA E-IMS or SRB POS first.

Your options

What your Zoho plan allows

You can start the same process in three ways. Your Zoho Books plan decides which ones you get. Plan names differ slightly by region.

Ways to send Zoho Books invoices to FBR, by plan
Option Available on Good for Limits to know
Workflow rule that calls a webhook (a message Zoho sends the moment something happens) Higher plans: Professional and above in most regions Instant filing on created or created or edited, with no extra program to run One per rule, and a daily limit on these calls (1,000 in Zoho’s US documentation)
Zoho Flow Any plan, with a Zoho Flow subscription No code: invoice created in Zoho Books starts a flow that sends it to eInvoicePro Zoho Flow starts only when an invoice is created. Edits need a different approach
Zoho Books API All plans A small program that keeps checking for new invoices and saves the results back in Zoho 100 requests a minute per organisation, and a daily limit that rises with your plan
eInvoicePro screens or bulk upload template Any plan; nothing in Zoho changes Businesses with few invoices, or teams who want to start before automating Invoices are typed in or uploaded separately from Zoho

Whichever option starts the filing, saving the FBR number back in Zoho uses Zoho’s API. So every automatic option needs API access.

Your data

Where Zoho Books keeps FBR’s details

Zoho Books lets you add custom fields to customers, items and invoices. That is where most of FBR’s missing details go.

FBR invoice fields and where they go in Zoho Books
FBR field Where it goes in Zoho Books Watch out for
Buyer NTN or CNIC A custom field on the customer Digits only, no dashes
Buyer registration type A custom field on the customer Set by checking the customer’s number with FBR
Buyer province The billing address on the customer record FBR wants the province: “Punjab” works, “Lahore” doesn’t
Invoice number Zoho’s invoice number, such as INV-000123 Hyphens are fine. FBR accepts only letters, digits and hyphens
HS code A custom field on the item Take it from FBR’s own list. Store it as text so leading zeros are kept
Unit of measure The item’s unit Use FBR’s name for the unit, and check that the HS code allows it
Sale type, rate and SRO The tax on each line: in the Global edition, just a name and a rate Match each Zoho tax to an FBR sale type, and take the rate from FBR
Value excluding tax and discount Line amounts and discounts Prices that include tax, and discounts on the whole invoice, must be split into values for each line
FBR invoice number and status Custom fields on the invoice Saved after filing and shown on your invoice template

How many custom fields you can add depends on your Zoho plan. The set-up on this page uses five or six in total.

Small teams

The questions small teams ask first

Most Zoho Books businesses run with small teams. These questions come up before anything is built.

We don’t have a developer. Can we still do this?

Yes. With workflow rules, or with Zoho Flow, you set up the trigger in Zoho’s settings with no code, and eInvoicePro does the FBR work. What is left is filling in HS codes, units and customer details. That is bookkeeping, not programming.

We raise only a few invoices a day. Is automation worth it?

Not yet. With only a few invoices, it is simpler to create tax invoices in eInvoicePro’s screens. The HS codes and customer details you set up there are the same ones an automation needs later.

Our quotes and deals are in Zoho CRM. Does that matter?

No. The connection only needs the invoice in Zoho Books. How it got there makes no difference: created directly, or converted from a CRM deal or quote.

What if we change Zoho plans later?

Your tax matching and custom fields carry over. Only the trigger can change. Move to a plan with workflow rules, and you can swap a Zoho Flow, or a program that checks back for new invoices, for a rule. Nothing else needs redoing.

Build or buy

Do the FBR part yourself, or hand it to eInvoicePro

Zoho makes the trigger easy. What happens after the trigger is FBR’s world, with FBR’s rules.

Do it yourself

A Zoho automation that talks to FBR

  • You handle buyer checks, FBR’s invoice format, FBR access tokens and reading FBR’s answers line by line
  • A no-code flow moves the data, but it can’t read FBR’s answers line by line or resend safely
  • FBR accepts the same invoice twice. So if a reply is lost and the flow resends, FBR records a duplicate
  • Each time FBR changes its technical rules, you must change your automation too
Ready-made

Zoho Books → eInvoicePro → FBR

  • Zoho’s automation makes one call for each invoice. eInvoicePro does the FBR work
  • If your side sends an invoice again, eInvoicePro spots it by its unique reference and never sends it to FBR twice
  • When FBR says no, you see exactly why, in FBR’s own words, and resend just that invoice
  • If FBR changes its rules, nothing in your Zoho automation needs to change

Using Zoho Books? Book a demo

See how eInvoicePro sends invoices to FBR, and ask us anything about connecting it to Zoho Books.

Watch these

Zoho mistakes to avoid

None of these show up with three test invoices. All of them show up in the first busy week.

Plans and limits

  • Workflow rules that call out to other systems aren’t on every plan
  • Calls from workflow rules, API requests and Zoho Flow tasks all have daily or monthly limits. Check them against your busiest day
  • Moving to a lower plan can switch off the rule that files your invoices
  • If API access expires, someone must approve it again. Decide who

Data

  • Customers created in a hurry have no NTN or province
  • Items added in a rush arrive without an HS code
  • Prices that include tax hide each line’s value before tax
  • A discount or adjustment on the whole invoice must be spread across the lines for FBR

Documents

  • A rule on “created or edited” runs again on every edit. Don’t file the same invoice twice
  • Voiding or deleting an invoice in Zoho does not cancel it at FBR
  • A credit note needs the original invoice’s FBR number
  • Don’t file draft invoices until they are actually issued

Going live

A realistic three-week plan

Zoho’s triggers need settings, not code, so the build is small. Most of the three weeks goes on your data.

  1. Week 1

    Add fields and fill them

    Create the custom fields for NTN, registration type, HS code and FBR number. Match each Zoho tax to an FBR sale type. Fill in HS codes and units for your items, and tax details for your regular customers.

  2. Week 2

    Prove it in FBR’s test system (the sandbox)

    Connect the trigger to eInvoicePro with test mode switched on. Run real invoices through the test scenarios FBR has given your business. Passing them unlocks your live token automatically.

  3. Week 3

    Run side by side, then go live

    For a few days, check every new invoice with FBR without filing it. Compare the totals with Zoho’s sales reports. Then switch on live filing, and add the FBR number and QR code to your invoice template.

Owner or accountant

Matches taxes to FBR sale types, fills in customer and item details, and approves test invoices.

Whoever runs your Zoho set-up

Creates the custom fields and the workflow rule or Zoho Flow, and keeps an eye on failed invoices after going live.

eInvoicePro

Checks every invoice against FBR's lists, files it with FBR and returns FBR's invoice number and QR data for the Zoho Books 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 Zoho Books support FBR digital invoicing?

Not on its own. There is no Pakistan edition of Zoho Books and no FBR connection. You connect Zoho Books to eInvoicePro, which files your invoices with FBR. A workflow rule, Zoho Flow or the API starts each one.

Which Zoho Books plan do we need?

Workflow rules that call a webhook are on higher plans: Professional and above in most regions. On other plans, Zoho Flow or a small program using Zoho’s API does the same job. Saving the FBR number back in Zoho needs API access in every case.

Is Zoho Flow enough on its own?

Zoho Flow starts the process when an invoice is created. But it can’t check an invoice against FBR’s rules, check NTNs, read FBR’s answer line by line or resend safely. eInvoicePro does that work, at the other end of the flow.

We use Zoho One. Does that change anything?

No. The connection only needs Zoho Books’ invoices, so it works the same whether Zoho Books is on its own or part of Zoho One.

Can we fix a rejected invoice by editing it in Zoho?

Yes. Fix the cause, such as an item’s HS code or a customer’s details, and send it again. An invoice FBR has already accepted is different. Editing it in Zoho leaves FBR’s record unchanged. The fix is made in FBR’s own system, where a genuine error can be corrected for up to 72 hours.

How long does it take?

The plan on this page takes about three weeks: one to fill in HS codes and customer details, one for FBR’s sandbox test scenarios, and one to run both side by side. Clean customer and item records speed it up; messy ones slow it down.

Ready to simplify your FBR digital invoicing?

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

Chat with us