TCS 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 Taxes - TCS, this value should be "Taxes - TCS".

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 Taxes - TCS 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

number

optional

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

for_other

number

optional

Specifies the TCS 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 TCS 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.

calculated_on

integer

optional

This field defines inter number of calculation on method like 1(Taxable Value) & 2(Invoice Value).

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 TCS applicability. TCS will only be deducted if total payments to a party in a financial year exceed this amount.

opening_balance_details

object

optional

opening_balance

number

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": "Taxes - TCS",
    "name": "TCS Receivable",
    "group_id": 21,
    "tax_type": 2,
    "individual_huf": 0.1,
    "for_other": 0.1,
    "pan_not_given": 1,
    "calculated_on": 2,
    "individual_bill_wise": 0,
    "yearly_total": 50000,
    "rounding_method": 1,
    "opening_balance_details": {
        "opening_balance": "500000",
        "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": "Taxes - TCS",
    "name": "TCS Receivable",
    "group_id": 21,
    "tax_type": 2,
    "individual_huf": 0.1,
    "for_other": 0.1,
    "pan_not_given": 1,
    "calculated_on": 2,
    "individual_bill_wise": 0,
    "yearly_total": 50000,
    "rounding_method": 1,
    "opening_balance_details": {
        "opening_balance": "500000",
        "opening_balance_dr_cr": 2
    }
}'

Responses

🟢200TCS 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 Taxes - TCS 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": 21,
        "name": "TCS Receivable",
        "group_id": 21,
        "model_type": "App\\Models\\Master\\TaxesTcs",
        "model_id": 21,
        "company_id": 1,
        "ledgers_data": {
            "TCSReceivable": {
                "tax_type": 2,
                "individual_huf": 0.1,
                "for_other": 0.1,
                "pan_not_given": 1,
                "individual_bill_wise": 0,
                "yearly_total": 50000,
                "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:11:44.000000Z",
        "updated_at": "2025-04-05T05:11:44.000000Z",
        "flag": "tcs"
    },
    "success": true,
    "message": "Taxes - TCS Created Successfully."
}