Zoho Books sync
Send your sales, payments and refunds to Zoho Books, one invoice per bill, plus stock purchases as bills and expenses if you switch them on. How to set it up in three steps, connect and map it, the Zoho plan's limits, what is and isn't sent, how late changes are handled, and what each problem message means.
112 min read
India only, for now. Zoho Books sync is for businesses in India (GST). For a business in the UAE, the United States or the European Union it is not offered. See Regions and countries.
AirQR can send your sales (and, if you switch them on, your stock purchases as bills from your suppliers and your expenses) to Zoho Books, so your accountant doesn't retype them. Every bill becomes its own Zoho invoice, with the same number as the bill, followed by the payments that came in (each bill gets its own payment for each way it was paid) and credit notes for refunds. The sync is not live: you press Sync now, which sends everything closed so far, including today's bills. After your first clean Sync now, AirQR also runs it by itself each morning around 9:00 AM (you can switch that off). Nothing reaches Zoho Books until you connect it, choose a start date and send.
The figures come from the same bills as your GST reports, so Zoho Books, GSTR-1 and Tally can't disagree about what was sold. See GST reports and Tally Prime export. This is a bookkeeping feed, not tax advice. Please have your accountant check the first few days before relying on it.
Set up in three steps
Accounts → Settings → Zoho Books opens a card called Set up Zoho Books with three steps. One step is open at a time, and a finished step folds into one line you can open again with Change. AirQR looks at both sides (your Zoho Books and your own bills from the last 90 days), says in plain words what fits and what doesn't, sets up what is missing with one confirm, and helps you go live. You don't need to be an accountant.
- Connect Zoho Books. Press Connect Zoho Books, sign in to Zoho and allow AirQR (see Connect Zoho Books). Once connected the step shows Connected, your Zoho data center and who connected it.
- Which Zoho organization? Outlets are grouped under their GSTIN, and each GSTIN gets one select. Every Zoho organization is listed with its state, and AirQR checks it against the GSTIN's state before you confirm: an organization in another state is disabled, with the reason beside it ("In Karnataka, but this GSTIN is for Maharashtra"). When exactly one organization fits, it is already picked. Don't send this outlet keeps an outlet out of Zoho Books, and AirQR remembers that you decided. An outlet with no GSTIN is shown on its own, with a note that AirQR can't check the state until you add the GSTIN. Press Refresh from Zoho after you create an organization in Zoho Books, then Continue. This is the only place the organization is chosen; the detailed sections below don't repeat it.
- Review and go live. In this order:
- Three questions only you can answer (AirQR remembers the answers; Not sure? Copy them for your accountant copies them as text):
- Is this business under the GST composition scheme? If Yes, the step stops with a plain sentence: AirQR can't send bills of supply yet, and sends nothing at all. Sync now answers "This business is under the GST composition scheme. AirQR can't send bills of supply to Zoho Books yet.", the automatic morning run skips the business and leaves a note in the run history, and the Zoho Books status page shows the same message. Answer No to send again.
- Have you turned off 'Rounding off in Sales Transactions' in Zoho Books (Settings › Preferences › General)? If not, turn it off (see Turn off Zoho's own rounding). It doesn't stop you going live.
- Does Zoho Books also hold other sales for this GSTIN (other outlets, other businesses, invoices made in Zoho)? The answer decides where you file GSTR-1. Yes: "file GSTR-1 from Zoho Books, not from AirQR's files. Copy each series from AirQR's Bill numbers page (GST & accounts) into Zoho's Documents issued." No: "file GSTR-1 from AirQR's files or from Zoho Books, not both." See A Zoho organization shared with other sales.
- Everything that can be set up is set up, or AirQR will set up N things in Zoho Books. The check runs by itself when the step opens (it reads your Zoho organization: taxes, tax exemptions, accounts, items, customers and reporting tags, which counts towards your Zoho plan's updates for the day like any other call, and looks at your last 90 days of bills; nothing is changed). Review list opens the Apply dialog, which lists everything that would be set up, grouped as Customers, Items, Payment accounts and Other (the Tips payable account and the Channel tag). Each has a tick box, ticked at first, says what it is for and whether it is New in Zoho Books or Already in Zoho Books (then AirQR uses it). The heading counts as you tick: "Creates up to N things in Zoho Books". Untick anything you'd rather set up yourself; you can pick an existing Zoho item or account for it in Edit details. Press Apply and AirQR, for each linked outlet, finds or creates the walk-in customer and the customers of the platforms you invoice, one Zoho item for each tax class in use, and the holding accounts for cash, card, UPI and online (Other uses Zoho's own Undeposited Funds), and saves the choices in your mappings, with each charge set to "Same item as the tax class it's charged in".
- Only if you tick "Also send purchases from today" (unticked by default; shown when an outlet has a suggested purchase account) it saves the purchase account and switches Send stock purchases to Zoho Books as bills on from today (see Stock purchases as bills).
- Only if you tick "Also send expenses from today" (unticked by default) it saves an expense account for every category and the account each way of paying is paid from, and switches Send expenses to Zoho Books on from today (see Expenses in Zoho Books). The two boxes are separate and neither is ticked for you.
What you untick is neither created nor saved, and a mapping you already have for it is left as it is. The list keeps it as Needs your choice with "You chose to set this up yourself. Pick it in Edit details." and a link that opens Edit details (for your accountant) at that field. If something you unticked is needed to send (an item for a tax class your bills used, the walk-in customer, the customer of a platform whose orders you invoice, or the account of a payment method your bills used), Start sending stays off and says "Choose Card in Edit details first. You chose to set these up yourself, and bills can't be sent without them." The Channel tag, Tips payable and the holding account of a method none of your bills used are optional. Apply only fills in what is missing: a choice you saved yourself is never changed, and running it again creates nothing new. If Zoho refuses something partway (a limit, a permission), AirQR stops, says what was done and what was not, and Review list again carries on. Every run is written to the audit log. If Zoho's daily limit has been reached, AirQR says "Zoho Books' daily limit was reached. Syncing is available again after (time)." and makes nothing until then.
- Yesterday's bills, one line per outlet: "Yesterday: 95 bills, ₹1,24,118.00: matches your GST report". It is AirQR's check of your latest finished day against the GST figures (nothing is sent). See exactly what's sent opens the full preview of that day (see Preview a day). If the day doesn't match, the line says something has to be fixed first.
- Invoice numbers: the numbers printed on your bills, like SP/26-27/1021. Zoho's invoice number is the printed bill number, character for character. A connection that already uses Zoho's own numbering sees a warning here (see Invoice numbers).
- Start date: Today (the default), the first of the month (for example 1 October; it is off when your first bill is later than that), or Pick a date. Choose today if your accountant already entered earlier sales in Zoho Books by hand. AirQR never sends anything before this date.
- Start sending, the same as Sync now on the status page. After the first clean run the automatic morning sync turns on by itself (see Start date, schedule and history). Start sending stays off until your organizations are chosen, the composition answer is No, and nothing needed is left to choose.
When every step is done the card folds to one line, "Zoho Books is set up. Last check (date).", with links to the Status page, Connection, How it works and Edit details (for your accountant). One verb is used everywhere, Sync now.
Edit details (for your accountant)
The detailed sections described below (Zoho organization, the Mappings for (outlet) cards, Sync settings and Preview a day) are under a button called Edit details (for your accountant). It is closed by default, also right after you connect. These sections are for your accountant: use them to link another outlet, choose an item or account yourself, or change the schedule. The guided setup never overwrites what you choose there.
How Zoho Books sync works (the guide in Settings)
Right after you connect, the top of Accounts → Settings → Zoho Books shows a card called How Zoho Books sync works. It stays there while you set things up, then folds away; the How it works button opens it again. It explains in plain words:
- What goes to Zoho Books: each bill as its own invoice with the number printed on the bill, as saved when the bill was issued (changing the outlet code or GSTIN later does not rewrite it; a printed bill that is changed before payment is cancelled and its new bill takes a new number, and bills marked "printed twice" in GST & accounts → For your accountant → Bill numbers wait there until the owner resolves them) (a connection on Zoho's own numbering reads "numbered by Zoho" instead), the GST split by tax rate, discounts, service charge and other charges, and the round-off; payments (each bill gets its own payment for each way it was paid, into the holding account you chose for that method); and refunds as credit notes against the bill (the GST-correct record: Zoho reverses the tax exactly); bills on a customer's credit, with the money paid later, on that customer's own Zoho customer (see Credit & dues); tips as a daily Tips payable journal and a Channel tag on every invoice when those are on; cancelled bills and cancelled bill numbers, as voided invoices on their own date, so your invoice numbers have no gaps (on unless you switch it off); stock purchases as unpaid bills from your suppliers when you switched that on (see Stock purchases as bills); and expenses, with money returned as journals, when you switched that on (see Expenses in Zoho Books).
- What doesn't: tips when you switched recording them off, cancelled bills if you switched sending them as voided invoices off (a refund after a bill was sent becomes a credit note), bills that Swiggy or Zomato invoice themselves, days with inter-state (IGST) bills (held for now), Quick add stock, stock purchases and expenses until you switch them on, and payroll (not yet).
- Your Zoho plan and its limits, as two small meters per Zoho organization. Updates today: {used} of about {limit} shows how many updates your Zoho plan's daily limit allows and how many have been used today. Invoices this financial year (since {date}): {used} of {cap} shows the invoices AirQR has created since your Zoho financial year began (for example "since 1 April 2026") against the invoices your Zoho plan allows a year. Both are counted from what AirQR has sent, not guessed from your sales, and a note says that invoices you create in Zoho Books yourself also count towards Zoho's limit. When nothing has been sent yet you see 0 of the limit. From 80% of the yearly invoices a warning appears: "You've used 80% of this year's 5,000 invoices on Zoho Standard. Upgrade to Zoho Professional (10,000) or Premium (25,000) before they run out: at 98% AirQR stops sending new invoices." (see Zoho's yearly invoice limit). This limit belongs to your Zoho plan. AirQR doesn't charge per update.
- How sales appear (below).
- Where to file GSTR-1. A box says either "File GSTR-1 from AirQR's files or from Zoho Books, not both." or, when Zoho Books also holds other sales for your GSTIN, "Zoho Books also holds other sales for your GSTIN: file GSTR-1 from Zoho Books, not from AirQR's files. Copy each series from AirQR's Bill numbers page (GST & accounts) into Zoho's Documents issued."
- What you can do: preview a day, press Sync now, leave the automatic sync on (or switch it off), fix problems with Retry. And: don't edit synced invoices in Zoho Books; AirQR adds corrections instead.
Under the two lists a link, See the live counts on the sync page, opens GST & accounts → Zoho Books, where the same lists carry real numbers (see What goes to Zoho Books).
How sales appear, and how payments are sent
AirQR sends one invoice per bill: every AirQR bill is its own Zoho invoice, numbered exactly like the bill, so your accountant can match the two bill by bill. There is no summary-invoice option to choose. (A connection set up before per-bill mode existed, which already sends one summary invoice per outlet and day, keeps doing that; the guide shows it as read-only and support can help if you need to change it.)
Every bill also gets its own payment in Zoho Books for each way it was paid: a bill paid in cash is one payment, a bill split between cash and UPI is two. There is nothing to choose. The guide says it in one line: "Payments: each bill gets its own payment in Zoho Books for each way it was paid (a split bill gets one per method), into the holding account you choose for that method." Earlier versions let you choose one payment per method per day; that choice is gone, and a connection that had chosen it now sends a payment for every bill from its next sync. Payments already in Zoho Books stay as they are and are counted, so nothing is paid twice. If a bill that a daily payment already covered later grows, only the difference is paid, as a payment of that bill.
The invoice mode is fixed once anything has been sent to Zoho Books. Changing it afterwards would send the same sales a second time, so the guide says "This is fixed because sales have already been sent to Zoho Books. Changing the mode would duplicate sales in Zoho. Contact support." (A connection that was set up before per-bill mode existed and already has day invoices in Zoho stays on one summary invoice per day.)
What it sends
For each outlet and each day that is over:
- One invoice per bill (the default). The lines are split by GST rate (one line per tax class), with service charge, packaging, delivery and card charges on their own lines. Discounts are taken off the lines, and AirQR's round off goes in as a Round off adjustment. The first line lists what was ordered ("Paneer Tikka ×2, Butter Naan ×4 …"), and the notes say, for example, "AirQR bill SP-1021 · dine-in · table 4 · Paid by UPI ₹2,686". No guest name, phone or address is sent. In one summary invoice per day mode the day's walk-in sales are one invoice instead, and its notes list the bill numbers (for example "Bills SP-1021 to SP-1187"), any cancelled bill numbers, and the tips that were left out.
- Payments: one for each bill and each payment method it was paid with, applied to that bill's invoice and never for more than the invoice still owes. For a paid bill, the payment is what turns the invoice Paid (or Partially paid) in Zoho Books: AirQR creates the invoice and then pays it, so a paid bill takes two updates, and the invoice is not separately marked as sent. A bill nobody paid is created and marked sent as an open invoice. The money lands in the Deposit to account you chose for cash, card, UPI, online and other (see holding accounts). A payment AirQR could not send, or that is waiting for your answer on its date, never leaves the invoice as a draft: the invoice is marked sent and the payment follows when it can.
- A credit note, and its refund, for each refund you gave on a settled bill (Record refund on an order). A refund is a credit note against the bill: the GST-correct record, because Zoho reverses the tax exactly. With one invoice per bill, the credit note is linked to that bill's own invoice. In summary mode it is linked to the invoice of the day the bill was sold. Either way it can be days after the sale. Each tax class gets back the same share as in your GST reports. A refund of the whole bill takes back each line as it was and gives back the bill's round off as a Round off adjustment, so the credit note equals the refund to the paisa.
Number and reference. Unless you chose Zoho's own numbering, the Zoho credit note carries AirQR's own GST credit note number (for example SPC/26-27/12; see GST credit notes), and its Reference# reads CN SPC/26-27/12 · SP/26-27/1021 (the credit note, then the invoice it credits). With Zoho's own numbering, Zoho numbers it and the reference still carries AirQR's number. AirQR never renumbers a GST credit note: if Zoho says the number is already used by another document, the credit note is held under Needs a look until you deal with it. A credit note that was already posted is never edited or renumbered. Older refunds, given before 1 November 2026, keep their old numbering (Refund IN-3633). An adjustment credit note for a late change is the invoice's number plus -CA and a count (SP/26-27/12-CA2); a connection that had already posted keeps PFX-CA<number>-<n> for older bills.
Cancelled and tip-only. A GST credit note cancelled in AirQR before it was sent is not sent. One cancelled after it was posted is flagged under Needs a look ("void it in Zoho Books"), and AirQR doesn't touch Zoho Books. A refund that is only a tip has nothing to credit, so it is not sent. A credit note issued after the GST time limit is not sent: posting it would reduce GST in Zoho Books, which the law does not allow past that date. It is held under Needs a look ("record the refund in Zoho Books by hand, without GST"); record the refund there yourself and press I'll handle this refund.
- A separate, unpaid invoice for each delivery platform bill whose orders you invoiced yourself but the platform collected (for example Swiggy or Zomato orders marked as collected by the platform). It stays open in Zoho Books as money the platform owes you. See Platform orders.
Invoice numbers: the same as the bill
The Zoho invoice number is the number printed on the bill, character for character: SP/26-27/1021, or SP3/26-27/41 for a bill made offline on till 3. There is no separate Zoho prefix any more, and the Invoice prefix field is gone from setup and Edit details. Cancelled bills, a bill reissued after a change and a split bill's parts keep their own numbers the same way.
- Old bills and connections that already sent. An outlet still on running numbers (
SP-1021, until 31 March 2027) printed those numbers before this change. A connection that had already posted to its Zoho organization keeps the style it has used (the prefix, a dash, and the bill's number) for those old bills, so its Zoho invoice series carries on unchanged until the outlet's 1 April 2027 switch. A connection that never posted uses the printed number exactly, even for old bills. New-format bills (the ones with/) always use the printed number. - A bill with no outlet code (an old
1021): it is sent with the number as printed, unless another outlet linked to the same Zoho organization (from any of your AirQR businesses) could print the same number. Then Zoho gets the prefix and the number, and the printed number is in Reference#. - A number that can't fit. Zoho allows 16 characters. A bill printed twice and reviewed (a number ending
/Dand the order), a correction invoice (/2) or an adjustment credit note that would go over 16 characters is numbered by Zoho (its own series, for exampleINV-00012) and the printed number is in Reference#. Only that one document is affected; the day is never held for it. - A correction invoice (
/2) is built on the number the bill's first invoice really has in Zoho. If Zoho numbered that one, Zoho numbers the correction too. - A draft that is refreshed after a bill changed keeps the number it was created with. A sent invoice is never renumbered.
- A bill that gets a GSTIN after payment is cancelled and reissued: the new bill is posted with its own printed number, no longer
old/2. The old invoice is still held for you to void in Zoho Books. - Zoho's own numbering is not offered on new connections. A connection that already uses it sees: "Your Zoho invoice numbers don't match your bills. If you file GSTR-1 from Zoho, the invoice numbers won't match the bills you gave. Switch to AirQR's numbers. The switch applies from the next day not yet sent." (in the guide and in the setup report, which then says the numbering "needs a choice" but never stops Start sending). In Sync settings → Invoice numbers, choose The numbers on your bills (for example SP/26-27/1021) to switch. Choosing Zoho's own numbering on a connection that doesn't have it is refused: "Zoho's own numbering isn't available. Your Zoho invoice numbers wouldn't match your bills."
- A summary invoice (a connection set up before per-bill mode) is still numbered from a hidden prefix and the date:
SP-261024for 24 October 2026. - Several outlets in one Zoho organization can't share a current or past outlet code, because their bill numbers would repeat. Linking an outlet to an organization another linked outlet prints the same code in is refused: "{outlet} can't be linked to this Zoho organization: another outlet linked to it prints bill numbers starting with {code}, and bill numbers in one Zoho organization must never repeat. Contact support to give this outlet another code."
What you read in Zoho Books. Every document carries a readable Reference# (it shows as P.O.# on the invoice PDF), so you can find it from the bill in your hand: the invoice is the printed bill number (SP/26-27/1021, and SP/26-27/1021/2 for a correction invoice); an adjustment credit note is SP/26-27/1021 adj 1; a refund's credit note is CN SPC/26-27/12 · SP/26-27/1021 (Refund IN-3633 for refunds given before 1 November 2026); a payment is SP/26-27/1021 · UPI (SP/26-27/1021 · Cash · 2 for the second cash payment of the same bill); the daily tips journal is Tips IN 2026-10-31; a stock purchase's bill is the supplier's invoice number (or AQP-…); an expense is Expense 2026-10-31 3F9A2C1D. They are at most 50 characters. Invoices sent before this change keep the reference they were sent with; AirQR still finds them, and nothing already in Zoho Books is changed or sent twice.
The invoice notes say how the bill was paid: "AirQR bill SP/26-27/1021 · dine-in · table T8 · Paid by UPI ₹2,686 · Tip (not included): ₹20.00". A split bill reads "Paid by Cash ₹500 + UPI ₹400", a bill nobody has paid yet reads "Not paid yet", and a bill the platform collected reads "Collected by Swiggy". Invoices already sent are never reworded.
What is not sent
- Tips as sales. They aren't part of the sale and aren't taxed, so they are never on the invoice (the notes show them). They are recorded separately, in the daily Tips payable journal described below, unless you switched that off.
- Cancelled bills, only if you switched Send cancelled bills as voided invoices off (it is on by default, see below). With it off, bills that were billed and then cancelled are not sent (a refund after a bill was sent becomes a credit note instead), so Zoho's invoice numbers can have a gap where a bill was cancelled. Preview a day lists each one ("Bill SP/26-27/1033 was cancelled; not sent to Zoho Books."), so the gap is explained, and the Zoho Books page says "Cancelled bills aren't sent to Zoho Books." (In one summary invoice per day mode, their numbers are listed in the invoice notes.)
- The liquor VAT invoice of a business's food and liquor check. It has no Zoho Books mapping yet, so it is held and you record it by hand (see Bills for a business).
- Orders where Swiggy, Zomato or another platform issues the invoice. The platform pays the GST on those, so they are left out, as they are from your GST reports.
- Write-offs and opening balances of credit customers. Dues you write off, and the opening balance you enter for a customer, are not sent. Enter them in Zoho Books yourself: a written-off bill stays open there until you do. What goes to Zoho Books lists the written-off dues. Everything else about credit is sent: see Credit & dues.
- Days with inter-state (IGST) sales. The sync doesn't support them yet, so such a day is held with the message "Inter-state sales aren't supported yet." and nothing is sent for it.
- Quick add stock, supplier payments and payroll. Quick add has no supplier bill, so it isn't sent. Supplier payments aren't sent: a stock purchase becomes an unpaid bill and your accountant records the payment in Zoho Books. Payroll is not sent yet. Sales, payments, refunds, tips, stock purchases and expenses are sent (the last two only when you switch them on).
- Open bills and drafts. A bill is sent only once it is closed. The automatic run sends a day after it is over, a little after your business day ends, so late closes and offline devices have time to arrive. Sync now also sends the bills closed so far today (see Today's bills).
Credit & dues
With one invoice per bill, bills put on a customer's credit, the money the customer pays later and refunds that reduce what they owe all go to Zoho Books. The full rules are in Give credit and collect dues. In short:
- Every credit customer is their own Zoho Books customer, never Walk-in. AirQR finds an existing customer only when the name and the phone number match exactly; otherwise it creates one. If the name exists with another phone number, the new customer is named Name (last 4 digits). If both names are taken, the bill is held until you rename one in Zoho Books, then press Retry. AirQR never changes a Zoho customer it did not create.
- A bill on credit is its normal invoice on that customer, due on the due date AirQR had when the bill was sent (a later extension is not sent). The notes read "On credit: due 07 Nov 2026", after "Paid by Cash ₹500 ·" when part was paid in cash, UPI or card (that part is a payment on the same invoice). The credit part is never sent as a payment.
- Money recorded in Payments → Credit becomes a customer payment dated the day it was recorded, applied to the invoices of the bills it paid, with the reference "Receipt 2026-10-31 3F9A2C1D". It waits until those invoices are sent and is never more than an invoice still owes.
- A refund with Reduce what the customer owes is sent as the GST credit note (for example SPC/26-27/12) with that bill's invoice, and Zoho Books applies it to the invoice, up to the smaller of the note and what the invoice still owes. No money is paid out. If the invoice is already paid, the credit stays as the customer's unused credit in Zoho Books.
Bills for a business
A bill made out to a business (the buyer's GSTIN was added before it was printed, see Business bills) goes to Zoho Books as its own invoice on a business customer, never Walk-in. With one invoice per bill:
- The customer. AirQR looks in Zoho Books for a customer whose GSTIN is exactly the buyer's (capitals don't matter) and uses it as it is. A customer with the same name but another GSTIN, or a vendor with that GSTIN, is never used. If there is none, AirQR makes one: the buyer's legal name, GST treatment Registered Business (Regular), the GSTIN and the buyer's state as the place of contact. If that name already belongs to another business, the new customer is named Name (GSTIN); if that is taken too, the bill is held until you rename one in Zoho Books and press Retry. The same GSTIN is found again next time, also when Zoho Books answered too slowly the first time, so one buyer is never made twice. A credit customer's stored Zoho customer is used only when that customer really has the bill's GSTIN; otherwise the GSTIN lookup decides. When the buyer is a credit customer with the same GSTIN, that customer's account is linked to the Zoho customer.
- The invoice carries the GST treatment Registered Business, the buyer's GSTIN and your state as the place of supply; the bill's payments and any credit note are on the same customer. An invoice already sent is never edited, so a bill sent as a walk-in's before the buyer's GSTIN was sent stays as it was.
- Held under Needs a look: "Liquor VAT bills aren't sent to Zoho Books yet. Bill {bill} is the liquor part of a business's food and liquor check: record it in Zoho Books by hand, then press I'll handle this bill in Zoho Books." The food part goes as an invoice. And a connection that sends daily summaries holds a day with a bill for a business: "Bills for a business (with the buyer's GSTIN) need an invoice of its own, and this connection sends daily summaries, so they are held. Record them in Zoho Books by hand." A day that was already posted and later gains a business bill (a late reissue, an offline till syncing late) is held too: "Business bill after the day was posted: post it to Zoho Books by hand." Nothing already sent is edited.
- A bill for a business that is on the credit of another customer is still addressed to the business whose GSTIN is on the bill. The credit customer's own Zoho customer is used only when that customer's GSTIN is the buyer's. A payment that customer later makes in Payments → Credit is then held ("The Zoho Books invoice of bill {bill} is not on {name}'s customer, so this payment was not sent"): record it in Zoho Books by hand.
Held under Needs a look: a payment with an advance part ("Advance receipts aren't sent yet"), a payment that cleared an opening balance, a payment you undid in AirQR after it was sent (delete it in Zoho Books by hand), a bill whose credit part changed after its invoice was sent (AirQR never edits a sent invoice), a bill on the credit of two or more customers, any credit day when the connection sends daily summaries instead of one invoice per bill, and a credit note outside the GST time limit.
Channel tags
When Zoho Books has reporting tags (Standard and up), AirQR puts a Channel reporting tag on every invoice it sends, so you can report sales by where the order came from. The tag's options are Dine-in, Takeaway, Delivery, Online, Swiggy, Zomato and Other. AirQR uses the same grouping as the Channels report in AirQR: a delivery platform order is its platform; an order from your own online ordering or website is Online; otherwise the order type decides (dine-in; takeaway and counter; your own delivery); anything else is Other.
- Set up. In Accounts → Settings → Zoho Books → Edit details (for your accountant), the Channel tag card has Create for me, and Apply (step 3 of the setup) does it too. AirQR looks for a tag called Channel in your Zoho organization first and uses it (adding any missing option); otherwise it creates the tag with its options and activates it. Pressing it again makes nothing new. There is one tag per Zoho organization.
- The switch. Tag invoices by channel is on once the tag exists. Turning it off stops tagging.
- What is tagged. Each new bill's invoice, its correction invoices, its adjustment credit notes and its refund credit notes. Payments, and the old one-summary-invoice-per-day invoices, are not tagged.
- Never changed afterwards. A tag is never a reason to send a document again, and AirQR never edits an invoice that is already in Zoho Books to add a tag. Turn tagging on today and only the bills sent from now on carry it.
- If Zoho refuses the tag (the Channel tag was switched off or deleted in Zoho Books, an option was removed, or the plan has no tags; a refusal about anything else is handled as always), AirQR sends that document once more without tags and never holds a bill because of a tag. Accounts → Settings → Zoho Books and the Zoho Books page then say "Channel tag couldn't be used: {reason}. Invoices are sent without it." The note goes away when a tagged document is accepted again.
- Zoho Free plan. The card says "Channel tags need Zoho Standard or higher", and invoices are sent without tags.
Tips in Zoho Books
A tip a guest pays by card or UPI reaches your holding account, but the invoice doesn't include it and the payment only covers the invoice, so Card Clearing, UPI Clearing (and the cash drawer) would come out short by the tips. So AirQR posts one journal for each outlet and day that has tips:
- it debits each payment method's deposit account (the same account its payments use) with that method's tips, and credits Tips payable with the total. The figures are the ones GST & accounts → For your accountant → Summaries (Payment-mode summary) shows as tips for each mode. The journal's reference is
airqr:tips:…and its notes say "Tips collected on {date}, {outlet}, AirQR". - The account. Tips payable is a liability account in your Zoho chart of accounts. Create for me (under Tips in the outlet's mappings, or Apply (step 3 of the setup)) finds or creates it; nothing is posted until it is chosen. Paying your staff out of Tips payable is something your accountant records in Zoho Books.
- Only the restaurant's tips. Tips on the bills the restaurant collected, by payment method; a tip on a bill a delivery platform collected is the platform's, not yours, so it is not recorded.
- When. After the day's bills and payments, once the day is over. Today's open day gets no journal (tips change all day); the next automatic sync or a Sync now on a later day posts it.
- Late changes. If a day's tips change afterwards, AirQR posts a second journal for the difference only (a reduction swaps debit and credit), dated like a late payment: on the day itself in the current month, otherwise you choose Post on original date or Post today. AirQR never edits or deletes a journal; a correction is always a new journal.
- The switch. Record tips in Zoho Books (Tips payable journal) under Sync settings is on by default. Switch it off and nothing is posted. If Tips payable isn't chosen, nothing is posted either and the Zoho Books page keeps saying "Not sent as sales".
- The Zoho Books page shows Tips journals sent under Sent or on its way, and the Tips row there says "Sent as a Tips payable journal" once they are on. GST & accounts → Zoho Books counts them as Tips journals; they don't affect the comparison with your GST figures.
Cancelled bills as voided invoices
Send cancelled bills as voided invoices (keeps your invoice numbers without gaps) under Sync settings is on by default, so Zoho's invoice numbers match your bills and GSTR-1 Table 13 with no gaps.
- New connections: on from the start date.
- Existing connections: switched on once, by the first run after this change, for days dated from that day on. Days already sent are not touched. If you switch it off afterwards, it stays off.
It applies to bills cancelled on or after your start date:
- A cancelled bill that was never sent: AirQR creates its invoice (same number and lines) and voids it. It isn't marked as sent and no payment is applied to it.
- A cancelled bill whose invoice was already sent and is unpaid: AirQR voids that invoice. It only does so if the invoice has no payment and no credit note in Zoho Books.
- Cancelled bill numbers are sent too: a number that was printed and then cancelled (the old number after a bill was changed and reissued, a bill merged into another check, a printed check cancelled before payment, a driver's bill the server refused, a removed till's numbers, an old number after a GSTIN was added) becomes a voided invoice with that number, on the number's own date. It is a one-line ₹0 invoice on the outlet's first mapped GST class, and its line says "Cancelled bill {number}: {reason}. Its total was ₹{total}." The figures are not sent: a voided invoice carries no tax. A number Zoho already has as the order's sale (a GSTIN added after payment) is left for you to void, as before.
- A voided invoice keeps its original date, even in an older month, and never asks you to choose a date: a void carries no tax.
- A bill cancelled after it was paid (it has a payment or a credit note, or Zoho shows it paid): it is held under Needs a look with "This bill was cancelled after it was paid. Void it in Zoho Books by hand, then press Retry, or press I'll handle this bill." Refunds stay credit notes. After you void it by hand, Retry reads Zoho Books again and ends the hold; I'll handle this bill in Zoho Books takes the bill over instead.
- A sent invoice from a month that may already be filed is never voided on its own: it is held with "This bill was cancelled in a month that may already be filed, so AirQR won't void its invoice…", with the same two ways out.
- A cancelled check with nothing on it (for example one merged into another) is sent as a ₹0 voided invoice with its number; one that never had a bill number is not sent. A cancelled bill with a problem of its own (a missing mapping, unreadable prices) is held alone; the day's sales go on.
- A cancelled liquor VAT part is held like its sale: "Liquor VAT bills aren't sent to Zoho Books yet. Bill {bill} is the liquor part…" It is never sent as a voided invoice with a tax invoice's number.
- Voided invoices count toward Zoho's yearly invoice limit (see below), and the 98% hold applies to them like any new invoice.
- The Zoho Books page counts them apart (Cancelled bills sent as void), and GST & accounts → Zoho Books shows Cancelled bills sent as void; they are not sales and not part of any total.
- With the option off nothing is sent for cancelled bills.
Expenses in Zoho Books
The costs you record on POS → Expenses (rent, gas, repairs and so on; see Record daily expenses and money returned) can go to Zoho Books too, so your accountant doesn't type them again. They are never sent until you switch this on yourself. It needs Zoho Books sync itself (Pro, or the add-on on Starter and Growth), and you need the setup permissions described under "Plan and who can use it".
- Switch it on. In Accounts → Settings → Zoho Books → Edit details (for your accountant), the outlet's Expenses card has Send expenses to Zoho Books, off by default. Saving mappings never turns it on. When you switch it on it asks Send expenses from: Today (the default), or the start date with "(also send earlier ones)". The card says how many expenses that would send ("N expenses since (date) will be sent"). Press Save mappings. The choice is for the whole business: AirQR remembers the day and sends expenses recorded on or after the later of your start date and that day. The guided setup's Apply (step 3 of the setup) switches it on, from today, only if you tick Also send expenses from today in its confirm dialog.
- What is sent. Each expense recorded on or after that day, at an outlet that posts to Zoho Books and has expense accounts saved, becomes one expense in Zoho Books. Its expense account is the one you chose for its category (an expense with no category goes to the account you chose for Uncategorised), it is paid through the cash or bank account you chose for the way it was paid, and it carries the day it was recorded in the outlet's time zone. The description reads "{reason} · {category}, AirQR", for example "Gas cylinder · Electricity, water & gas, AirQR", and the reference is
airqr:expense:…, so AirQR can find it again and never sends the same expense twice. - GST on an expense. The expense is always sent as the amount you paid, tax included. When you recorded GST details for it (a tax invoice from a supplier with a valid GSTIN, see Purchases and input credit), the expense also carries the Zoho tax of its rate (the GST group for your state, IGST for another), the supplier's GSTIN, the states, the HSN and whether the tax is eligible for input credit (it follows the status in the input-credit register, a change you made included). An expense with no GST details, a supplier's credit note, a bill from an unregistered supplier, or a rate Zoho Books has no tax for is sent exactly as before, with the GST in the cost. If Zoho Books refuses these fields (its answer is about the tax, GST, HSN or input credit), the expense is sent once more without them so it is never lost, and it is listed under Needs a look as "Expense {reference} was sent without its GST details: Zoho Books refused them. Add the tax in Zoho Books or tell your accountant." until you press Mark as resolved; AirQR's input-credit register still counts that expense's credit. This has been tried against a test copy of Zoho Books only; check the first one in Zoho Books.
- Money returned. Each amount of money returned against an expense becomes one journal: it debits the account the money came back to (the cash or bank account of the way it was returned) and credits the expense account the original expense was booked to, so the cost comes down. It follows the same day rule, and it is sent only after its expense is in Zoho Books. Money returned against an expense that was never sent (one recorded before the day you chose) is not sent, because there is nothing in Zoho Books for it to come off.
- Set it up. The Expenses card lists the categories with a Suggested Zoho account for each, matched by name (for example Rent → Rent Expense, Repairs → Repairs and Maintenance, Cleaning → Janitorial Expense, Fuel → Automobile Expense, Marketing → Advertising And Marketing, Phone & internet → IT and Internet Expenses, Bank & card charges → Bank Fees and Charges, Professional fees → Consultant Expense, Other → Other Expenses, Uncategorised → Uncategorized). A category with no account of its name goes to Other Expenses, else Uncategorized. Paid from suggests the outlet's Cash Drawer – (outlet) account (else Petty Cash) for cash, and your first bank account (else Petty Cash) for card, UPI, online and other: cash and bank accounts only. This is how you paid, which can differ from where sales are deposited. The suggestions are filled in when you switch expenses on; after that your choices are final, and a category you set to Not chosen stays unmapped.
- Waiting for an account. An expense whose category (or way of paying) has no Zoho account is not sent. Under Needs a look one line for the outlet says "Expenses waiting for a Zoho Books account: {n}. Choose an account for each expense category you use, and the account each way of paying comes from, in Accounts → Settings → Zoho Books." They go on the next sync after you save the missing account.
- When. Expenses go after the sales of every outlet in the same run, together with stock purchases (purchases first). The two use at most half of what is left of the day's Zoho updates between them, so they never hold your sales. Press Sync now and the expenses recorded so far go; the automatic morning run sends the rest. If there are many (for example when you chose "also send earlier ones"), a run stops at that limit with More to do. Press Continue., and the next run carries on.
- Never edited, never deleted. AirQR has no way to edit or delete an expense once it is recorded, and it never deletes anything in Zoho Books. If an expense (or its money returned) is no longer in AirQR after it was sent, it is held under Needs a look with "This expense was removed in AirQR after it was sent. Delete it in Zoho Books by hand." (for a return: "This money-returned entry was removed in AirQR after it was sent. Delete its journal in Zoho Books by hand."). Delete it in Zoho Books, then press I've deleted it in Zoho Books; it then no longer counts as sent.
- Held expenses. Zoho can refuse an expense (for example a locked period, or a deleted account). It is listed as "Expense: {reason} ({date})" with Zoho's reason; fix it and press Retry.
- Switching it off. Switch the same switch off and press Save mappings: nothing new is sent, and nothing already in Zoho Books is changed.
- Zoho's yearly limit. Zoho counts expenses together with bills in a yearly cap of their own, separate from invoices, so AirQR doesn't count them in "Invoices this financial year". They share one count with your stock-purchase bills (see Zoho's yearly invoice limit).
- Where to see them. The Expenses box on the Zoho Books page under GST & accounts: Expenses sent, Money returned sent, Expenses waiting to be sent, Expenses held for you. The tiles above it count held, failed and waiting expenses too.
Stock purchases as bills
If you use Inventory, AirQR can also send your stock purchases to Zoho Books as bills from your suppliers, so your accountant doesn't retype supplier bills. It is off until you switch it on: nothing is ever sent for purchases because you saved mappings, ran Apply or connected Zoho Books.
If your accountant already enters supplier bills in Zoho Books, choose Today or leave this off. Sending the same bills again would double them in your books.
Turning it on. In Accounts → Settings → Zoho Books → Sync settings, switch on Send stock purchases to Zoho Books as bills. AirQR asks Send purchases from: Today (the default), or The start date with the number of earlier purchases that would also be sent ("also send earlier ones"). Save, and from then on purchases go in the same Sync now and the same automatic run, after the sales of every outlet. Purchases and expenses together use at most half of what is left of the day's Zoho updates, purchases first (voids and lookups of bills already in Zoho come before new bills), so they never hold your sales. If a run stops at that limit it says More to do. Press Continue. The first day chosen is kept ("Sending purchases from {date}."): nothing dated before it, or before your start date, is ever sent. The guided Set up Zoho Books card can do the same with its own unticked box Also send purchases from today when you apply. Turning the switch off, or turning the Inventory module off, stops new bills only: a bill already in Zoho Books is still voided when its stock-in is voided, and a bill whose answer was lost is still looked up.
Which purchases. Every stock-in you received with Inventory → Add stock → Supplier delivery that is not voided, has something to pay, and is dated on or after the day you chose (and your start date). The date is the invoice date on the supplier's bill, or the day the goods arrived (in the outlet's time zone) when the bill has no date. A purchase received today goes with Sync now like any other. Quick add stock has no supplier bill, so it is not sent (the Tally purchase export leaves it out too, unless you tick Include quick adds).
The account. Every line of the bill goes on the outlet's Purchase account. Choose it in Accounts → Settings → Zoho Books → Edit details → Stock purchases. AirQR suggests Cost of Goods Sold, then Raw Materials And Consumables, then the first cost of goods sold account in your chart, but saves the suggestion only when you save with the switch on (a choice you make yourself is always saved). Until an account is chosen, purchases wait and the What goes to Zoho Books panel says "Choose the purchase account in Accounts → Settings → Zoho Books and they go with the next sync."
The vendor. Each supplier becomes a vendor in Zoho Books with the supplier's name. AirQR looks for a vendor of that name first (capitals don't matter) and creates one only if there is none, then remembers it, so a supplier is made once however many bills it has. If you rename a supplier in AirQR later, its vendor keeps the old name in Zoho Books; rename it there if you want both to match. If you delete the vendor in Zoho Books, AirQR looks it up by name once and makes a new one if needed. A supplier with a valid GSTIN is a registered business (its GSTIN and its state are sent); one without is an unregistered business. Purchases with no supplier (a cash or market purchase) share one unregistered vendor for the outlet, called Market purchases ({outlet}). If Zoho Books already has a customer or another contact with the supplier's name that isn't a vendor, the purchase is held: rename one of them, then Retry.
Numbers and dates. The bill number is the supplier's invoice number, or AQP- and the first 8 characters of the purchase's id when it has none. Zoho Books refuses a number a vendor has had before, a voided bill's too (for example when a purchase is voided and the same supplier invoice is entered again, or two market sellers both write "101"): the next bill is then sent as 101/2, 101/3 and so on, and AirQR keeps the number it chose. The bill is dated the invoice date (or the day the goods arrived); it has no due date of its own, so Zoho Books applies the vendor's payment terms. AirQR finds its bill again by a reference of its own, so a purchase is never sent twice, not even when Zoho's answer is lost.
Tax: input credit or cost.
- Each line is marked with the input-credit status it has in the input-credit register: eligible (also for common credit and capital goods, which are claimed first and reversed in your GSTR-3B), ineligible under section 17(5) for blocked credit, and ineligible, others when there is no credit (for example at a 5% restaurant). A status you change later is not sent to Zoho Books for a bill already there (a posted bill is never edited): your accountant corrects it in the GSTR-3B. The states used are the ones saved with the stock-in, so a supplier you edit later does not change an old bill.
- A supplier with a valid GSTIN (a real state and a correct check digit) is a registered vendor, and every line carries the Zoho tax of its GST rate: the GST group (CGST + SGST) when the supplier is in your state, IGST when its GSTIN is from another state, and the 0% tax for a line with no GST. If the purchase was recorded with GST on purchases = Input credit, the lines are marked eligible for input credit; if it was recorded as Part of the cost, they are marked ineligible (the tax stays in the cost), the same rule as the Tally export.
- A supplier with no GSTIN, a market purchase, or a GSTIN that fails its check is an unregistered vendor: Zoho Books accepts no tax at all on its lines (not even 0%), so each line is sent as its whole amount with the GST in it, as part of the cost. A supplier whose GSTIN looks wrong is shown on the sync page ("Supplier GSTIN looks wrong; sent without GST. Fix it in Suppliers."): correct it in Inventory → Suppliers for the next purchases.
- Zoho Books works out tax by adding up the lines of each rate and rounding each component (CGST and SGST, or the one IGST) to the paisa, while AirQR rounds each line, so they can differ by a few paise. AirQR puts the difference into the bill's round-off up front, so the bill's total is the purchase's total. If the bill Zoho Books makes still has another total (a tax setting there, or Zoho refusing the round-off), the purchase is held as Totals differ and the bill is left as it is.
Unpaid in Zoho Books. Bills are created unpaid, even when you marked the stock-in Paid. AirQR has no supplier payments, so your accountant records the payments in Zoho Books. The bill's notes say so.
Voids. If you void a stock-in in AirQR after its bill was sent, AirQR voids the bill in Zoho Books, but only while the bill has no payment there: it reads the bill first. This also applies to a bill you marked Mark as resolved or that is held for its total, and it happens whatever the switch says. If the bill is already paid in Zoho Books it is held ("This purchase was voided in AirQR but its bill is paid in Zoho Books. Record a vendor credit in Zoho Books."): record the vendor credit in Zoho Books, then press Mark as resolved. A stock-in voided before it was sent is never sent. AirQR never edits or deletes a bill: stock-ins aren't edited after they are received, and if one ever changes after its bill was sent, it is held ("Changed after it was sent to Zoho Books") and the bill is left as it is.
Supplier credit notes. A credit note from a supplier (recorded from the stock-in history, see Purchases and input credit) goes to Zoho Books as a vendor credit, with the supplier's own credit note number as its number and reference, positive amounts and the same tax lines as the bill it credits, each marked eligible or ineligible like the bill's line. It is sent only once the bill it credits is in Zoho Books (until then, or for good when that bill was never sent, it is listed as "Not sent: its bill wasn't sent to Zoho Books."), and AirQR does not apply it to that bill: your accountant does that in Zoho Books, like the payments. Voiding the credit note in AirQR voids the vendor credit, but only while nothing is applied to it there; if it is applied, it is held ("This credit note was voided in AirQR but its vendor credit is applied to a bill in Zoho Books. Remove the application there.") until you remove the application and press Retry or Mark as resolved. A credit note keeps the supplier's own number and is never renumbered: if Zoho Books already has that number for the supplier it is held ("Credit note {no}: this number is already used for this supplier in Zoho Books."); fix it in Zoho Books and press Retry. Vendor credits are not counted in Zoho's yearly bills-and-expenses limit. A connection made before this version has no permission for vendor credits: its credit notes are held with "Zoho Books needs a new permission for this. Reconnect Zoho Books…" while everything else keeps syncing; reconnect once and press Retry. The sync page counts them as supplier credits.
Your Zoho plan. Zoho counts bills and expenses together in one yearly limit, apart from invoices (Zoho's yearly limit). At 98% of it AirQR stops creating new bills and holds the purchase, a Retry included.
Reports. Your input GST shows in Zoho Books's own GST reports. The AirQR vs Zoho tab of GST & accounts is about sales GST and doesn't include purchases. The sync page shows Purchases sent as bills, Purchases waiting and Purchases held for you, and each held purchase is listed under Needs a look as "Purchase {invoice no} from {supplier}".
Plan and who can use it
- Plan: included in Pro, Custom, Licence and the free trial. On Starter and Growth it is an add-on at ₹199 a month, added in Settings → Modules or Plan & billing. It is called Zoho Books sync there. It is billed with your plan like other add-ons and stops if the plan isn't active. If it is switched off, turn on Zoho Books sync in Settings → Modules. Turning it off keeps your connection, mappings and history, but the sync stops.
- Set it up (the Set up Zoho Books card, connect, choose organizations, map, change settings): owners, and any role that has Settings access and GST access. A manager can do this only if an owner switches on GST and accounts for managers (Team → Staff → Roles → Manager → Choose what managers see) and the manager also has Settings. The setup lives at Accounts → Settings → Zoho Books.
- Send and fix (Sync now, Retry, the late-change choices and the history): anyone with GST access, which means owners and accountants, and managers when an owner allows it. This is the Zoho Books page under GST & accounts. An accountant can run the sync and answer questions about a day but can't change the setup.
- A cashier, waiter or other staff member can't see either page.
Connect Zoho Books
You need a Zoho Books account (an organization) already set up for your business, and the Zoho login that owns it.
- Open Accounts → Settings → Zoho Books and press Connect Zoho Books (in the Connection card; the Set up Zoho Books card above it takes over once you are connected). If the button isn't there and the page says "Zoho Books isn't available yet. Contact support@airqr.in.", write to us.
- Sign in to Zoho (if you aren't already) and press Accept. AirQR asks to create and update invoices, payments, credit notes, customers, items and accounts (the holding accounts below), to delete its own unsent draft of a cancelled bill, and to read your taxes, accounts and bank accounts. It also asks to create and read bills and vendors (AirQR uses them for your stock purchases), and, for the expenses and bank transactions planned next, expenses, vendor payments and bank transactions; AirQR sends none of those yet. AirQR never sees your Zoho password.
- You return to AirQR with "Zoho Books connected". The Connection card shows Connected, your Zoho data center (the Zoho region your account lives in, such as India) and who connected it.
One Zoho login serves your whole business, whatever the number of outlets.
Choose the Zoho organization for each outlet
(The Set up Zoho Books card does this for you in step 2; this is the same thing in the detailed section, under Edit details (for your accountant).) In Zoho organization, press Refresh from Zoho to read your organizations. For each outlet:
- Choose its Zoho organization, or leave it at Not synced. Outlets can share one organization, or use different ones (for example, outlets in two states with a separate GSTIN each).
- If your Zoho organization has more than one location (branch), choose the outlet's Zoho location (see Zoho locations).
- Press Save changes.
There is no Invoice prefix to set: invoices carry the number printed on the bill. AirQR only refuses to link two outlets that print the same outlet code into one Zoho organization (see Invoice numbers).
AirQR checks the organization against the outlet and tells you if they don't match: the organization must be in the same currency as the outlet, and its state must match the outlet's GSTIN. If you move an outlet to a different organization, its mappings are reset after you confirm with Move and reset (see Moving an outlet to another Zoho organization for what stays where).
Map your Zoho Books to AirQR
The Review list and Apply in step 3 of the setup do all of this in one go (see Set up in three steps); this section is for checking or changing it by hand, under Edit details (for your accountant). Once an organization is chosen, each outlet gets a Mappings for {outlet} card. Press Read from Zoho so AirQR can load that organization's customers, items, taxes and accounts. AirQR then fills in a Suggested match wherever it can find one (by name, rate or account type). Check each one. Nothing is final until you press Save mappings. Use suggestions throws away your changes on the screen and goes back to the suggestions.
- Customers. The walk-in sales need a Zoho customer, and each delivery platform that collected for the outlet needs one of its own (Walk-in guests, Swiggy orders, Zomato orders, Other platforms orders). A platform's customer is listed as soon as the outlet's settings (POS → Settings → POS settings → Platform orders) switch that platform on, say Platform collects for the customer's payment and Restaurant invoice for the tax invoice, or after the first such order, so you can map it before the first Swiggy bill. Choose an existing customer (use Find a customer in Zoho and Search for one that isn't listed), or press Create for me to make "Walk-in customers (outlet name)" or "Swiggy (outlet name)" in Zoho. If a customer with that name is already there, AirQR uses it.
- Tax classes. For each tax class of the outlet (for example "Food 5%"), choose the Zoho item it sells as and the Zoho tax (inside the same state), which must be a Zoho tax group that adds CGST and SGST at the class's rate (cess included, if the class has any). The Zoho tax (other states, IGST) is stored for later; inter-state days aren't sent yet. A tax-free class asks for a Zoho tax exemption instead. A state VAT class needs only an item (see Liquor and state VAT below). Create for me makes the item in Zoho with the class's HSN/SAC code; Sales account for new items is the income account it goes to. AirQR refuses a save when the Zoho tax doesn't charge what the class charges, and says which.
- A class that was renamed or removed in AirQR after bills were made with it is still listed, marked (no longer in settings), as long as bills from the sync window carry it. Map it like the others, or the days with those bills stay on hold.
- Charges. Service charge, Packaging charges, Delivery charges and Card surcharge each go on their own invoice line, so they land in their own income account. Give each an item (or press Create for me), or leave it at "Same item as the tax class it's charged in".
- Payment methods. For each of cash, card, UPI, online and other, set the Payment mode Zoho shows (the name you'll see in Zoho Books, up to 100 characters) and the account in Deposit to. Card, UPI and online money does not reach your bank on the day: the card or UPI provider settles it later, after fees. So AirQR deposits each payment into a holding account and you move the settled amount to the bank. See holding accounts below.
An outlet that has closed bills in the last 90 days shows only the methods those bills were paid with, plus any method you have already mapped. The others are tucked away; press Show all methods to see them. An outlet with no bills in the last 90 days (a new one) shows all five, each with its Create for me button.
- Expenses. Off until you switch on Send expenses to Zoho Books in this card (see Expenses in Zoho Books). Once it is on: for each expense category (Rent, Electricity, water & gas, Repairs & maintenance and the rest, plus Uncategorised), choose the Zoho expense account it is booked to, and under Paid from choose the cash or bank account each way of paying (cash, card, UPI, online, other) is paid through. An outlet that recorded expenses in the last 90 days shows only the categories they used, plus any you changed; press Show all categories for the rest. A category left on Not chosen is not sent. If this card says "Press Refresh from Zoho to read this organization's expense accounts.", press Refresh from Zoho first.
- Stock purchases. Choose the Purchase account the lines of this outlet's supplier bills go on (see Stock purchases as bills). Nothing is sent until you switch on Send stock purchases to Zoho Books as bills under Sync settings; saving this mapping never turns it on.
Holding accounts for payments
A holding account is a Zoho account that holds money that has been taken but is not in your bank yet. Payments go there instead of straight to the bank, because a card or UPI settlement arrives later and net of fees, and cash is in the drawer until someone deposits it. When the settlement lands, you move the money from the holding account to the bank with a transfer in Zoho Books, and the books match the bank statement.
Next to Deposit to for cash, card, UPI and online there is a Create for me button. It makes one account for the method, as a Zoho "cash" type account (the same type as Zoho's own Undeposited Funds, so it is accepted as a deposit account):
| Method | Account |
|---|---|
| Card | Card Clearing |
| UPI | UPI Clearing |
| Online | Online Payments Clearing |
| Cash | Cash Drawer – (outlet name), one for each outlet |
| Other | Zoho's own Undeposited Funds (AirQR never creates it; there is no button) |
If an account of that name is already in Zoho Books (letters in any case), AirQR uses it and says "Card Clearing already exists in Zoho Books and is now chosen for Card"; otherwise it makes it and says "Card Clearing created in Zoho Books and chosen for Card". It is then selected in Deposit to, but nothing is kept until you press Save mappings. If Zoho has an account of that name that cannot take payments (an expense account, for example), AirQR does not use it and asks you to rename it in Zoho Books.
For a method that has no mapping yet, AirQR suggests the holding account if it exists, then Petty Cash (cash) or Undeposited Funds (the others), then your first bank account. A mapping you saved is never changed by a suggestion.
New permissions: reconnect once
When AirQR asks Zoho for more permissions (this version adds the permission to create accounts, and the ones for tips journals, stock purchases as bills, expenses and supplier credit notes), a connection made earlier keeps working, and Accounts → Settings → Zoho Books shows a note: "Reconnect Zoho Books when you want to use AirQR's newer features, such as sending supplier credit notes. Everything else keeps working, and your settings and synced data stay as they are." The note is optional: the only thing that waits for the reconnect is a newer feature (today, supplier credit notes). Press Reconnect, sign in to Zoho and press Accept; the note goes away. If you press Create for me for a holding account before reconnecting, Zoho refuses and AirQR says "Zoho Books needs a new permission for this. Reconnect Zoho Books (Accounts → Settings → Zoho Books), then try again." The connection is not marked as needing a reconnect and the sync is not stopped.
Turn off Zoho's own rounding
AirQR sends its own Round off line, so that the invoice total equals the bill total to the rupee. If your Zoho Books organization also rounds sales totals, the two can pile up and the totals won't match. In Zoho Books, open Settings → Preferences → General and set Rounding off in Sales Transactions to No Rounding. If Zoho still shows a total that differs from AirQR's by a few paise or rupees, this is the first place to look.
Zoho locations (branches)
A Zoho organization can have several locations (branches), each with its own GSTIN. AirQR reads them when you connect and when you press Refresh from Zoho (no new permission is needed), and sends the outlet's location on its invoices, credit notes and payments, so each one lands under the right GSTIN in Zoho Books.
When the organization has more than one location, Edit details shows a card called Zoho locations: "Your Zoho organization has more than one location (branch). Choose the one each outlet's invoices, credit notes and payments go to: the location with the outlet's GSTIN."
- For each outlet pick Zoho location for this outlet · (outlet) (placeholder Choose a location). Each option shows the location's name, with Primary and GSTIN … when Zoho says so. Under it AirQR shows This outlet's GSTIN: … and Suggested: (location). After you choose you see Zoho location saved.
- AirQR fills it in by itself when the outlet's GSTIN matches a location's GSTIN (or the primary location, for the organization's own GSTIN). Check it anyway.
- Until a location is chosen the outlet is held and nothing is sent for it. Edit details and the Zoho Books status page say "Choose the Zoho location for (outlet) in Accounts → Settings → Zoho Books → Edit details."
- A location that was deleted or made inactive in Zoho is cleared when you press Refresh from Zoho, and the outlet is held again. If you pick one that has gone: "This Zoho location isn't in the organization any more. Press Refresh from Zoho."
- AirQR never sends an invoice without a location to an organization that has several. An organization with one location (or none) works as before.
A Zoho organization shared with other sales
Many businesses keep one Zoho Books organization for everything, and connect AirQR for only one outlet, or some. The rest of the organization's invoices are made in Zoho by hand, by another outlet or by another app. This is fine:
- Two number series in one organization are allowed. GST permits "one or multiple series". AirQR's invoices carry the printed number (
SP/26-27/1021) and are created so that Zoho does not give them its own number. Zoho's own series (for exampleINV-000123) keeps running for everything else and is untouched. - A number already used in Zoho. Zoho refuses duplicate numbers in an organization. If something in Zoho already has the number of one of your bills, that bill is held under Needs a look: "The number … is already used in Zoho Books by another document. Rename or delete that document in Zoho Books, then Retry." It is never renumbered.
- Several GSTINs in one organization: choose each outlet's Zoho location (see above).
- AirQR never edits or deletes documents it didn't create. It finds its own by the reference it put on them.
- Customers, items and accounts work as before: Walk-in customer, business customers matched by exact GSTIN, and the items, tax groups and accounts you mapped.
- Where do I file GSTR-1?
- If AirQR is the only source of sales for that GSTIN, file from AirQR's files or from Zoho Books, not both.
- If Zoho Books also holds that GSTIN's other sales, file from Zoho Books, because AirQR can't see the rest. AirQR's own GSTR-1 files then cover only the AirQR outlets and must not be uploaded for that GSTIN.
- Zoho's Documents issued (Table 13) is entered by hand for each series. Open GST & accounts → For your accountant → Bill numbers: Documents issued in (period): lines to copy gives one line per series (series, first and last number, total, cancelled and net), and Copy lines copies them. See GST reports.
- The setup question "Does Zoho Books also hold other sales for this GSTIN…?" records which case applies, and the guide shows the matching instruction.
- Zoho's yearly invoice limit counts the whole organization. AirQR counts only what it sent.
Liquor and state VAT
Zoho Books India doesn't accept a state tax such as VAT on liquor as a tax on an invoice line: it refuses it ("Specified tax is not allowed."), and it marks such items non-GST supply. So AirQR sends a non-GST tax class (state VAT, or another levy) as a line without a Zoho tax. The line's amount is what the guest paid for it, VAT included, and the line's description says so: "Includes state VAT 20%: ₹10.00". The invoice total in Zoho Books is still the bill's total to the paisa. The same goes for credit notes of refunds.
- In Accounts → Settings → Zoho Books → Tax classes, a non-GST class asks only for a Zoho item: there is no tax to choose, and the page says "Zoho Books India treats {class} as a non-GST supply. AirQR includes the {rate}% VAT in the line amount." A Zoho tax saved earlier for the class is ignored. Create for me makes the item as a non-GST supply, with the sales account you chose.
- Zoho Books doesn't see the VAT as tax, so it is not in Zoho's tax reports or in the Tax difference column. Your accountant records the VAT payable from AirQR's VAT report (GST & accounts), for example as a journal entry. A VAT journal from AirQR is a possible later option.
- A liquor line carries no HSN or SAC code in Zoho Books unless the tax class has its own (the restaurant SAC 996331 would be wrong on it). Food and other GST lines keep their code.
Start date, schedule and history
Still in Accounts → Settings → Zoho Books, under Sync settings:
- Start date (required). Pick a date in the calendar. Nothing before it is ever sent. It can't be before your first bill or in the future. A month is a good first run: you can always move it earlier later, and the days between are then sent. Moving it later works too, and after you save, AirQR tells you "{n} days already sent before {date} stay in Zoho Books." They aren't removed. A refund of a sale from before the new date still finds the sale's invoice.
- Schedule. Until you choose, it says Automatic after your first Sync now: after your first clean Sync now, AirQR sends each closed day automatically the next morning around 9:00 AM, and late changes are picked up too. When that happens you see "Automatic sync is now on: every morning around 9:00 AM. You can change it in Zoho Books settings." Choose Manual only to switch it off (it is then never turned on again by itself), or Automatic: once a day, around 9:00 AM to choose it yourself. If you would rather check the first days with your accountant first, choose Manual only before your first Sync now.
- Recheck recent days for late changes (1 to 45, default 7). Each run checks this many recent days again for late changes, such as an offline bill that arrives later.
- Invoice numbers. The numbers on your bills (for example SP/26-27/1021) (AirQR's daily numbers in summary mode). Zoho's own numbering is shown only to a connection that already uses it, with a warning (see Invoice numbers).
- Send stock purchases to Zoho Books as bills, off by default, with Send purchases from (Today, or The start date). See Stock purchases as bills. Sending expenses has its own switch in the outlet's Expenses card (see Expenses in Zoho Books).
Press Save settings.
Preview a day
Under Preview a day, choose the outlet and a Day (pick a date; any day up to today, and today shows the bills closed so far) and press Preview. AirQR shows exactly what it would send: with one invoice per bill, the list of bill invoices (number, total, tax and whether the bill is already in Zoho Books, with Open in Zoho once it is) and, under each, The exact data sent to Zoho as it will be sent; then each bill's payment or payments; in summary mode, the day's invoice with the Zoho item and tax of each line, the round off and the payments with their mode and account. Credit notes follow, next to your own GST figures. The Checks list shows whether the invoice total, the tax and the payments agree with AirQR's GST report. A red cross shows both figures. To fix before this day can be sent lists anything still unmapped. Nothing is sent, and Zoho isn't called. This is the best way for you or your accountant to check a day before the first sync. The exact data sent to Zoho shows the raw request.
Sending: the Zoho Books status page
Open GST & accounts: under the headline numbers a single Zoho Books line says where you stand (Not connected, In sync · last sent …, Connected · nothing sent yet or Reconnect needed), and its Open status button goes to the Zoho Books page (Set up or Reconnect when it isn't connected). You can also go to GST & accounts → Zoho Books. The status page is the one place that says whether Zoho is in sync; the GST page's line is only a pointer to it.
- The status line at the top: In sync, "last sent {when} · next automatic sync tomorrow around 9:00 AM" (or "today" before 9:00 AM), with Sync now beside it. Instead you may see "{n} items need a look" with Fix, Reconnect needed with Reconnect, or Zoho Books is disconnected. Under Sync now it says "Sends everything closed so far, including today's bills." It works through the days since your start date, oldest first, then today so far, and the page updates by itself. A first run over many days can take a few rounds: if time runs out the run says "More to do. Press Continue." and the page carries on by itself, or you press Continue. There are no day counters to read: the sentence carries the state, and today is said in words ("Today (so far)").
- One card for each Zoho organization, with its name and state, the outlets that post to it, and two labelled meters: Zoho Standard: 120 of 2,000 updates today (how much of your Zoho plan's daily allowance has been used, by everything using that organization, with a mark at the 80% AirQR keeps to) and Invoices this year: 4,200 of 5,000 (the invoices AirQR has created since your Zoho financial year began, counted from AirQR's own records, so invoices made by hand in Zoho Books aren't in it). If the daily limit was reached, a note says when syncing is available again.
- Needs a look lists everything that stopped for a person, oldest first, with what to do. See below. It is only there when something needs you.
- Three closed sections: What goes to Zoho Books (what has been sent, what waits and what is never sent; "Tips go as one journal a day, not as payments; cancelled bills don't go."), Last 60 days (for your accountant) and Run history.
Last 60 days scrolls inside its own box and has a pager below it ("1–20 of 63", with 20, 40 or 60 days a page). It shows each day and outlet, the AirQR total, the Zoho total, the Tax difference (AirQR's tax minus Zoho's, a few paise at most) and a status: Synced, Pending, Waiting, Needs attention, Needs your answer or Failed. Preview shows what was sent for that day, and Open in Zoho opens the invoice in Zoho Books. With one invoice per bill the day shows how many of its bills are in Zoho, and Preview lists each bill with its own Open in Zoho. A day is Synced only when every bill on it is done.
Run history lists the last runs (in a box that scrolls): when, how it started (Sync now, Automatic or Retry), by whom, the result, what it did (days, invoices, payments, credit notes) and how many Zoho calls it used.
What goes to Zoho Books: the live counts
Under What goes to Zoho Books, the panel says "Since your start date ({date}), all outlets that sync." and counts, from AirQR's own records (Zoho isn't called):
- Sent or on its way: Bills sent as invoices (with "{n} correction invoices" when a bill changed after it was sent), Payments sent (how many and the total), Refunds sent as credit notes (how many and the total, with "{n} of them corrections" when some are adjustments), Waiting to be sent (closed bills with no invoice in Zoho yet that aren't held: "Including today's closed bills. Press Sync now, or they go with the next automatic sync."), and Held for you (the items in Needs a look, with a See below link).
- Tips journals sent (with Tips and its total, "Sent as a Tips payable journal") and Cancelled bills sent as void are added to the first group when those are on.
- Purchases sent as bills (how many and the total, "Unpaid bills from your suppliers. Record the payments in Zoho Books."), Purchases waiting and Purchases held for you (with a See below link) are added to the first group once stock purchases are on or any were sent. See Stock purchases as bills.
- Not sent, by design, each with its reason: Tips when recording them is off (the total; "Not sent as sales: tips belong to your staff."), Cancelled bills, Bills that Swiggy or Zomato invoice (shown when the outlet has delivery platforms or such bills exist), and Days with inter-state (IGST) bills (shown when there are any; "Held until AirQR supports IGST bills.").
- Expenses (its own box under the two groups, shown once expenses are on or anything was sent): Expenses sent (how many and the total), Money returned sent (how many and the total), Expenses waiting to be sent and Expenses held for you (with a See below link). See Expenses in Zoho Books.
Rows at zero stay on screen on purpose: a zero is reassuring. Without a start date the panel says "Set a start date in Zoho Books settings" instead of counts.
Today's bills and the open day
Sync now sends the bills that are closed so far today as well, exactly like the bills of any other day (an invoice, then its payments; a refund as a credit note). Today is shown in the days table as Today (so far) with the status Sent so far, and a run that included it says "Including today (so far)". It is not counted as a Synced day or as Pending, because the day isn't over.
- A bill that closes later today is sent by the next Sync now as a normal first posting. It is not treated as a late change, and nothing asks you for a date.
- If a bill that was already sent changes later today, it is corrected as on any day: one supplementary invoice for what went up, or a credit note for what went down, for that bill alone, with its payment for the difference.
- Only Sync now sends today. The automatic run, Retry and the answers you give never do. When the day is over, the next run (the automatic one the following morning, or Sync now) finishes it: it doesn't send anything twice, posts whatever closed after the last Sync now, and from then on a bill added to that day is a late change as usual.
- A business that still sends one summary invoice per outlet and day (set up before per-bill mode) has no open day: only finished days are sent.
Only one sync runs at a time for a business. If you press Sync now while one is running, you're told it is already running.
Retry and your answers
- Retry gives a stuck day or refund another go. Its tries start again, and the next Sync now sends it. Use it once the cause is fixed, for example after a Zoho outage.
- Post on original date and Post today appear when a late change falls in a month that may already be filed (see below), or when Zoho refuses to take entries for that date. You choose the date the late-change entry carries. Then press Sync now to post it.
- Post as calculated appears when a day's bills have data problems (a bill with no payment, or payments that don't add up to the bill) and you accept the figures as they are. Fixing the bill in AirQR is usually better; the problem line links to Check the bills in GST & accounts.
- Mark as resolved appears for a payment that is now lower than what's in Zoho. It accepts that difference: AirQR records it, clears the line and doesn't raise the same difference again (a bigger one is raised).
- I'll handle this bill in Zoho Books (one invoice per bill) and I'll handle this day in Zoho Books appear when a synced invoice was edited, voided or deleted in Zoho Books. The bill version takes over that one bill; the day version takes over every bill of the day. After you confirm, AirQR posts nothing more for that day: no sending, payments, late-change entries or credit notes. If the day changes in AirQR later, it tells you ("This day changed in AirQR after you took it over in Zoho Books") and still posts nothing; press the button again to accept the new figures. Refunds on a sale from that day show "Record this refund in Zoho Books yourself", with the same kind of button.
- Post again appears when the invoice was voided or deleted in Zoho Books and you want AirQR to post it again as the next invoice (number ending
/2,/3…) with its payments. With one invoice per bill it is offered for that bill alone, and the other bills are not touched. Post again posts the bill's payments again too. If the voided invoice had a payment applied, Zoho may leave that payment in place, unapplied. So first delete (or unapply) that old payment in Zoho Books, or the money is counted twice. - A total that differs from AirQR's by more than a rupee has only Retry: fix the tax mapping or the Zoho tax first, then press it. It can't be marked as resolved.
- While a sync is running these buttons wait: "A sync is running. Try again in a minute."
- Where a mapping is missing, the line links to Open Zoho Books settings.
Check your figures against Zoho Books
On GST & accounts, under For your accountant, there is an AirQR vs Zoho tab (it was the Zoho Books tab, after Credit notes). It shows only for a GSTIN with an outlet that posts to a Zoho organization (an outlet left at Not synced has no tab; with several such outlets under the GSTIN, each gets its own table), and it opens by ?tab=zoho in the address. For the GSTIN and period you have chosen at the top, it puts AirQR's GST figures next to what AirQR has posted to Zoho Books, and says why when they differ. Opening the tab reads only AirQR's own records: it makes no call to Zoho, so it doesn't use any of your Zoho plan's updates. Only people who can open GST & accounts → Zoho Books (the same permission as Sync now) see it.
At the top of the tab:
- Everything matches (within rounding), or "{n} days differ" and "{n} payment methods differ" with the Total difference. It says everything matches only when the days, the rates and the payment methods all agree.
- When Zoho Books was last checked ("Zoho Books last checked 2 hours ago. 0 issues", or "Zoho Books has not been checked yet.").
- The Check in Zoho Books button (see below).
- How many Invoices AirQR has posted in the period, with the number of bills they cover, the Correction invoices (late changes), the Credit notes (refunds and adjustments), the Payments, and, when there are some, the Tips journals and the Cancelled bills sent as void (counted apart and never part of the comparison).
The two sides. AirQR is the GST report you see on the other tabs of For your accountant: the same bills and refunds, with the same figures. Zoho Books is what AirQR posted there: the invoices, credit notes and payments that AirQR finished, counted by the date the document carries in Zoho Books. Credit notes are taken off.
By rate has one row for each GST rate and a Non-GST · VAT row (liquor at state VAT, tax-free items), with a Total. The columns are Rate, AirQR taxable, Zoho taxable, AirQR tax, Zoho tax and Difference.
By payment method comes after By rate and has a row for each method with money in the period (Cash, Card, UPI, Online, Other), with a Total. The columns are Method, AirQR received, Zoho payments, Tips, Refunds and Difference:
- AirQR received is what the Payment-mode summary on the Summaries tab shows for the method (payments plus tips), with the number of bills.
- Zoho payments are the customer payments AirQR posted to Zoho Books for that method, with their number. They never include tips.
- Tips shows the tips posted to Zoho Books in the Tips payable journal for the method, with AirQR's tips under it. Refunds shows the refunds posted to Zoho Books (the payout of each credit note) by the method they were paid back with, with AirQR's refunds under it. The tip part of a refund is not counted: a credit note has none.
- Difference = (AirQR received − refunds) − (Zoho payments + tips − refunds).
Under a method that has reasons they are listed as under By day. A method matches when each of its days is within ₹1.00 of rounding once the reasons that are not differences are set aside: Collected by the platform (Swiggy, Zomato…): not sent (the platform collects those bills, so AirQR sends no payment for them), Netted against another method on the same bill (a method that gave back more than it took, for example cash handed back on a card bill, is posted netted against the bill's largest method) and Tips not sent to Zoho (by your choice) (the Tips payable journal is off in the Zoho Books settings; Tips not sent to Zoho (Tips payable isn't set up) when it is on but the account or the method's deposit account isn't mapped). The reasons that are differences are the same as for the days, plus Overpaid (more than the invoice in Zoho Books can take): Zoho Books applies at most the invoice's balance to a payment, so a payment above it is left unapplied. Tips are never a difference: a tip that has no journal yet (today's open day, or a tip added after the day's journal was posted) shows as Tips go to Zoho as one journal once the day is over until the next sync posts the journal, and the method still matches. The warning's Total difference leaves out amounts that are only information (platform-collected bills, netted methods, tips waiting for their journal).
By day has a row for each day with the taxable value, tax and total for AirQR and for Zoho Books, and the Difference in the total. A day shows Matches when the two agree within rounding. Under every other day the reasons are listed. A long list shows 20 days at a time and loads more as you scroll.
Rounding. "Rounding: Zoho rounds tax per line." A difference of up to ₹1.00 a day in tax or in total counts as rounding, so such a day shows Matches. Anything larger needs a reason.
The reasons. Each one says how many bills it is about, the amount, the bills (open a bill from its number), and where to fix it:
- Not sent yet: bills that have no finished invoice (waiting for a run, pending, or today's open day), and changes to a sent bill that have not been posted yet. In By payment method it also covers payments, refund payouts and tips not posted yet. The link is "Sync now on the Zoho Books page".
- Held for you: a day or bill that needs attention, needs your answer, or failed. The link goes to Needs a look on the Zoho Books page.
- Handled in Zoho Books by you: bills or days you took over ("I'll handle this bill in Zoho Books"). AirQR posts nothing more for them.
- Posted on another date: a document whose date in Zoho Books is not its GST date, for example after you chose Post today for a late change. Both dates are shown, on both days, and over a period that holds both of them the rates balance.
- Not sent on purpose: days held because of an inter-state (IGST) bill. Orders that Swiggy or Zomato invoice, and cancelled bills, are in neither side, so they are not a difference.
- Unexplained difference: a difference no reason above explains. It should not happen: the tab says "Contact support", and AirQR logs it (the outlet and the date, no amounts).
Before the start date. Days before your start date aren't synced, and are shown as Not synced (before start date), not as differences. They, and the refunds of sales from before the start date (the sale isn't in Zoho Books), are left out of the tables.
Check in Zoho Books
The button Check in Zoho Books is manual: AirQR doesn't run it by itself. It reads Zoho's own invoices and credit notes dated in the period and compares them, one by one, with the documents AirQR posted. It changes nothing, in Zoho Books or in AirQR. It finds:
- Deleted in Zoho Books: AirQR posted it and Zoho doesn't list it (it may also have been moved to a date outside the period).
- Voided in Zoho Books.
- Changed in Zoho Books: the total, or the tax when Zoho's list shows it, is more than ₹1 from what AirQR posted.
- Date changed in Zoho Books: Zoho has it, but dated outside the period. Before AirQR calls a document deleted, it asks Zoho for that one document (at most 20 per check, each one a call) and reports Date changed when it is there.
- In Zoho Books, not from AirQR (information only, not an issue): an invoice or credit note for this outlet's walk-in or platform customers that carries no AirQR reference, "made by hand in Zoho Books?".
Each one has an Open in Zoho link and says what to do. AirQR never fixes anything by itself. For a changed document: "Changed by hand in Zoho Books. AirQR won't overwrite it. Correct it in Zoho Books or contact your accountant." For a deleted or voided one: AirQR doesn't send it again by itself. If that bill changes in AirQR, the next Sync now notices that the invoice is gone and the Zoho Books page offers Post again (see Retry and your answers); otherwise ask your accountant to enter it in Zoho Books. Documents you took over (every invoice of a bill you took over, supplements included, and every document of a day you took over), accepted as they are, or set aside with Post again are not reported.
The result is kept ("Checked in Zoho Books 5 minutes ago: 0 issues", with the period) until you check again; each outlet keeps its last check, and at most 200 issues. What is kept is small (the kind, the number and Zoho's id of each issue, not the amounts), so the full detail is shown straight after you press the button. The tab shows a stored result in full only for the same period; for another period it says "Last checked {from}–{to}". Every check is written to the audit log (zoho_books.check, with the period and the counts).
- One month at most. A period of more than 31 days can be compared but not checked: the button is off and says "Pick a month or less". A busy outlet's month is about 45 calls.
- It never compares with a partial list. AirQR asks Zoho for your outlet's customers one at a time (walk-in, and each delivery platform) and reads every page to the end. If it can't read everything (the daily limit is reached partway, or a list is too long), it ends with no result and says so: "Couldn't read all of Zoho's invoices for this period. Pick a shorter period." Nothing is reported as deleted from half a list.
- Not while a sync runs. The check waits ("A sync is running. Try again in a minute."), because the sync works on the same documents.
- It uses your Zoho plan's updates. Every page of 200 documents Zoho answers is one call, counted in Zoho updates today like any other. The check stops at the same daily limit as the sync (the share AirQR keeps to) and says when it is available again. Press it when you need it, not several times a day.
- The nightly check is not part of this: the automatic morning sync does not run it.
No duplicates, and late changes
Every document AirQR sends has a fixed reference built from what it is: the bill (airqr:bill:...), one payment of a bill for one method (airqr:pay:bill:...), one refund. In summary mode it is built from the outlet and the day. Before it creates anything, AirQR knows whether that document was already sent. If a request times out or the connection drops, AirQR checks Zoho Books for the document before it sends it again, so a repeat run, a Retry or a reconnect doesn't create a second copy. Zoho's own check on invoice numbers is a second guard.
Bills sometimes change after a day was sent: an offline till sends a bill late, a late payment comes in, or a refund is given. AirQR notices (it re-checks the days set in Recheck recent days for late changes, and any day touched by a recent change) and never overwrites what is in Zoho Books:
- A bill that arrives late on a day that was already sent (a day that is over and finished) gets its own invoice and its own payment. It follows the dating rule below: on its own date in the current month (or the previous month until the 11th), otherwise the day shows Needs your answer and nothing is sent for that bill until you choose Post on original date or Post today. Its payment carries the same date.
- If a run stopped before it finished the invoice and nobody has touched it in Zoho, AirQR updates that invoice first. Otherwise it posts only the difference, for that bill alone: a supplementary invoice (number ending
/2,/3…, built on the number the bill's first invoice has in Zoho) for sales that went up, a credit note (notes "Adjustment for late changes") for sales that went down, and an extra payment of that bill, for the difference only, for a payment that arrived late. - A payment that is now lower than what's in Zoho can't be taken back by AirQR: the day shows Needs attention. Fix it in Zoho Books, or press Mark as resolved to accept the difference.
- A late change keeps the day's own date in the current month, and in the previous month up to the 11th (the GSTR-1 due date). After that the month may already be filed, so the day shows Needs your answer and you choose Post on original date or Post today.
- If you edit or delete a synced invoice in Zoho Books yourself, AirQR leaves it as you made it and shows Needs attention ("Changed in Zoho Books; AirQR won't overwrite it." or "This invoice was voided or deleted in Zoho Books."). Press I'll handle this day in Zoho Books to take the day over, or (for a voided invoice) Post again.
Disconnect and reconnect
- Disconnect (Accounts → Settings → Zoho Books → Connection) stops the sync and asks you first: "Sync stops. Records already in Zoho Books stay there. History stays in AirQR." Your mappings and history are kept. To start again, press Connect Zoho Books.
- Reconnect is shown when the connection needs it (the badge says Reconnect needed), or any time from the Connection card. You sign in to Zoho and press Accept again. Your settings, mappings and history are kept. If you reconnect to the same Zoho organization, the sync carries on without duplicating anything.
- When Zoho stops accepting AirQR's connection (you removed AirQR in your Zoho account's connected apps, or Zoho signed the login out), the sync stops and the page says "Zoho Books needs to be reconnected."
- If you reconnect with a Zoho login that can't see an organization an outlet is linked to, the outlet shows "This Zoho login can't access {org}. Reconnect with the login that owns it, or link this outlet to another organization."
The Zoho connection over time
You can connect late, disconnect for weeks, reconnect or move an outlet to another organization. Here is what happens to the numbers.
- You connect in the middle of a year (the start date is after your first bill). Nothing before the start date is sent. The guide and the Zoho Books status page say exactly which numbers are therefore not in Zoho: "Bills before (date) aren't in Zoho Books: SP/26-27/1–SP/26-27/940." (per series, cancelled numbers included, and per outlet when you have several), so your accountant knows where each number lives. The date is the later of the start date and the outlet's "send from" date.
- You disconnect and reconnect to the same organization. Nothing moves while disconnected. After reconnecting, every day not yet sent is sent, and recent changes are found again: late offline splits, bills reissued after a change, merges and cancelled numbers recorded in the meantime are picked up even after a long gap.
- Your login expired ("Reconnect needed"). The nightly run can't send. The history gets one row a day, "Couldn't send: Zoho Books needs to be reconnected.", so you can see since when. After reconnecting, it catches up.
- You disconnected and left it. The Zoho Books page and the Zoho Books line in GST & accounts say "Nothing sent to Zoho Books since (date)". The AirQR vs Zoho tab stays readable from what AirQR stored: "Nothing sent to Zoho Books since (date). This comparison is from what AirQR sent before." (or "Nothing has been sent to Zoho Books. Reconnect Zoho Books to send." if it never sent). Check in Zoho Books needs a connection.
- You move an outlet to another Zoho organization. The dialog Move to another Zoho organization? says "(n) documents already sent stay in the old organization." and asks Send to the new organization from: Today (the default), A date or The start date. Documents already in the old organization are not sent again to the new one. A refund of a sale that went to the other organization is held: "The sale of this refund was sent to another Zoho organization ({org}). Record the refund there by hand, then press I'll handle this." Moving back to an organization the outlet already posted to finds its old documents, and keeps its old numbers.
- You move the start date later. After saving: "(n) days already sent before (date) stay in Zoho Books." They stay; refunds still find their sale's invoice.
- 1 April 2027 passes while you are disconnected. Catching up sends March's old-style bills and April's new ones, each numbered as printed on its own date. The yearly invoice cap counts invoices dated in this financial year or created in it.
- A Zoho location was deleted, or its GSTIN changed, while you were away. Press Refresh from Zoho after reconnecting: the outlet is held until you choose a valid Zoho location.
Troubleshooting
While connecting
| What you see | What to do |
|---|---|
| Zoho Books isn't available yet. Contact support@airqr.in. | Write to support@airqr.in. |
| Zoho didn't complete the connection. If you clicked Accept, wait a few minutes and try again. | You pressed Decline, or Zoho limits repeated connection attempts (about 10 in 10 minutes). Wait a few minutes and use Try again. |
| The code from Zoho expired or was already used (it is valid for 2 minutes). Please try again. | Press Try again and accept at once. |
| Zoho didn't accept the connection. Please try again. | Press Try again. If it keeps happening, write to support. |
| This connection link isn't valid or has expired. Please start again. | Start from Connect Zoho Books again. Don't reload an old Zoho tab. |
| This connection was started by someone else or for another business. Please start again. | Start again, signed in as the person who is connecting, in the right business. |
| Zoho sent an unexpected address, so the connection was stopped for your safety. | Try again. If it repeats, write to support. |
| Zoho Books can't be connected from this session. Sign in again, then try again. | Sign out and in again. Support sessions can't connect Zoho Books. |
| Zoho Books is temporarily unavailable. We're on it. | Wait and try again later. If it lasts, write to support. |
| Could not reach Zoho. Please try again. / Zoho couldn't complete the connection. Please try again. | Check your connection and try again. |
Choosing organizations and mapping
| What you see | What to do |
|---|---|
| {outlet}: the Zoho organization is in {zoho}, but this outlet bills in {currency}. | The organization's currency must match the outlet's. Choose the organization that bills in the outlet's currency. |
| {outlet}: the Zoho organization is in {zoho}, but this outlet's GSTIN is for {state}. | The organization's state must match the GSTIN. Pick the organization for that state, or fix the GSTIN in Settings → Outlets. |
| {outlet} can't be linked to this Zoho organization: another outlet linked to it prints bill numbers starting with {code}, and bill numbers in one Zoho organization must never repeat. Contact support to give this outlet another code. | Two outlets in one Zoho organization (from any of your AirQR businesses) print or printed the same outlet code. Contact support@airqr.in. |
| This Zoho login can't access {org}. Reconnect with the login that owns it, or link this outlet to another organization. | Press Reconnect with the right Zoho login, or choose another organization. |
| This Zoho login has no Zoho Books organization yet. Create one in Zoho Books, then refresh. | Create the organization in Zoho Books, then press Refresh from Zoho. |
| Zoho tax {tax} is {zoho}%, but the tax class '{name}' charges {rate}%. | Choose the Zoho tax whose rate matches, or fix the class's rate in AirQR. |
| Zoho tax {tax} is a single tax, but the tax class '{name}' needs a tax group (CGST + SGST). | Choose a Zoho tax group (CGST + SGST). |
| Zoho tax {tax} is not an IGST tax, but the tax class '{name}' is sold across states. | Choose an IGST tax at the same rate. |
| Zoho didn't list any tax groups, so nothing is suggested. | Create the CGST + SGST group in Zoho Books, press Refresh from Zoho, then choose it. |
| That tax isn't in Zoho. Press Refresh from Zoho and choose again. | The Zoho setup changed. Refresh and pick again. |
| Press Read from Zoho first, so AirQR knows this organization's taxes and accounts. | Press Read from Zoho. |
| The start date can't be before the first bill ({date}). / The start date can't be in the future. | Choose a start date from your first bill's day to today. |
| The Zoho Books setup was changed on another screen. Reload to see the latest, then make your change again. | Someone else saved a change. Reload and repeat yours. |
| Zoho Books is busy right now. Try again in a minute. | Zoho limited the number of requests. Wait a minute. |
| Could not reach Zoho Books. Please try again. | Check your connection and try again. |
| Zoho Books refused that: {message} | Zoho's own words: fix what it names in Zoho Books or on the mapping, then try again. |
| Choose {things} in Edit details first. You chose to set these up yourself, and bills can't be sent without them. | You unticked that thing in Apply (step 3 of the setup), and your bills need it. Press Pick it in Edit details on its row of the report, choose the Zoho account, item or customer and press Save mappings (or tick it in Apply (step 3 of the setup) and apply). |
| Press Check my setup first, so AirQR knows this organization's taxes and accounts. | Open step 3 of the Set up Zoho Books card: the check reads the organization by itself. If it didn't run, press Check my setup, then Review list and Apply. |
| Stopped part-way. Press Review list again to carry on. | Zoho refused one thing, and the card says which and why (a daily limit, a missing permission, a name clash). Fix it or wait, then press Review list and Apply again. What was done is kept and nothing is made twice. |
| Zoho has no 5% GST tax group. Add it in Zoho Books, then Check again. (and the matching messages for IGST, tax exemptions and sales accounts) | Add that tax, group, exemption or income account in Zoho Books, then press Check again in the Set up Zoho Books card. AirQR creates nothing for a Not supported yet row. |
| This business is under the GST composition scheme. AirQR can't send bills of supply to Zoho Books yet. | The composition question was answered Yes, so nothing is sent (Sync now, the automatic run). Answer No in the Set up Zoho Books card if that is not right. |
| Zoho Books' daily limit was reached. Syncing is available again after {time}. (also while setting up) | Zoho's daily limit for your plan was reached. Wait until the time shown; nothing is lost, and Apply (step 3 of the setup) carries on. |
| Answer the question about the GST composition scheme first. / AirQR can't send bills of supply yet, so it can't send for a business under the composition scheme. | Go live is off until the composition question is answered No. A business under the composition scheme issues bills of supply, which AirQR can't send to Zoho Books yet. |
On the Zoho Books page: why Sync now can't start
| What you see | What to do |
|---|---|
| Connect Zoho Books first. | Go to Accounts → Settings → Zoho Books and connect. |
| Zoho Books needs to be reconnected. | Press Reconnect in Accounts → Settings → Zoho Books. |
| Zoho Books needs a new permission for this. Reconnect Zoho Books (Accounts → Settings → Zoho Books), then try again. / ...then Retry. | Your connection was made before AirQR asked for this permission (to create a holding account, or to delete its own unsent draft of a cancelled bill). Press Reconnect, accept in Zoho, then try again or press Retry. If it still fails, ask your Zoho Books admin to give your Zoho user access to the chart of accounts. Only that action is refused; the sync carries on. |
| An invoice of this day is still a draft in Zoho Books, waiting for its payment. Press Sync now to finish it, then try again. | You pressed I'll handle this day in Zoho Books while AirQR was still waiting to pay an invoice it had left a draft. Press Sync now; AirQR pays it or marks it sent, and then you can take the day over. |
| Zoho Books already has an account called {name} that can't take payments. Rename it in Zoho Books, then try again. | An account of the holding account's name exists in Zoho as another kind of account. Rename it in Zoho Books, then press Create for me again. |
| Link an outlet to a Zoho organization in Accounts → Settings → Zoho Books. | Choose an organization for at least one outlet. |
| Choose the first day to send in Accounts → Settings → Zoho Books. | Set the Start date and press Save settings. |
Under Needs a look
| What you see | What to do |
|---|---|
| Pick or create the Zoho customer for walk-in guests. / ...for {platform} orders. | In the outlet's Customers mapping, choose a customer or press Create for me. |
| Map the tax class '{name}' to a Zoho item. / Map {name} to a Zoho item, or map the tax class '{class}' to one. | Choose a Zoho item for the class or charge. |
| Map the tax class '{name}' to a Zoho tax. / ...to a Zoho tax for inter-state sales. / ...to a Zoho tax exemption. | Choose the Zoho tax or exemption for the class. |
| Choose the payment mode and the account for {method} payments. | Fill in Payment mode and Deposit to for that method. |
| Add the outlet's GSTIN in Settings → Outlets so the place of supply can be sent. | Add the GSTIN. |
| The invoice number for {date} would be longer than 16 characters. Use a shorter prefix. | Only a connection that sends one summary invoice a day can see this; support can help. A per-bill connection never holds a day for a long number (Zoho numbers that one document). |
| This Zoho organization uses {n} decimal places, but AirQR sends amounts with 2. | Zoho Books must use 2 decimal places for rupees. Ask your accountant. |
| Inter-state sales aren't supported yet. | A bill that day has IGST. Those days aren't sent yet. Tell your accountant. |
| Bill {bill}: no payment is recorded. / the payments don't add up to the bill total. / its item prices can't be read, so its tax can't be split. | Open the bill in AirQR and fix it (Check the bills in GST & accounts), or press Post as calculated to accept the figures. |
| The figures of {date} don't add up (off by {diff}), so it can't be sent. Check its bills in GST & accounts. | Fix the bills. The day can't be posted until its figures agree. |
| The payments to send for {date} ({sent}) don't add up to the invoice total ({total}). | Check the day's bills and payments, or press Post as calculated. |
| Nothing to post: the bills of this day add up to nothing. | Nothing is needed. |
| This bill changed in AirQR after you took it over in Zoho Books. | The bill was taken over, so nothing was posted. Check it in Zoho Books, then press I'll handle this bill in Zoho Books again. |
| This bill is no longer part of AirQR's sales, but its invoice is already in Zoho Books. | The bill was cancelled or changed after its invoice was sent. Check it in Zoho Books. (If only a draft of it was made, AirQR deletes that draft itself and keeps a record.) |
| This bill was cancelled after it was paid. Void it in Zoho Books by hand, then press Retry, or press I'll handle this bill. | The option to send cancelled bills as voided invoices is on, and this bill has a payment or a credit note, or Zoho shows it paid. AirQR never voids a paid invoice. Refund it in AirQR, or void it in Zoho Books, then press Retry; or press I'll handle this bill in Zoho Books. |
| Channel tag couldn't be used: {reason}. Invoices are sent without it. | Zoho refused a document because of the Channel tag. It was sent again without tags. Check the tag in Zoho Books (Settings → Reporting Tags): it must be active and have all its options; or press Create for me again. |
| This payment belongs to an invoice that was voided in Zoho Books, so it was not sent. | A payment that might already be in Zoho was meant for an invoice that has since been voided. AirQR never creates it against the voided invoice. Check it in Zoho Books. |
| Changing the mode would duplicate sales in Zoho. Contact support. | How sales appear can't change after the first send. Write to support@airqr.in if you must. |
| Zoho's total differs from AirQR by {diff}. | The invoice total in Zoho differs from AirQR's by more than a rupee. Check Rounding off in Sales Transactions in Zoho Books and the tax mapping, then press Retry. This line can't be marked as resolved. |
| Zoho's credit note total differs from AirQR's refund by {diff}. | Same checks, for a refund. |
| The number {number} is already used in Zoho Books by another document. Rename or delete that document in Zoho Books, then Retry. | Another Zoho document already has this number (for example an invoice made by hand, or by another app). AirQR never renumbers a bill. Rename or delete that document in Zoho Books, then Retry. |
| Choose the Zoho location for {outlet} in Accounts → Settings → Zoho Books → Edit details. / Choose the Zoho location for an outlet in Accounts → Settings → Zoho Books → Edit details. Nothing is sent for it until then. | Your Zoho organization has more than one location and none is chosen for this outlet. Choose it under Zoho locations in Edit details. |
| This Zoho location isn't in the organization any more. Press Refresh from Zoho. | The chosen location was deleted or made inactive in Zoho. Press Refresh from Zoho and choose another. |
| Bill {old} was reissued as {new}: void {old} in Zoho Books, then press I'll handle this bill. | A bill already in Zoho Books was changed and has a new number. Void the old invoice in Zoho Books, then press I'll handle this bill. (A bill to a business reads "…reissued as {new} for a business…".) |
| The sale of this refund was sent to another Zoho organization ({org}). Record the refund there by hand, then press I'll handle this. | The outlet was moved to another Zoho organization after the sale was sent. Record the refund in the old organization by hand, then press I'll handle this refund. |
| Couldn't send: Zoho Books needs to be reconnected. | Shown once a day in the history while the login is expired. Press Reconnect. |
| Zoho Books refused this: {message} | Fix what Zoho names, then Retry. |
| Zoho Books couldn't find something this refers to: {message} | A customer, item, tax or account was deleted in Zoho. Refresh and map it again, then Retry. |
| Zoho Books didn't answer ({message}). AirQR will try again. | Nothing to do. AirQR retries with growing waits. |
| Zoho Books kept failing: {message}. Press Retry when it works again. | After 8 tries it stops. Press Retry when Zoho is working. |
| This invoice was voided or deleted in Zoho Books. | Someone voided or deleted it in Zoho. Restore it in Zoho Books, press Post again to post the day again, or press I'll handle this day in Zoho Books. |
| This day changed in AirQR after you took it over in Zoho Books: {amount} more/less. | The day was taken over, so nothing was posted. Check it in Zoho Books, then press I'll handle this day in Zoho Books again. |
| Record this refund in Zoho Books yourself: you are handling the day of the sale ({date}) there. | The sale's day is yours in Zoho Books, so its refund is too. Record it there, then press I'll handle this refund in Zoho Books. |
| Changed in Zoho Books; AirQR won't overwrite it. | The invoice was edited in Zoho. Check it there. |
| Zoho Books has {amount} more in {method} payments than AirQR shows for {date}. Fix it in Zoho Books. | Zoho shows more payments than AirQR. Correct them in Zoho Books. |
| Late changes to {date} fall in a month that may already be filed. Choose the date to post them on. | Choose Post on original date or Post today. |
| Zoho Books won't accept entries dated {date} (a locked period). Choose the date to post them on. | The period is locked in Zoho Books. Choose Post today, or ask your accountant to unlock it. |
| The original sale isn't in Zoho Books. | A refund for a bill that was never sent (before the start date, or its day failed). Ask your accountant how to record it. |
| This refund is larger than any single Zoho invoice for this bill. Record it in Zoho Books yourself or contact support. | Zoho refuses a credit note for more than is left to credit on one invoice, and this bill's refund is bigger than each of its invoices (a corrected bill has an original and a /2 invoice). Record the refund in Zoho Books yourself, then press I'll handle this refund in Zoho Books. |
| Credit note {number}: this number is already used in Zoho Books | Another Zoho document already has this GST credit note's number. AirQR never changes the number of a GST credit note, so it is held for you. Change or delete the other document in Zoho Books (or use Zoho's own numbering), then press Retry. |
| Credit note {number} was cancelled in AirQR. Void it in Zoho Books; AirQR doesn't change it. | The GST credit note was cancelled after it had been posted. Void the credit note in Zoho Books by hand, then press I'll handle this refund in Zoho Books. |
| Credit note {number} is outside the GST time limit (30 Nov after the bill's financial year): record the refund in Zoho Books by hand, without GST. | The credit note was issued after the time limit, so it reduces no GST and is not sent. Record the money refund in Zoho Books yourself, without GST, then press I'll handle this refund. |
| Waiting for the Zoho Books invoice of {date}. | The refund waits for its day's invoice. It is sent once that day is synced. |
| Expenses waiting for a Zoho Books account: {n}. Choose an account for each expense category you use, and the account each way of paying comes from, in Accounts → Settings → Zoho Books. | Open Accounts → Settings → Zoho Books → Edit details, and in the outlet's Expenses card choose the Zoho expense account of each category and the Paid from account of each way of paying, then Save mappings. They go on the next sync. |
| Expense: {reason} ({date}) with "Zoho Books refused this: {message}". | Zoho refused the expense (a locked period, a deleted account…). Fix what it names, then Retry. |
| This expense was removed in AirQR after it was sent. Delete it in Zoho Books by hand. / This money-returned entry was removed in AirQR after it was sent. Delete its journal in Zoho Books by hand. | Delete the expense (or the journal) in Zoho Books, then press I've deleted it in Zoho Books. AirQR never deletes in Zoho Books. |
| Purchase {invoice no} from {supplier}: Choose the purchase account for stock purchase bills in Accounts → Settings → Zoho Books. | Choose the Purchase account in Edit details → Stock purchases. |
| Purchase {invoice no} from {supplier}: Zoho has no {rate}% GST tax. Add it in Zoho Books, then Retry. | Add the GST tax group and the IGST tax of that rate in Zoho Books's tax settings, then press Retry. AirQR reads Zoho's taxes again on Retry. |
| Purchase {invoice no} from {supplier}: Zoho Books already has a contact called {name} that isn't a vendor. Rename one of them, then Retry. | A customer (or another contact) in Zoho Books has the supplier's name. Rename it or the supplier, then Retry. |
| Purchase {invoice no} from {supplier}: Totals differ: the bill in Zoho Books is {zoho}, but the purchase is {airqr}. | The bill exists in Zoho Books but its total is not the purchase's, usually a tax setting in Zoho. AirQR never edits a bill: correct it in Zoho Books, then press Mark as resolved. |
| Purchase {invoice no} from {supplier}: This purchase's lines don't add up to its total, so nothing was sent. | The stock-in's own figures disagree. Contact support. |
| Purchase {invoice no} from {supplier}: This purchase was voided in AirQR but its bill is paid in Zoho Books. Record a vendor credit in Zoho Books. | Record a vendor credit in Zoho Books, then press Mark as resolved. Press Retry to check again after you removed the payment there. |
| Purchase {credit note no} from {supplier}: This credit note was voided in AirQR but its vendor credit is applied to a bill in Zoho Books. Remove the application there. | In Zoho Books remove the application of the vendor credit, then press Retry (or Mark as resolved if you dealt with it there). |
| Purchase {credit note no} from {supplier}: Zoho Books needs a new permission for this. Reconnect Zoho Books (Accounts → Settings → Zoho Books), then Retry. | Your connection was made before AirQR sent supplier credit notes. Reconnect once (New permissions), then press Retry. Nothing else is held. |
| Purchase {invoice no} from {supplier}: Changed after it was sent to Zoho Books | The stock-in changed after its bill was sent. The bill is left as it is. Check it in Zoho Books, then press Mark as resolved. |
| Purchase {invoice no} from {supplier}: Zoho {plan} allows {cap} bills and expenses a year and this year's are nearly used. Upgrade your Zoho plan, then press Refresh from Zoho in setup. | Upgrade your Zoho plan, press Refresh from Zoho, then Retry. |
On the AirQR vs Zoho tab of GST & accounts
| What you see | What to do |
|---|---|
| Pick a month or less | Check in Zoho Books reads at most 31 days. Choose a shorter period at the top of the page (the comparison itself works for any period). |
| Zoho Books' daily limit was reached. Checking is available again after {time}. | The check stops at the same daily limit as the sync. Try again after the time shown. |
| Zoho Books needs to be reconnected. / Zoho Books isn't answering. Try again in a few minutes. / Zoho Books asked us to slow down. Try again in a minute. | As for Sync now: reconnect, or try again later. A check that stops partway keeps nothing and changes nothing. |
| Your Zoho user doesn't have permission for this. Ask your Zoho Books admin to give your user access to invoices and credit notes, then try again. | The Zoho user that connected AirQR can't read invoices or credit notes. |
| Unexplained difference. Contact support. | No reason explains this day. Write to support@airqr.in with the outlet and the date. |
In Run history
| What you see | What to do |
|---|---|
| Zoho Books refused the connection. Reconnect it in Accounts → Settings → Zoho Books. | Press Reconnect. The run status says Needs reconnecting. |
| Zoho Books isn't answering. Try again in a few minutes. | Zoho or the network is down. Press Sync now later. |
| Zoho rate limit; continues in a minute | Zoho allows a limited number of requests a minute. The sync carries on by itself. |
| Zoho Books' daily limit was reached. The sync continues tomorrow. / AirQR kept to 80% of Zoho Books' daily limit. The sync continues tomorrow. | See Zoho limits below. Nothing is lost. |
| More to do. Press Continue. | The run ran out of time. Press Continue. |
| Some documents will be sent again later. | Zoho didn't answer for some. A later run sends them. |
| The run was interrupted before it finished. / Another run took over, so this one stopped. | Press Sync now. Whatever was done isn't repeated. |
| The run stopped because of an unexpected problem. It is logged. | Press Sync now again. If it repeats, write to support@airqr.in. |
| Zoho {plan} allows {cap} invoices a year and this year's are nearly used. Upgrade your Zoho plan, then press Refresh from Zoho in setup. | See Zoho's yearly invoice limit. Nothing was posted for that bill or day. After you upgrade your Zoho plan, press Refresh from Zoho in Accounts → Settings → Zoho Books, then Retry. |
Zoho limits
Zoho Books limits how many requests (updates) an organization may make: 100 a minute, and a daily total that depends on your Zoho Books plan. This limit belongs to your Zoho plan; AirQR doesn't charge per update. AirQR counts every request it makes and keeps to about 90 a minute, waiting when the minute is full. It uses at most 80% of your plan's daily limit, so the rest is left for your other apps. When it reaches that point (or Zoho says the limit is reached) the run stops and continues the next day with Stopped at the daily limit; the Zoho Books page shows when syncing is available again.
| Zoho plan | Updates a day | AirQR uses up to |
|---|---|---|
| Free | 1,000 | 800 |
| Standard | 2,000 | 1,600 |
| Professional | 5,000 | 4,000 |
| Premium, Elite, Ultimate | 10,000 | 8,000 |
If AirQR can't read your plan it assumes the smallest allowance and says so.
How many updates a bill takes: one invoice per bill takes 1 per bill (create the invoice), plus 1 for each payment (one per bill and payment method; the payment is also what marks the invoice paid, so a paid bill needs no extra "mark as sent" update), plus 1 for each bill nobody paid (to mark it sent), plus 2 per refund. A typical paid bill is 2 updates. A split bill takes one more update for each extra payment method, and in a few cases (a bill nobody paid, a payment that is held or fails, a late addition to a day already sent) the invoice is marked sent as well, so those bills take three. If Zoho rounds the tax per line instead of once, a bill can take one more update to correct a paisa. AirQR doesn't forecast how many you will need: the guide shows the updates used today against your plan's daily limit, counted as AirQR makes them (by everything using that Zoho organization, not only AirQR).
If you send many past days at once, a first run can take more than one day on a small Zoho plan: choose a start date about a month back.
Zoho's yearly invoice limit
Besides the updates a day, Zoho Books caps how many invoices you can create a year, by plan (India pricing, checked on 26 October 2026). Bills and expenses share the same numbers as a separate cap, which AirQR counts together (see Stock purchases as bills).
| Zoho plan | Invoices a year |
|---|---|
| Free | 1,000 |
| Standard | 5,000 |
| Professional | 10,000 |
| Premium | 25,000 |
| Elite, Ultimate | 1,00,000 |
Because AirQR sends one invoice per bill, a busy outlet uses the yearly limit quickly, so choose your Zoho plan with your bill count in mind: a plan with 5,000 invoices a year covers about 13 bills a day on average. AirQR doesn't forecast this for you. The guide shows what has actually been sent: Invoices this financial year (since {date}): {used} of {cap}, counted from the invoices AirQR has created (refunds are credit notes, which Zoho counts apart from invoices). Invoices you create in Zoho Books yourself also count towards Zoho's limit, but AirQR can't see them.
From 80% of your plan's yearly invoices the guide shows a warning, for example: "You've used 80% of this year's 5,000 invoices on Zoho Standard. Upgrade to Zoho Professional (10,000) or Premium (25,000) before they run out: at 98% AirQR stops sending new invoices." It names the next Zoho plans up, or just says to upgrade your Zoho plan when yours is already the biggest. If AirQR can't read your plan it assumes Free (1,000 a year). Upgrade your Zoho plan in good time.
While syncing, AirQR counts the invoices it has created since your Zoho financial year began. Once 98% of your plan's yearly limit is used, it creates no more: the bill is held under Needs a look with "Zoho {plan} allows {cap} invoices a year and this year's are nearly used. Upgrade your Zoho plan, then press Refresh from Zoho in setup." Upgrade your Zoho plan, press Refresh from Zoho in Accounts → Settings → Zoho Books so AirQR sees the new plan, then Retry. Nothing is lost.
Common questions
- Are my bills in Zoho the tax invoices for guests? No. The bills AirQR prints for your guests remain the GST invoices. The Zoho invoice is a record for your books. Ask your accountant how to treat it.
- Does it send each bill? Yes, every bill is its own Zoho invoice with the bill's number. Watch Zoho's yearly invoice limit for your plan (see Zoho's yearly invoice limit).
- Why does Zoho's tax differ by a few paise? Zoho works out tax per line, AirQR on each bill. For one invoice per bill, AirQR allows for that when it creates the invoice (the difference goes into the Round off adjustment), so the invoice total equals the bill. A difference up to ₹1 that is still left is corrected once, and the Tax difference column shows what remains. A larger gap holds the bill with "Zoho's total differs from AirQR by {diff}."
- Do my expenses go to Zoho Books? Only after you switch Send expenses to Zoho Books on and save expense accounts (see Expenses in Zoho Books). Each expense becomes an expense in Zoho Books and each amount of money returned becomes a journal. GST on expenses is not sent.
- Do my stock purchases go to Zoho Books? Only after you switch Send stock purchases to Zoho Books as bills on under Sync settings and choose the purchase account (see Stock purchases as bills). Each supplier delivery becomes an unpaid bill from that supplier, and you record the payments in Zoho Books.
- Can I change the start date later? Yes. Move it earlier to send older days too. Days already sent aren't touched.
- What if I switch the module off or the plan ends? The sync stops. Nothing already in Zoho Books is deleted, and the connection, mappings and history stay in AirQR.
- How do I stop all sync? Choose Manual only and don't press Sync now, or Disconnect.
For help, write to support@airqr.in. Related: GST reports (its AirQR vs Zoho tab is described in Check your figures against Zoho Books), Tally Prime export, Platform orders, Modules and Plans and billing.
New to AirQR?
Try everything free for 28 days, no card needed. Already a customer? Sign in to follow these steps in your dashboard.
Still stuck? Contact support at support@airqr.in.
Related articles
- Your clients: every business you do the accounts forAn accountant who works for several businesses on AirQR sees all of them on one page, with each GSTIN's return period and dates, whether it is marked filed or overdue, books closed, the last Tally export, and the open problems and credit notes. Each business decides who sees its accounts.
- Accountant tools: Problems, Books closed and GST adjustmentsWhere an accountant sees every problem AirQR found for a GSTIN and month and decides what to do about it, closes the books for a month, adds GST adjustment lines with a reason, and proposes a refund the owner then does. Adjustments never touch a bill and never go to Tally or Zoho Books.
- Accounts for businesses without GSTOutlets with no GSTIN (state VAT only, or not registered) get an Accounts page with their sales, the VAT collected, a short VAT checklist, VAT and sales reports, Tally files without GST ledgers, and a ZIP for the accountant.
- GST credit notes: refund a bill and keep your GST rightEvery money-back on a settled bill makes a numbered GST credit note that prints, reaches Tally and Zoho Books and takes the right GST off your return. How tips, items, split bills, the time limit and Mark as filed work.