Create Receipt

POST

https://app.hisabkitab.co/third-party/receipt-transactions

This API is used to create a new receipt transaction. Receipts represent payments received from customers, vendors, or other parties, which can be in the form of cash, bank transfers, or other payment modes.

Request

The request is a POST method, and the body must include the details of the receipt transaction.

Response

Upon successful creation, the API returns a response containing the details of the newly created receipt transaction.

Request

Authorization

Add parameter in header

ApiKey

Example:

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

Body Params multipart/form-data

date

string

required

The date on which the receipt transaction is created. The format is DD-MM-YYYY.

Example:

13-02-2025

receipt_number

string

required

A unique identifier assigned to the receipt for tracking purposes. get it from Next Invoice Number. It helps in referencing transactions efficiently.

Example:

bank_cash_ledger_id

integer

required

The unique identifier for the bank or cash ledger where the received payment is recorded.

Example:

ledger_id

integer

required

The unique identifier of the customer or party ledger from whom the payment is received.

Example:

total_received_amount

number

required

The total amount received from the customer across multiple invoices. The value represents the sum of all payments recorded in this receipt transaction.

Example:

55388.00

is_manage_transaction

boolean

optional

A flag (1 or 0) indicating whether transaction management is enabled. The value "1" means that the system will handle and allocate payments automatically based on the provided details.

Example:

payment_mode

integer

optional

Specifies the mode of payment used in the transaction. The value represents a particular payment method (e.g., cash, bank transfer, or cheque), as defined in the system.

Example:

transaction_id[]

array[string]

optional

A list of unique transaction identifiers corresponding to the invoices being settled. Each transaction ID links the receipt to a specific invoice payment.

Example:

["8","2","5","6"]

invoice_number[]

array[string]

optional

A list of invoice numbers associated with the transactions. Each invoice number corresponds to a bill that is being paid with this receipt.

Example:

["82023-24","22023-24","22023-24","3"]

bill_type[]

array[string]

optional

Indicates the type of bill or transaction being settled, where: 1 = Sale, 2 = Income Debit Note, 3 = Payment, 4 = Purchase Return, and 5 = Expense Debit Note. This categorization helps in accurately classifying financial transactions within the accounting system.

Example:

["1","1","1","3"]

received_amount[]

array[string]

optional

The amount received for each respective invoice as part of the payment transaction. This value represents the portion of the total due amount paid by the customer for a specific invoice, which is included in the total received amount.

Example:

["263.00","5000.00","100.00","50000.00"]

discount_amount[]

array[string]

optional

Any discount applied to the invoice payment. The value "0" means no discount was given. If a discount were applied, the value would reflect the reduced amount.

Example:

["0","0","0","0"]

rounding_amount[]

array[string]

optional

The rounding adjustment made to the received amount for calculation accuracy. The value "0" means no rounding adjustment was needed.

Example:

["0","0","0","0"]

narration

string

optional

A short note or description explaining the receipt transaction.

Example:

A receipt is a written acknowledgment issued by a seller upon purchasing goods or services.

upload_receipt_invoice

file

optional

These field is used to upload and associate a receipt or invoice document with the transaction.

submit_button_value

string

optional

Defines the action of the button used for submitting the form, where 1 means Save, 2 means Save & New, and 3 means Save & Print.

Example:

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://app.hisabkitab.co/third-party/receipt-transactions' \
--header 'ApiKey;' \
--form 'date="13-02-2025"' \
--form 'receipt_number="9"' \
--form 'bank_cash_ledger_id="3"' \
--form 'ledger_id="2"' \
--form 'total_received_amount="55388.00"' \
--form 'is_manage_transaction="1"' \
--form 'payment_mode="2"' \
--form 'transaction_id[]="8"' \
--form 'transaction_id[]="2"' \
--form 'transaction_id[]="5"' \
--form 'transaction_id[]="6"' \
--form 'invoice_number[]="82023-24"' \
--form 'invoice_number[]="22023-24"' \
--form 'invoice_number[]="22023-24"' \
--form 'invoice_number[]="3"' \
--form 'bill_type[]="1"' \
--form 'bill_type[]="1"' \
--form 'bill_type[]="1"' \
--form 'bill_type[]="3"' \
--form 'received_amount[]="263.00"' \
--form 'received_amount[]="5000.00"' \
--form 'received_amount[]="100.00"' \
--form 'received_amount[]="50000.00"' \
--form 'discount_amount[]="0"' \
--form 'discount_amount[]="0"' \
--form 'discount_amount[]="0"' \
--form 'discount_amount[]="0"' \
--form 'rounding_amount[]="0"' \
--form 'rounding_amount[]="0"' \
--form 'rounding_amount[]="0"' \
--form 'rounding_amount[]="0"' \
--form 'narration="A receipt is a written acknowledgment issued by a seller upon purchasing goods or services."' \
--form 'upload_receipt_invoice=@""' \
--form 'submit_button_value="1"'

Responses

🟢200Create Receipt

application/json

Body

data

object

required

integer

required

A unique identifier for the receipt transaction, used to differentiate it from other transactions.

company_id

integer

required

The ID of the company making the receipt helps to associate transactions with specific business entities.

date

string

required

The date when the receipt transaction was created, recorded in DD-MM-YYYY format.

receipt_number

string

required

The field represents the unique identifier assigned to a receipt transaction.

bank_cash_ledger_id

string

required

Specifies the payment source, indicating whether the amount was received in cash or through a bank account.

ledger_id

string

required

The ID of the party ledger (customer, vendor, or account) associated with the receipt transaction.

total_received_amount

number

required

The total amount received in this transaction, representing incoming funds recorded in the financial records.

narration

string

required

An optional field that stores additional notes or descriptions related to the receipt transaction.

is_manage_transaction

boolean

required

The field is a boolean value that indicates whether the receipt transaction is directly associated with invoice settlement.

payment_mode

string

required

The field specifies the ID of the method used to receive the payment in the receipt transaction.

reference_number

string

required

Stores a reference number for transactions involving bank transfers, UPI, or cheques.

via_api

boolean

required

is_import

boolean

required

created_by

integer

required

A unique identifier of the user who created the transaction.

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.

success

boolean

required

message

string

required

Example

{
    "data": {
        "id": 5,
        "company_id": 6,
        "date": "2025-02-12T18:30:00.000000Z",
        "receipt_number": "9",
        "bank_cash_ledger_id": "3",
        "ledger_id": "2",
        "total_received_amount": 55388,
        "narration": "A receipt is a written acknowledgment issued by a seller upon purchasing goods or services.",
        "is_manage_transaction": true,
        "payment_mode": "2",
        "reference_number": null,
        "via_api": true,
        "is_import": false,
        "created_by": 8,
        "created_at": "2025-02-13T09:23:44.000000Z",
        "updated_at": "2025-02-13T09:23:44.000000Z"
    },
    "success": true,
    "message": "Receipt transaction created successfully."
}

Modified at 2025-05-05 11:59:54

Next invoice number

Edit Receipt

Create Receipt

Request#

Response#

Request

Request samples

Responses

Request

Response