抖音订单发货后单号未回传会导致订单状态滞留“待发货”，影响店铺评分。需依次完成五步：一、确认抖音店铺在聚水潭已启用且API参数正确；二、通过聚水潭批量发货功能准确录入快递公司与纯数字单号；三、启用快递模板中的抖音回传开关并校验字段映射；四、在抖音开放平台开通物流回传接口权限、配置IP白名单及回调地址；五、通过接口日志排查INVALID_ACCESS_TOKEN或LOGISTICS_NO_INVALID等错误。
当抖音订单在聚水潭完成发货操作后，物流单号需准确回传至抖音平台，否则抖音侧订单状态将长期停留在“待发货”，影响店铺评分与消费者体验。以下是实现聚水潭向抖音同步发货信息的完整操作路径：
一、确认抖音店铺已正确对接聚水潭
该步骤是回传生效的前提，若未完成基础对接，后续所有发货动作均无法触发单号回传。需确保抖音店铺已在聚水潭后台完成授权绑定，并处于“启用”状态。
1、登录聚水潭ERP系统，进入设置 → 店铺管理 → 抖音小店；
2、检查目标店铺状态是否为“已启用”，且“对接方式”显示为“API对接”；
3、点击店铺右侧“编辑”，核对“App Key”“App Secret”“Access Token”三项参数与抖音开放平台申请时完全一致；
4、若任一参数异常或过期，需重新在抖音开放平台获取最新凭证并更新至聚水潭。
二、在聚水潭完成标准发货流程（含单号录入）
仅完成“发货”动作不足以触发回传，必须通过聚水潭内置的物流单号填写机制，将快递公司与运单号完整提交，系统才识别为可回传的有效发货事件。
1、进入订单管理 → 待发货订单，筛选出抖音来源的待发订单；
2、勾选订单，点击“批量发货”按钮；
3、在弹出窗口中，从下拉菜单选择已配置的快递公司（如中通、圆通等），不可手动输入；
4、在“物流单号”栏准确填写12–16位纯数字单号，禁止添加空格、字母或特殊符号；
5、点击“确认发货”，系统提示“发货成功”即表示单号已写入聚水潭订单主数据。
三、验证快递模板是否启用抖音回传开关
聚水潭使用打单模板控制不同平台的回传行为，即使完成发货，若对应模板未开启抖音单号回传功能，仍将静默失败。
1、进入设置 → 订单设置 → 物流（快递）公司及打印模板；
2、找到与所选快递公司匹配的模板，点击“编辑”；
3、向下滚动至“平台回传设置”区域，确认“抖音小店”复选框已勾选；
4、检查下方“回传字段映射”中，“快递公司编码”与“物流单号”两项是否分别绑定至抖音要求的接口字段（通常为logistics_company_code与logistics_no）；
5、保存模板后，返回订单列表，对任意一条已发货但未回传的订单，点击“重发物流信息”手动触发一次回传。
四、检查抖音侧接口权限与回调地址配置
聚水潭需调用抖音开放平台的物流回传接口，若抖音应用未开通对应API权限或回调地址未白名单放行，将返回403或超时错误。
1、登录抖音开放平台（https://developer.open.douyin.com），进入“我的应用” → 对应抖音小店应用 → 接口权限”；
2、确认已开通“物流单号回传”权限（接口名：/api/logistics/update_logistics）；
3、进入“安全设置 → IP白名单”，将聚水潭官方服务器出口IP段加入（常见为112.124.100.0/24、121.43.128.0/20等，具体以聚水潭技术文档为准）；
4、若使用自建网关或反向代理，还需在抖音后台配置正确的“回调地址（Callback URL）”，格式为https://[your-domain]/douyin/callback/logistics。
五、排查常见回传失败日志与响应码
当单号未出现在抖音订单详情页时，应立即查看聚水潭系统级日志，定位具体失败环节，而非重复点击发货。
1、进入系统管理 → 日志中心 → 接口调用日志；
2、筛选条件设为：平台=抖音小店，接口=update_logistics，时间=最近2小时；
3、查找状态为“失败”的记录，点开查看详情中的“响应内容（Response Body）”；
4、若返回“INVALID_ACCESS_TOKEN”，说明Access Token已过期，需重新授权；
5、若返回“LOGISTICS_NO_INVALID”，表示单号格式不被抖音校验通过，需检查是否含字母、长度不符或已被其他订单使用。
