Fluent Commerce Docs

This article introduces Sourcing Criteria as the ranking (and exclusion) functions that score candidate Locations during Strategy evaluation. You’ll learn how Criteria order affects final rankings, which reference Criteria are available, and how to extend the library with custom implementations.

Author:

Kirill Gaiduk

Changed on:

2 Oct 2025

Overview

Sourcing Criteria determine which eligible Locations are best once a Strategy applies. You’ll learn how to configure, sequence, and extend Criteria so your prioritization is predictable and explainable across business scenarios.

Key points

Define prioritization with configurable Sourcing Criteria that score and order candidate Locations
Reference Sourcing Criteria schema is global and can be extended or overridden with customer-specific definitions for tailored Strategies
Criterion Utilities provide reference functions, normalization, and a registry/annotations model for custom extensions
Configure all Criteria with clear names, parameters, and evaluation order to ensure accurate and predictable ranking

What is a Sourcing Criterion?

A Sourcing Criterion is a function that returns a numeric rating for a Location (or excludes it by returning -1). Criteria are evaluated only after a Strategy passes its Conditions. Typical examples:

Proximity: `locationDistance`, `locationDistanceBanded`, `locationDistanceExclusion`
Availability-driven: `inventoryAvailability`, `inventoryAvailabilityBanded`, `inventoryAvailabilityExclusion`
Business preference: `networkPriority`, `locationTypeExclusion`, `locationNetworkExclusion`
Operational: `locationDailyCapacity`

Architectural Context

Sourcing Criteria are part of the Responsive Sourcing Framework within the Fluent platform. They sit in several places within the platform, each serving a distinct role:

1. Sourcing Criterion Entity

Sourcing Criterion Entity is represented by the `SourcingCriterion` GraphQL type.It refers to an individual, concrete instance of a Sourcing Criterion that is configured as part of a Sourcing Strategy.

Structure

Field	Type	Description	Notes
`name`	`String`	Name of the Sourcing Criterion	The `name` serves as a unique identifier for Sourcing CriteriaReference Sourcing Criteria schema (specified in the `fc.rubix.order.sourcing.criteria` Setting) can be overridden by using the same `name` and alternative configuration in the `fc.rubix.order.sourcing.criteria.custom` Setting
`type`	`String`	Type of the Sourcing Criterion	The `type` is mapped to a specific function in the `util-sourcing` library (Criterion Utilities)
`params`	`Json`	Parameters of the Sourcing Criterion	The Parameters configure Sourcing Criteria to support specific customer sourcing logicAvailable configuration options are defined with the `fc.rubix.order.sourcing.criteria` and `fc.rubix.order.sourcing.criteria.custom` Settings

Reminder

Use the Sourcing Profile GraphQL API to:

Add a Sourcing Criterion to a Primary / Fallback Sourcing Strategy (`CreateSourcingCriterionInput`)
Check the configured Sourcing Criteria (`sourcingCriteria` sub-query)

2. Sourcing Criteria Schema

The Sourcing Criteria schema is located in the dedicated Setting(s):

`fc.rubix.order.sourcing.criteria` stores reference (`GLOBAL`) Sourcing Criteria schema
`fc.rubix.order.sourcing.criteria.custom` can be created for customer-specific (`ACCOUNT` / `RETAILER`) Sourcing Criteria schema

It defines the structure of a Criterion and specifies which parameters it can include. In practice, it acts as the template for a Sourcing Criterion that is added to the Criteria library, making it available for configuration and use by end users.

Reminder

Override the reference schema by reusing the same Criterion `name` in the custom schema with alternate configuration.

3. Criterion Utilities

Criterion Utilities are an integral part of the Sourcing Utilities bundle.

Java Docs

The helper methods contained in the Utility Bundles libraries are many and varied, so the JavaDocs provided with the packages should be treated as the source of truth for documentation.

They include:

Reference Criterion Functions
- Implemented as classes extending `BaseSourcingCriterion`
- Each class encapsulates the logic for scoring (or excluding) Locations, for example:
  - `LocationDistanceCriterion` – calculates distance between destination and Location
  - `InventoryAvailabilityCriterion` – evaluates available stock coverage
  - `NetworkPriorityCriterion` – prioritizes Locations based on Network membership
