HisabKitab
  1. Purchase Order Transaction
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
      • 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
        GET
      • Next Invoice Number
        GET
      • Create Item Purchase Order
        POST
      • Create Accounting Purchase Order
        POST
      • Edit purchase Order
        GET
      • Update Purchase Order
        POST
      • Duplicate purchase Order
        GET
      • Delete purchase Order
        DELETE
      • Book Purchase Order
        GET
    • 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. Purchase Order Transaction

Update Purchase Order

POST
https://app.hisabkitab.co/third-party/purchase-order-transactions/{id}
This API allows users to update an existing purchase order by modifying its details, and the updated information is then saved in the system to reflect the changes in the purchase order.

Request#

The API uses a POST request to update the details of an existing purchase order. The order ID must be provided in the URL, and the updated data must be sent in the request body.

Response#

The response confirms that the purchase order has been successfully updated and returns the updated purchase order details.

Request

Authorization
Add parameter in header
ApiKey
Example:
ApiKey: ********************
Path Params
id
integer 
required
It will be the ID of the purchase order transaction you want to update.
Example:
1
Body Params application/json
title
integer 
required
Defines the title ID assigned to purchase order, which is configured in the settings.
order_number
string 
required
The unique purchase order number is system-generated and assigned to each order and Typically fetched from the Next invoice Number Endpoint.
order_date
string 
required
The order date represents the date on which an order is issued, and the date is set within the applicable financial year.
party_ledger_id
integer 
required
The unique ID of the supplier ledger from whom the purchase order was originally made.
billing_address
object 
required
The registered address of the supplier, including street details, country, state, city, and pin code.
country_id
integer 
required
state_id
integer 
required
address_1
string 
optional
address_2
string 
optional
city_id
integer 
optional
pin_code
string 
optional
items
array [object {15}] 
required
item_id
integer 
required
Unique identifier for the item.
ledger_id
integer 
required
Ledger reference associated with the item.
unit_id
integer 
required
This field holds the identifier for the unit of measurement used for the item, such as pieces etc.
quantity
number 
required
The number of units being ordered.
rpu
number 
required
Represents the Rate Per Unit of the item, the selling price for each unit before taxes and discounts.
with_tax
boolean 
required
This indicates whether the price is inclusive of tax. A value of 0 means the price is exclusive of tax.
discount_type
integer 
required
Type of discount applied to the selling price (2 = Percentage, 1 = Fixed amount).
gst_id
integer 
required
This field represents the GST tax rate for the item and is required if your company is GST applicable.
total
number 
required
This is the final total for the item after all calculations, including discounts.
additional_description
string  | null 
optional
Additional details or remarks about the item.
mrp
number 
optional
Refers to the Maximum Retail Price of the item.
discount_value
number 
optional
Represents the discount amount applied to the item.
discount_type_2
integer 
optional
Similar to discount_type applicable on the second discount amount.
discount_value_2
number 
optional
Represents the second discount amount applied.
cess
number 
optional
Represents the cess (additional tax) applied to the item.
order_type
integer 
required
Indicates the type of order such as item invoice (2) and accounting invoice (1).
gross_value
number 
required
Represents the total value of the transaction before applying any discounts, taxes, or additional charges.
taxable_value
number 
required
The total value of the invoice, after applying discounts and additional charges but before adding any taxes.
main_classification_nature_type
string 
required
The nature of the purchase transaction, e.g., Interstate Purchase Taxable.
is_rcm_applicable
boolean 
required
Specifies whether Reverse Charge Mechanism (RCM) is applicable (1 = Yes, 0 = No).
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.
grand_total
number 
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.
is_cgst_sgst_igst_calculated
boolean 
required
Indicates whether CGST, SGST, or IGST has been calculated.
is_gst_na
boolean 
required
Indicates if GST is not applicable to the transaction.
is_round_off_not_changed
boolean 
required
check if adjustments are made to the rounding of the invoice total.
valid_for
integer 
optional
This field specifies the validity period of the order, indicating how long it valid for acceptance. The value can be in number of days or months.
valid_for_type
integer 
optional
This field specifies the type of order validity, where 1 represents months and 2 represents days.
gstin
string  | null 
optional
The GSTIN (Goods and Services Tax Identification Number) is a unique number assigned to the customer for claim tax credits.
shipping_address
object 
optional
The location where the returned goods are being shipped, which may differ or same from the billing address.
country_id
integer 
required
state_id
integer 
required
shipping_name
string 
optional
The recipient's name for the return shipment, if applicable.
address_1
string 
optional
address_2
string 
optional
city_id
integer 
optional
pin_code
string 
optional
broker_details
object 
optional
Contains broker information, including broker_id, brokerage percentage, and how it is calculated on value.
broker_id
integer 
optional
The broker id is the unique identifier assigned to the broker involved in the transaction or deal.
brokerage_for_sale
number 
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 
required
Represents the unique identifier for the transport service provider that is responsible for delivering the goods.
transporter_document_number
integer 
required
Refers to the document number issued by the transporter, such as a bill.
transporter_document_date
string 
required
This is the date when the transporter's document was issued.
narration
string  | null 
optional
An optional narrative field for providing additional notes or descriptions related to the transaction
additional_charges
array [object {4}] 
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).
ac_value
number 
required
Represents the value or amount of the additional charge.
ac_total
number 
required
This indicates the total amount of the additional charge.
add_less
array [object {4}] 
optional
Contains adjustments that either increase (add) or decrease (less) the total transaction 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.
al_type
integer 
required
Indicates the type of charge being applied (2 = Percentage, 1 = Fixed amount).
al_value
number 
required
Represents the value or amount of the add or less charge.
rounding_amount
number  | null 
optional
The rounding adjustment to make the total amount a round figure. This is usually done for simplifying invoice totals.
Example
{
    "title": 1,
    "order_number": "4",
    "order_date": "12-02-2025",
    "party_ledger_id": 2702,
    "valid_for": 10,
    "valid_for_type": 1,
    "gstin": "37AAGAA2385M1ZE",
    "billing_address": {
        "address_1": "2121, 3RD FLOOR, RADHA RAMAN TEXTILE MARKET",
        "address_2": "KADODARA ROAD",
        "country_id": 101,
        "state_id": 4030,
        "city_id": 134096,
        "pin_code": "395008"
    },
    "shipping_address": {
        "shipping_name": null,
        "address_1": "2121, 3RD FLOOR, RADHA RAMAN TEXTILE MARKET",
        "address_2": "KADODARA ROAD",
        "country_id": 101,
        "state_id": 4030,
        "city_id": 134096,
        "pin_code": "395008"
    },
    "broker_details": {
        "broker_id": null,
        "brokerage_for_sale": null,
        "brokerage_on_value_type": null
    },
    "transport_details": {
        "transport_id": null,
        "transporter_document_number": null,
        "transporter_document_date": null
    },
    "order_type": 2,
    "items": [
        {
            "item_id": 93,
            "additional_description": "test",
            "ledger_id": 848,
            "unit_id": 29,
            "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": 10,            
            "cess": 0,
            "total": 100
        }
    ],
    // "ledgers": [
    //     {
    //         "ledger_id": 79968,
    //         "additional_description": "test",
    //         "rpu_with_gst": 100,
    //         "rpu_without_gst": 100,
    //         "gst_id": 10,
    //         "gst_tax_percentage": 10,
    //         "with_tax": 0,
    //         "discount_type": 1,
    //         "discount_value": null,
    //         "discount_type_2": 1,
    //         "discount_value_2": null,
    //         "total": 1000
    //     }
    // ],
    "gross_value": 100,
    "narration": "Hello World",
    "additional_charges": [
        {
            "ac_ledger_id": 79971,
            "ac_type": 1,
            "ac_value": 100,
            "ac_total": 100
        }
    ],
    "taxable_value": 100,
    "add_less": [
        {
            "al_ledger_id": 7655,
            "al_is_show_in_print": 0,
            "al_type": 1,
            "al_value": 100
        }
    ],
    "main_classification_nature_type": "Interstate Purchase Taxable",
    "is_rcm_applicable": 0,
    "cgst": 0,
    "sgst": 0,
    "igst": 0,
    "cess": 0,
    "rounding_amount": null,
    "grand_total": 100,
    "is_gst_enabled": 0,
    "is_cgst_sgst_igst_calculated": 0,
    "is_gst_na": 1,
    "is_round_off_not_changed": false
}

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/purchase-order-transactions/1' \
--header 'Content-Type: application/json' \
--header 'ApiKey;' \
--data-raw '{
    "title": 1,
    "order_number": "4",
    "order_date": "12-02-2025",
    "party_ledger_id": 2702,
    "valid_for": 10,
    "valid_for_type": 1,
    "gstin": "37AAGAA2385M1ZE",
    "billing_address": {
        "address_1": "2121, 3RD FLOOR, RADHA RAMAN TEXTILE MARKET",
        "address_2": "KADODARA ROAD",
        "country_id": 101,
        "state_id": 4030,
        "city_id": 134096,
        "pin_code": "395008"
    },
    "shipping_address": {
        "shipping_name": null,
        "address_1": "2121, 3RD FLOOR, RADHA RAMAN TEXTILE MARKET",
        "address_2": "KADODARA ROAD",
        "country_id": 101,
        "state_id": 4030,
        "city_id": 134096,
        "pin_code": "395008"
    },
    "broker_details": {
        "broker_id": null,
        "brokerage_for_sale": null,
        "brokerage_on_value_type": null
    },
    "transport_details": {
        "transport_id": null,
        "transporter_document_number": null,
        "transporter_document_date": null
    },
    "order_type": 2,
    "items": [
        {
            "item_id": 93,
            "additional_description": "test",
            "ledger_id": 848,
            "unit_id": 29,
            "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": 10,            
            "cess": 0,
            "total": 100
        }
    ],
    // "ledgers": [
    //     {
    //         "ledger_id": 79968,
    //         "additional_description": "test",
    //         "rpu_with_gst": 100,
    //         "rpu_without_gst": 100,
    //         "gst_id": 10,
    //         "gst_tax_percentage": 10,
    //         "with_tax": 0,
    //         "discount_type": 1,
    //         "discount_value": null,
    //         "discount_type_2": 1,
    //         "discount_value_2": null,
    //         "total": 1000
    //     }
    // ],
    "gross_value": 100,
    "narration": "Hello World",
    "additional_charges": [
        {
            "ac_ledger_id": 79971,
            "ac_type": 1,
            "ac_value": 100,
            "ac_total": 100
        }
    ],
    "taxable_value": 100,
    "add_less": [
        {
            "al_ledger_id": 7655,
            "al_is_show_in_print": 0,
            "al_type": 1,
            "al_value": 100
        }
    ],
    "main_classification_nature_type": "Interstate Purchase Taxable",
    "is_rcm_applicable": 0,
    "cgst": 0,
    "sgst": 0,
    "igst": 0,
    "cess": 0,
    "rounding_amount": null,
    "grand_total": 100,
    "is_gst_enabled": 0,
    "is_cgst_sgst_igst_calculated": 0,
    "is_gst_na": 1,
    "is_round_off_not_changed": false
}'

