Country and tax
What it's for
Country & tax sets the rules every money document follows: the country pack with its tax codes and withholding (TDS) rules, the locale and fiscal year, exchange rates, how document numbers are built, and your company's own tax IDs. Set it once, before you issue the first booking, receipt or invoice.
Before you start
- You need the finance settings permission (owners, Finance Head).
- A country pack can be applied once the company has an ERP module (for example Pricing).
Apply a country pack
- Tab Country & locale → Choose a country pack: India, Tanzania or Generic (any country). The suggested pack matches your company's country.
- Read the preview: locale, fiscal year start, number format, the tax codes and withholding rules it adds (those you already have are marked Already present), tax ID types and KYC document types.
- Press Apply pack and confirm. Review every value before you use it on a document.
A company uses one pack. To change rates later, edit its tax codes and rules instead of applying another pack.
Locale and fiscal year
Choose the Locale (number and date format) and Fiscal year starts in, then Save. The fiscal year groups document numbers and yearly reports, so it cannot change once a document number has been issued. Base currency is shown for reference.
Tax codes
- Add tax code: Code, Name, Rate, Components (for example CGST and SGST halves), Inclusive or not, and Effective from.
- Edit works while the code is unused. Once a document uses it, it is Locked.
- To change a locked code, use End & replace: the old version ends and a new version starts from the date you choose. Old documents keep the old rate.
- Switch off / Switch on stops or allows its use on new documents.
Withholding rules
Add rule: name, Section (for example 194C), Applies to, Rate, Threshold and Starts. Rules follow the same Edit, End & replace and switch on / off steps as tax codes.
Exchange rates
Enter From and To currency, the rate and the Date, then Save rate. The list shows each pair's latest rate and its source. Convert checks an amount at the saved rate.
Document numbering
- Add series: the Document (booking, receipt, invoice…), Project or Whole company, the Pattern, when it Starts again at 1, the next number and Active.
- Pattern tokens:
{PROJECT}, {FY}, {YYYY}, {YY}, {MM}, {SEQ:5} (a 5-digit running number). Example: {PROJECT}/BK/{FY}/{SEQ:5}.
- Once numbers were issued from a series it is Locked: only switching it on or off is possible.
Numbers never get shorter: after 99999 comes 100000.
Company tax IDs
Enter your company's own registrations (for example GSTIN, PAN, TAN or TIN). They print on documents.
What happens automatically
Every finance change is written to the activity log and listed under Recent finance changes.
Tips and common questions
- Why can't I change the fiscal year? A document number has already been issued.
- Why is Edit missing on a tax code? It is locked because a document used it; use End & replace.
Related: Ledger · All contacts