Skip to main content
If tags have been enabled, then every single inventory record will be associated with those tags. However, items do not need to have tags specified in the order data. If an item does have a tag name provided in the order, then an associated value must be included as well. For example, if your configuration has the tags OrderType and Channel and you only care about a certain item’s OrderType, then specify the OrderType tag and its value. Do not include the Channel tag and it will be set to the default. If neither of these tags mattered for the product, then would exclude them both from the item data.

​
Set Tags via API

An example of an Inventory Refresh call that sets inventory data with discrete tag values: 
{
  "locationCode": "examplelocation",
  "items": [
    {
      "upc": "AD1001",
      "quantity": 100,
      "tags": {
        "Channel": "Warehouse"
      }
    },
    {
      "upc": "AD1001",
      "quantity": 50,
      "tags": {
        "Channel": "Target"
      }
    }
  ]
}
By default, the quantity provided in this request (as well as in the inventory file import shown below) is used for the On Hand value. The system will then calculate the appropriate Available amount. If you want to change this behavior so that quantity is applied directly as the Available inventory value, contact Kibo Support to update your tenant configurations.

​
Upload Tagged Inventory Files

The inventory import process also supports segmentation, so you can use this file upload to apply your tags instead of doing it via API. To do this, add the tag name as a column header after the default headers and insert the tag value into the column value. The example below shows a sample file with Channel and OrderType tag columns: 
LOCATIONCODE,PARTNUMBER,UPC,SKU,QUANTITY,DELIVERY_DATE,Channel,OrderType
Spatula_LA_WH,SpatulaTestPartNumber,SpatulaTestUPC,SpatulaTestSKU,10,,,
Spatula_DAL_WH,SpatulaTestPartNumber3,SpatulaTestUPC3,SpatulaTestSKU3,30,,Amazon,CarrierPigeon

​
Redistribute Tagged Inventory

Inventory should be periodically redistributed between your channels based on the allocation percentages. You can do this on-demand by calling the Inventory Redistribution API with the UPCs and/or location codes you want to redistribute across. Asynchronous redistribution will then occur at the next Refresh or Adjust update to restore the appropriate amount of inventory to the designated channels.