Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
This method allows you to obtain a list of the current available inventory in
boxes. This method works either with tokens type "Company" and "Vendor".Boxes.
Request
URL: https://api.kometsales.com/api/inventory.list
Method: GETParameters:
Content-Type: URL Parameters
Input Parameters
authenticationToken (required) (string:50): Komet Sales security token.
includeBoxes:* (optional) (integer:1) 1 include boxes. 0 or empty does not include boxes.
inventoryType:* (optional) (string:5). valid values: all or M, L, S, P (OpenMarket, Local, Standing Order, and Prebook), M is the default option. You can enter different values separated by commas (L, S, P). With "all" you will include all the options.
excludeHeldItems (optional)(boolean: 1 or 0): default 0. If it's 1, the response will exclude items that are in hold.
lotNumber (optional)(integer: 6): Lot number that identifies the inventory item.
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.
curl
Code Block | ||
---|---|---|
| ||
https://api.kometsales.com/api/inventory.list?
authenticationToken=token_info_goes_here&locationid=2321 |
Response
Output
:status (integer:1):
transactionTransaction status. 1 for
sucesssuccess or 0 for failure/error.
message (string:500):
containsContains a status description of the request.
inventoryItems:
arrayArray of available inventory items.
companyProductId (integer:20): ID of the product.
orderItemId (integer:20): Inventory Item ID.
grade (string:100):
gradeGrade or product cut point.
productDescription (string:200):
productProduct description.
productCode (optional)(string:50):
productProduct legacy code.
quantity (integer:20):
numberNumber of available boxes.
totalUnits (integer:20):
totalTotal units. When unit type is bunch this is the number of total bunches; when the unit type is stem this is the number of total stems.
growerId (integer: 20):
growerGrower or
vendorVendor ID.
growerName (string:200):
growerGrower or
vendorVendor name.
boxTypeId (integer:20):
boxBox type ID.
boxTypeCode (string:3):
code used that corresponds toCode for the size of the box (i.e. FB, EB, etc.).
unitType (string:5):
unitUnit type (Bunch or Stem).
bunches (integer:20):
numberNumber of bunches per box.
unitsPerBox (integer:20):
unitsUnits per box or pack.
stemsBunch (integer:20)
number: Number of stems per bunch.
inventoryDate (date):
inventoryInventory date.
price (decimal:10,2):
unitUnit price or price per individual item.
NoNot available when the token used is type Vendor.
sellFast (boolean: true/false):
indicates whether thisIndicates if the item qualifies as sell-fast.
localAfter (integer:10):
theThe number of days set for the category
orof the product in the local after setting.
isAssorted (
boleanboolean: true/false):
indicates whetherIndicates if this item is assorted or it has breakdowns.
category (string: 200):
categoryCategory name.
awb (string:20):
air waybillAir Way Bill number.
unitCost (decimal:10,2):
unitUnit cost.
landedCost (decimal: 10,2):
unit landed costUnit Landed Cost.
reference (string:100):
itemItem reference.
lotNumber (integer:10):
lotLot number.
markCode (string:20):
markMark code or item label.
aging (integer:20):
theThe amount of time (in days) the item has been in inventory.
breakdowns:
an arrayArray of breakdowns (empty when isAssorted is false).
assortedCompositionId (integer:20):
breakdownBreakdown item ID.
productId (integer:20):
productProduct ID.
productDescription (string:200):
breakdownBreakdown product description.
bunches (integer:20):
numberNumber of bunches.
stemsBunch (integer:20):
numberNumber of stems per bunch.
cost (decimal:10,2):
unitUnit cost.
price (decimal:10,2):
unitUnit price.
NoNot available when the token used is type Vendor.
width | 100% |
---|---|
language | js |
theme | Confluence |
title | Response Example |
height | 850 |
Sample Response
Code Block |
---|
{ "message": "success", "status": "1", "inventoryItems": [ { "companyProductId": 999999, productId "orderItemId": 2172049999999, "grade": "60 Cm", "productDescription": "Arrangement Fresh FlowersAgapanthus Blue Crme de la Crme 60 Cm", "quantity": 85, "categorytotalUnits": 12240, "ArrangementgrowerId": 21738, "growerName": "Follajes La Luna", "categoryIdboxTypeId": 11457900, "boxTypeCode": "FB", "unitType": "Stem", "bunches": 12, "bunchesunitsPerBox": 86144, "stemsBunch": 12, "stemsBunchinventoryDate": 1"2014-03-02", "price": 3.01389, "totalUnitssellFast": 86false, "isAssorted": false, "unitLandedCostcategory": 3.3"Agapanthus", "awb": "131322", "unitPriceunitCost": 4.02, "localAfter": 7, "totalPricelandedCost": 3442.017, "reference": "text for reference", "inventoryUnitsIdslotNumber": "17304308", "markCode": "text for mark code", "inTransitaging": null10, "breakdowns": [ "vendorId": null, { "vendorassorteCompositionId": null9999, "productDescription": "text "localfor product description", "companyIdproductId": 703099999, "bunches": 10, "locationCode "stemsBunch": "02"12, "locationNamecost": "Waterloo", 0.56, "locationIdprice": 31.25 } ] } ] } |
Panel | ||
---|---|---|
| ||
Tip | ||
Valid Tokens: Company and Vendor. |
Filter by label (Content by label) | ||||
---|---|---|---|---|
|
|
|
|
|