HisabKitab
  1. Sale Transactions
HisabKitab
  • Third Party APIs
    • How to Generate ApiKey ?
    • Account Master
      • Ledger Groups
        • List of All Groups
        • Create Group
        • Create Batch Groups
        • Edit Group
        • Update Group
        • Delete Group
      • Ledgers
        • Create Ledger
          • Customer Ledger
          • Supplier Ledger
          • Bank Ledger
          • Capital Ledger
          • Cash Ledger
          • Income Ledger
          • Expense Ledger
          • Fixed Asset Ledger
          • Investment Ledger
          • Loan and Advance (Asset) Ledger
          • Misc Assets Ledger
          • Other Current Assets Ledger
          • Taxes - GST Ledger
          • Taxes - TDS Ledger
          • Taxes - TCS Ledger
          • Provisions Ledger
          • Reserve and Surplus Ledger
          • Secured Loan Ledger
          • Unsecured Loan Ledger
          • Stock In Hand Ledger
          • Other Current Liabilities Ledger
          • TDS Receivable Ledger
          • TCS Receivable Ledger
        • Create Batch Ledgers
        • Ledger Detail
        • List of all Ledgers
        • Edit Ledger
        • Update Ledger
        • Delete Ledger
        • Delete Batch Ledgers
        • Delete Ledger Media
        • Add Location(Fixed Asset )
        • Check Unique GST Number
        • Check Unique GST Number with Ledger
        • Holding & Profit Ratio
        • Ledger TDS tax Data
        • Ledger TCS tax Data
    • Item Master
      • Item Groups
        • List of all groups
        • Create Group
        • Create Batch Groups
        • Edit Group
        • Update Group
        • Delete Group
      • Items
        • Create Batch Items
        • Item Form Details
        • List of items
        • Create Good Item
        • Create Service Item
        • Edit Item
        • Update Item
        • Delete Batch Items
        • Delete Item
      • Unit of Measurement
        • Create Batch Unit of Measurements
        • List of Unit of Measurement
        • Create Unit of Measurement
        • Edit Unit of Measurement
        • Update Unit of Measurement
        • Delete Batch Items unit of measurements
        • Delete Unit of Measurement
    • Broker Master
      • List of Brokers
      • Create Broker
      • Edit Broker
      • Update Broker
      • Delete Broker
    • Transport Master
      • List of Transport
      • Create Transport
      • Edit Transport
      • Update Transport
      • Delete Transport
    • Cess Rate
      • List of Cess Rate
      • Create Cess Rate
      • Edit Cess Rate
      • Update Cess Rate
      • Delete Cess Rate
    • Dispatch Address
      • List of Dispatch Address
      • Create Dispatch Address
      • Edit Dispatch Address
      • Update Dispatch Address
      • Delete Dispatch Address
    • Shipping Address
      • List of Shipping Addresses
      • Create Shipping Address
      • Edit Shipping Address
      • Update Shipping Address
      • Delete Shipping Address
    • Comman APIs
      • Company Details
      • Countries
      • States
      • Cities
      • Gst Rates
      • Classification-nature-type
    • Configuration
      • Sale
        • Sale Configuration
        • Update Configuration
        • Update Configuration with Type
      • Sale Return
        • Sale Return Configuration
        • Update Configuration
        • Update Configuration with Type
      • Income Debit Note
        • Debit Note Configuration
        • Update Configuration
        • Update Configuration with Type
      • Income Credit Note
        • Credit Note Configuration
        • Update Configuration
        • Update Configuration with Type
      • Estimate Quote
        • Estimate Configuration
        • Update Configuration with Type
        • Update Configuration
      • Delivery Challan
        • Delivery Challan Configuration
        • Update Configuration
        • Update Configuration with Type
      • Purchase
        • Purchase Configuration
        • Update Configuration
        • Update Configuration with Type
      • Purchase Return
        • Purchase Return Configuration
        • Update Configuration
        • Update Configuration with Type
      • Expense Credit Note
        • Expense Credit Note Configuration
        • Update Configuration
        • Update Configuration with Type
      • Expense Debit Note
        • Expense Debit Note Configuration
        • Update Configuration
        • Update Configuration with Type
      • Purchase Order
        • Purchase Order Configuration
        • Update Configuration
        • Update Configuration with Type
    • Sale Transactions
      • List of Transactions
        GET
      • Next Invoice Number
        GET
      • Create Item Sale
        POST
      • Create Accounting Sale
        POST
      • Edit Sale
        GET
      • Update Sale
        POST
      • Duplicate Sale
        GET
      • Delete Sale
        DELETE
      • Get Sale For Sale Return
        GET
      • Create Challan From Sale Invoice
        GET
    • Sale Return Transaction
      • List of Transactions
      • Next Invoice Number
      • Create Item Sale Return
      • Create Accounting Sale Return
      • Edit Sale Return
      • Update Sale Return
      • Duplicate Sale Return
      • Delete Sale Return
    • Income Debit Note Transaction
      • List of Transactions
      • Next Invoice Number
      • Create Item Debit Note
      • Create Accounting Debit Note
      • Edit Debit Note
      • Update Debit Note
      • Duplicate Debit Note
      • Delete Debit Note
    • Income Credit Note Transaction
      • List of Transactions
      • Next Invoice Number
      • Create Item Credit Note
      • Create Accounting Credit Note
      • Edit Credit Note
      • Update Credit Note
      • Duplicate Credit Note
      • Delete Credit Note
    • Estimate Quote Transaction
      • List of Transactions
      • Next Estimate Number
      • Create Item Estimate
      • Create Accounting Estimate
      • Edit Estimate
      • Update Estimate
      • Duplicate Estimate
      • Create Sale From Estimate
      • Delete Estimate
    • Delivery Challan Transaction
      • List of Transactions
      • Next Challan Number
      • Create Delivery Challan
      • Edit Delivery Challan
      • Update Delivery Challan
      • Duplicate Delivery Challan
      • Create Sale From Delivery Challan
      • Delete Delivery Challan
    • Purchase Transaction
      • List of Transactions
      • Next Invoice Number
      • Create Item Purchase
      • Create Accounting Purchase
      • Edit purchase
      • Update purchase
      • Duplicate purchase
      • Get purchase For purchase Return
      • Delete purchase
    • Purchase Return Transaction
      • List of Transactions
      • Next Invoice Number
      • Create Item Purchase Return
      • Create Accounting Purchase Return
      • Edit purchase Return
      • Update purchase Return
      • Duplicate purchase Return
      • Delete purchase Return
    • Expense Credit Note Transaction
      • List of Transactions
      • Next Invoice Number
      • Create Item Expense Credit Note
      • Create Accounting Expense Credit Note
      • Edit Expense Credit Note
      • Update Expense Credit Note
      • Duplicate Expense Credit Note
      • Delete Expense Credit Note
    • Expense Debit Note Transaction
      • List of Transactions
      • Next Invoice Number
      • Create Item Expense Debit Note
      • Create Accounting Expense Debit Note
      • Edit Expense Debit Note
      • Update Expense Debit Note
      • Duplicate Expense Debit Note
      • Delete Expense Debit Note
    • Purchase Order Transaction
      • List of Transactions
      • Next Invoice Number
      • Create Item Purchase Order
      • Create Accounting Purchase Order
      • Edit purchase Order
      • Update Purchase Order
      • Duplicate purchase Order
      • Delete purchase Order
      • Book Purchase Order
    • Receipt Transaction
      • List of Receipts
      • Next invoice number
      • Create Receipt
      • Edit Receipt
      • Update Receipt
      • Delete Receipt
    • Payment Transaction
      • List of Payments
      • Next invoice number
      • Create Payment
      • Edit Payment
      • Update Payment
      • Delete Payment
    • Journal Transaction
      • List of Journals
      • Next invoice number
      • Create Journal
      • Edit Journal
      • Update Journal
      • Delete Journal
  1. Sale Transactions

