连接快递100并查看发货物流

本指南适用于企业使用自己的快递100 API 账号，将已有发货单的物流信息接入 Viseq。完成后，你应能核对连接状态，在发货详情查看轨迹，并区分查询结果、订阅接纳和物流资料更新。

快递100账号、产品开通和接口费用由企业自行管理。Viseq 不代购或代充值，物流查询也不使用 AI Credits。实际套餐、用量和扣费请在快递100后台核对；Viseq 中的操作记录不代替供应商账单。

开始前准备

• 企业具备合法使用的快递100 API 账号，以及所需查询或订阅服务。
• 管理连接的人员具备第三方集成的查看和连接管理权限。
• 查询人员能查看对应销售订单、发货单及物流。维护承运服务映射、开启订阅还需要相应管理权限。
• 发货单已确认，并已登记承运服务和正确的包裹运单号。
• 承运商要求手机验证时，准备有权使用的收件或寄件人手机号信息。

看到菜单不代表已经获得数据或操作权限。页面提示无权限时，请企业管理员核对当前企业的角色配置；不要借用其他人的登录状态。

1. 注册企业 API 账号并开通服务

1. 打开快递100 API 开放平台，按官方企业账号注册说明完成注册及所需审核。
2. 在供应商后台核对已开通的产品。主动查询需要实时查询服务；自动接收更新需要订阅推送服务。可从官方文档中心进入对应产品说明。
3. 核对服务状态、可用单量及企业内部的费用批准范围。保存 Viseq 连接不会替企业购买或开通服务。
4. 使用订阅前，由企业向快递100确认该账号已支持向 Viseq 的 HTTPS 地址推送。官方订阅接口说明仍要求 HTTPS 兼容需联系技术人员处理；未确认前，不要把自动更新当作已可用，也不要改用公网 HTTP。

供应商后台的注册、审核、服务和计费条件以企业实际账号为准。本地测试数据或“已配置”状态不能证明正式账号已获授权。

2. 为 Viseq 准备主账号或专用子账号

Viseq 支持主账号和子账号。企业可以使用主账号，也可以为 Viseq 单独管理一个子账号。

需要子账号时，按快递100子账户官方说明操作：

1. 登录企业管理后台，在“我的信息”中进入“子账户管理”。
2. 创建名称清晰的专用子账户，例如用于识别 Viseq 的名称。
3. 打开子账户详情，核对状态并取得该子账户自己的鉴权参数。
4. 按企业需要配置调用限额，并核对主账号承担的用量结算方式。

主账号与子账号有各自的鉴权参数和调用地址。Viseq 根据所选账号类型处理地址；你只需正确选择类型并提供同一账号自己的 Key 和 Customer，不需要填写 API 域名。

3. 取得 Key 和 Customer 并保存连接

在快递100企业后台查看所用账号的 API 鉴权参数。使用子账号时，从该子账号的详情取得参数，不要将主账号 Key 与子账号 Customer 混用。

Viseq 需要 API Key 和 Customer，不需要快递100登录密码，也不需要为本指南的查询、订阅填写电子面单 Secret。

1. 进入当前企业的“业务管理”，在“数据与集成”中打开“第三方集成”。
2. 在连接列表点击“连接快递100”。
3. 填写便于企业识别的连接名称。
4. 选择实际使用的主账号或子账号。
5. 填写该账号的“API Key”和“Customer”，核对后保存。
6. 在列表核对连接名称、账号类型及状态。

保存后显示“已配置，待验证”。这表示配置已保存，尚未证明供应商账号能够查询物流。系统不会在保存时偷偷执行可能消耗单量的查询。

Key 和 Customer 不会作为普通连接资料明文读回。不要把它们放入连接名称、备注、截图、网址或聊天记录。需要更换账号类型或 Customer 时，创建另一条连接，不要把换账号当作同账号的密钥轮换。

4. 用真实发货单查询物流

