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
        • Ledger Detail
        • List of all Ledgers
        • Edit Ledger
        • Update Ledger
        • Delete Ledger
        • 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
        • Item Form Details
        • List of items
        • Create Good Item
        • Create Service Item
        • Edit Item
        • Update Item
        • Delete Item
      • Unit of Measurement
        • List of Unit of Measurement
        • Create Unit of Measurement
        • Edit Unit of Measurement
        • Update Unit of Measurement
        • 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
invoice_number
string 
required
The unique invoice number is system-generated and assigned to each invoice and Typically fetched from the Next Invoice Number API.
date
string 
required
The invoice date represents the date on which an invoice is issued, and the date is set within the applicable financial year.
customer_ledger_id
integer 
required
Represents the unique identifier of the customer for whom the invoice is being created, linking the invoice to the relevant business entity. you get it from Ledger List API.
billing_address
object 
required
Represents the billing address of the customer for invoicing purposes.
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.
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.
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.
sales_item_type
integer  | null 
optional
Indicates the type of invoice here is must 2, such as item invoice (2) and accounting invoice (1). This field is nullable. If no specific type is provided, the system will automatically assign the item invoice (2) type by default.
Default:
2
items
array [object {16}] 
required
An array of items for item invoice.
quantity
integer 
required
Indicates the number of items being sold in the transaction
with_tax
integer 
required
This indicates whether the price is inclusive of tax. A value of 0 means the price is exclusive of tax.
rpu
number <double>
required
Represents the Rate Per Unit of the item, the selling price for each unit before taxes and discounts.
item_id
integer  | null 
optional
The unique identifier for the item being added to the sales invoice. This field is nullable but required if sku is not provided. you get it from Item List.
sku
string  | null 
optional
The Stock Keeping Unit (SKU) associated with the item. This field is nullable but required if item_id is not provided. It must be a string and is used for inventory tracking and product identification.
ledger_id
integer  | null 
optional
The unique identifier for the ledger account associated with the item. This field is nullable. If no specific ledger is provided, the system will automatically assign the default sale ledger ID.
unit_id
integer  | null 
optional
The unique identifier for the unit of measurement (UOM) associated with the item. This field is nullable. If no specific unit is provided, the system will automatically assign the primary UOM of the item.
total
integer  | null 
optional
This is the final total for the item after all calculations, including discounts. This field is nullable. If no total amount is provided, the system will automatically calculate it for item.
gst_id
integer 
optional
This field represents the GST tax rate for the item and is required if your company is GST applicable.It should be retrieved from Gst Rates API.
additional_description
string  | null 
optional
Provides any extra details or notes about the item being sold.
mrp
integer  | null 
optional
Refers to the Maximum Retail Price of the item.
discount_type
integer  | null 
optional
The type of discount applied to the selling price. Options include 2 = Percentage and 1 = Fixed amount. This field is nullable. If no specific discount type is provided, the system will automatically assign 1 (Fixed amount) as the default.
discount_value
integer  | null 
optional
Represents the discount amount applied to the item.
discount_type_2
integer  | null 
optional
Similar to discount_type applicable on the second discount amount.
discount_value_2
number  | null 
optional
Represents the second discount amount applied.
cess
integer  | null 
optional
Represents the cess (additional tax) applied to the item.
main_classification_nature_type
string 
required
Describes the nature of the sale for tax purposes, such as "Intrastate Sales Taxable". you get it from Classification-nature-type
gross_value
number <double>
required
Represents the total value of the transaction before applying any discounts, taxes, or additional charges.
taxable_value
number <double>
required
The total value of the invoice, after applying discounts and additional charges but before adding any taxes.
cgst
number 
required
These fields represent the Central GST
sgst
number 
required
These fields represent the State GST
igst
number 
required
These fields represent the Integrated GST
cess
number 
required
Represents the cess (additional tax) applied to the transaction.
is_rcm_applicable
boolean 
required
Indicates whether the Reverse Charge Mechanism (RCM) is applicable, it is a tax mechanism where the buyer, rather than the seller, is liable to pay the tax.
Default:
false
rounding_amount
integer 
required
The rounding adjustment to make the total amount a round figure. This is usually done for simplifying invoice totals.
grand_total
integer 
required
The final amount of the invoice, which includes all items, taxes, additional charges, and rounding adjustments.
is_gst_enabled
boolean 
required
Indicates whether GST is enabled for the transaction.
Default:
false
is_cgst_sgst_igst_calculated
boolean 
required
Indicates whether CGST, SGST, or IGST has been calculated.
Default:
false
is_gst_na
boolean 
required
Indicates if GST is not applicable to the transaction.
Default:
false
is_round_off_not_changed
boolean 
required
check if adjustments are made to the rounding of the invoice total.
Default:
true
party_phone_number
number 
optional
The contact phone number of the party (customer) for the invoice.
region_iso
string 
optional
Represents the ISO country code of the customer's location. For example, "in" indicates India. This field is required when adding a party's phone number.
region_code
integer 
optional
Represents the country-specific regional code (e.g., 91 for India). This field is required when adding a party's phone number.
gstin
string 
optional
The GSTIN (Goods and Services Tax Identification Number) is a unique number assigned to the customer for claim tax credits.
estimate_quote_no
integer  | null 
optional
This field holds the quote or estimate number that was generated before creating the invoice and allows to use the details of it in the sales invoice.
delivery_challan_no
integer  | null 
optional
This field holds the delivery challan number that was generated before creating the invoice and allows to use the details of it in the sales invoice.
dispatch_address_id
integer 
optional
Contains the delivery address for the products or services being invoiced.
shipping_address
object 
optional
The shipping address where goods should be delivered. This includes customer details, GSTIN, and address information.
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.
shipping_name
string 
optional
Define the shipping customer's name.
shipping_gstin
string 
optional
Define the shipping customer gstin number.
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.
city_id
integer 
optional
Reference ID for the city of the selected state. it get from City API.
pin_code
integer 
optional
Postal code of the address.
broker_details
object 
optional
Contains details about broker related to the transaction.
broker_id
integer 
required
The broker id is the unique identifier assigned to the broker involved in the transaction or deal. it get from List of Broker API.
brokerage_for_sale
number <double>
optional
The brokerage value is the percentage fee that the broker receives for facilitating the deal.
brokerage_on_value_type
integer 
optional
This field determines the basis on which the brokerage fee is calculated such as invoice value (1) and taxable value (2).
transport_details
object 
optional
transport_id
integer 
optional
Represents the unique identifier for the transport service provider that is responsible for delivering the goods. get it from List of Transport.
transporter_document_number
integer 
optional
Refers to the document number issued by the transporter, such as a bill.
transporter_document_date
string 
optional
This is the date when the transporter's document was issued.
transporter_vehicle_number
string 
optional
Represents the vehicle number used for transporting the goods.
eway_bill_details
object 
optional
eway_bill_number
integer 
optional
This field holds the unique identification number of the E-way bill generated for the shipment of goods.
eway_bill_date
string 
optional
This is the date when the E-way bill was generated.
other_details
object 
optional
po_no
integer 
optional
Represents the Purchase Order Number associated with the transaction issued by the buyer.
po_date
string 
optional
This is the date on which the Purchase Order was issued.
credit_period
integer 
optional
Refers to the credit period (number of days or month) granted to the buyer, which is the time allowed to make payment for the goods or services received.
credit_period_type
integer 
optional
This field defines the type of credit period applied months (1) and days (2).
Default:
1
narration
string  | null 
optional
An optional narrative field for providing additional notes or descriptions related to the transaction
term_and_condition
string  | null 
optional
Includes any terms and conditions relevant to the transaction, such as payment terms, delivery schedules, or return policies.
additional_charges
array [object {5}] 
optional
This section lists any extra charges that are added to the invoice, such as shipping .
ac_ledger_id
integer 
required
This field represents the unique identifier for the ledger account that records the additional charge.
ac_type
integer 
required
Indicates the type of charge being applied (2 = Percentage, 1 = Fixed amount).
Default:
1
ac_value
number <double>
required
Represents the value or amount of the additional charge.
ac_total_without_tax
number <double>
optional
This indicates the total amount of the additional charge excluding taxes.
ac_gst_rate_id
integer 
optional
This field specifies the GST tax rate applied to the additional charge. get it from Gst Rates API.
tcs_details
object 
optional
Includes Tax Collected at Source (TCS) information
tcs_tax_id
integer 
required
This field holds the id for the TCS rate applied to the transaction.
tcs_rate
integer 
required
Represents the rate (%) at which TCS is collected on the transaction.
tcs_amount
number <double>
required
This field shows the amount of TCS collected on the transaction.
add_less
array [object {4}] 
optional
An array for any adjustments (either additions or reductions) to the total invoice amount.
al_ledger_id
integer 
required
This is the unique identifier for the ledger account associated with the add or less charge.
al_is_show_in_print
boolean 
required
This field determines whether the charge should be displayed in the printed invoice.
Default:
true
al_type
integer 
required
Indicates the type of charge being applied (2 = Percentage, 1 = Fixed amount).
Default:
2
al_value
number <double>
required
Represents the value or amount of the add or less charge.
tds_details
object 
optional
Contains information regarding Tax Deducted at Source (TDS).
tds_tax_id
integer 
required
This field holds the id for the TDS applied to the transaction.
tds_rate
integer 
required
Represents the rate (%) at which TDS is collected on the transaction.
tds_amount
number <double>
required
This field shows the amount of TDS collected on the transaction.
payment_details
array [object {5}] 
optional
pd_ledger_id
integer 
required
This is the unique identifier for the ledger account associated with the payment.
pd_date
string <date>
required
Refers to the date when the payment was made.
pd_amount
number <double>
required
This is the amount paid in the transaction.
pd_mode
integer  | null 
optional
Represents the mode id of payment used for the transaction, such as cash, cheque, UPI, RTGS, etc.
pd_reference_number
number  | null 
optional
This field holds a reference number related to the payment, like a transaction number or cheque number.
submit_button_value
integer 
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
{
    "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 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 'Content-Type: application/json' \
--header 'ApiKey;' \
--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
data
object 
required
Contains the details of the newly created sale transaction
sale_transaction
object 
required
transaction_id
integer 
required
A unique identifier assigned to the sale transaction.
e_invoice_is_create
boolean 
required
A boolean flag indicating whether an e-invoice has been generated for this sale
success
boolean 
required
message
string 
required
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