Overview

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

  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.

Elite soft json viewer
width 100% language js theme Confluence title Sample 1 height 200
{ "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" }

270

Elite soft json viewer
width	100%
language	js
theme	Confluence
title	Sample 2
height

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

width100%languagejsthemeConfluencetitle

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

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

  
  

Elite soft json viewer

Sample Response

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