Create Journal

Request

Authorization

Add parameter in header

ApiKey

Example:

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

Body Params multipart/form-data

voucher_number

string

required

The voucher number is a unique identifier assigned to the journal transaction. get it from Next Invoice Number.

Example:

6

date

string

required

This field represents the date on which the journal transaction is recorded, formatted as DD-MM-YYYY.

Example:

13-02-2025

debit_credit_type[]

array[string]

required

This field indicates whether the ledger transaction is a debit (1) or credit (2). Debit transactions generally represent expenses or asset additions, while credit transactions signify revenue or liability increases.

Example:

["1","2"]

ledger_id[]

array[string]

required

The ledger ID refers to the unique identifier assigned to each account involved in the transaction.

Example:

["2702","25718"]

amount[]

array[string]

required

The amount[] field represents the value assigned by the user for each ledger in the transaction. It ensures that the total debit and credit amounts remain balanced(same).

Example:

["1500","1500"]

debit_total

number

optional

The total debit amount represents the sum of all debit transactions recorded in the journal entry.

Example:

85000.00

credit_total

number

optional

This field holds the total amount of credits in the journal entry, ensuring that it matches the corresponding debits.

Example:

85000.00

is_manage_debit_transaction

boolean

optional

A flag that indicates whether the system should automatically allocate debits to invoices.

Example:

1

debit_ledger_id[2702][]

array[string]

optional

This debit_ledger_id[ledger_id][] specifies the ledger ID associated with each debit transaction. It ensures that the transaction is correctly linked to the appropriate account in the financial system.

Example:

["2702","2702"]

debit_transaction_id[2702][]

array[string]

optional

The transaction ID (debit_transaction_id[ledger_id][]) represents a unique identifier for each debit transaction.

Example:

["890","7503"]

debit_invoice_number[2702][]

array[string]

optional

This debit_invoice_number[ledger_id][] field contains the invoice number associated with a debit transaction.

Example:

["6","16"]

debit_bill_type[2702][]

array[string]

optional

The bill type determines the nature of the debit transaction, such as purchase invoices, expense notes, or other financial documents.

Example:

["1","1"]

debit_paid_amount[2702][]

array[string]

optional

This field represents the amount debited for a specific invoice. It is the portion of the total payable amount that has been settled.

Example:

["785.00","10642.00"]

debit_discount_amount[2702][]

array[string]

optional

If any discount is applied to a debit transaction, it is recorded in this field.

Example:

["0","0"]

debit_rounding_amount[2702][]

array[string]

optional

This field accounts for rounding adjustments applied to a debit transaction. Minor rounding differences occur due to currency conversions or decimal approximations.

Example:

["0","0"]

narration

string

optional

The field is used to provide a brief description of the journal transaction.

Example:

0

is_manage_credit_transaction[25718][]

array[string]

optional

This flag determines whether the system should auto-manage credit transactions.

Example:

1

credit_ledger_id[25718][]

array[string]

optional

The credit ledger ID (credit_ledger_id[ledger_id][]) represents the account that will receive the credit entry.

Example:

25718

credit_transaction_id[25718][]

array[string]

optional

A unique identifier assigned to each credit transaction.

Example:

12418

credit_invoice_number[25718][]

array[string]

optional

This field contains the invoice number linked to the credit transaction.

Example:

14

credit_bill_type[25718][]

array[string]

optional

This field specifies the type of bill that is being settled in the transaction. It helps categorize the financial entry based on its nature, such as sale, purchase return, payment, debit note, or credit note.

Example:

1

credit_received_amount[25718][]

array[string]

optional

The amount credited to an invoice as part of the transaction. It represents the portion of the total receivable amount that has been collected.

Example:

505.00

credit_discount_amount[25718][]

array[string]

optional

Any discount applied to the credit transaction is recorded in this field.

Example:

0

credit_rounding_amount[25718][]

array[string]

optional

This field stores any rounding adjustments applied to the credit transaction.

Example:

0

upload_journal_invoice

file

optional

The upload journal invoice process allows users to attach invoices related to a journal transaction.

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/journal-transactions' \
--header 'ApiKey;' \
--form 'voucher_number="6"' \
--form 'date="13-02-2025"' \
--form 'debit_credit_type[]="1"' \
--form 'debit_credit_type[]="2"' \
--form 'ledger_id[]="2702"' \
--form 'ledger_id[]="25718"' \
--form 'amount[]="1500"' \
--form 'amount[]="1500"' \
--form 'debit_total="85000.00"' \
--form 'credit_total="85000.00"' \
--form 'is_manage_debit_transaction="1"' \
--form 'debit_ledger_id[2702][]="2702"' \
--form 'debit_ledger_id[2702][]="2702"' \
--form 'debit_transaction_id[2702][]="890"' \
--form 'debit_transaction_id[2702][]="7503"' \
--form 'debit_invoice_number[2702][]="6"' \
--form 'debit_invoice_number[2702][]="16"' \
--form 'debit_bill_type[2702][]="1"' \
--form 'debit_bill_type[2702][]="1"' \
--form 'debit_paid_amount[2702][]="785.00"' \
--form 'debit_paid_amount[2702][]="10642.00"' \
--form 'debit_discount_amount[2702][]="0"' \
--form 'debit_discount_amount[2702][]="0"' \
--form 'debit_rounding_amount[2702][]="0"' \
--form 'debit_rounding_amount[2702][]="0"' \
--form 'narration="0"' \
--form 'is_manage_credit_transaction[25718][]="1"' \
--form 'credit_ledger_id[25718][]="25718"' \
--form 'credit_transaction_id[25718][]="12418"' \
--form 'credit_invoice_number[25718][]="14"' \
--form 'credit_bill_type[25718][]="1"' \
--form 'credit_received_amount[25718][]="505.00"' \
--form 'credit_discount_amount[25718][]="0"' \
--form 'credit_rounding_amount[25718][]="0"' \
--form 'upload_journal_invoice=@""'

Responses

🟢200Create Journal

application/json

Body

data

object

required

id

integer

required

A unique identifier for the journal transaction.

company_id

integer

required

The ID of the company making the journal transaction associates with specific business entities.

voucher_number

string

required

A sequential number assigned to the journal transaction.

date

string

required

The date on which the journal transaction was recorded.

debit_total

number

required

The total amount debited across all accounts in this journal transaction.

credit_total

number

required

The total amount credited across all accounts in this journal transaction. The debit and credit totals must be equal to maintain accounting balance.

narration

string

required

A brief description or note about the journal transaction.

is_import

boolean

required

created_by

integer

required

The ID of the user who recorded the journal transaction.

created_at

string

required

The date and time indicate when the journal transaction was created.

updated_at

string

required

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

success

boolean

required

message

string

required

Example

{
    "data": {
        "id": 4,
        "company_id": 6,
        "voucher_number": "6",
        "date": "2025-02-12T18:30:00.000000Z",
        "debit_total": 85000,
        "credit_total": 85000,
        "narration": "0",
        "is_import": false,
        "created_by": 8,
        "created_at": "2025-02-13T11:51:18.000000Z",
        "updated_at": "2025-02-13T11:51:18.000000Z"
    },
    "success": true,
    "message": "Journal Transaction created successfully."
}

Request#

Response#

Request

Request samples

Responses

Request

Response