Skip to main content

​
Overview

The Inventory Delta Export Feed is a Kibo-managed automated export that periodically queries your inventory for recently changed records and delivers a compressed CSV file to a destination of your choice. It is designed for scenarios where you need to keep a downstream system (e.g., a warehouse management system, an external marketplace, or a third-party platform) in sync with your Kibo inventory without pulling a full inventory snapshot each time.
Looking to push inventory changes into Kibo on a recurring basis instead? The Inventory Import File supports incremental update files (sometimes called a delta import feed) that apply quantity adjustments throughout the day.

​
How to Get Started

To set up an Inventory Delta Export Feed for your tenant, open a support ticket at help.kibocommerce.com with the following information:

​
Required Information

​
Delivery Destination Options

Choose one of the following delivery methods and provide the corresponding details:

​
Option 1 — Amazon S3

  • S3 bucket name (and optional key prefix/folder path)
  • AWS region
  • IAM role or policy granting Kibo write access to the bucket

​
Option 2 — Google Cloud Storage (GCS)

  • GCS bucket name (and optional folder path)
  • A service account or Workload Identity Federation configuration with write access to the bucket

​
Option 3 — SFTP

  • SFTP hostname and port
  • Username and password (or SSH key)
  • Remote directory path where files should be deposited

​
How It Works

Once configured, the feed runs automatically on a schedule. On each run, Kibo:
  1. Identifies all inventory records that were updated since the last successful run
  2. Exports those records to a CSV file
  3. Compresses the CSV into a ZIP file
  4. Uploads the ZIP to your configured destination
If no inventory records changed during a given interval, no file is uploaded for that interval.

​
Timing Window

  • By default, each run captures changes from the last 30 minutes.
  • The timing window is tracked automatically — you do not need to manage state on your end.
  • If a run is delayed or missed, the system will not exceed a 4-hour catch-up window to prevent unexpectedly large exports
The 30-minute timing window and automatic last-run tracking described above apply to standard (non-prefixed) export configurations. Exports using the DELTA_EXPORT_ prefix use a fixed 24-hour lookback window instead. See Filtering by Location Group.

​
Filtering by Location Group

By default, each delta export run includes inventory records from all locations in your tenant. If you need to scope an export to a specific subset of locations — for example, only warehouse locations, only retail stores, or only a regional set of stores — you can link the export configuration to one or more Location Groups.

​
Requirements

Three conditions must be met for location group filtering to take effect:
  1. The export settings name must begin with DELTA_EXPORT_ (for example, DELTA_EXPORT_WAREHOUSE or DELTA_EXPORT_MEX_STORES). Export configurations whose names do not use this prefix will export all tenant locations regardless of any Location Group association.
  2. One or more Location Groups must be linked to the export settings record.
  3. At least one active storage destination (S3, GCS, or FTP) must be configured on the export settings record. Records with no active destination are not processed by the cron, even if they match the DELTA_EXPORT_ naming prefix.
Important: If your export settings name does not start with DELTA_EXPORT_, location group filtering will not be applied — the export will deliver all tenant locations. Double-check the configuration name if filtered results are not appearing as expected.

​
Lookback Window

Exports using the DELTA_EXPORT_ prefix use a fixed 24-hour lookback window — each run queries for inventory records updated within the last 24 hours. This is different from the standard (non-prefixed) export path, which tracks a dynamic last-run timestamp per tenant.
If no inventory records changed within the lookback window, no file is uploaded for that run.

​
Configuring Multiple Filtered Exports

You can run multiple filtered exports simultaneously, each targeting a different location group and writing to a different destination. Create a separate export settings record for each, naming each with the DELTA_EXPORT_ prefix and linking the appropriate Location Group in the Export Settings. Example: All DELTA_EXPORT_ configurations run within the same cron invocation, on a schedule determined by your deployment configuration. Each delivers a separate ZIP file to its own destination — or skips upload if no inventory changes were found in the lookback window.

​
Backward Compatibility

Existing export configurations that do not use the DELTA_EXPORT_ prefix are unaffected by this change. They continue to export all tenant locations using the dynamic last-run tracking, without any reconfiguration required.

​
Output File Format

Each delivery is a ZIP archive containing a single file named inventory.csv.

​
ZIP File Naming

Example: 100041_20240815143000.zip

​
CSV Structure

The CSV includes a header row. The base columns are:

​
Future Inventory Columns

Future inventory data in the Delta Export is opt-in per tenant. When enabled, five additional columns appear in the CSV output. When the flag is off, the export output is identical to its previous format — no new columns are added. To enable future inventory columns in your Delta Export, make sure to keep include_future_inventory flag enabled
Only future inventory records with a delivery date on or after the current date are included.
When enabled, the following columns are added to the CSV: When both include_future_inventory andonlySendAvailable export setting are enabled, products with zero current availability but positive future availability are included in the export. A product is only excluded if both its current available quantity and future available quantity are zero or less.
If future inventory is deleted via the API (DELETE /futureInventory), the delta export will not reflect that removal until the next regular inventory update occurs on that row.

​
Optional Columns

The following columns can be enabled on request:

​
Example CSV

​
Frequently Asked Questions

What if no inventory changed during an interval? No file is uploaded for that interval. Your destination will simply have no new file for that run. What time zone are timestamps in? All timestamps are in UTC. Can I receive files more or less frequently than every 30 minutes? This setting is fixed at 30 minutes and does not support customization. Can I receive files to more than one destination? Yes — include all destination details in your support ticket. What does available represent exactly? available = raw on-hand quantity - safety stock - pending allocations. onHand = raw on-hand - safety stock only. Use rawOnHand if you need the unmodified quantity. What if an extensible attribute has multiple values? Multi-value attributes are serialized as a pipe-delimited string in a single column. For example, a Color attribute with values Red and Blue would appear as Red|Blue. How do I enable future inventory columns in my delta export? In your export settings make sure include_future_inventory option is enabled. Once enabled, five new columns will appear in your CSV output: Allocated, FutureOnHand, FutureAvailable, FutureAllocated, and FutureInventoryDate. If the setting is off, your export format remains unchanged. Can I filter the delta export to only certain store locations or warehouses? Yes. Kibo supports location group filtering for delta exports. Name your export settings with a DELTA_EXPORT_ prefix (for example, DELTA_EXPORT_WAREHOUSE) and link the desired Location Groups in the Export Settings. Each filtered configuration uses a fixed 24-hour lookback window and can deliver to its own destination. Exports configured without the DELTA_EXPORT_ prefix are unaffected and continue to export all tenant locations. See Filtering by Location Group for full details.