Overview

ExcerptThis method allows you to add an item to an existing invoice on Komet Sales. 

Request

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

Method: POST

Content-Type: application/

JSON

Input Parameters

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

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

• orderItemId (required)(integer:20): ID of the Komet Sales internal inventory item. This field is required if productCode is not given. This value can be obtained from the inventory.list API method.

• productCode (required: if orderItemId is not given)(string:20): product code of the Komet Sales inventory item. This field is required if orderItemId is not given. You can obtain this value from the product.list API method.

• boxTypeCode (required: if orderItemId is not given)(string:3): box type code of the Komet Sales inventory item. This field is required if orderItemId is not given. You can obtain this value from the boxtype.list API method.

• unitsPerBox (required: if orderItemId is not given)(integer:10): units per box.

• unitType (required: if orderItemId is not given)(string:5): stem or bunch are the unique valid values.

• boxes (required)(integer:10): number of boxes.

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

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

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

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

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

• locationId (optional)(integer:20): location Komet Sales internal ID. You can obtain this value from the location.list API method. This only applies

  for

  to companies in Multi-Location mode. 

Note
You can use either orderItemId or the productCode, boxTypeCode, unitsPerBox, and unitType, but you cannot use both parameters at the same time.

theme

Code Block
language	js
	Confluence	title

Sample

{
  "authenticationToken": "token_info_goes_here",
  "invoiceId": 85063,
  "orderItemId": 9999999,   
  "boxes": 5, 
  "price": 2.50,
  "markCode": "text for mark code", 
  "productAlias" : "text for product alias", 
  "notes": "text for notes"
}

Request

{
  "authenticationToken": "token_info_goes_here",
  "invoiceId": 85063,
  "productCode": "RS50",   
  "boxTypeCode": "HB",
  "unitsPerBox": 150,
  "unitType": "Stem",
  "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.

Sample Response

{
  "status": "1",
  "message": "OK"
}