- Criterion classes can override `normalize()` to adjust rating scales (e.g., smaller distance = higher score)
Annotations and Auto-Generation
- `@SourcingCriterionInfo` - defines metadata such as `name`, `type`, `tags`, and `label`
- `@SourcingCriterionParam` - specifies configurable parameters, UI component type, and options
- These annotations are processed to automatically generate the Sourcing Criteria Schema JSON, which feeds the configuration UI
Helper Methods (`SourcingCriteriaUtils`)
- `CriteriaArray` - stacks multiple Criteria for sequential evaluation and tie-breaking
- `normalize()` - scales ratings across all candidate Locations into a [0..1] range
- Utility methods (`getFloats`, `getStrings`, `getDistanceUnits`) - parse parameter values from JSON configs
- `getCriteria(...)` - merges default and Strategy-specific Criteria into a single evaluation stack
Criterion Registry (`SourcingCriteriaTypeRegistry`)
- Registers and retrieves Criterion classes by their type identifier
- Dynamically instantiates Criterion implementations during Strategy evaluation
- Supports extension with custom Criterion classes through explicit registration

Features

Within the Responsive Sourcing Framework, Sourcing Criteria provide the ability to:

Prioritize fulfillment Locations by configuring Criteria that score, rank, or exclude candidates
Leverage the reference library of predefined Sourcing Criteria, with flexible parameters and configuration options
Develop new Sourcing Criteria using recommended patterns and best practices to extend ranking logic as needed

Key Points

Understand the Ranking Mechanism: Sourcing Criteria score (or exclude) candidate Locations to drive ranking and tie-breaking
Sequence Matters: Criteria are evaluated top-to-bottom; the first Criterion decides the primary order, the next acts as a tie-breaker
Normalize Ratings: Most Criteria return raw numeric ratings that the framework normalizes across Locations to ensure consistent comparisons
Use Exclusion Carefully: Some Criteria return a negative score (-1) to exclude Locations; apply these early in the stack for predictable outcomes
Know When to Extend: The reference library covers common distance, inventory availability, and priority logic; develop a custom Criterion for domain-specific logic

Prerequisites

Responsive Sourcing Framework Overview

Sourcing Utilities Overview

Sourcing Criteria Overview

Steps

Core Concept

A Sourcing Criterion is a configurable function that evaluates a candidate Location in context of the Sourcing Request and returns a rating:

A positive float (0…1) ranks how suitable a Location is
-1 filters a Location out of consideration
Criteria are applied in sequence to produce a final ranked list of eligible Locations

During Strategy evaluation, the framework instantiates the Criterion class defined by `type` (for example, `fc.sourcing.criterion.locationDistance`) and applies its `apply()` method to every candidate Location.

Internal Mechanics

Reference Criteria share common behavior through `BaseSourcingCriterion` and Criterion Utilities:

Apply → Execute → Normalize:
- `apply()` calls pre-logic, executes business rules, and post-logic
- `normalize()` adjusts raw scores to a [0–1] range where applicable
Sequential Stack:
- Criteria are applied in order of appearance
- The first Criterion usually defines the main ranking dimension (e.g., distance or inventory availability)
- Later Criteria resolve ties
Parameter Parsing:
- `parseParams()` reads JSON params defined in the `fc.rubix.order.sourcing.criteria` Setting
- Helper Utilities (`getFloats`, `getStrings`, `getDistanceUnits`) ensure correct types and default handling

Reference Sourcing Criterion Functions

