This project aims to integrate the ClearTax portal's APIs with the ERPNext solution. The user can directly generate e-invoices, IRNs, and E-way bills and cancel them from within ERPNext.
It works on top of ERPNext and the Frappe Framework - incredible FOSS projects built and maintained by the incredible folks at Frappe. Go check these out if you haven't already!
- E-invoicing (Generation/Cancellation)
- E-Way Bills (Generation/Cancellation/Updation)
- GST Invoices (Generation)
- Credit/Debit Notes
- Export Invoices
- Cleartax Account ( Only for Enterprise Users)
- Erpnext(v13 & above)
- Frappe (v13 & above)
Once you've set up a Frappe site, installing India Compliance is simple:
- Download the app using the Bench CLI
bench get-app https://github.com/8848digital/GST-India.git
- Install the app on your site
bench --site [site name] install-app india_compliance
-
Enterprise Users
- Go to Cleartax Settings
- Check the Enterprise checkbox
- Under Enterprise Details, enter the auth tokens, GSTINs and their corresponding tax entity IDs
-
SMB Users
- Go to Cleartax Settings
- Uncheck the Enterprise checkbox
-
Common Setup Instructions
- Click the Enable checkbox to enable all features.
- Check the Sandbox checkbox for testing and uncheck it for production mode.
- Check the Automate checkbox if you want automatic generation of IRNs and EWBs on submit of documents.
-
You can generate IRNs for a Sales Invoice(submitted) by clicking Create -> IRN
-
You can see the IRN details in the E-Invoicing section in the More Info tab.
-
If there are issues with the document, a popup will display the errors.
-
You can also check the errors from Cleartax Api Log List
-
After generating IRN, now you can generate EWB by IRN.
-
In order to generate EWB,
- The Sales Invoice must be generated from a Delivery Note
- (OR) A Delivery Note must be generated from the Sales Invoice
- (OR) Transporter Details must be created from the Sales Invoice.
-
To generate EWB, click Create -> EWB
-
EWB details will be in the Ewaybill section in the More Info tab
-
You can cancel EWB and IRN from Cancel EWb and Cancel IRN Buttons at the top.
-
You can also generate EWb from a Delivery Note. i.e. EWB Without IRN
-
In Delivery Note, you can enter the vehicle details, and update with the cleartax Portal.
-
This can be done using the Update Part B Button.
-
You can also generate IRN for a Credit Note(same as Sales Invoice)
- You Can Generate GST Invoice for the Following Documents
- Sales Invoice
- Purchase Invoice
- Credit Note
- Debit Note
- To Generate GST Invoice, the billing company must be removed from E-Invoicing list in cleartax Settings
- Click on Create -> GST Invoice
- Incase anything goes wrong when generating an IRN/EWB/GST Invoice, you can look into the error logs and resolve the data.
- To Check Error logs, go to Cleartax Api Log List.
- You can filter the log by Document ID and API TYPE(i.e. IRN,EWB etc)
- You can generate IRN and EWB in bulk from Sales Invoice List and Delivery Note List.
- Select the documents, then click on Action -> IRN/EWB.
We have created 3 dashboards
- E-Invoicing
- EWB (IRN - Sales Invoice)
- EWB (Delivery Note)
You can get the count of generated, pending, failed, cancelled and also a monthly chart in these dashboards.