Create Item Sale

POST
https://app.hisabkitab.co/third-party/sale-transactions
This endpoint makes an HTTP POST request to create a new sale transaction of item invoice type. in create invoice detail item type must set 2 for create item type sale invoice.

Request#

The request body must include the details of the sale transaction, including the customer information, items sold, payment details, and other details related to the item type invoice.

Response#

The API will return a confirmation message along with the details of the newly created sale transaction.

Request

Authorization
Add parameter in header
ApiKey
Example:
ApiKey: ********************
Body Params application/json

Example
{
    "invoice_number": "1",
    "date": "27-12-2024",
    "customer_ledger_id": 1,
    "party_phone_number": "",
    "region_iso": "in",
    "region_code": 91,
    "gstin": "27AACCD1376K1ZJ",
    "estimate_quote_no": null,
    "delivery_challan_no": null,
    "dispatch_address_id": null,
    "billing_address": {
        "address_1": "172/5, , Coastal City Center",
        "address_2": "Undi Road,  Bhimavaram town and Municipality",
        "country_id": 1,
        "state_id": 1,
        "city_id": 2,
        "pin_code": "395010"
    },
    "shipping_address": {
        "shipping_name": "joan",
        "shipping_gstin": "27AACCD1376K1ZJ",
        "address_1": "172/5, , Coastal City Center",
        "address_2": "Undi Road,  Bhimavaram town and Municipality",
        "country_id": 1,
        "state_id": 2,
        "city_id": 1,
        "pin_code": "395010"
    },
    "broker_details": {
        "broker_id": 1,
        "brokerage_for_sale": 1,
        "brokerage_on_value_type": 1
    },
    "transport_details": {
        "transport_id": 1,
        "transporter_document_number": "212",
        "transporter_document_date": "12-10-2024",
        "transporter_vehicle_number": "GJ05-SG-1234"
    },
    "eway_bill_details": {
        "eway_bill_number": null,
        "eway_bill_date": null
    },
    "other_details": {
        "po_no": "FASG522",
        "po_date": "10-12-2024",
        "credit_period": "30",
        "credit_period_type": 2
    },
    "sales_item_type": 2,
    "items": [
        {
            "item_id": 1,
            "additional_description": "test",
            "ledger_id": 1,
            "unit_id": 1,
            "quantity": 1,
            "mrp": null,
            "rpu": 100,
            "with_tax": 0,
            "discount_type": 1,
            "discount_value": 100,
            "discount_type_2": 1,
            "discount_value_2": null,
            "gst_id": 1,
            "cess": 0,
            "total": 100
        },
        {
            "item_id": 2,
            "additional_description": "test",
            "ledger_id": 1,
            "unit_id": 2,
            "quantity": 1,
            "mrp": null,
            "rpu": 100,
            "with_tax": 0,
            "discount_type": 1,
            "discount_value": null,
            "discount_type_2": 1,
            "discount_value_2": null,
            "gst_id": 1,
            "cess": 0,
            "total": 100
        }
    ],
    "main_classification_nature_type": "Intrastate Sales Taxable",
    "is_rcm_applicable": 0,
    "narration": null,
    "term_and_condition": null,
    "gross_value": 200,
    "additional_charges": [
        {
            "ac_ledger_id": 1,
            "ac_type": 1,
            "ac_value": 500,
            "ac_gst_rate_id": 12,
            "ac_total_without_tax": 500
        }
    ],
    "taxable_value": 700,
    "cgst": 0,
    "sgst": 0,
    "igst": 0,
    "cess": 0,
    "tcs_details": {
        "tcs_tax_id": null,
        "tcs_rate": null,
        "tcs_amount": null
    },
    "add_less": [
        {
            "al_ledger_id": 1,
            "al_is_show_in_print": false,
            "al_type": 1,
            "al_value": 100
        }
    ],
    "rounding_amount": 0,
    "grand_total": 700,
    "tds_details": {
        "tds_tax_id": null,
        "tds_rate": null,
        "tds_amount": null
    },
    "payment_details": [
        {
            "pd_ledger_id": 1,
            "pd_date": "27-12-2025",
            "pd_amount": 500,
            "pd_mode": 3592,
            "pd_reference_number": null
        }
    ],
    "is_gst_enabled": 0,
    "is_cgst_sgst_igst_calculated": 0,
    "is_gst_na": 1,
    "is_round_off_not_changed": 0,
    "submit_button_value": 2
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://app.hisabkitab.co/third-party/sale-transactions' \
--header 'ApiKey: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "invoice_number": "1",
    "date": "27-12-2024",
    "customer_ledger_id": 1,
    "party_phone_number": "",
    "region_iso": "in",
    "region_code": 91,
    "gstin": "27AACCD1376K1ZJ",
    "estimate_quote_no": null,
    "delivery_challan_no": null,
    "dispatch_address_id": null,
    "billing_address": {
        "address_1": "172/5, , Coastal City Center",
        "address_2": "Undi Road,  Bhimavaram town and Municipality",
        "country_id": 1,
        "state_id": 1,
        "city_id": 2,
        "pin_code": "395010"
    },
    "shipping_address": {
        "shipping_name": "joan",
        "shipping_gstin": "27AACCD1376K1ZJ",
        "address_1": "172/5, , Coastal City Center",
        "address_2": "Undi Road,  Bhimavaram town and Municipality",
        "country_id": 1,
        "state_id": 2,
        "city_id": 1,
        "pin_code": "395010"
    },
    "broker_details": {
        "broker_id": 1,
        "brokerage_for_sale": 1,
        "brokerage_on_value_type": 1
    },
    "transport_details": {
        "transport_id": 1,
        "transporter_document_number": "212",
        "transporter_document_date": "12-10-2024",
        "transporter_vehicle_number": "GJ05-SG-1234"
    },
    "eway_bill_details": {
        "eway_bill_number": null,
        "eway_bill_date": null
    },
    "other_details": {
        "po_no": "FASG522",
        "po_date": "10-12-2024",
        "credit_period": "30",
        "credit_period_type": 2
    },
    "sales_item_type": 2,
    "items": [
        {
            "item_id": 1,
            "additional_description": "test",
            "ledger_id": 1,
            "unit_id": 1,
            "quantity": 1,
            "mrp": null,
            "rpu": 100,
            "with_tax": 0,
            "discount_type": 1,
            "discount_value": 100,
            "discount_type_2": 1,
            "discount_value_2": null,
            "gst_id": 1,
            "cess": 0,
            "total": 100
        },
        {
            "item_id": 2,
            "additional_description": "test",
            "ledger_id": 1,
            "unit_id": 2,
            "quantity": 1,
            "mrp": null,
            "rpu": 100,
            "with_tax": 0,
            "discount_type": 1,
            "discount_value": null,
            "discount_type_2": 1,
            "discount_value_2": null,
            "gst_id": 1,
            "cess": 0,
            "total": 100
        }
    ],
    "main_classification_nature_type": "Intrastate Sales Taxable",
    "is_rcm_applicable": 0,
    "narration": null,
    "term_and_condition": null,
    "gross_value": 200,
    "additional_charges": [
        {
            "ac_ledger_id": 1,
            "ac_type": 1,
            "ac_value": 500,
            "ac_gst_rate_id": 12,
            "ac_total_without_tax": 500
        }
    ],
    "taxable_value": 700,
    "cgst": 0,
    "sgst": 0,
    "igst": 0,
    "cess": 0,
    "tcs_details": {
        "tcs_tax_id": null,
        "tcs_rate": null,
        "tcs_amount": null
    },
    "add_less": [
        {
            "al_ledger_id": 1,
            "al_is_show_in_print": false,
            "al_type": 1,
            "al_value": 100
        }
    ],
    "rounding_amount": 0,
    "grand_total": 700,
    "tds_details": {
        "tds_tax_id": null,
        "tds_rate": null,
        "tds_amount": null
    },
    "payment_details": [
        {
            "pd_ledger_id": 1,
            "pd_date": "27-12-2025",
            "pd_amount": 500,
            "pd_mode": 3592,
            "pd_reference_number": null
        }
    ],
    "is_gst_enabled": 0,
    "is_cgst_sgst_igst_calculated": 0,
    "is_gst_na": 1,
    "is_round_off_not_changed": 0,
    "submit_button_value": 2
}'