Class(Criterion Utilities)	Type(Sourcing Criteria Schema)	Description(UI)	Notes
`LocationDistanceCriterion`	`fc.sourcing.criterion.locationDistance`	Prioritises locations that are geographically closer to the delivery address	Calculates raw distance (in km) between delivery address and Location Then normalized (closer = higher rating)
`LocationDistanceBandedCriterion`	`fc.sourcing.criterion.locationDistanceBanded`	Ranks locations by distance bands {{value}}, prioritising bands that are closer	Groups Locations into configurable distance “bands” (in km or miles) Scores based on which band they fall into (closer = higher rating)
`LocationDistanceExclusionCriterion`	`fc.sourcing.criterion.locationDistanceExclusion`	Excludes locations that are farther than {{value}}{{value}}	Excludes (-1) Locations beyond a specified maximum distance threshold (in km or miles)
`LocationDailyCapacityCriterion`	`fc.sourcing.criterion.locationDailyCapacity`	Prioritises locations with the highest available daily fulfillment capacity	Rates Locations based on their `DAILY_MAX_ORDER_CAPACITY` attribute value (higher capacity = higher rating)
`NetworkPriorityCriterion`	`fc.sourcing.criterion.networkPriority`	Prioritises locations by the specified network ranking {{value}}	Assigns scores by matching each Location to an ordered list of preferred Networks If a Location belongs to multiple Networks, it inherits the score of the highest-ranked Network it belongs to Example: Network priority value = [Network1, Network2] Scores: Location1 (Network1) → 1 Location2 (Network2) → 0 Location3 (Network1 and Network2) → 1
`InventoryAvailabilityCriterion`	`fc.sourcing.criterion.inventoryAvailability`	Prioritises locations based on total units of inventory requested in the order that can be fulfilled	Calculates a "raw" availability for each Location = total available Items / total requested Items (can be > 1 if there is surplus Inventory) All scores normalized to the 0-1 range: normalized = raw / max(raw) If total requested Items = 0, returns 1 Example: Sourcing Request: Product1 (P1): 5 Product2 (P2): 3 Total requested Items = 8 Scores: Location 1 (P1: 5, P2: 3) → raw = 8 / 8 = 1 → normalized = 0.625 Location 2 (P1: 4, P2: 1) → raw = 5 / 8 = 0.625 → normalized = 0.39 Location 3 (P1: 10, P2: 6) → raw = 16 / 8 = 2 → normalized = 1 Note:A Location with surplus Inventory that does not fulfill the entire Sourcing Request may still receive a higher score than a Location that fully satisfies the Request. However, the framework prioritizes the Fulfillment Plan with the fewest Fulfillments overall
`InventoryAvailabilityBandedCriterion`	`fc.sourcing.criterion.inventoryAvailabilityBanded`	Ranks locations by fulfillment percentage bands {{value}}, prioritising bands with higher availability	Converts fulfillment percentage into configured “bands” Assigns corresponding scores
`InventoryAvailabilityExclusionCriterion`	`fc.sourcing.criterion.inventoryAvailabilityExclusion`	Excludes locations where inventory availability for a given order, is less than {{value}}%	Excludes (-1) Locations that do not meet the configured minimum fulfillment threshold (in %)
`LocationTypeExclusionCriterion`	`fc.sourcing.criterion.locationTypeExclusion`	Excludes locations of type {{value}}	Excludes (-1) Locations whose type matches a configured value(s) (e.g., store vs. warehouse)
`LocationNetworkExclusionCriterion`	`fc.sourcing.criterion.locationNetworkExclusion`	Excludes locations that are members of one of the following networks {{value}}	Excludes (-1) Locations that belong to disallowed Networks If a Location belongs to multiple Networks, and any of them matches a disallowed Network from the list, that Location will be excluded
`OrderValueCriterion`	`fc.sourcing.criterion.orderValue`	Prioritises locations that fulfill a higher monetary portion of the order	Calculates a score for each Location based on the monetary value of fulfillable Items For each Item: value = (paidPrice + taxPrice) * quantity filled = sum of monetary value that the Location can fulfill (capped at the requested quantity) total = sum of monetary value of all requested Items Score = filled / total (always in the 0–1 range) If total = 0, returns 0 Example: Sourcing Request: Product1 (P1): 5 units @ $10 each Product2 (P2): 3 units @ $20 each Total value = (5 × $10) + (3 × $20) = $110 Scores: Location 1 (P1: 5, P2: 3) → fulfills full $110 → 1 Location 2 (P1: 4, P2: 1) → fulfills (4 × $10) + (1 × $20) = $60 → 0.545 Location 3 (P1: 2, P2: 2) → fulfills (2 × $10) + (2 × $20) = $60 → 0.545 Note:Unlike `InventoryAvailabilityCriterion`, surplus Inventory does not increase the score above 1 because the calculation caps the fulfilled value at the requested quantity of each Item

Default Sourcing Criteria

Class	Type	Notes
`RejectedLocationExclusionCriterion`	`fc.sourcing.criterion.locationExclusion`	Automatically excludes Locations that previously rejected Items in the same Sourcing Request (applied by default, not shown in UI)

Parameter Definitions

Sourcing Criteria rely on parameters defined in the `fc.rubix.order.sourcing.criteria` Setting to ensure valid configuration:

