Data imports and connected books
How client data gets into the app (uploads, bulk zips, the Tally connector, Zoho Books, Busy exports), how it is checked and published as datasets, and how the firm's billing goes back out to Tally.
Everything the app knows about a client's returns and books comes in through Data imports
(/imports) or Connected books (/books). Each source is read, checked and, when it passes,
published as a dataset: a versioned, read-only copy that reconciliation, GST annual work, TDS
and other modules use. The app never writes into a client's books or a portal.
Ways data comes in
| Source | Where | Read more |
|---|---|---|
| A file you upload for one client (GSTR-2B, GSTR-1, GSTR-3B, IMS, registers, bank statements, AIS, TIS, Form 26AS, Tally Day Book) | Data imports, client page | Upload a client's return, register or statement |
| One zip with many clients' portal files | Data imports, Bulk upload | Upload many clients' portal files in one zip |
| Tally, read on a schedule by the connector on the firm's computer | Data imports, Tally connector | Read Tally books with the connector |
| A client's Zoho Books, read with the client's consent | Connected books | Connect a client's Zoho Books |
| Busy's own export files, uploaded or picked up from a folder | Connected books, Busy books | Import a client's Busy books |
Which file kinds your firm can upload, and the switches that turn some of them on, are listed in File kinds the importer reads.
What happens to a file
Steps
- Virus check. Nothing is opened before the malware scan passes.
- Recognise the format. The app picks a reader from the content, or uses the kind you chose.
- Read and check. Every row is checked (identifiers, dates, tax heads, totals). Problems are listed as errors, warnings or information, each pointing at the row or field.
- Publish. A file without errors is published as a new version of the dataset. A register with a few bad rows can be published partly, if you accept the valid rows.
Aadhaar numbers are masked before anything is stored, and passwords given for protected PDFs are used once and discarded. See Datasets, versions and the original file for versions, withdrawing and the original file.
Books going out
Export to books builds a Tally import file of the firm's own billing, which you import into the firm's Tally yourself: Export the firm's billing to Tally (sign in to read).
Settings and switches
Firm settings for connected books are in Settings for connected books and the books export (sign in to read). Some sources are switched on per firm while they are rolled out: bulk upload, the Tally connector, bank statements, AIS PDFs and JSON, trial balances, GSTR-1A, GSTR-9, and the e-invoice and e-way bill registers. A page whose source is off for your firm says so.
When something goes wrong
Each problem has its own help article, reached from the message. The most common are The file’s format could not be recognised (sign in to read), The GSTIN in the file is not one of this client’s GSTINs (sign in to read), The file is password-protected (sign in to read) and The client’s consent is required before its books are read (sign in to read). Documents the app builds for you (letters, certificates, packs) have their own problems: Documents the app builds, packs and signs.
Last reviewed 27 October 2026