Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This method retrieves a list of the current items in the hard goods inventory. This method works with Companytypetokens.

Tip

Valid Tokens: Company.


Filter by label (Content by label)
showLabelsfalse
max5
titleRelated Articles
cqllabel in ( "hard-goods" , "company-token" , "inventory" )

Request


Params

Parameters.


Header

authenticationToken (required)(string:50)

:

Komet Sales security token.


Input Parameters

locationId (required)(integer:20)

:

Komet Sales internal Location ID. Only applies to Multi-Location companies.

You can get this value from the location.list API method.

This only applies to Companies in Multi-Location mode.


vendorCode (optional)(string:50)

:

Code of the

vendor

Vendor that supplies the

items

products.

You can get this value from the vendor.list API method.


sku (optional)(string:50)

: SKU associated with the item in the inventory

The inventory item SKU number.


category (optional) (string: 100)

:

Category name.

curl


Code Block
languagejs
https://api.kometsales.com/api/hardgood/inventory.list?authenticationToken=token_info_goes_here&locationid=2321

Response

Output

inventoryItems: array of

inventoryItems (array)

An array containing available inventory items.


inventoryIds (string:200)

:

Inventory Item IDs that

represents

represent the lines listed separated by commas.


vendorId (integer: 20)

:

Vendor Komet Sales internal ID.


productId (integer:20)

: product

Komet Sales internal product ID.


productVendorId (integer:20)

: ID of the product associated with the vendor

The Vendor ID.


productDescription (string:200)

: product

Product description.


locationCode (optional)(string:10)

:

The Location code.

It

Only applies

for

to Multi-Location companies.


locationName locationName (string:200)

: location

Location name.


locationId (integer:20)

:

Komet Sales internal Location ID

of the location

.


categoryId (integer:20)

:

Komet Sales internal category ID.


category (string:200)

: category

Category description.


subcategory (string:200)

: subcategory

Subcategory description.


color (string:100)

:

Product color

of the product

.


sku (string:50)

:

Product SKU

of the product

.


quantity (integer:20)

:

Available quantity

available

.


packSize (integer:20)

: number

Number of units per box.


totalUnits (integer:20)

: total

Total available units

available

regardless of the product pack quantity.


unitPrice (decimal:10,2)

:

Individual unit price

or price per individual unit

.


image (string:200)

: The url of the product image, if it exists

Product’s image URL.


unitCost (decimal:10,2)

: The cost per unit in the inventory

Individual unit cost.


unitLandedCost (decimal:10,2)

:

The total landed cost per unit in the inventory.


message (string:500)

: contains

Transaction status description

of request

.


status (integer:1)

: transaction

Transaction status. 1

for success or 0 for failure/error.

Sample Response

= Success | 0 = Failure


Code Block
languagejs
{
   "inventoryItems": [
      {
         "inventoryIds": "69",
         "vendorId": 6322,
         "productId": 652,
         "productVendorId": 27,
         "productDescription": "Alcatraz negro ( Soft thing )",
         "locationCode": null,
         "locationName": null,
         "locationId": null,
         "categoryId": 13371,
         "category": "Soft thing",
         "subcategory": "Margaritas",
         "color": "negro",
         "sku": "11111",
         "quantity": 183,
         "packSize": 3,
         "totalUnits": 549,
         "unitPrice": 2003.32,
         "image": null,
         "unitCost": 1.2,
         "unitLandedCost": 1.2
      }
   ],
   "message": "OK",
   "status": "1"
}
Panel
titleRelated Articles
Filter by label (Content by label)showLabelsfalsemax10showSpacefalsesorttitlecqllabel in ( "add-inventory" , "inventory" )labelsadd-inventory inventory