17TRACK 包裹归档操作在 Home Assistant 中自动归档已送达包裹的完整实战指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读本文聚焦 Home Assistant 中17TRACK 集成的seventeentrack.archive_package操作Action讲解如何通过界面或 YAML 将 17Track 账户中的包裹按运单号归档从而让 17Track 停止主动跟踪该包裹。读完本文你将掌握该操作的全部参数、UI 与 YAML 两种配置方式并能直接复制一个包裹送达后自动归档的自动化示例实现快递管理闭环。什么是归档包裹操作在 Home Assistant 的 17TRACK 集成中seventeentrack.archive_package操作通过运单号tracking number将包裹归档到你的 17Track 账户。归档后17Track 将停止主动跟踪该包裹——它不再出现在实时跟踪列表里状态传感器中也不再统计它。该操作非常适合在交付完成后做收尾清理。最典型的场景是当包裹被标记为已送达时自动将其归档避免账户中被已完成的运单堆积让仪表盘只保留真正需要关注的包裹。从 17TRACK 集成的整体设计看见 17TRACK 集成文档该集成通过配置流config flow绑定你的 17track.net 账户采用云轮询Cloud Polling方式获取数据并创建汇总传感器按状态统计包裹数量与每个包裹的独立传感器。归档操作正是这个闭环的终点动作。使用前提使用该操作前需要确保已通过设置 设备与服务Settings Devices services添加 17TRACK 集成并登录你的 17track.net 账户详见 17TRACK 集成文档。获取到 17Track 配置条目的 IDconfig_entry_id。方法在设置 设备与服务中选择 17Track 集成点击右上角三个点的菜单选择复制条目 IDCopy entry ID。注意17track.net 官网虽声称密码不能超过 16 个字符但技术上可以设置更长的密码这类密码无法被 17Track 使用的 API 识别。请确保你的 17track.net 密码不超过 16 个字符见 17TRACK 集成文档 中的提示。在界面UI中使用该操作如果你偏好可视化地构建自动化和脚本Home Assistant 会逐步引导你完成配置无需 YAML 知识参见 actions/ui_header.md。归档包裹的界面操作步骤如下进入设置 自动化与场景Settings Automations scenes。打开一个现有的自动化或脚本或选择创建自动化 创建新自动化Create automation Create new automation。如果是新建自动化在When部分添加触发器。脚本则不需要触发器它们在被其他内容调用时运行。在Then do部分选择添加操作Add action。在搜索框中搜索并选择17TRACK: Archive package。选择17Track 服务17Track service然后输入要归档的包裹运单号Package tracking number。选择保存Save。关于目标Targets的说明该操作不支持目标targets。在界面中你通过17Track 服务字段选择对应的 17Track 服务而不是像其他操作那样选择区域、设备、实体或标签。UI 中的选项选项说明是否必填17Track 服务17Track service包裹所属的 17Track 服务是包裹运单号Package tracking number要归档的包裹运单号是在 YAML 中使用该操作如果你直接编写 YAML或者想确切了解 Home Assistant 在底层做了什么可以参阅下面的技术参考。这里列出了 YAML 中使用的字段名、类型以及必填项参见 actions/yaml_header.md。在 YAML 中该操作以seventeentrack.archive_package调用基本示例action: seventeentrack.archive_package data: config_entry_id: 2b4be47a1fa7c3764f14cf756dc98991 package_tracking_number: RU0103445624A这段配置会将运单号为RU0103445624A的包裹在 17Track 中归档。YAML 选项字段说明必填类型config_entry_id包裹所属的 17Track 服务配置条目 ID是stringpackage_tracking_number要归档的包裹运单号是string如何找到 config_entry_idconfig_entry_id是一长串 ID如示例中的2b4be47a1fa7c3764f14cf756dc98991它不是运单号而是你在 Home Assistant 中为 17Track 创建的配置条目的唯一标识。获取方式设置 设备与服务→ 选择 17Track 集成 → 三个点菜单 →复制条目 ID参见 17TRACK 集成文档 中的提示。实战自动化包裹标记为已送达后自动归档下面是一个完整的自动化示例当一个保存已送达运单号的文本辅助元素text helper发生变化时自动在 17Track 中归档该包裹。触发器一个持有已送达运单号的文本辅助元素发生变化操作17TRACK: Archive packageautomation: alias: Archive delivered package triggers: - trigger: state entity_id: input_text.delivered_tracking_number actions: - action: seventeentrack.archive_package data: config_entry_id: 2b4be47a1fa7c3764f14cf756dc98991 package_tracking_number: {{ states(input_text.delivered_tracking_number) }}在这个示例中trigger: state监听input_text.delivered_tracking_number的状态变化package_tracking_number通过模板{{ states(input_text.delivered_tracking_number) }}动态读取辅助元素当前值实现运单号一变就归档。这是 17TRACK 三个操作add_package、get_packages、archive_package中典型的终点动作——与 seventeentrack.add_package添加包裹、开始跟踪形成对称的完整生命周期添加 → 查询 → 送达后归档。与其他 17TRACK 操作配合使用归档操作通常与以下两个操作配合构成完整的包裹管理流程Add a package添加包裹通过运单号把新包裹添加到 17Track 账户开始跟踪。该操作除config_entry_id和package_tracking_number外还需要package_friendly_name包裹的友好名称。Get packages获取包裹查询 17Track API 获取最新包裹数据可通过package_state参数按状态过滤如delivered、in_transit并通过response_variable保存返回结果。一个推荐的工作流是用seventeentrack.add_package将新订单自动加入跟踪例如从订单确认邮件中提取运单号用seventeentrack.get_packages定期拉取状态配合 17TRACK 集成的状态传感器Not found、In transit、Expired、Ready to be picked up、Undelivered、Delivered、Returned详见 17TRACK 集成文档在仪表盘展示用本文的seventeentrack.archive_package在包裹送达后归档保持列表整洁。三个操作的参数关系总结如下操作主要参数返回值seventeentrack.add_packageconfig_entry_id、package_tracking_number、package_friendly_name无seventeentrack.get_packagesconfig_entry_id、package_state可选response_variable中的packages列表seventeentrack.archive_packageconfig_entry_id、package_tracking_number无动手测试想快速验证该操作的效果打开设置 工具 操作Settings Tools Actions即开发工具中的操作标签页搜索该操作填写字段并点击执行操作Perform action无需编写任何 YAML 即可在真实实体上观察结果参见 actions/try_it.md。常见问题排查找不到运单号对应的包裹请确认运单号属于所选config_entry_id对应的 17Track 账户且大小写与格式完全一致。归档后传感器仍显示包裹归档后17Track 停止主动跟踪该包裹汇总传感器会在下一次轮询刷新后不再统计它你可以用seventeentrack.get_packages操作配合package_state过滤主动查询验证归档是否生效。config_entry_id填写错误该 ID 必须与你的 17Track 配置条目严格对应复制时避免多余空格或截断。相关文档17TRACK 集成文档集成能力总览、配置流与包裹状态列表Add a package 操作文档添加包裹的完整用法与仪表盘辅助元素自动化示例Get packages 操作文档查询包裹数据、状态过滤与响应字段说明【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/17 1:51:08 · 阅读 1.2k 17TRACK 包裹归档操作：在 Home Assistant 中自动归档已送达包裹的完整实战指南
17TRACK 包裹归档操作在 Home Assistant 中自动归档已送达包裹的完整实战指南【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io导读本文聚焦 Home Assistant 中17TRACK 集成的seventeentrack.archive_package操作Action讲解如何通过界面或 YAML 将 17Track 账户中的包裹按运单号归档从而让 17Track 停止主动跟踪该包裹。读完本文你将掌握该操作的全部参数、UI 与 YAML 两种配置方式并能直接复制一个包裹送达后自动归档的自动化示例实现快递管理闭环。什么是归档包裹操作在 Home Assistant 的 17TRACK 集成中seventeentrack.archive_package操作通过运单号tracking number将包裹归档到你的 17Track 账户。归档后17Track 将停止主动跟踪该包裹——它不再出现在实时跟踪列表里状态传感器中也不再统计它。该操作非常适合在交付完成后做收尾清理。最典型的场景是当包裹被标记为已送达时自动将其归档避免账户中被已完成的运单堆积让仪表盘只保留真正需要关注的包裹。从 17TRACK 集成的整体设计看见 17TRACK 集成文档该集成通过配置流config flow绑定你的 17track.net 账户采用云轮询Cloud Polling方式获取数据并创建汇总传感器按状态统计包裹数量与每个包裹的独立传感器。归档操作正是这个闭环的终点动作。使用前提使用该操作前需要确保已通过设置 设备与服务Settings Devices services添加 17TRACK 集成并登录你的 17track.net 账户详见 17TRACK 集成文档。获取到 17Track 配置条目的 IDconfig_entry_id。方法在设置 设备与服务中选择 17Track 集成点击右上角三个点的菜单选择复制条目 IDCopy entry ID。注意17track.net 官网虽声称密码不能超过 16 个字符但技术上可以设置更长的密码这类密码无法被 17Track 使用的 API 识别。请确保你的 17track.net 密码不超过 16 个字符见 17TRACK 集成文档 中的提示。在界面UI中使用该操作如果你偏好可视化地构建自动化和脚本Home Assistant 会逐步引导你完成配置无需 YAML 知识参见 actions/ui_header.md。归档包裹的界面操作步骤如下进入设置 自动化与场景Settings Automations scenes。打开一个现有的自动化或脚本或选择创建自动化 创建新自动化Create automation Create new automation。如果是新建自动化在When部分添加触发器。脚本则不需要触发器它们在被其他内容调用时运行。在Then do部分选择添加操作Add action。在搜索框中搜索并选择17TRACK: Archive package。选择17Track 服务17Track service然后输入要归档的包裹运单号Package tracking number。选择保存Save。关于目标Targets的说明该操作不支持目标targets。在界面中你通过17Track 服务字段选择对应的 17Track 服务而不是像其他操作那样选择区域、设备、实体或标签。UI 中的选项选项说明是否必填17Track 服务17Track service包裹所属的 17Track 服务是包裹运单号Package tracking number要归档的包裹运单号是在 YAML 中使用该操作如果你直接编写 YAML或者想确切了解 Home Assistant 在底层做了什么可以参阅下面的技术参考。这里列出了 YAML 中使用的字段名、类型以及必填项参见 actions/yaml_header.md。在 YAML 中该操作以seventeentrack.archive_package调用基本示例action: seventeentrack.archive_package data: config_entry_id: 2b4be47a1fa7c3764f14cf756dc98991 package_tracking_number: RU0103445624A这段配置会将运单号为RU0103445624A的包裹在 17Track 中归档。YAML 选项字段说明必填类型config_entry_id包裹所属的 17Track 服务配置条目 ID是stringpackage_tracking_number要归档的包裹运单号是string如何找到 config_entry_idconfig_entry_id是一长串 ID如示例中的2b4be47a1fa7c3764f14cf756dc98991它不是运单号而是你在 Home Assistant 中为 17Track 创建的配置条目的唯一标识。获取方式设置 设备与服务→ 选择 17Track 集成 → 三个点菜单 →复制条目 ID参见 17TRACK 集成文档 中的提示。实战自动化包裹标记为已送达后自动归档下面是一个完整的自动化示例当一个保存已送达运单号的文本辅助元素text helper发生变化时自动在 17Track 中归档该包裹。触发器一个持有已送达运单号的文本辅助元素发生变化操作17TRACK: Archive packageautomation: alias: Archive delivered package triggers: - trigger: state entity_id: input_text.delivered_tracking_number actions: - action: seventeentrack.archive_package data: config_entry_id: 2b4be47a1fa7c3764f14cf756dc98991 package_tracking_number: {{ states(input_text.delivered_tracking_number) }}在这个示例中trigger: state监听input_text.delivered_tracking_number的状态变化package_tracking_number通过模板{{ states(input_text.delivered_tracking_number) }}动态读取辅助元素当前值实现运单号一变就归档。这是 17TRACK 三个操作add_package、get_packages、archive_package中典型的终点动作——与 seventeentrack.add_package添加包裹、开始跟踪形成对称的完整生命周期添加 → 查询 → 送达后归档。与其他 17TRACK 操作配合使用归档操作通常与以下两个操作配合构成完整的包裹管理流程Add a package添加包裹通过运单号把新包裹添加到 17Track 账户开始跟踪。该操作除config_entry_id和package_tracking_number外还需要package_friendly_name包裹的友好名称。Get packages获取包裹查询 17Track API 获取最新包裹数据可通过package_state参数按状态过滤如delivered、in_transit并通过response_variable保存返回结果。一个推荐的工作流是用seventeentrack.add_package将新订单自动加入跟踪例如从订单确认邮件中提取运单号用seventeentrack.get_packages定期拉取状态配合 17TRACK 集成的状态传感器Not found、In transit、Expired、Ready to be picked up、Undelivered、Delivered、Returned详见 17TRACK 集成文档在仪表盘展示用本文的seventeentrack.archive_package在包裹送达后归档保持列表整洁。三个操作的参数关系总结如下操作主要参数返回值seventeentrack.add_packageconfig_entry_id、package_tracking_number、package_friendly_name无seventeentrack.get_packagesconfig_entry_id、package_state可选response_variable中的packages列表seventeentrack.archive_packageconfig_entry_id、package_tracking_number无动手测试想快速验证该操作的效果打开设置 工具 操作Settings Tools Actions即开发工具中的操作标签页搜索该操作填写字段并点击执行操作Perform action无需编写任何 YAML 即可在真实实体上观察结果参见 actions/try_it.md。常见问题排查找不到运单号对应的包裹请确认运单号属于所选config_entry_id对应的 17Track 账户且大小写与格式完全一致。归档后传感器仍显示包裹归档后17Track 停止主动跟踪该包裹汇总传感器会在下一次轮询刷新后不再统计它你可以用seventeentrack.get_packages操作配合package_state过滤主动查询验证归档是否生效。config_entry_id填写错误该 ID 必须与你的 17Track 配置条目严格对应复制时避免多余空格或截断。相关文档17TRACK 集成文档集成能力总览、配置流与包裹状态列表Add a package 操作文档添加包裹的完整用法与仪表盘辅助元素自动化示例Get packages 操作文档查询包裹数据、状态过滤与响应字段说明【免费下载链接】home-assistant.io:blue_book: Home Assistant User documentation项目地址: https://gitcode.com/GitHub_Trending/ho/home-assistant.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考