TDS Receivable Ledger

Request

Authorization

Add parameter in header

ApiKey

Example:

ApiKey: ********************

Body Params application/json

action

string

required

Specifies the type of ledger being created. For TDS Receivable, this value should be "TDS Receivable".

name

string

required

This field specifies the name of the ledger.

group_id

integer

required

The unique identifier of the ledger group under which this ledger will be created here is TDS Receivable group.It should be retrieved from the List of Ledger Groups API.

tax_type

integer

required

This field defines the category of GST applicable to a particular transaction. It can represent one of several predefined types To get these use ledger detail api.

rounding_method

integer

required

This field specifies ID to how numerical values, such as totals or tax amounts, should be rounded during calculations.

individual_huf

integer

optional

TDS percentage rate applicable to Individuals or Hindu Undivided Families (HUF). Set as 10.

for_other

integer

optional

Specifies the TDS rate—for entities other than individuals or HUFs, such as companies, firms, or associations. This ensures correct deduction based on the deductee type.

pan_not_given

integer

optional

This is the default higher TDS rate—applied when the deductee does not provide a valid PAN. As per government rules, a higher rate must be charged in such scenarios to ensure compliance.

individual_bill_wise

integer

optional

Indicates that applies specifically to individual payments when calculated bill-wise, rather than on a cumulative yearly basis. This allows different rates for bill-level deductions when needed.

yearly_total

number

optional

This defines the annual threshold amount (e.g., 5000) for TDS applicability. TDS will only be deducted if total payments to a party in a financial year exceed this amount.

opening_balance_details

object

optional

opening_balance

string

optional

Initial balance amount to be recorded at ledger creation.

opening_balance_dr_cr

integer

optional

Indicates whether the opening balance is a debit (1) or credit (2) entry.

Example

{
    "action": "TDS Receivable",
    "name": "TDS Redeivable",
    "group_id": 20,
    "tax_type": 1,
    "individual_huf": 10,
    "for_other": 10,
    "pan_not_given": 20,
    "individual_bill_wise": 0,
    "yearly_total": "",
    "rounding_method": 1,
    "opening_balance_details": {
        "opening_balance": "",
        "opening_balance_dr_cr": 2
    }
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://app.hisabkitab.co/third-party/ledgers' \
--header 'Content-Type: application/json' \
--header 'ApiKey;' \
--data-raw '{
    "action": "TDS Receivable",
    "name": "TDS Redeivable",
    "group_id": 20,
    "tax_type": 1,
    "individual_huf": 10,
    "for_other": 10,
    "pan_not_given": 20,
    "individual_bill_wise": 0,
    "yearly_total": "",
    "rounding_method": 1,
    "opening_balance_details": {
        "opening_balance": "",
        "opening_balance_dr_cr": 2
    }
}'

Responses

🟢200TDS Receivable Ledger

application/json

Body

data

object

required

id

integer

required

A unique identifier for the ledger.

name

string

required

This field specifies the name of the ledger.

group_id

integer

required

The unique identifier of the ledger group under which this ledger will be created here is TDS Receivable group.It should be retrieved from the List of Ledger Groups API.

model_type

string

required

Defines the type of model the bank belongs to.

model_id

integer

required

The identifier linking the bank to a specific data model.

company_id

integer

required

The ID of the company associated with the ledger.

ledgers_data

object

required

opening_balance

number

required

Initial balance amount to be recorded at ledger creation.

opening_balance_dr_cr

integer

required

Indicates whether the opening balance is a debit (1) or credit (2) entry.

via_api

integer

required

is_import

boolean

required

created_at

string

required

The date and time indicating when the record was initially created in the system.

updated_at

string

required

The date and time indicating when the record was last modified or updated in the system.

flag

string

required

success

boolean

required

message

string

required

Example

{
    "data": {
        "id": 20,
        "name": "TDS Redeivable",
        "group_id": 20,
        "model_type": "App\\Models\\Master\\TdsReceivable",
        "model_id": 20,
        "company_id": 1,
        "ledgers_data": {
            "TDSReceivable": {
                "tax_type": 1,
                "individual_huf": 10,
                "for_other": 10,
                "pan_not_given": 20,
                "individual_bill_wise": 0,
                "yearly_total": null,
                "rounding_method": 1,
                "opening_balance": null,
                "opening_balance_dr_cr": null
            }
        },
        "opening_balance": null,
        "opening_balance_dr_cr": null,
        "via_api": 2,
        "is_import": false,
        "created_at": "2025-04-05T05:05:08.000000Z",
        "updated_at": "2025-04-05T05:05:08.000000Z",
        "flag": "tds"
    },
    "success": true,
    "message": "TDS Receivable Created Successfully."
}