`value`: Numeric thresholds or band breakpoints. An input like [10, 25, 50] defines 4 bands:
- (–∞ … 10]
- (10 … 25]
- (25 … 50]
- (50 … +∞)
`valueUnit`: Selects unit of measure where applicable (kilometres, miles)
`component`: UI input type such as `fc.field.multistring`, `integer`, or `select`
`mandatory` / `exactSearch`: Validation flags controlling whether the field must be provided and if exact match applies

Correct parameter definition guarantees consistent evaluation in both UI and runtime.

Configuration in the UI

The reference schema in `fc.rubix.order.sourcing.criteria` Setting defines templates for all reference Sourcing Criteria. Each template specifies the required UI components and their validation rules to ensure that Criteria parameters are entered consistently and correctly.For account/retailer-specific adjustments, override Criteria in `fc.rubix.order.sourcing.criteria.custom`. When a Criterion with the same `name` exists in both schemas, the custom schema takes precedence, allowing organizations to tailor global definitions to their own business needs without breaking the baseline.

Attaching Criteria to Strategies

Sourcing Criteria are added to Primary or Fallback Sourcing Strategies via the Sourcing Profile GraphQL API, similar to Conditions.

Best Practices

Order Criteria deliberately: put Exclusion Criteria first, then your primary ranking Criterion, then tie-breakers
Provide exact values and enforce strict types via schema-driven components (e.g., units in select, numeric bands)
Test boundary and edge cases thoroughly
Apply overrides in `fc.rubix.order.sourcing.criteria.custom` when tailoring Criteria for specific Accounts / Retailers

Related artifacts

fc.rubix.order.sourcing.criteria

Key Points

Outcome: You’ll extend the Responsive Sourcing Framework with a Custom Criterion and apply it in real Strategies
Minimal essentials: Implement the Criterion → register it → expose it in the Setting (auto-generate or manual) → verify behavior
Application: Influence Location ranking (exclusion) with domain-specific scoring that fits your business

Prerequisites

Responsive Sourcing Framework Overview

Sourcing Utilities Overview

Sourcing Criteria Overview

Getting Started with Reference Sourcing Criteria

Steps

Preliminary Setup

Start with your own custom module setup.1. Create a custom module.

Reminder

Check the Module Recipe - Plugin Setup and Installation Guide for details.

2. Include Sourcing Utilities in your plugin dependencies.Your plugin must have access to its own copy of `util-sourcing` at runtime so it can initialize its own local sourcing registries.You can include it in your project by:

Adding it as a dependency in your `pom.xml`

Using a provided JAR, depending on your build setup

Reminder

Each plugin runs in an isolated classloader. Your custom Sourcing Conditions / Criteria will only be available if `util-sourcing` is included in the same plugin where your custom logic is implemented and executed
General Utility Bundles guidelines also apply to Sourcing Utilities

3. Optionally, download the Sourcing Utilities Java source package to review reference implementations.

Implement a Custom Sourcing Criterion Function

Create a class that enforces your ranking (exclusion) logic:

Implement `SourcingCriterion` (or extend `BaseSourcingCriterion`).
(When extending `BaseSourcingCriterion`) Put computation in `execute(CriterionContext ctx)`.
(If needed) Parse configuration in `parseParams(JsonNode params)`.
(Optional) Override `normalize(min, max, rating)` when your metric is “lower is better” (e.g., distance).

1@SourcingCriterionInfo(
2    name = "CustomSourcingCriterion",
3    type = "company.sourcing.criterion.custom",
4    tags = { "ATS-agnostic" } // or "ATS-dependent", "Exclusion"
5)
6public class CustomSourcingCriterion extends BaseSourcingCriterion {
7
8    @SourcingCriterionParam(name = "value", component = "integer")
9    private Integer threshold;
10
11    @Override
12    public void parseParams(final JsonNode params) {
13        // parse threshold, lists, units, and etc.
14    }
15
16    @Override
17    protected float execute(final SourcingCriteriaUtils.CriterionContext ctx) {
18        // Return:
19        //  -1f to exclude a location,
20        //   0..1f (or any float) to score/rank a location, higher score is better.
21        return 0.75f;
22    }
23
24    // Override normalize(...) only if the default doesn’t fit your scale.
25}

Tips

