Versions Compared

Key

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

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
languagejs
https://api.kometsales.com/api/inventory.list?
authenticationToken=token_info_goes_here&locationid=2321

Response

Output

:

  • status (integer:1):

    transaction

    Transaction status. 1 for

    sucess

    success or 0 for failure/error.

  • message (string:500):

    contains

    Contains a status description of the request.

  • inventoryItems:

    array

    Array of available inventory items.

    • companyProductId (integer:20): ID of the product.

    • orderItemId (integer:20): Inventory Item ID.

    • grade (string:100):

      grade

      Grade or product cut point.

    • productDescription (string:200):

      product

      Product description.

    • productCode (optional)(string:50):

      product

      Product legacy code.

    • quantity (integer:20):

      number

      Number of available boxes.

    • totalUnits (integer:20):

      total

      Total 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):

      grower

      Grower or

      vendor

      Vendor ID.

    • growerName (string:200):

      grower

      Grower or

      vendor

      Vendor name.

    • boxTypeId (integer:20):

      box

      Box type ID.

    • boxTypeCode (string:3):

      code used that corresponds to

      Code for the size of the box (i.e. FB, EB, etc.).

    • unitType (string:5):

      unit

      Unit type (Bunch or Stem).

    • bunches (integer:20):

      number

      Number of bunches per box.

    • unitsPerBox (integer:20):

      units

      Units per box or pack.

    • stemsBunch (integer:20)

      number

      : Number of stems per bunch.

    • inventoryDate (date):

      inventory

      Inventory date.

    • price (decimal:10,2):

      unit

      Unit price or price per individual item.

      No

      Not available when the token used is type Vendor.

    • sellFast (boolean: true/false):

      indicates whether this

      Indicates if the item qualifies as sell-fast.

    • localAfter (integer:10):

      the

      The number of days set for the category

      or

      of the product in the local after setting.

    • isAssorted (

      bolean

      boolean: true/false):

      indicates whether

      Indicates if this item is assorted or it has breakdowns.

    • category (string: 200):

      category

      Category name.

    • awb (string:20):

      air waybill

      Air Way Bill number.

    • unitCost (decimal:10,2):

      unit

      Unit cost.

    • landedCost (decimal: 10,2):

      unit landed cost

      Unit Landed Cost.

    • reference (string:100):

      item

      Item reference.

    • lotNumber (integer:10):

      lot

      Lot number.

    • markCode (string:20):

      mark

      Mark code or item label.

    • aging (integer:20):

      the

      The amount of time (in days) the item has been in inventory.

    • breakdowns:

      an array

      Array of breakdowns (empty when isAssorted is false).

      • assortedCompositionId (integer:20):

        breakdown

        Breakdown item ID.

      • productId (integer:20):

        product

        Product ID.

      • productDescription (string:200):

        breakdown

        Breakdown product description.

      • bunches (integer:20):

        number

        Number of bunches.

      • stemsBunch (integer:20):

        number

        Number of stems per bunch.

      • cost (decimal:10,2):

        unit

        Unit cost.

      • price (decimal:10,2):

        unit

        Unit price.

         No

         Not available when the token used is type Vendor.

Elite soft json viewer
width100%
languagejs
themeConfluence
titleResponse Example
height850

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
titleRelated Articles
Tip

Valid Tokens: Company and Vendor.

Filter by label (Content by label)
showLabelsfalse
max10
showSpace
sort
false
title
sort
title
title
Related Articles
cqllabel in ( "add-inventory" , "inventory" )
labelsadd-inventory inventory