Overview

ExcerptThis method allows you Use this method to update an existing invoice item on Invoice Item in Komet Sales. 

Request

URL: https://api.kometsales.com/api/invoice.item.update

Method: POST

Content-Type:

Application/

JSON

Input Parameters

• authenticationToken (required)(string:20): Komet Sales security token.

• invoiceId (required)(integer:20): the Komet Sales invoice internal ID that you want to update. You can obtain this value from the invoice.create API method.

• invoiceItemId (required)(number:20): ID of the Komet Sales invoice item. This value can be obtained from the invoice.create API method.

• boxes (optional)(integer:10): new number of boxes.

• price (required) (decimal:10,2): new unit price.

• discount (optional) (decimal:10,2) : discount percentage.

• markCode (optional)(string:20): new mark code.

• productAlias (optional)(string:50): new product description alias.

• notes (optional)(string:200): new item notes.

• returnAvailableBoxes (optional)(boolean: 1 or 0): default 0. If it's 1, the response will include the number of boxes available.

Sample Request

{
  "authenticationToken": "token_info_goes_here",
  "invoiceId": "085063",
  "invoiceItemId": 9999999,   
  "boxes": 5, 
  "price": 2.50,
  "discount": 10,
  "markCode": "text for mark code", 
  "productAlias" : "text for product alias", 
  "notes": "text for notes"
}

{
  "authenticationToken": "token_info_goes_here",
  "invoiceId": 08506385063,
  "invoiceItemId": 9999999,   
  "boxes": 5, 
  "price": 2.50,
  "markCode": "text for mark code", 
  "productAlias" : "text for product alias", 
  "notes": "text for notes",
  "returnAvailableBoxes":1
}

Response

Output

• status (integer:1): transaction status. 1 for success or 0 for failure.

• message (string:500): description of the status of the transaction.

• invoiceId (integer:20): invoice ID.

• invoiceNumber (integer:10): invoice number.

• invoiceItemId (integer:20): invoice item ID.

• availableBoxes (integer:10): number of boxes that are available if returnAvailableBoxes is given.

Sample Response

  {
  "status": "1",
  "message": "success",
  "invoiceId": 111111111,
  "invoiceNumber": "9999999",
  "invoiceItemId": 32323
 }

{
  "status": "1",
  "message": "success",
  "invoiceId": 111111111,
  "invoiceNumber": "9999999",
  "invoiceItemId": 32323,
  "availableBoxes": 2
 }