Responses

🟢200Update Purchase Order
application/json
Body
data
object 
required
purchase_order_transaction
object 
required
transaction_id
integer 
required
A unique identifier is assigned to the purchase order transaction.
success
boolean 
required
message
string 
required
Example
{
    "data": {
        "purchase_order_transaction": {
            "id": 1,
            "company_id": 6,
            "title": 1,
            "order_number": "4",
            "full_order_number": "4",
            "order_type": 2,
            "order_date": "2025-02-11T18:30:00.000000Z",
            "valid_for": 10,
            "valid_for_type": 1,
            "valid_till_date": "2025-12-11T18:30:00.000000Z",
            "party_ledger_id": 5,
            "gstin": null,
            "broker_id": null,
            "brokerage": null,
            "brokerage_on_value_type": null,
            "transport_id": null,
            "transporter_document_number": null,
            "transporter_document_date": null,
            "transporter_vehicle_number": null,
            "shipping_name": null,
            "shipping_gstin": null,
            "shipping_freight": null,
            "shipping_freight_with_gst": 0,
            "shipping_freight_cgst_amount": null,
            "shipping_freight_sgst_amount": null,
            "shipping_freight_igst_amount": null,
            "packing_charge": null,
            "packing_charge_with_gst": 0,
            "packing_charge_cgst_amount": null,
            "packing_charge_sgst_amount": null,
            "packing_charge_igst_amount": null,
            "cgst": 0,
            "sgst": 0,
            "igst": 0,
            "cess": 0,
            "round_off_amount": null,
            "total": 100,
            "grand_total": 100,
            "taxable_value": 100,
            "gross_value": 100,
            "narration": "Hello World",
            "is_gst_enabled": 0,
            "is_gst_na": 1,
            "is_cgst_sgst_igst_calculated": 0,
            "status": "Open",
            "is_round_off_not_changed": false,
            "transaction_items": [
                {
                    "id": 1,
                    "transactions_id": 1,
                    "item_id": 5,
                    "ledger_id": 848,
                    "additional_description": "test",
                    "unit_id": 1,
                    "quantity": 1,
                    "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": 18,
                    "total": 100,
                    "cess_rate": 0,
                    "cess_amount": 0,
                    "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",
                    "taxable_value": 100,
                    "created_at": "2025-02-12T12:41:55.000000Z",
                    "updated_at": "2025-02-12T12:41:55.000000Z"
                }
            ],
            "via_api": false,
            "created_by": 8,
            "created_at": "2025-02-12T12:40:55.000000Z",
            "updated_at": "2025-02-12T12:41:55.000000Z"
        }
    },
    "success": true,
    "message": "Purchase Order Transaction Updated Successfully."
}
Modified at 2025-04-03 10:22:32
Previous
Edit purchase Order
Next
Duplicate purchase Order
Built with