Return only a float (use `-1f` for location exclusion)
Validate required data from the context; handle nulls defensively
Mirror conventions from reference Criteria:
- naming
- logging
- units

Introduce Custom Sourcing Rules

Introduce custom versions of the Sourcing Rules that will execute your sourcing logic inside your plugin.

Note

Custom type registration and Rule execution must be initialized within the same plugin module.Creating custom Rules ensures that your Sourcing Condition or Criterion type is available during runtime evaluation.

1. Copy the reference Sourcing Rule implementation:

2. Rename the class3. Register your custom Sourcing Condition or Criterion inside the Rule class

1@RuleInfo(
2        name = "CustomCreateFulfilmentWithSourcingProfile",
3        description = "Applies Sourcing Profile {" + "profileRef" + "} to a sourcing request (Order, Fulfilment Option, etc.) and produces Fulfillment(s)",
4        accepts = {@EventInfo(entityType = "ORDER"),
5                @EventInfo(entityType = "FULFILMENT_CHOICE")}
6)
7@ParamString(name = "profileRef", description = "Profile reference to apply.")
8@Slf4j
9public class CustomCreateFulfilmentWithSourcingProfile implements Rule {
10
11    static {
12        // register custom sourcing criterion
13        SourcingCriteriaTypeRegistry.register("company.sourcing.criterion.custom", CustomSourcingCriterion.class);
14        // register custom sourcing condition
15        SourcingConditionTypeRegistry.register("company.sourcing.condition.custom", CustomSourcingCondition.class);
16    }
17
18    @Override
19    public void run(Context context) {
20        SourcingProfile sourcingProfile = loadSourcingProfile(context);
21        if (sourcingProfile.getSourcingStrategies() != null) {
22            SourcingContext sourcingContext = loadSourcingContext(context, SourcingUtils::getUnfulfilledItems);
23            SourcingUtils.SourcingPlan plan = findPlanBasedOnStrategies(context, sourcingContext, sourcingProfile,
24                    ImmutableList.of("ACTIVE", "AT_RISK"), null);
25            if (plan.getFulfilments() != null) {
26                fillFulfilmentType(sourcingContext, plan.getFulfilments());
27                createFulfilments(context, sourcingContext, plan.getFulfilments());
28            }
29        }
30    }
31}

4. Replace the reference Rule in your Workflow configuration with your custom Rule

Reminder

Each plugin initializes its own Sourcing registries.To ensure correct registration and runtime resolution of custom Sourcing Conditions or Criteria, your custom Rule must:

Include `util-sourcing` in the plugin’s `pom.xml`
Register custom types inside the same plugin where the Rule executes

Expose the Criterion Schema

Create (or update the existing) the Setting `fc.rubix.order.sourcing.criteria.custom` with your new Criterion schema.

1mutation createSetting ($input: CreateSettingInput) {
2    createSetting (input: $input) {
3        id
4        name
5        valueType
6        lobValue
7        value
8        context
9        contextId
10    }
11}

1{
2  "input": {
3    "name": "fc.rubix.order.sourcing.criteria.custom",
4    "valueType": "JSON",
5    "lobValue": [
6      {
7      "name": "CustomSourcingCriterion",
8      "type": "company.sourcing.criterion.custom",
9      "tags": [
10        "Lorem ipsum"
11      ],
12      "params": [
13        {
14        "name": "parameter1",
15        "value": "Lorem ipsum"
16        },
17        {
18        "name": "parameterN",
19        "value": "Lorem ipsum"
20        }
21      ]
22      }
23    ],
24    "value": "",
25    "context": "RETAILER",
26    "contextId": 1
27  }
28}

1{
2    "data": {
3        "createSetting": {
4            "id": "13142",
5            "name": "fc.rubix.order.sourcing.criteria.custom",
6            "valueType": "JSON",
7            "lobValue": [
8                {
9                    "name": "CustomSourcingCriterion",
10                    "type": "company.sourcing.criterion.custom",
11                    "tags": [
12                        "Lorem ipsum"
13                    ],
14                    "params": [
15                        {
16                            "name": "parameter1",
17                            "value": "Lorem ipsum"
18                        },
19                        {
20                            "name": "parameterN",
21                            "value": "Lorem ipsum"
22                        }
23                    ]
24                }
25            ],
26            "value": "",
27            "context": "RETAILER",
28            "contextId": 1
29        }
30    }
31}

