Fluent Commerce Logo
Docs
Sign In

How Inventory Batch Pre-Processing works

Essential knowledge

Author:

Fluent Commerce

Changed on:

12 Feb 2025

Overview

This document outlines the functionality of Inventory Batch Pre-Processing, offering insights into how unchanged records are filtered during the inventory ingestion process using Inventory Batches.

Key points

  • Efficient Processing: Inventory Batch Pre-Processing handles batch inventory updates before they reach the inventory workflows, streamlining the process.
  • Change Detection: Identifying inventory records that have changed, ensuring the workflow engine processes only necessary updates.
  • Performance Improvement: Reduces workflow engine load by filtering unchanged records, enabling faster and more efficient inventory processing.
  • Enhanced Flexibility: Supports additional fields in batch records, allowing for more precise control and management of inventory updates.

Pre-requisites

Architecture

Overview

No alt provided

In traditional inventory update processes, batch updates are split into individual records and added directly to the Inventory Queue for processing. This can be inefficient, especially when many records haven't changed and don't require processing.

Batch Pre-Processing introduces a more efficient flow:

  • Initial Analysis: Instead of immediately processing each record, the system first analyzes the batch to identify which records have actually changed.
  • Selective Processing: The workflow engine forwards only the records identified as changed to the Inventory Queue for processing.
  • Optimized Workflow: This reduces unnecessary workload on the workflow engine, improving overall system performance and reducing processing time.

Components

The Batch Pre-Processing system consists of two main components:

1. Loader Job

Purpose

The Loader Job loads existing inventory data from the database. This includes current quantities, statuses, and any active transient inventory quantities.

Function:

  • Data Gathering: Collects the current state of inventory positions and quantities.
  • Preparation for Comparison: Prepares data for the Comparison Job to use in determining changes.

2. Comparison Job

Purpose: The Comparison Job compares the new batch updates against the existing inventory data loaded by the Loader Job.

Function:

  • Change Detection: Determines whether each inventory update represents a change that needs processing.
  • Criteria for Change:
    • Inventory Quantity Identification:
    • Quantity and Status Comparison:
    • Transient Inventory Quantities Check:

Result: Only updates marked as changed are forwarded to the Inventory Queue for processing.

Understanding Transient Inventory Quantities

  • Definition: Transient inventory quantities are temporary adjustments due to sales, reservations, corrections, or other activities.
  • Significance: Their presence indicates recent activity affecting the inventory position, necessitating reprocessing of the update.

Decision Logic Flow

Here's a detailed breakdown of how the Comparison Job decides whether an update is "changed" or "unchanged"  for each inventory record in the batches processed for the current preprocessing execution :

No alt provided
Fluent Commerce

Fluent Commerce

Copyright © 2025 Fluent Retail Pty Ltd (trading as Fluent Commerce). All rights reserved. No materials on this docs.fluentcommerce.com site may be used in any way and/or for any purpose without prior written authorisation from Fluent Commerce. Current customers and partners shall use these materials strictly in accordance with the terms and conditions of their written agreements with Fluent Commerce or its affiliates.

Fluent Logo