Taxes - GST Ledger - HisabKitab

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

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 - GST 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

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

opening_balance_details

object

optional

opening_balance

number

optional

The starting financial balance for the ledger.

opening_balance_dr_cr

integer

optional

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

Example

{
    "action": "Taxes - GST",
    "name": "Jitsadsdu Patel",
    "group_id": "13",
    "tax_type": "1",
    "rounding_method": "2",
    "opening_balance_details": {
        "opening_balance": 100000,
        "opening_balance_dr_cr": 1
    }
}

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 - GST",
    "name": "Jitsadsdu Patel",
    "group_id": "13",
    "tax_type": "1",
    "rounding_method": "2",
    "opening_balance_details": {
        "opening_balance": 100000,
        "opening_balance_dr_cr": 1
    }
}'

Responses

🟢200Taxes - GST 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 - GST group.It should be retrieved from the List of Ledger Groups API.

model_type

string

required

Defines the type of model the ledger belongs to.

model_id

integer

required

The identifier linking the ledger 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": 12,
        "name": "Jitsadsdu Patel",
        "group_id": "12",
        "model_type": "App\\Models\\Master\\TaxesGst",
        "model_id": 12,
        "company_id": 1,
        "ledgers_data": {
            "TaxesGst": {
                "tax_type": "1",
                "rounding_method": "2",
                "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-04T13:12:28.000000Z",
        "updated_at": "2025-04-04T13:12:28.000000Z",
        "flag": "addless"
    },
    "success": true,
    "message": "Taxes - GST Created Successfully."
}