Docs
Author:
Kirill Gaiduk
Changed on:
2 Oct 2025
`createSourcingProfile` mutation to create new versions of Sourcing Profiles, which are immutable`activateSourcingProfile` mutation
Create Networks1. Use the `createNetwork` mutation to create the Warehouse (`WH`) Network for your Sourcing Profile, including all the Locations from `UK_WH`, `BEL_WH`, `FRA_WH` Networks.
2. Configure your Network using the `CreateNetworkInput` fields:
`CreateNetworkInput.name` value (it is saved in the `Network.ref` field).`network` query to get the list of Location Ids by Network Reference.3. Repeat the points 1 and 2 for the following Networks creation:
`UK` with Locations from `UK_LS` and `WH``EU` with Locations from `BEL_LS`, `FRA_LS`, and `WH`Create Sourcing Profile1. Use the `createSourcingProfile` mutation to create a new Sourcing Profile, including its:
2. Configure your Sourcing Profile using the `CreateSourcingProfileInput` fields:
`Europe`)`BASE:EU` (or as required)`EU`3. Configure Primary Sourcing Strategies for:
`UK_LS`, `UK_WH`) to comply with import restrictions`BEL_LS`), then French stores if Belgian stock is insufficient`FRA_LS`), then Belgian stores when needed4. Organize Strategies in the `"sourcingStrategies": []` array to reflect the priority order:
`Jewellery` (U.K.)`UK` (general)`Belgium``France`5. Define Sourcing Conditions:
`deliveryCountryIn` to bind each Strategy to its country`anyProductCategoryIn` or `allProductCategoryNotIn` to apply product-specific sourcing (e.g., Jewellery)`networkPriority` to prefer local stores before cross-border or warehouse sourcing`locationDistanceBanded` or `locationDistanceExclusion` to enforce distance rules`locationDailyCapacity` to manage fulfillment limits by capacity`inventoryAvailability` to ensure fulfillment only from stocked Locations1mutation createSourcingProfile($input: CreateSourcingProfileInput) {
2 createSourcingProfile (input: $input) {
3 id
4 ref
5 version
6 versionComment
7 name
8 description
9 status
10 user {
11 id
12 }
13 createdOn
14 updatedOn
15 retailer {
16 id
17 }
18 defaultVirtualCatalogue {
19 ref
20 }
21 defaultNetwork {
22 ref
23 }
24 defaultMaxSplit
25 sourcingStrategies {
26 id
27 ref
28 sourcingProfile {
29 id
30 }
31 name
32 description
33 status
34 priority
35 createdOn
36 updatedOn
37 virtualCatalogue {
38 ref
39 }
40 network {
41 ref
42 }
43 maxSplit
44 sourcingConditions {
45 name
46 type
47 params
48 }
49 sourcingCriteria {
50 name
51 type
52 params
53 }
54 }
55 sourcingFallbackStrategies {
56 id
57 ref
58 sourcingProfile {
59 id
60 }
61 name
62 description
63 status
64 priority
65 createdOn
66 updatedOn
67 virtualCatalogue {
68 ref
69 }
70 network {
71 ref
72 }
73 maxSplit
74 sourcingConditions {
75 name
76 type
77 params
78 }
79 sourcingCriteria {
80 name
81 type
82 params
83 }
84 }
85 }
86}1{
2 "input": {
3 "ref": "Europe",
4 "versionComment": "First version of Europe SP",
5 "name": "Europe",
6 "description": "Europe SP",
7 "retailer": {
8 "id": 1
9 },
10 "defaultVirtualCatalogue": {
11 "ref": "BASE:EU"
12 },
13 "defaultNetwork": {
14 "ref": "EU"
15 },
16 "defaultMaxSplit": 5,
17 "sourcingStrategies": [
18 {
19 "ref": "Jewellery",
20 "name": "U.K. Jewellery",
21 "description": "U.K. Jewellery SS",
22 "status": "ACTIVE",
23 "network": {
24 "ref": "UK"
25 },
26 "sourcingConditions": [
27 {
28 "name": "deliveryCountryIn",
29 "type": "fc.sourcing.condition.path",
30 "params": {
31 "path": "fulfilmentChoice.address.country",
32 "operator": "in",
33 "value": ["United Kingdom"]
34 }
35 },
36 {
37 "name": "anyProductCategoryIn",
38 "type": "fc.sourcing.condition.path",
39 "params": {
40 "path": "unfulfilledItems.product.categories.ref",
41 "conditionScope": "ANY",
42 "operator": "in",
43 "value": ["Jewellery"]
44 }
45 }
46 ],
47 "sourcingCriteria": [
48 {
49 "name": "locationNetworkExclusion",
50 "type": "fc.sourcing.criterion.locationNetworkExclusion",
51 "params": {
52 "value": ["BEL_WH", "FRA_WH"]
53 }
54 },
55 {
56 "name": "networkPriority",
57 "type": "fc.sourcing.criterion.networkPriority",
58 "params": {
59 "value": ["UK_LS", "UK_WH"]
60 }
61 },
62 {
63 "name": "locationDistanceBanded",
64 "type": "fc.sourcing.criterion.locationDistanceBanded",
65 "params": {
66 "value": [5, 15, 50, 150],
67 "valueUnit": "miles"
68 }
69 },
70 {
71 "name": "locationDailyCapacity",
72 "type": "fc.sourcing.criterion.locationDailyCapacity"
73 }
74 ]
75 },
76 {
77 "ref": "UK",
78 "name": "U.K. General",
79 "description": "U.K. General SS",
80 "status": "ACTIVE",
81 "network": {
82 "ref": "UK"
83 },
84 "sourcingConditions": [
85 {
86 "name": "deliveryCountryIn",
87 "type": "fc.sourcing.condition.path",
88 "params": {
89 "path": "fulfilmentChoice.address.country",
90 "operator": "in",
91 "value": ["United Kingdom"]
92 }
93 },
94 {
95 "name": "allProductCategoryNotIn",
96 "type": "fc.sourcing.condition.path",
97 "params": {
98 "path": "unfulfilledItems.product.categories.ref",
99 "conditionScope": "ALL",
100 "operator": "not_in",
101 "value": ["Jewellery"]
102 }
103 }
104 ],
105 "sourcingCriteria": [
106 {
107 "name": "networkPriority",
108 "type": "fc.sourcing.criterion.networkPriority",
109 "params": {
110 "value": ["UK_LS", "UK_WH", "WH"]
111 }
112 },
113 {
114 "name": "locationDistanceBanded",
115 "type": "fc.sourcing.criterion.locationDistanceBanded",
116 "params": {
117 "value": [5, 15, 50, 150],
118 "valueUnit": "miles"
119 }
120 },
121 {
122 "name": "locationDailyCapacity",
123 "type": "fc.sourcing.criterion.locationDailyCapacity"
124 }
125 ]
126 },
127 {
128 "ref": "Belgium",
129 "name": "Belgium",
130 "description": "Belgium SS",
131 "status": "ACTIVE",
132 "sourcingConditions": [
133 {
134 "name": "deliveryCountryIn",
135 "type": "fc.sourcing.condition.path",
136 "params": {
137 "path": "fulfilmentChoice.address.country",
138 "operator": "in",
139 "value": ["Belgium"]
140 }
141 }
142 ],
143 "sourcingCriteria": [
144 {
145 "name": "networkPriority",
146 "type": "fc.sourcing.criterion.networkPriority",
147 "params": {
148 "value": ["BEL_LS", "FRA_LS", "WH"]
149 }
150 },
151 {
152 "name": "locationDistance",
153 "type": "fc.sourcing.criterion.locationDistance"
154 }
155 ]
156 },
157 {
158 "ref": "France",
159 "name": "France",
160 "description": "France SS",
161 "status": "ACTIVE",
162 "sourcingConditions": [
163 {
164 "name": "deliveryCountryIn",
165 "type": "fc.sourcing.condition.path",
166 "params": {
167 "path": "fulfilmentChoice.address.country",
168 "operator": "in",
169 "value": ["France"]
170 }
171 }
172 ],
173 "sourcingCriteria": [
174 {
175 "name": "locationDistanceExclusion",
176 "type": "fc.sourcing.criterion.locationDistanceExclusion",
177 "params": {
178 "value": 200,
179 "valueUnit": "kilometres"
180 }
181 },
182 {
183 "name": "networkPriority",
184 "type": "fc.sourcing.criterion.networkPriority",
185 "params": {
186 "value": ["FRA_LS", "BEL_LS", "WH"]
187 }
188 },
189 {
190 "name": "inventoryAvailability",
191 "type": "fc.sourcing.criterion.inventoryAvailability"
192 }
193 ]
194 }
195 ],
196 "sourcingFallbackStrategies": []
197 }
198}1{
2 "data": {
3 "createSourcingProfile": {
4 "id": "5017",
5 "ref": "Europe",
6 "version": 1,
7 "versionComment": "First version of Europe SP",
8 "name": "Europe",
9 "description": "Europe SP",
10 "status": "ACTIVE",
11 "user": {
12 "id": "1982"
13 },
14 "createdOn": "2025-09-27T09:35:48.162Z",
15 "updatedOn": "2025-09-27T09:35:48.162Z",
16 "retailer": {
17 "id": "1"
18 },
19 "defaultVirtualCatalogue": {
20 "ref": "BASE:EU"
21 },
22 "defaultNetwork": {
23 "ref": "EU"
24 },
25 "defaultMaxSplit": 5,
26 "sourcingStrategies": [
27 {
28 "id": "9737",
29 "ref": "Jewellery",
30 "sourcingProfile": {
31 "id": "5017"
32 },
33 "name": "U.K. Jewellery",
34 "description": "U.K. Jewellery SS",
35 "status": "ACTIVE",
36 "priority": 1,
37 "createdOn": "2025-09-27T09:35:48.183Z",
38 "updatedOn": "2025-09-27T09:35:48.183Z",
39 "virtualCatalogue": null,
40 "network": {
41 "ref": "UK"
42 },
43 "maxSplit": null,
44 "sourcingConditions": [
45 {
46 "name": "deliveryCountryIn",
47 "type": "fc.sourcing.condition.path",
48 "params": {
49 "path": "fulfilmentChoice.address.country",
50 "value": [
51 "United Kingdom"
52 ],
53 "operator": "in"
54 }
55 },
56 {
57 "name": "anyProductCategoryIn",
58 "type": "fc.sourcing.condition.path",
59 "params": {
60 "path": "unfulfilledItems.product.categories.ref",
61 "value": [
62 "Jewellery"
63 ],
64 "operator": "in",
65 "conditionScope": "ANY"
66 }
67 }
68 ],
69 "sourcingCriteria": [
70 {
71 "name": "locationNetworkExclusion",
72 "type": "fc.sourcing.criterion.locationNetworkExclusion",
73 "params": {
74 "value": [
75 "BEL_WH",
76 "FRA_WH"
77 ]
78 }
79 },
80 {
81 "name": "networkPriority",
82 "type": "fc.sourcing.criterion.networkPriority",
83 "params": {
84 "value": [
85 "UK_LS",
86 "UK_WH"
87 ]
88 }
89 },
90 {
91 "name": "locationDistanceBanded",
92 "type": "fc.sourcing.criterion.locationDistanceBanded",
93 "params": {
94 "value": [
95 5,
96 15,
97 50,
98 150
99 ],
100 "valueUnit": "miles"
101 }
102 },
103 {
104 "name": "locationDailyCapacity",
105 "type": "fc.sourcing.criterion.locationDailyCapacity",
106 "params": null
107 }
108 ]
109 },
110 {
111 "id": "9736",
112 "ref": "UK",
113 "sourcingProfile": {
114 "id": "5017"
115 },
116 "name": "U.K. General",
117 "description": "U.K. General SS",
118 "status": "ACTIVE",
119 "priority": 2,
120 "createdOn": "2025-09-27T09:35:48.174Z",
121 "updatedOn": "2025-09-27T09:35:48.174Z",
122 "virtualCatalogue": null,
123 "network": {
124 "ref": "UK"
125 },
126 "maxSplit": null,
127 "sourcingConditions": [
128 {
129 "name": "deliveryCountryIn",
130 "type": "fc.sourcing.condition.path",
131 "params": {
132 "path": "fulfilmentChoice.address.country",
133 "value": [
134 "United Kingdom"
135 ],
136 "operator": "in"
137 }
138 },
139 {
140 "name": "allProductCategoryNotIn",
141 "type": "fc.sourcing.condition.path",
142 "params": {
143 "path": "unfulfilledItems.product.categories.ref",
144 "value": [
145 "Jewellery"
146 ],
147 "operator": "not_in",
148 "conditionScope": "ALL"
149 }
150 }
151 ],
152 "sourcingCriteria": [
153 {
154 "name": "networkPriority",
155 "type": "fc.sourcing.criterion.networkPriority",
156 "params": {
157 "value": [
158 "UK_LS",
159 "UK_WH",
160 "WH"
161 ]
162 }
163 },
164 {
165 "name": "locationDistanceBanded",
166 "type": "fc.sourcing.criterion.locationDistanceBanded",
167 "params": {
168 "value": [
169 5,
170 15,
171 50,
172 150
173 ],
174 "valueUnit": "miles"
175 }
176 },
177 {
178 "name": "locationDailyCapacity",
179 "type": "fc.sourcing.criterion.locationDailyCapacity",
180 "params": null
181 }
182 ]
183 },
184 {
185 "id": "9738",
186 "ref": "Belgium",
187 "sourcingProfile": {
188 "id": "5017"
189 },
190 "name": "Belgium",
191 "description": "Belgium SS",
192 "status": "ACTIVE",
193 "priority": 3,
194 "createdOn": "2025-09-27T09:35:48.173Z",
195 "updatedOn": "2025-09-27T09:35:48.173Z",
196 "virtualCatalogue": null,
197 "network": null,
198 "maxSplit": null,
199 "sourcingConditions": [
200 {
201 "name": "deliveryCountryIn",
202 "type": "fc.sourcing.condition.path",
203 "params": {
204 "path": "fulfilmentChoice.address.country",
205 "value": [
206 "Belgium"
207 ],
208 "operator": "in"
209 }
210 }
211 ],
212 "sourcingCriteria": [
213 {
214 "name": "networkPriority",
215 "type": "fc.sourcing.criterion.networkPriority",
216 "params": {
217 "value": [
218 "BEL_LS",
219 "FRA_LS",
220 "WH"
221 ]
222 }
223 },
224 {
225 "name": "locationDistance",
226 "type": "fc.sourcing.criterion.locationDistance",
227 "params": null
228 }
229 ]
230 },
231 {
232 "id": "9739",
233 "ref": "France",
234 "sourcingProfile": {
235 "id": "5017"
236 },
237 "name": "France",
238 "description": "France SS",
239 "status": "ACTIVE",
240 "priority": 4,
241 "createdOn": "2025-09-27T09:35:48.171Z",
242 "updatedOn": "2025-09-27T09:35:48.171Z",
243 "virtualCatalogue": null,
244 "network": null,
245 "maxSplit": null,
246 "sourcingConditions": [
247 {
248 "name": "deliveryCountryIn",
249 "type": "fc.sourcing.condition.path",
250 "params": {
251 "path": "fulfilmentChoice.address.country",
252 "value": [
253 "France"
254 ],
255 "operator": "in"
256 }
257 }
258 ],
259 "sourcingCriteria": [
260 {
261 "name": "locationDistanceExclusion",
262 "type": "fc.sourcing.criterion.locationDistanceExclusion",
263 "params": {
264 "value": 200,
265 "valueUnit": "kilometres"
266 }
267 },
268 {
269 "name": "networkPriority",
270 "type": "fc.sourcing.criterion.networkPriority",
271 "params": {
272 "value": [
273 "FRA_LS",
274 "BEL_LS",
275 "WH"
276 ]
277 }
278 },
279 {
280 "name": "inventoryAvailability",
281 "type": "fc.sourcing.criterion.inventoryAvailability",
282 "params": null
283 }
284 ]
285 }
286 ],
287 "sourcingFallbackStrategies": []
288 }
289 }
290}Ensure the Sourcing Profile `ref` is specified in the `sourcingProfileRef` parameter of the CreateFulfilmentWithSourcingProfile Rule.
1{
2 "name": "SourceOrder",
3 "description": "Creates fulfilments at a location based on sourcing profile. If there are unfulfilled items in the order, trigger an event for sourcing from another location to fulfil remaining items",
4 "type": "ORDER",
5 "eventType": "NORMAL",
6 "rules": [
7 {
8 "name": "[[account.id]].order.CreateFulfilmentWithSourcingProfile",
9 "props": {
10 "sourcingProfileRef": "Europe"
11 }
12 },
13 {
14 "name": "{{account}}.order.CreateRejectedFulfilment",
15 "props": {
16 "systemRejectedLocationRef": "RJT_EU"
17 }
18 }
19 ],
20 "triggers": [
21 {
22 "status": "BOOKED"
23 },
24 {
25 "status": "PICK_PACK"
26 }
27 ],
28 "userActions": []
29}Copyright © 2024-2025 Fluent Retail Pty Ltd (trading as Fluent Commerce). Unless otherwise expressly stated in a current written agreement with Fluent Commerce or any of its affiliates or on any single page of the docs.fluentcommerce.com site, use of the materials on this site is strictly limited to viewing by individuals over 18 years old for legitimate commercially appropriate reasons; and any downloading, copying or other actions or uses of any kind or by any means of the materials on this site, including by artificial intelligence tools, is strictly prohibited. All other rights reserved.
