invoice.item.add

This 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 to companies in Multi-Location mode. 

Sample 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"
}