HisabKitab
  1. Items
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
          GET
        • List of items
          GET
        • Create Good Item
          POST
        • Create Service Item
          POST
        • Edit Item
          GET
        • Update Item
          POST
        • Delete Item
          DELETE
      • 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
      • Next Invoice Number
      • Create Item Sale
      • Create Accounting Sale
      • Edit Sale
      • Update Sale
      • Duplicate Sale
      • Delete Sale
      • Get Sale For Sale Return
      • Create Challan From Sale Invoice
    • 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. Items

Update Item

POST
https://app.hisabkitab.co/third-party/items/{id}
This endpoint makes an HTTP POST request to update an existing item in the system. It allows users to modify items.

Request#

The request body must include the complete item details that need to be updated.

Response#

Upon successful update, the API will return a confirmation message along with the updated item details.

Request

Authorization
Add parameter in header
ApiKey
Example:
ApiKey: ********************
Path Params
id
integer 
required
It represents the ID of the item you want to update.
Example:
1
Body Params application/json
create an item or service
item_name
string 
required
The unique name of the item or service, used for identification.
group_id
integer 
required
The group id represents the category under which an item or service falls and it must exist in item groups.It should be retrieved from the Item Form Details API.
item_type
integer 
required
There are two item types used: 1 for Goods and 2 for Services.
Default:
1
primary_unit_of_measurement
integer 
required
The main unit (id) in which the item is measured (e.g., "Pieces" or "Kg"). It should be retrieved from the Item Form Details API.
secondary_unit_of_measurement
integer 
optional
An optional secondary unit (id), if dual units are used (e.g., "Gram"). It should be retrieved from the Item Form Details API.
conversion_rate
number <double>
optional
Defines the conversion factor between the primary and secondary units (e.g., 1 Kg = 1000 Grams) and it require when secondary unit used.
sale_price_type
integer 
required
Specifies whether the sale price is inclusive (1) or exclusive (2) of GST.
Default:
2
sale_price
number <double> | null 
optional
The price at which the item is sold in income transactions, which may or may not include GST.
mrp
number <double> | null 
optional
Maximum Retail Price (MRP) at which the item can be sold to end customers (e.g., 100).
discount_type
integer 
required
Type of discount applied to the sale price (1 = Percentage, 2 = Fixed amount).
Default:
2
discount
number  | null 
optional
The actual discount value is applied according to the discount type.
income_ledger_id
integer  | null 
optional
The ledger account where sales income is recorded. It should be retrieved from the Item Form Details API.
purchase_price_type
integer 
required
Defines whether the purchase price is inclusive (1) or exclusive (2) of GST.
Default:
2
purchase_price
number <double>
optional
The price at which the item is sold in expense transactions, which may or may not include GST.
purchase_discount_type
integer 
required
Specifies the discount type on purchase (1 = Percentage, 2 = Fixed amount).
Default:
2
purchase_discount_value
number 
optional
Discount value applied on purchase according to the purchase discount type.
expense_ledger_id
integer 
optional
The ledger account where expenses related to this item are recorded. It should be retrieved from the Item Form Details API.
is_description_same_as_item_name
boolean 
required
If set to 1, the system automatically copies the item name as the description. If set to 0, a custom description must be provided.
Default:
false
description
string  | null 
optional
A detailed description of the item provides additional clarity.
decimal_places
integer 
optional
The number of decimal places allowed for quantity values (e.g., 2 means values like 10.25).
sku
string  | null 
optional
Stock Keeping Unit (SKU) is a unique code assigned to track inventory.
is_gst_applicable
boolean 
required
Specifies if the item is taxable under GST (1 = Yes, 0 = No).
Default:
false
gst_tax_id
integer 
optional
The GST tax ID links the item to a predefined tax rate, and it is required if gst applicable true (e.g., 8%, 12%). It should be retrieved from the Item Form Details API.
hsn_sac_code
string  | null 
optional
The Harmonized System of Nomenclature (HSN) or Service Accounting Code (SAC) for GST classification (e.g., 1001).
gst_cess_rate
integer  | null 
optional
The GST cess (additional tax) rate applicable on the item in percentage if item is taxable under GST. It should be retrieved from the Item Form Details API.
is_rcm_applicable
boolean 
required
Indicates if Reverse Charge Mechanism (RCM) applies (0 = No, 1 = Yes), meaning the buyer must pay GST instead of the seller.
Default:
false
decimal_places_for_rate
integer 
optional
Defines how many decimal places are allowed for pricing calculations (e.g., 3 means values like 10.256)
quantity_unit
integer  | null 
optional
Defines the unit (id) in which the opening stock quantity is measured. It should be retrieved from the Item Form Details API.
quantity
number <double> | null 
optional
Represents the initial stock quantity available at the time of recording. If null, it means no predefined opening stock is set.
rate
number <double> | null 
optional
The cost amount per unit of the item at the time of opening balance entry.
opening_balance_type
integer 
optional
Determines whether the opening balance is inclusive (1) or exclusive (2) of GST.
Default:
2
item_image
string  | null 
optional
These fields allow you to upload an image of the item
Example
{
    "item_name": "Set SER1", // create Goods type item
    "group_id": "118",
    "item_type": "1",
    "primary_unit_of_measurement": "29",
    "secondary_unit_of_measurement": null,
    "conversion_rate": null,
    "decimal_places": "2",
    "sku": null,
    "description": null,
    "is_description_same_as_item_name": 1,
    "is_gst_applicable": "1",
    "gst_tax_id": "10",
    "hsn_sac_code": "1001",
    "is_rcm_applicable": "0",
    "gst_cess_rate": 136,
    "mrp": 100,
    "sale_price": 100,
    "sale_price_type": 2, // 1 = with GST, 2 = without GST
    "discount_type": 1,
    "discount": 0,
    "income_ledger_id": 1196,
    "purchase_price": null,
    "purchase_price_type": 2, // 1 = with GST, 2 = without GST
    "purchase_discount_type": 1,
    "purchase_discount_value": 0,
    "expense_ledger_id": 1197,
    "decimal_places_for_rate": 3,
    "quantity_unit": "6",
    "quantity": null,
    "rate": null,
    "opening_balance_type": 2,
    "item_image": null
}
// {
//     "item_name": "Set Service item", // create Service type item
//     "group_id": "12296",
//     "item_type": "2",
//     "primary_unit_of_measurement": "29",
//     "secondary_unit_of_measurement": null,
//     "conversion_rate": null,
//     "decimal_places": "2",    
//     "description": null,
//     "is_description_same_as_item_name": 1,
//     "is_gst_applicable": "1",
//     "gst_tax_id": "10",
//     "hsn_sac_code": "1001",
//     "is_rcm_applicable": "0",
//     "gst_cess_rate": 136,    
//     "sale_price": 100,
//     "sale_price_type": 2, // 1 = with GST, 2 = without GST
//     "discount_type": 1,
//     "discount": 0,
//     "income_ledger_id": 1196,
//     "purchase_price": null,
//     "purchase_price_type": 2, // 1 = with GST, 2 = without GST
//     "purchase_discount_type": 1,
//     "purchase_discount_value": 0,
//     "expense_ledger_id": 1197,
//     "decimal_places_for_rate": 3,
//     "quantity_unit": "6",
//     "quantity": null,
//     "rate": null,
//     "opening_balance_type": 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/items/1' \
--header 'Content-Type: application/json' \
--header 'ApiKey;' \
--data-raw '{
    "item_name": "Set SER1", // create Goods type item
    "group_id": "118",
    "item_type": "1",
    "primary_unit_of_measurement": "29",
    "secondary_unit_of_measurement": null,
    "conversion_rate": null,
    "decimal_places": "2",
    "sku": null,
    "description": null,
    "is_description_same_as_item_name": 1,
    "is_gst_applicable": "1",
    "gst_tax_id": "10",
    "hsn_sac_code": "1001",
    "is_rcm_applicable": "0",
    "gst_cess_rate": 136,
    "mrp": 100,
    "sale_price": 100,
    "sale_price_type": 2, // 1 = with GST, 2 = without GST
    "discount_type": 1,
    "discount": 0,
    "income_ledger_id": 1196,
    "purchase_price": null,
    "purchase_price_type": 2, // 1 = with GST, 2 = without GST
    "purchase_discount_type": 1,
    "purchase_discount_value": 0,
    "expense_ledger_id": 1197,
    "decimal_places_for_rate": 3,
    "quantity_unit": "6",
    "quantity": null,
    "rate": null,
    "opening_balance_type": 2,
    "item_image": null
}
// {
//     "item_name": "Set Service item", // create Service type item
//     "group_id": "12296",
//     "item_type": "2",
//     "primary_unit_of_measurement": "29",
//     "secondary_unit_of_measurement": null,
//     "conversion_rate": null,
//     "decimal_places": "2",    
//     "description": null,
//     "is_description_same_as_item_name": 1,
//     "is_gst_applicable": "1",
//     "gst_tax_id": "10",
//     "hsn_sac_code": "1001",
//     "is_rcm_applicable": "0",
//     "gst_cess_rate": 136,    
//     "sale_price": 100,
//     "sale_price_type": 2, // 1 = with GST, 2 = without GST
//     "discount_type": 1,
//     "discount": 0,
//     "income_ledger_id": 1196,
//     "purchase_price": null,
//     "purchase_price_type": 2, // 1 = with GST, 2 = without GST
//     "purchase_discount_type": 1,
//     "purchase_discount_value": 0,
//     "expense_ledger_id": 1197,
//     "decimal_places_for_rate": 3,
//     "quantity_unit": "6",
//     "quantity": null,
//     "rate": null,
//     "opening_balance_type": 2
// }'

