Enabling Batch Pre-Processing

To ensure that Batch Pre-Processing works correctly and won’t impact your inventory accuracy, the first step is to ensure your inventory workflows are compatible with Batch Pre-Processing.

Batch Pre-Processing is based on the logic within the inventory module. This diagram details the high-level view of the logic.

Signs of a compatible workflow

• It uses the inventory module reference workflow and reference plugin
• The types of transient quantities are in line with the standard examples
• There’s no customisation in the first few rulesets (specifically between InventoryChanged and NotifyVirtualCatalogues)
  • CheckOnHandChanged is a key ruleset to compare logic

Signs of an incompatible workflow

• The workflow executes logic on unchanged inventory records
• Usage of new and custom transient quantity types
• Custom rules and custom rulesets within the Inventory workflow

To enable Batch Pre-Processing, you must ensure the setting

`fc.enable.batch.preprocessing`

`fc.enable.batch.preprocessing`

Once the setting is updated, within 5 minutes (the setting cache refresh time), all batch inventory updates will go through Batch Pre-Processing before reaching the inventory workflows.

Due to the way Batch Pre-Processing works, it is most efficient with large amounts of updates and a significant unchanged rate. Through our Metrics API we provide metrics to track the total number of batch items processed and the ratio of unchanged items.

Desired volumes

For the total amount of batch inventory updates, you should be aiming for the following:

• At least 1 million total per day
• Grouped in batches of at least 100,000

For the unchanged rate of batch inventory updates, you should be aiming for the following:

• Ideally, the unchanged rate should be greater than 50%
  • Once the unchanged rate falls below 50% (the majority of submitted changes are considered updates), Batch Pre-Processing loses its efficiency gains vs batch inventory updates going straight into workflows
  • Most retailers have an unchanged rate of greater than 80%

Using the Metrics API to analyse

Finding total amount

The metric to use here is bpp_records_processed_total. This will return the total count of all batch inventory updates processed through Batch Pre-Processing for the given time period

Find the unchanged rate

This will use an additional metric. To calculate the unchanged rate you will want to divide the total unchanged records by the total records. The metric for unchanged records is bpp_records_unchanged_total.

E.g. (bpp_records_unchanged_total / bpp_records_processed_total)