Cleartax Integration

Introduction

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!

Key Features

• E-invoicing (Generation/Cancellation)
• E-Way Bills (Generation/Cancellation/Updation)
• GST Invoices (Generation)
• Credit/Debit Notes
• Export Invoices

Prerequisites

• ClearTax Account ( Only for Enterprise Users)
• Erpnext(v13)
• Frappe (v13)

Installation

Once you've set up a Frappe site, installing Cleartax Integration is simple:

1. Download the app using the Bench CLI

   bench get-app https://github.com/8848digital/cleartax-v13
   

2. Install the app on your site

   bench --site [site name] install-app cleartax_integration
   

Setup Instructions

1. Enterprise Users

   1. Go to ClearTax Settings

      

   2. Check the Enterprise checkbox

      

   3. Under Enterprise Details, enter the auth tokens, GSTINs and their corresponding tax entity IDs

      

2. SMB Users

   1. Go to Cleartax Settings

      

      2. Uncheck the Enterprise checkbox

      

3. Common Setup Instructions

   1. Click the Enable checkbox to enable all features.

      

   2. Check the Sandbox checkbox for testing and uncheck it for production mode.

      

   3. Check the Automate checkbox if you want automatic generation of IRNs and EWBs on submit of documents.

      

   4. Select the companies that require E- Invoicing here

      

   5. Let the Host Site have the default value unless asked to change by the organization.

Functionalities

E-Invoicing

1. You can generate IRNs for a Sales Invoice(submitted) by clicking Create -> IRN

   

2. You can see the IRN details in the E-Invoicing section in the More Info tab.

   

3. If there are issues with the document, a popup will display the errors.

4. You can also check the errors from Cleartax Api Log List
5. After generating IRN, now you can generate EWB by IRN.
6. In order to generate EWB,
   1. The Sales Invoice must be generated from a Delivery Note
   2. (OR) A Delivery Note must be generated from the Sales Invoice
   3. (OR) Transporter Details must be created from the Sales Invoice.
7. To generate EWB, click Create -> EWB
8. EWB details will be in the Ewaybill section in the More Info tab
9. You can cancel EWB and IRN from Cancel EWb and Cancel IRN Buttons at the top.
10. You can also generate EWb from a Delivery Note. i.e. EWB Without IRN
11. In Delivery Note, you can enter the vehicle details, and update with the cleartax Portal.
12. This can be done using the Update Part B Button.
13. You can also generate IRN for a Credit Note(same as Sales Invoice)

GST Invoice

1. You Can Generate GST Invoice for the Following Documents
   1. Sales Invoice
   2. Purchase Invoice
   3. Credit Note
   4. Debit Note
2. To Generate GST Invoice, the billing company must be removed from E-Invoicing list in cleartax Settings
3. Click on Create -> GST Invoice

Error Log

1. Incase anything goes wrong when generating an IRN/EWB/GST Invoice, you can look into the error logs and resolve the data.
2. To Check Error logs, go to Cleartax Api Log List.
3. You can filter the log by Document ID and API TYPE(i.e. IRN,EWB etc)

Bulk Generation

1. You can generate IRN and EWB in bulk from Sales Invoice List and Delivery Note List.
2. Select the documents, then click on Action -> IRN/EWB.

Dashboards

We have created 3 dashboards 1. E-Invoicing 2. EWB (IRN - Sales Invoice) 3. EWB (Delivery Note)

You can get the count of generated, pending, failed, cancelled and also a monthly chart in these dashboards.