库存审计

在任何送货位置，无论是配送中心还是商店，都可能处理数千个由于库存供应或需求变化而发生的库存交易。对于供应，它可以是入站供应商库存，也可以是由步入式客户在购物车结帐期间创建的微型交易。对于一个需求，可以通过新的在线订单捕获来引领。

实现经理需要一个工具来复审大量历史库存记录，以了解执行库存操作的正确原因，例如，研究库存趋势或识别属于数据组的库存记录集。

供应诊断: 如果存在错误的供应更新导致商店出现不正确的库存图片，那么供货经理必须确定一个或多个库存更新的准确时间和详细信息，以便能够解决根本原因。相反，如果没有审计和时间因素，仅检索供应或需求更新列表可能无济于事。
用于数据分析的审计导出: 在销售营销活动之后，在外部数据分析工具的帮助下，供货经理可以借助审计对库存移动趋势进行比较分析，以发现营销活动的结果是否有提升或下降。
供应批次标识: 假设存在来自制造商的产品召回，那么供货经理需要发现一组与制造商名称关联或加盖戳记的库存供应更新，以便供货经理可以跟踪受影响的接收节点以执行保护操作。

有一些交易是不会导致供需变化的。例如，如果针对供应或需求的调整发送的时间戳记早于上次供应同步或需求同步时间戳记，那么不会应用该调整，并且会将其忽略。由于还需要捕获此类交易的审计，因此将审计每个已接受的客户请求。

供需审计

库存审计服务提供对供需记录进行审计的能力。当存在供应或需求的调整或同步请求时，如果 Inventory Visibility已接受该请求，那么审计服务将记录以下详细信息:

活动时间戳记。
执行的操作。
库存记录的详细信息。
事务标识 (在库存更新期间包含)。

此外，您可以通过 Order Hub 用户界面或使用相应的供应和需求审计搜索 API 来搜索审计记录。

库存审计搜索和详细信息查找

库存审计搜索是一个基于查询的灵活 API ，它使用户能够通过指定时间段和库存属性来查找审计记录。这些结果可以按升序或降序排序。为了在导出或 UI 用例中提供帮助，您可以使用审计搜索 API 通过指定所需的页面大小和页面偏移量，以分页格式查看结果。

搜索查询包含一个或多个搜索属性名称和比较运算符。一些非详尽清单可能包括:

表 1. 搜索属性和查询
搜索属性	搜索查询
供应属性	`itemId, unit of measure, product class, shipnode, shipByDate, line Reference, reference type, reference, eta, type, base type, audit type, purpose, parent actionId, relatedByActionId`.
需求属性	`itemId, unit of measure, product class, shipnode, shipDate, reference type, reference, cancel date, min ship by date, type, base type`.

系统支持以下操作程序:

Contains.
Equals (单个值)。
Equals (多个值类似于 IN 子句)。
Start with.
对于时间戳记字段，为 From 和 To 日期范围。

如果审计标识已知，那么可以使用审计详细信息 API 来查找特定审计记录。

库存审计保留期

您可以搜索从查询时间起最多 30 个历史记录日的库存审计。如果要延长保留期或有兴趣分析数据，可以使用审计搜索 API 将审计记录导出到外部数据库。

有关信息，请参阅供应审核 API 和需求审核 API。

供应审计的定制库存属性

标准供应审计记录由库存属性组成，这些属性可能不足以在某些用例中执行详细的根本原因分析。例如，供货经理可能希望在供应调整和同步请求中包含制造商名称， GTIN 值或修改后的用户名，以便在库存审计中持久存储其他值。如果稍后发生问题 (例如，制造商召回或错误更新) ，那么可以使用附加属性作为审计搜索功能中的过滤器来识别特定供应记录和活动时间。另一个示例是，供货经理可以使用定制属性 modifiedUserId 作为查询术语，对特定系统或用户创建的所有供应调整记录执行审计搜索。

可以通过执行以下步骤为审计搜索启用定制库存属性:

配置定制供应属性。
在供应调整或同步请求中包含定制供应属性。
使用定制供应属性作为搜索查询 (通过 API 或 Order Hub) 来搜索供应审计。

配置定制供应属性

通过使用 createCustomAttribute API ，您必须注册要包含在供应调整和同步请求中的 JSON 属性。标签必须与供应请求中的实际属性值匹配。在这种情况下，业务目的是 "供应"。

有关如何创建自定义属性的更多信息，请参阅 createCustomAttribute API.

{
   "label":"ManufacturerName",
   "datatype":"string",
   "businessPurposes":[
      "supply",
      "sourcing"
   ]
}

注: 在此示例中，将同一属性设置为同时适用于 IBM® Sterling Intelligent Promising中的供应和寻源规则用例。

供应调整或与自定义属性同步

定义定制供应属性后，下一步是在供应调整和同步请求中包含 JSON 属性。例如，如果配置的定制属性为 ManufacturerName ，那么此属性包含在 customAttributes JSON 元素中。

注：供应请求中包含的“未注册”属性在审计过程中不予考虑。

{
   "supplies":[
      {
         "itemId":"17854",
         "unitOfMeasure":"EACH",
         "productClass":"NEW",
         "type":"ONHAND",
         "shipNode":"matrix",
         "eta":"1900-01-01T00:00:00-00:00",
         "shipByDate":"2500-01-01T00:00:00-00:00",
         "minShipByDate":"2500-01-01T00:00:00-00:00",
         "quantity":"9993.0",
         "customAttributes":{
            "ManufacturerName":"process",
            "ModifyUserId":"123456",
            "ManufacturingDate":"2020-01-01T00:00:00.000Z"
         }
      }
   ]
}

使用定制库存属性查询库存审计

在系统接受供应更新后，定制属性将显示在审计中。您可以使用 Order Hub 审计搜索，也可以为由一个或多个搜索项组成的 API 请求构建搜索查询。例如，如果查询为 itemId=Item001 和 ManufacturerName=ACME，那么它将返回源自 ACME的所有 Item001 供应记录。

{
   "offset":0,
   "pageSize":25,
   "time":{
      "fromValue":"2023-03-01T00:00:00.000Z",
      "toValue":"2023-03-03T00:00:00.000Z"
   },
   "data":{
      "itemId":{
         "operator":"contains",
         "values":[
            "SKU1024"
         ]
      },
      "customAttributes":[
         {
            "customAttribute":"ManufacturerName",
            "operator":"equals",
            "values":[
               "ACME"
            ]
         }
      ]
   }
}