1. 进入“库存与履约”的“销售发货”，找到已确认的发货单，点击“管理物流”，打开“包裹与运输轨迹”。也可以从对应销售订单的发货记录进入。
2. 核对包裹的承运服务和运单号。查询使用该包裹的资料，不能在这里输入任意他人的单号。
3. 在“快递100物流”区域核对“承运服务映射”。尚未配置时，由有权限的人员展开“管理此承运服务的快递100映射”，选择正确的快递公司并保存。不要仅凭名称相似选择。
4. 在“企业快递100连接”中选择当前企业有权使用的有效连接。
5. 在“操作”中选择“查询当前物流”。承运商要求验证手机号时，按其要求填写有权使用的信息；提交后输入会清空。
6. 核对并勾选本次查询可能消耗企业快递100单量的确认项，再提交。
7. 等待原操作结果，再点击“刷新状态与包裹”核对轨迹与资料更新时间。已有查询结果未确认时，提交按钮会保持不可用，请先核对原记录。

“刷新状态与包裹”只读取已经保存的状态，不会发起新的供应商查询。提交查询可能消耗单量；遇到频率限制应等待提示允许的时间，不要反复提交。

读取到供应商结果后，物流资料仍需要可靠地保存到发货单。请同时核对操作结果与包裹轨迹，不能只凭“已受理”判断轨迹已更新。快递100轨迹中的签收也不自动代表销售、库存或财务流程全部完成。

5. 开启物流订阅并核对推送

确认企业账号及部署环境已满足 HTTPS 推送条件后：

1. 在同一个发货单包裹的“快递100物流”区域选择连接。
2. 将“操作”改为“开启物流订阅”。
3. 按需提供承运商要求的验证信息，重新核对本次订阅的单量确认项并提交。
4. 通过“刷新状态与包裹”查看原订阅、推送及物流资料交付状态。包裹已有订阅时，系统提示先核对原订阅，不能以没有推送为由重新发送。

订阅被接纳、收到可信推送、物流资料已保存，是不同的结果。“订阅已接纳，等待推送”不表示已收到轨迹，也不表示已经签收。没有新推送时，不要反复新建订阅来催促更新。

Viseq 为原订阅生成并管理回调地址和签名信息；不需要在连接表单里自行填写回调网址或 Salt。

6. 查看操作记录和失败原因

在“第三方集成”的“操作记录”中查看查询或订阅，点击对应记录读取结果、错误提示和投递状态。连接列表的“诊断”可用于核对连接及相关操作。

Viseq 不把供应商返回的成功 HTTP 状态一律当作业务成功，也不向普通页面展示原始密钥或供应商敏感响应。

7. 轮换凭证、暂停和撤权

在“第三方集成”的连接列表操作：

• 更新凭证：用于同一账号更换 Key。填写该账号的参数；需要恢复新的调用时，按表单提示明确选择重新启用。更新后仍需核对验证状态。
• 暂停：确认暂停后，阻止新的第三方调用。已发出的请求仍可能返回结果。
• 撤权：确认撤销 Viseq 使用该连接凭证的授权。它不代表快递100后台的密钥已经删除、供应商已取消订阅，或已经发生的外部效果被撤销。

需要在供应商侧禁用子账号或撤销 Key 时，由企业在快递100后台另外处理。Viseq 中的历史操作及可信回执按数据保留规则保存，不会因为更新凭证或撤权就改写为“未执行”。

轮换或重新启用连接也不会自动重发原来的未知订阅。先核对历史请求，再按页面提供的合法恢复方式操作。

8. 旧运单已被其他系统订阅怎么办

快递100的重复订阅提示不能证明推送地址已绑定到 Viseq。由原系统负责人和企业集成管理员核对原订阅与回调配置，必要时联系供应商处理迁移。

不要把“重复订阅”、暂未收到回调或一次网络超时当作安全重发的依据。只有页面取得适用的可信终止事实、允许受控替换，并完成新的费用确认时，才按提示操作；仍需遵守供应商的次数及时间限制。

9. 完成后核对

• 当前企业、连接账号类型和包裹对应正确。
• 连接配置状态与实际验证结果分得清楚。
• 原查询或订阅结果可在操作记录中找到。
• 发货单能读回承运服务、运单号、轨迹、来源及更新时间。
• 结果未知、单量不足、暂停或撤权时，相关人员知道从哪里核对和恢复。

若页面使用标记为 Synthetic 的本机测试资料，只能据此核对产品流程。正式账号查询、实际扣费和供应商公网 HTTPS 推送，仍需在企业获准的真实账号及环境中单独验证。