Loan and Advance (Asset) 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 Loan and Advance (Asset), this value should be "Loan and Advance (Asset)".

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 Loan and Advance (Asset) group.It should be retrieved from the List of Ledger Groups API.

address

object

required

address_1

string

optional

Primary address line (e.g., office or building name).

address_2

string

optional

Secondary address line, often for road or area name.

country_id

integer

required

Reference ID for the country. it get from Country API.

state_id

integer

required

Reference ID for the state of the selected country. it get from State API.

city_id

integer

optional

Reference ID for the city of the selected state. it get from City API.

pin_code

string

optional

Postal code of the address.

contact_details

object

optional

contact_person_name

string

optional

Name of the primary contact person for this ledger.

contact_person_email

string

optional

Email address of the ledger contact person.

region_iso_1

string

optional

ISO country code (e.g., "in" for India) for primary and secondary contact numbers.

region_code_1

integer

optional

Country dialing code (e.g., "91" for India) for the respective contact numbers.

contact_person_phone_1

string

optional

Primary phone numbers of the contact person.

region_iso_2

string

optional

ISO country code (e.g., "in" for India) for primary and secondary contact numbers.

region_code_2

integer

optional

Country dialing code (e.g., "91" for India) for the respective contact numbers.

contact_person_phone_2

string

optional

Alternate phone numbers of the contact person.

contact_person_website

string

optional

ledger website URL, if applicable.

tax_details

object

optional

pan

string

optional

PAN (Permanent Account Number) of the ledger for tax reporting.

type_of_entity

integer

optional

Indicates the legal structure of the supplier, such as Proprietorship, Partnership, LLP, Company, Trust, or other recognized entity types. To get these use ledger detail api.

opening_balance_details

object

optional

opening_balance_dr_cr

integer

optional

Initial balance amount to be recorded at ledger creation.

opening_balance

number

optional

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

Example

{
    "action": "Loan and Advance (Asset)",
    "name": "Loan and Advance Ledger",
    "group_id": "10",
    "address": {
        "address_1": "billiing, Ward No. 38, P.C. No. 106A, RIS-Raipur",
        "address_2": "test",
        "country_id": "1",
        "state_id": "3",
        "city_id": "2",
        "pin_code": "492001"
    },
    "contact_details": {
        "contact_person_name": "test",
        "contact_person_email": "test@gmail.com",
        "region_iso_1": "in",
        "region_code_1": 91,
        "contact_person_phone_1": "",
        "region_iso_2": "in",
        "region_code_2": 91,
        "contact_person_phone_2": "",
        "contact_person_website": ""
    },
    "tax_details": {
        "pan": "AAOFJ9779K",
        "type_of_entity": "5"
    },
    "opening_balance_details": {
        "opening_balance_dr_cr": 1,
        "opening_balance": 100
    }
}

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": "Loan and Advance (Asset)",
    "name": "Loan and Advance Ledger",
    "group_id": "10",
    "address": {
        "address_1": "billiing, Ward No. 38, P.C. No. 106A, RIS-Raipur",
        "address_2": "test",
        "country_id": "1",
        "state_id": "3",
        "city_id": "2",
        "pin_code": "492001"
    },
    "contact_details": {
        "contact_person_name": "test",
        "contact_person_email": "test@gmail.com",
        "region_iso_1": "in",
        "region_code_1": 91,
        "contact_person_phone_1": "",
        "region_iso_2": "in",
        "region_code_2": 91,
        "contact_person_phone_2": "",
        "contact_person_website": ""
    },
    "tax_details": {
        "pan": "AAOFJ9779K",
        "type_of_entity": "5"
    },
    "opening_balance_details": {
        "opening_balance_dr_cr": 1,
        "opening_balance": 100
    }
}'

Responses

🟢200Loan and Advance (Asset) 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 Loan and Advance (Asset) 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 last modified or updated 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": 10,
        "name": "Loan and Advance Ledger",
        "group_id": "10",
        "model_type": "App\\Models\\Master\\LoanAndAdvanceAsset",
        "model_id": 10,
        "company_id": 1,
        "ledgers_data": {
            "LoanAndAdvanceAsset": {
                "person_name": "test",
                "person_email": "test@gmail.com",
                "phone_1": null,
                "phone_2": null,
                "website": null,
                "pan_card_number": "AAOFJ9779K",
                "entity_type": "5",
                "tan": null,
                "cin_number": null,
                "rate_of_interest": null,
                "reference": null,
                "reference_name": null,
                "reference_address": null,
                "reference_contact_details": null,
                "opening_balance": null,
                "opening_balance_dr_cr": null,
                "billing_address_address_1": "billiing, Ward No. 38, P.C. No. 106A, RIS-Raipur",
                "billing_address_address_2": "test",
                "billing_address_country_id": 1,
                "billing_address_state_id": 3,
                "billing_address_city_id": 2,
                "billing_address_pin_code": "492001"
            }
        },
        "opening_balance": null,
        "opening_balance_dr_cr": null,
        "via_api": 2,
        "is_import": false,
        "created_at": "2025-04-04T13:04:55.000000Z",
        "updated_at": "2025-04-04T13:04:55.000000Z",
        "flag": "addless"
    },
    "success": true,
    "message": "Loan and Advance (Asset) Created Successfully."
}