Learn how to implement TallyPrime POST API to Integrate Third-party applications with TallyPrime

TallyPrime POST API Integration mainly requires 2 parties as below;

1. Third-party Software Developer who can implement POST API to send data
2. TallyPrime User who can implement Tally Plugin/TCP to import data

Quick Integration Steps

Basically our TallyPrime POST API Integration works in 3 simple steps as explained below;

Step 1: Implement our TallyPrime API POST URL + Headers + JSON Body in your application from where you would like to send the data

Step 2: Load our .TCP file and TallyPrime-API-Sync.exe in your TallyPrime in which you would like to received the data

Step 3: Either you define schedule to import data automatically or sync data on-demand as and when required

That’s it, by implementing TallyPrime API data from third-party applications and ERP’s will be imported seamlessly.

In this section you will get step by step understanding of how to implement TallyPrime API

Steps to be performed by Third-party Developers

Signup/Create API Account

Visit our website https://api2books.com and create your free trial account

Dashboard

Once you are done with the signup, login to your account and you will be redirected to your Dashboard area where you will find POST API’s for all Tally Masters and Voucher type

Generate POST API Auth Key’s

Click on View API Key option to get your unique Test Key and Live Key as shown in below snapshot.

Test Key :

You can use Test Key to perform tests by sending data from your application to TallyPrime. In Test Key you are allowed to send upto 450 records after which you will get the response message as “Your Free Limit is Exceeded”

Live Key :

Using live key you can send unlimited data from your application to TallyPrime. Validity of the Live key is subject to the subscription you have opted

URL, Headers & Body

Third-party software developers can now click on view API Code for any template that you wish to integrate in your application/ERP.

On the next screen you will get complete details of;

• POST API URL on which you need to send the data
• Header
• JSON Body

• X-Auth-Key : This will be your Test or Live Key as explained in above section
• Template-Key : This will be the template key belongs to each template type. This identifies the type of data you are sending to TallyPrime whether it is sales, purchase, receipt, payment, etc
• CompanyName : This will be the Company Name that have been assigned in Tally API Settings. It helps to sync data with right company, if you make mistake here your data will be not imported to the TallyPrime

• AddAutoMaster : Use “1” if you want to auto generate the masters along with the data you have sent or Use “0” if you have already created required masters in Tally and want to just send the vouchers. For example, you want to auto generate customer masters, item masters, voucher type etc then set “1”
• Automasterids : If you wish to auto generate the masters along with data then you need to specify which type of master to be auto generated from 1 to 9. Each templates are having more or less ID’s depending upon it’s nature. We have already given list of ID’s and it’s purpose for each templates as shown below;

• Version : Depending upon the Tally version you are using, you will have to define “1” or “3”, here “1” belongs to any Tally version lower then TallyPrime Rel 3.x and “3” belongs to Tally version higher then TallyPrime Rel 3x

• Body
  • Body contains your actual data that you wish to import in Tally. Each templates are having it’s different body structure. It is important for you to follow the body fields and it’s value carefully to avoid errors while sending data to API server.
  • Fields highlighted in the red are compulsory and can not be left blank where as fields in green are optional and you can left them blank

API Testing via POSTMAN

We recommend you use Postman application to perform your testing to check the end to end data flow.

Headers

Body & Response

Above example indicates, 3 records are submitted successfully to the TallyPrime API server and is now ready to import in TallyPrime Data.

Steps to be performed by TallyPrime User

Follow the steps below to be configured TallyPrime POST API Plugin to begin importing the data from POST API Server;

Download TallyPrime API Plugin

Download TallyPrime Plugin from your Dashboard.

Configure TallyPrime API Plugin

Copy .TCP file as per your TallyPrime Version and TallyPrime-API-Sync.exe files in your TallyPrime folder

Open TallyPrime > Press F1: Help > TDLs & Add-ons > Press F4: Manage Local TDLs to load the TallyPrimeAPI.tcp file and Press F6: Add-on Features to Activate the API Module as shown in below snapshots;

Once you activate the module, you will find new menu on Gateway of Tally under utilities as TallyPrime API

POST API Settings in TallyPrime

Go to POST API Settings and paste the Test or Live Auth Key you got from the Dashboard as explained in above section and Company Name or Short Name that will be used by your Third-party software developer

Sync Data with POST API Server

Go to API Template to sync data manually from the POST API Server;

As soon as you hit enter on any of these templates, it will start syncing data with API server. It is recommended to check the error log after each import to check whether any errors encountered or not during data import, check Tally.imp file found under the TallyPrime folder.

If you notice any errors in the Tally.imp then you are advised to take help from your accounts team to understand the error and get it resolved for the error free import of current or future data.

Data Import Settings & Error Handling

Make sure your default data import directory is set as TallyPrime directory only and behavior of Import is set as “Record Exception and Import”

Data Import Log

Do check the Tally data import log file to see the details of each records imported and not imported with possible error reasons.

This import log file can be found under TallyPrime application directory named as “Tally.IMP” file. Open it in Notepad and always check latest import log details at the end of the file.

POST API Events Log

This will display POST API data import log

API Data Import Schedule

Use schedule option if you wish to auto import the data via third-party application without any user intervention or manual data import tasks.