Verify the Criterion Behavior

Use the Sourcing Profile GraphQL API to add the new Criterion to a Sourcing Strategy.
Test against different Sourcing Requests and confirm the expected outcomes.

Related artifacts

fc.rubix.order.sourcing.criteria

Related content

Knowledge Tracks Related To This Topic

All about Responsive Sourcing

Responsive Sourcing Framework Overview

How Sourcing Profile GraphQL API works

How Sourcing Utilities work

How Sourcing Conditions work

How Sourcing Criteria work

Setting Up Region-Specific Sourcing Logic

Configure Multi-Region Sourcing Logic

Setting Up Country-Specific Sourcing Logic

Configure Multi-Country Sourcing Logic

Setting Up Customer-Specific Sourcing Logic

Configure Multi-Customer-Tier Sourcing Logic

Sourcing Profiles Interface

Configuring Profiles and Sourcing Strategies: A Step-by-Step Guide

Reference Sourcing Criterion Functions

Class(Criterion Utilities)	Type(Sourcing Criteria Schema)	Description(UI)	Notes
`LocationDistanceCriterion`	`fc.sourcing.criterion.locationDistance`	Prioritises locations that are geographically closer to the delivery address	Calculates raw distance (in km) between delivery address and Location Then normalized (closer = higher rating)
`LocationDistanceBandedCriterion`	`fc.sourcing.criterion.locationDistanceBanded`	Ranks locations by distance bands {{value}}, prioritising bands that are closer	Groups Locations into configurable distance “bands” (in km or miles) Scores based on which band they fall into (closer = higher rating)
`LocationDistanceExclusionCriterion`	`fc.sourcing.criterion.locationDistanceExclusion`	Excludes locations that are farther than {{value}}{{value}}	Excludes (-1) Locations beyond a specified maximum distance threshold (in km or miles)
`LocationDailyCapacityCriterion`	`fc.sourcing.criterion.locationDailyCapacity`	Prioritises locations with the highest available daily fulfillment capacity	Rates Locations based on their `DAILY_MAX_ORDER_CAPACITY` attribute value (higher capacity = higher rating)
`NetworkPriorityCriterion`	`fc.sourcing.criterion.networkPriority`	Prioritises locations by the specified network ranking {{value}}	Assigns scores by matching each Location to an ordered list of preferred Networks If a Location belongs to multiple Networks, it inherits the score of the highest-ranked Network it belongs to Example: Network priority value = [Network1, Network2] Scores: Location1 (Network1) → 1 Location2 (Network2) → 0 Location3 (Network1 and Network2) → 1
`InventoryAvailabilityCriterion`	`fc.sourcing.criterion.inventoryAvailability`	Prioritises locations based on total units of inventory requested in the order that can be fulfilled	Calculates a "raw" availability for each Location = total available Items / total requested Items (can be > 1 if there is surplus Inventory) All scores normalized to the 0-1 range: normalized = raw / max(raw) If total requested Items = 0, returns 1 Example: Sourcing Request: Product1 (P1): 5 Product2 (P2): 3 Total requested Items = 8 Scores: Location 1 (P1: 5, P2: 3) → raw = 8 / 8 = 1 → normalized = 0.625 Location 2 (P1: 4, P2: 1) → raw = 5 / 8 = 0.625 → normalized = 0.39 Location 3 (P1: 10, P2: 6) → raw = 16 / 8 = 2 → normalized = 1 Note:A Location with surplus Inventory that does not fulfill the entire Sourcing Request may still receive a higher score than a Location that fully satisfies the Request. However, the framework prioritizes the Fulfillment Plan with the fewest Fulfillments overall
`InventoryAvailabilityBandedCriterion`	`fc.sourcing.criterion.inventoryAvailabilityBanded`	Ranks locations by fulfillment percentage bands {{value}}, prioritising bands with higher availability	Converts fulfillment percentage into configured “bands” Assigns corresponding scores
`InventoryAvailabilityExclusionCriterion`	`fc.sourcing.criterion.inventoryAvailabilityExclusion`	Excludes locations where inventory availability for a given order, is less than {{value}}%	Excludes (-1) Locations that do not meet the configured minimum fulfillment threshold (in %)
`LocationTypeExclusionCriterion`	`fc.sourcing.criterion.locationTypeExclusion`	Excludes locations of type {{value}}	Excludes (-1) Locations whose type matches a configured value(s) (e.g., store vs. warehouse)
`LocationNetworkExclusionCriterion`	`fc.sourcing.criterion.locationNetworkExclusion`	Excludes locations that are members of one of the following networks {{value}}	Excludes (-1) Locations that belong to disallowed Networks If a Location belongs to multiple Networks, and any of them matches a disallowed Network from the list, that Location will be excluded
`OrderValueCriterion`	`fc.sourcing.criterion.orderValue`	Prioritises locations that fulfill a higher monetary portion of the order	Calculates a score for each Location based on the monetary value of fulfillable Items For each Item: value = (paidPrice + taxPrice) * quantity filled = sum of monetary value that the Location can fulfill (capped at the requested quantity) total = sum of monetary value of all requested Items Score = filled / total (always in the 0–1 range) If total = 0, returns 0 Example: Sourcing Request: Product1 (P1): 5 units @ $10 each Product2 (P2): 3 units @ $20 each Total value = (5 × $10) + (3 × $20) = $110 Scores: Location 1 (P1: 5, P2: 3) → fulfills full $110 → 1 Location 2 (P1: 4, P2: 1) → fulfills (4 × $10) + (1 × $20) = $60 → 0.545 Location 3 (P1: 2, P2: 2) → fulfills (2 × $10) + (2 × $20) = $60 → 0.545 Note:Unlike `InventoryAvailabilityCriterion`, surplus Inventory does not increase the score above 1 because the calculation caps the fulfilled value at the requested quantity of each Item

