跳到主要内容

到期数据元字段

另请参阅:通知、订单打印与装箱单

Product Expiration Dates 应用会在 expiration_dates 命名空间下为产品的多属性添加元字段。如果产品没有多属性,则使用默认多属性。

请勿在 Shopify 后台中使用 expiration_dates 命名空间及下列任何键添加元字段定义。 这样做毫无必要,反而会导致应用无法正常工作。应用设置的元字段均为只读状态,无法通过 Shopify 后台直接修改。

如果您需要将到期日导出到仅支持元字段集成(且不支持 JSON 元字段)的外部应用,请参阅 soonest_expiring 键。

系统提供以下元字段:

键说明
allocations分配给该多属性的到期日和数量数组。数组按到期日从早到晚升序排列,因此 allocations[0] 将返回最早到期批次的数据。
allocations[N].time到期日。格式为:YYYY-MM-DDT00:00。例如:2025-01-22T00:00。目前时间部分始终为 00:00。该数值可以使用 Liquid date 过滤器 进行格式化。
allocations[N].quantity剩余库存数量。
allocations[N].batch_number分配的批次号。
allocations[N].location_id分配的地点的 Shopify ID。
use_within包含开封后使用期限信息的对象。
use_within.use_within_value开封后使用期限数据的数值部分。例如,若设置为 30 天,此处将包含 30。
use_within.use_within_unit开封后使用期限数据的时间单位部分。例如,若设置为 30 天,此处将包含 days。
use_within.use_within_value_in_days折算为天数的开封后使用期限数值。例如,若设置为 6 个月,此处将包含 180。按每月 30 天计算:6 * 30 = 180。
bundled_inventory包含捆绑内各产品及其到期数据/批次号的数组。仅当该产品为捆绑产品时才会设置。
bundled_inventory[N].title捆绑内产品的标题。
bundled_inventory[N].allocations分配给该多属性的到期日和数量数组。请参阅 allocations[N] 的文档说明。
soonest_expiring最早到期库存批次的字符串形式。若需将到期日导出至仅支持元字段集成的外部应用程序,此字段尤为实用。日期格式可在设置页面上配置。
仅在高级版套餐下提供