Author:
Fluent Commerce
Changed on:
11 Sept 2024
This guide is designed to help you implement the enhanced
`attributes`
`attributes`
`attributes`
`expectedOn`
`storageAreaRef`
`condition`
`attributes`
`inventoryPosition.inventoryQuantity.attributes.<fieldname>`
`YYYY-MM-DDTHH:MM:SSZ`
`attributes`
While the
`attributes`
`expectedOn`
`storageAreaRef`
`condition`
Beyond the recommended attributes, you have the flexibility to include additional fields that are specific to your business requirements. Whether you need to send simple key-value pairs, nested JSON structures, or arrays, our system will process these and make them available within the workflow via
`inventoryPosition.inventoryQuantity.attributes.<fieldname>`
The table below provides examples of the recommended attributes along with their descriptions, usage, and examples. However, you are not limited to these fields—you can extend the
`attributes`
Attribute Description | Recommended Attribute Key Name | Category | Example | Notes | Use Case |
Specific storage locations in a warehouse. |
| Warehouse Management | "LOC1-SR-1" | Available in the workflow via
| Optimizing space utilization, reducing retrieval time, and improving warehouse efficiency. |
Date when new stock is expected. |
| Supply Chain Management | "2024-10-31T00:00:00.00Z" | Available in the workflow via
| Planning for space allocation, staffing, and ensuring timely product availability. |
Information on the manufacturing country. |
| Compliance/Localization | "France" | Available in the workflow via
Alternate field name for this madeIn | Compliance with import/export regulations, supporting marketing strategies emphasizing local products. |
Details like production date and location. |
| Product Tracking | { "batchNumber": "BATCH001", "productionDate": "2024-01-15T00:00:00.00Z" } | Available in the workflow via
| Tracking production details, quality control, and recall management. |
Indicates the last date a product is safe to use. |
| Product Lifecycle | "2025-12-31T23:59:59.00Z" | Available in the workflow via
| Managing stock rotation, reducing waste, and ensuring compliance with health and safety regulations. |
Unique identifier for each supplier. |
| Vendor Management | "SUP12345" | Available in the workflow via
| Tracking supplier performance, managing vendor relationships, and optimizing supply chain efficiency. |
Details on how inventory is quantified. |
| Inventory Specification | "PCS" | Available in the workflow via
| Ensure consistency in inventory counting, aid in order fulfillment, and simplify stocktaking processes. |
Unique identifier for high-value items. |
| Item Identification | "SN123456789" | Available in the workflow via
| Tracking individual items, managing warranties, and enhancing theft prevention. |
Links inventory to specific purchase orders. |
| Procurement Tracking | "PO987654321" | Available in the workflow via
| Matching received goods with purchase orders, improving procurement tracking, and enhancing order accuracy. |
Source of inventory transfer. |
| Inventory Movement | "STORE01" | Available in the workflow via
| Tracking inventory movement between locations for internal auditing. |
Purpose of the inventory. |
| Inventory Utilization | "For Sale" | Available in the workflow via
| Differentiating stock based on its intended use, aiding in inventory accounting and management. |
Indicates the condition of the inventory item. |
| Inventory Condition | "NEW" | Available in the workflow via
| Managing inventory condition, enabling categorization of items for different sales channels. |
1
2{
3 "name": "INVENTORY_UPDATE",
4 "accountId": "YOUR_ACCOUNT",
5 "retailerId": "1",
6 "entityRef": "DEFAULT:2",
7 "entityType": "INVENTORY_CATALOGUE",
8 "entitySubtype": "DEFAULT",
9 "rootEntityType": "INVENTORY_CATALOGUE",
10 "rootEntityRef": "DEFAULT:2",
11 "attributes":
12 {
13 "inventoryUpdates":
14 [
15 {
16 "ref" : "testref1",
17 "productRef": "D45",
18 "locationRef": "LOC_MEL",
19 "qty": 350,
20 "correctedQty":0,
21 "type":"DEFAULT" ,
22 "inventoryQuantity": {
23 "attributes": {
24 "expectedOn": "2024-10-31T00:00:00.00Z", // ISO 8601 format
25 "storageAreaRef": "LOC_MELB_RET2-SR1",
26 "condition": "NEW",
27 "countryOfOrigin": "China",
28 "expiryDate": "2025-12-31T23:59:59.00Z", // ISO 8601 format
29 "supplierId": "SUP12345",
30 "unitOfMeasurement": "PCS",
31 "serialNumber": "SN123456789",
32 "purchaseOrderNumber": "PO987654321",
33 "transferFrom": "STORE01",
34 "inventoryPurpose": "For Sale",
35 "manufacturingBatchInfo": {
36 "batchNumber": "BATCH001",
37 "productionDate": "2024-01-15T00:00:00.00Z" // ISO 8601 format
38 }
39 }
40 }
41 ]
42 }
43}
Language: json
Name: Example payload with enhanced payload for direct updates via INVENTORY_UPDATE event
Description:
Example payload with enhanced payload for direct updates via INVENTORY_UPDATE event
Copyright © 2024 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.