Hisaab Docs Support Download

Docs / Move your books

Bring in your old books

Import masters and vouchers from your previous software as a legacy XML export, a CSV file or an Excel sheet.

How-toHisaab 0.6Updated 19 November 2026

Hisaab reads the legacy XML export from your previous software, CSV files and Excel (.xlsx) sheets. You need Accountant or Admin access to import.

Do things in this order#

  1. Create your company and open it.
  2. Import masters first: ledgers, then stock items.
  3. Import vouchers.
  4. Open the Trial Balance and compare the totals with your previous software.

Careful: If a voucher names a ledger, stock item, godown, cost centre or voucher type that is not in the books, Hisaab creates it. A ledger made this way gets a group guessed from its name. Importing masters first keeps your own groups.

Import a file#

  1. Click Import & Export in the sidebar.
  2. Drop the file on the window. It is imported straight away.
  3. If you prefer to type, enter the file's path in the box under Import and click Import.

The status bar reports the result, for example masters.xml: 42 added, 0 already present.

What a legacy XML export brings in#

Record Fields imported
Groups Name and parent. Predefined groups are already present and are skipped
Ledgers Name, group, opening balance, GSTIN, state, bill-wise setting, GST duty head, credit days
Stock items Name, stock group, unit, HSN code, opening quantity, opening value
Vouchers Date, voucher type, number, reference, narration, party, cancelled and optional flags
Voucher ledger lines Ledger, Dr/Cr amount, bill references (name, type, amount), one cost centre, bank date
Voucher item lines Item, quantity, rate, amount, godown, batch, expiry date

If a file uses the reversed Dr/Cr sign convention that some third-party tools write, Hisaab detects and corrects it, and the status bar says "inverted Dr/Cr convention normalised". Vouchers without a valid date are skipped and counted.

What a CSV or Excel sheet brings in#

Hisaab recognises three layouts from the column headings. On Import & Export, beside Blank sheets to fill in, click ledgers, stock items or vouchers to get a blank sheet.

Layout Columns
Ledgers Ledger Name, Under, Opening Balance, Dr/Cr, GSTIN, State, Address, Credit Days, Bill-wise
Stock items Item, Unit, HSN, GST%, Opening Qty, Opening Value, Reorder Level, Stock Group
Vouchers Date, Voucher Type, Voucher No, Party, Narration, Reference, Ledger, Debit, Credit, Cost Centre, Item, Qty, Rate, Godown
  • Columns can be in any order. Unknown columns are ignored.
  • The Bill-wise column, like the bill-wise setting in a legacy XML export, is recorded with the ledger. It does not switch a party to on account. Every imported party is tracked bill by bill until you switch Track bill-by-bill off on its ledger.
  • A voucher takes one row per ledger line. Leave Date, Voucher Type and Voucher No blank on the second and later rows of the same voucher.
  • Every voucher in a sheet must balance.
  • For Excel files, only the first worksheet is read.
  • If any row has a problem, nothing from that sheet is imported. The message lists the problems with their row numbers.

How duplicates are handled#

  • Vouchers from XML are matched by the id your previous software gave them. Vouchers without an id, and all vouchers from sheets, are matched by content: date, type, number, reference, narration and every line.
  • Ledgers, groups and items from XML that already exist by name are left as they are and counted as "already present".
  • Ledgers and items from a sheet that already exist are updated. Only the columns present in the sheet change.

Not imported#

  • Company details such as address, GSTIN and financial year. Enter these on the Company screen.
  • From XML: ledger address, phone, e-mail, bank details and credit limit; the GST rate on stock items; bill due dates; more than one cost centre per line.
  • Users, budgets, price lists, bills of materials, employees and payroll data.

An XML voucher that does not balance is still imported. Open Data Health from All Reports to find such vouchers.

Next#

Something here wrong or missing? Open a ticket and mention this page.

Hisaab is developed and supported by Aware Consultants  ·  About  ·  Support  ·  Privacy