Default Sourcing Criteria

Class	Type	Notes
`RejectedLocationExclusionCriterion`	`fc.sourcing.criterion.locationExclusion`	Automatically excludes Locations that previously rejected Items in the same Sourcing Request (applied by default, not shown in UI)

Content in this track:

Responsive Sourcing Framework Overview

How Sourcing Profile GraphQL API works

How Sourcing Utilities work

How Sourcing Conditions work

How Sourcing Criteria work

Setting Up Region-Specific Sourcing Logic

Configure Multi-Region Sourcing Logic

Setting Up Country-Specific Sourcing Logic

Configure Multi-Country Sourcing Logic

Setting Up Customer-Specific Sourcing Logic

Configure Multi-Customer-Tier Sourcing Logic

Sourcing Profiles Interface

Configuring Profiles and Sourcing Strategies: A Step-by-Step Guide

End Of Track

How Sourcing Criteria work

How Sourcing Criteria work

Overview

Sourcing Criteria Overview

Overview

Key points

What is a Sourcing Criterion?

Architectural Context

1. Sourcing Criterion Entity

Structure

2. Sourcing Criteria Schema

3. Criterion Utilities

Features

Related content

Getting Started with Reference Sourcing Criteria

fc.rubix.order.sourcing.criteria

Create Custom Sourcing Criterion

Getting Started with Reference Sourcing Criteria

Key Points

Prerequisites

Responsive Sourcing Framework Overview

Sourcing Utilities Overview

Sourcing Criteria Overview

Steps

Core Concept

Internal Mechanics

Reference Sourcing Criterion Functions

Default Sourcing Criteria

Parameter Definitions

Configuration in the UI

Attaching Criteria to Strategies

Best Practices

Related artifacts

fc.rubix.order.sourcing.criteria

Related content

Responsive Sourcing Framework Overview

fc.rubix.order.sourcing.criteria

Getting Started with Reference Sourcing Conditions

Create Custom Sourcing Criterion

Key Points

Prerequisites

Responsive Sourcing Framework Overview

Sourcing Utilities Overview

Sourcing Criteria Overview

Getting Started with Reference Sourcing Criteria

Steps

Preliminary Setup

Implement a Custom Sourcing Criterion Function

Introduce Custom Sourcing Rules

Expose the Criterion Schema

Verify the Criterion Behavior

Related artifacts

fc.rubix.order.sourcing.criteria

Related content

Responsive Sourcing Framework Overview

Getting Started with Reference Sourcing Criteria

Create Custom Sourcing Condition

Related content

Responsive Sourcing Framework Overview

How Sourcing Profile GraphQL API works

How Sourcing Utilities work

How Sourcing Conditions work

Kirill Gaiduk

Knowledge Tracks Related To This Topic

Building Blocks