Responses

🟢200Update Item
application/json
Body
data
object 
required
id
integer 
required
This is the unique identifier for the product or service.
item_name
string 
required
The unique name of the item or service, used for identification.
group_id
string 
required
The group id represents the category under which an item or service falls and it must exist in item groups.
item_type
string 
required
There are two item types used: 1 for Goods and 2 for Services.
item_type_name
string 
required
There is a name of item types used: Goods and Services.
company_id
integer 
required
Represents the unique identifier of the company to which the item belongs.
sku
string 
required
Stock Keeping Unit (SKU) is a unique code assigned to track inventory.
units_of_array
array [object {9}] 
required
Contains information about the measurement unit used for the item.
model
object 
required
item_image
string 
required
These fields allow you to upload an image of the item
media
array[string]
required
These fields allow you to upload an image of the item
via_api
boolean 
required
is_import
boolean 
required
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": 3,
        "company_id": 6,
        "item_name": "Softek",
        "group_id": "118",
        "item_type": "1",
        "model_id": 2,
        "model_type": "App\\Models\\Master\\ItemMasterGoods",
        "sku": null,
        "units_of_array": [
            {
                "id": 1,
                "name": "PIECES",
                "code": "PCS",
                "full_name": "PCS-PIECES",
                "is_default": true,
                "for_gst_use_name": null,
                "company_id": null,
                "created_at": "2023-02-10T04:22:56.000000Z",
                "updated_at": "2023-02-10T04:22:56.000000Z"
            }
        ],
        "model": {
            "id": 2,
            "unit_of_measurement": 1,
            "alternate_unit": null,
            "secondary_unit_of_measurement": null,
            "decimal_places": 2,
            "sale_price_type": 2,
            "selling_price_with_gst": 118,
            "selling_price_without_gst": 100,
            "purchase_price_type": 2,
            "purchase_price_with_gst": null,
            "purchase_price_without_gst": null,
            "decimal_places_for_rate": 3,
            "conversion_rate": null,
            "is_gst_applicable": true,
            "hsn_sac_code": "1001",
            "description": "Set SER1",
            "is_description_same_as_item_name": true,
            "is_rcm_applicable": false,
            "gst_tax_id": 1,
            "gst_cess_rate": 136,
            "income_ledger_id": 1196,
            "expense_ledger_id": 1197,
            "quantity_unit": 6,
            "quantity": 1000,
            "rate": 100,
            "mrp": 100,
            "purchase_discount_type": 1,
            "discount_type": 1,
            "purchase_discount_value": null,
            "discount_value": null,
            "opening_balance": null,
            "method_of_stock_valuation": null,
            "conversion_of_unit": null,
            "gst_tax_rate": 18,
            "cess_rate": null,
            "gst_tax": {
                "id": 10,
                "name": "18%",
                "tax_rate": 18,
                "company_id": null,
                "created_at": "2023-02-10T04:22:55.000000Z",
                "updated_at": "2023-02-10T04:22:55.000000Z"
            },
            "gst_gst_cess_rate": null,
            "via_api": 0,
            "created_at": "2025-02-11T09:56:20.000000Z",
            "updated_at": "2025-02-11T10:06:32.000000Z"
        },
        "item_image": "",
        "media": [],
        "via_api": false,
        "is_import": false,
        "created_at": "2025-02-11T09:56:20.000000Z",
        "updated_at": "2025-02-11T10:06:32.000000Z"
    },
    "success": true,
    "message": "Item Master Updated Successfully."
}
Modified at 2025-04-07 07:12:45
Previous
Edit Item
Next
Delete Item
Built with