Responses

🟢200Create Item Sale
application/json
Body

Example
{
    "data": {
        "sale_transaction": {
            "id": 3,
            "full_invoice_number": "Bill-3",
            "invoice_number": "3",
            "date": "2024-12-26T18:30:00.000000Z",
            "company_id": 6,
            "payment_mode": null,
            "payment_type_ledger_id": null,
            "customer_ledger_id": 1,
            "party_phone_number": null,
            "region_iso": "in",
            "region_code": 91,
            "gstin": null,
            "broker_id": 1,
            "brokerage_for_sale": 1,
            "brokerage_on_value_type": 1,
            "credit_period": 30,
            "credit_period_type": 2,
            "credit_period_due_date": "2025-01-25T18:30:00.000000Z",
            "transport_id": 1,
            "transporter_document_number": "212",
            "transporter_document_date": "2024-10-11T18:30:00.000000Z",
            "transporter_vehicle_number": "GJ05-SG-1234",
            "shipping_name": "ddd",
            "shipping_gstin": "27AACCD1376K1ZJ",
            "po_no": "FASG522",
            "po_date": "2024-12-09T18:30:00.000000Z",
            "eway_bill_number": null,
            "eway_bill_date": null,
            "sales_item_type": 2,
            "tcs_tax_id": null,
            "tcs_rate": null,
            "tcs_amount": null,
            "tds_tax_id": null,
            "tds_rate": null,
            "tds_amount": null,
            "cgst": 0,
            "sgst": 0,
            "igst": 0,
            "rounding_amount": 0,
            "total": 700,
            "grand_total": 700,
            "taxable_value": 700,
            "gross_value": 200,
            "narration": null,
            "term_and_condition": null,
            "dispatch_address_id": null,
            "is_gst_enabled": 0,
            "cess": 0,
            "is_cgst_sgst_igst_calculated": 0,
            "is_gst_na": 1,
            "payment_status": "Unpaid",
            "due_amount": 700,
            "receipt_transaction_item": [],
            "journal_transaction_item": [],
            "sale_return": [],
            "credit_note": [],
            "sale_items": [
                {
                    "id": 1,
                    "sale_transactions_id": 3,
                    "item_id": 1,
                    "additional_description": "test",
                    "unit_id": 2,
                    "quantity": 1,
                    "mrp": null,
                    "with_tax": false,
                    "rpu_with_gst": null,
                    "rpu_without_gst": 100,
                    "discount_type": 1,
                    "discount_value": 100,
                    "discount_type_2": 1,
                    "discount_value_2": null,
                    "total_discount_amount": 0,
                    "gst_id": 10,
                    "gst_tax_percentage": 8,
                    "total": 100,
                    "ledger_id": 1,
                    "classification_igst_tax": null,
                    "classification_cgst_tax": null,
                    "classification_sgst_tax": null,
                    "classification_cess_tax": null,
                    "classification_is_rcm_applicable": 0,
                    "classification_nature_type": null,
                    "consolidating_items_to_invoice": "0",
                    "cess_rate": 0,
                    "cess_amount": 0,
                    "taxable_amount": 0,
                    "taxable_value": 100,
                    "created_at": "2025-02-11T11:09:39.000000Z",
                    "updated_at": "2025-02-11T11:09:39.000000Z"
                },
                {
                    "id": 2,
                    "sale_transactions_id": 3,
                    "item_id": 3,
                    "additional_description": "test",
                    "unit_id": 2,
                    "quantity": 1,
                    "mrp": null,
                    "with_tax": false,
                    "rpu_with_gst": null,
                    "rpu_without_gst": 100,
                    "discount_type": 1,
                    "discount_value": null,
                    "discount_type_2": 1,
                    "discount_value_2": null,
                    "total_discount_amount": 0,
                    "gst_id": 10,
                    "gst_tax_percentage": 8,
                    "total": 100,
                    "ledger_id": 4,
                    "classification_igst_tax": null,
                    "classification_cgst_tax": null,
                    "classification_sgst_tax": null,
                    "classification_cess_tax": null,
                    "classification_is_rcm_applicable": 0,
                    "classification_nature_type": null,
                    "consolidating_items_to_invoice": "0",
                    "cess_rate": 0,
                    "cess_amount": 0,
                    "taxable_amount": 0,
                    "taxable_value": 100,
                    "created_at": "2025-02-11T11:09:39.000000Z",
                    "updated_at": "2025-02-11T11:09:39.000000Z"
                }
            ],
            "estimate_quote_no": null,
            "delivery_challan_no": null,
            "is_round_off_not_changed": 0,
            "via_api": false,
            "is_import": false,
            "created_by": 8,
            "created_at": "2025-02-11T11:09:39.000000Z",
            "updated_at": "2025-02-11T11:09:39.000000Z"
        },
        "transaction_id": 3,
        "e_invoice_is_create": false
    },
    "success": true,
    "message": "Sale Transaction Created Successfully"
}
Modified at 2025-05-02 12:10:31
Previous
Next Invoice Number
Next
Create Accounting Sale
Built with