适用对象：使用易抵达对接 noon FBPI（Fulfilled by Partner Integration）的客户。注意 FBPI 与 FBP 是 noon 的两种不同履约模式，仓库必须建在 FBPI 板块，建在 FBP 板块的仓库无法对接（务必先看下方「开始前必读」）。 本文介绍如何在 noon 侧完成 Service Account 与 Webhook 配置、在易抵达配置 noon 抓单接口并完成授权、订单如何同步进易抵达、出仓绑定 AWB 后如何自动回传 noon，以及缺货、异常订单的处理方式。
¶ ⚠️ 开始前必读：仓库必须建在 FBPI，不要建在 FBP
易抵达对接的是 noon 的 FBPI 通道。仓库建错板块，是本对接最容易踩的坑：凭证、授权、参数全都填对，界面也提示「已授权」，但订单永远进不来，也查不到任何报错。
¶ noon 的三种履约模式
| 模式 | 全称 | 货放哪 | 谁发货 | 有没有接口能力 | 能不能接易抵达 |
|---|---|---|---|---|---|
| FBN | Fulfilled by noon | noon 仓 | noon | — | ❌ 不适用 |
| FBP | Fulfilled by Partner（含 DirectShip） | 卖家自己的仓 | 卖家自己发 | 没有订单接口，也没有 Webhook，全程在 Seller Lab 人工处理 | ❌ 不能 |
| FBPI | Fulfilled by Partner Integration | 卖家自己的仓 | 卖家自己发 | 有：Webhook 推单 + 订单/发货/缺货接口 | ✅ 本文对接的就是它 |
一句话：FBP 和 FBPI 的货都在卖家自己仓里，实物流程也一样（贴 noon 预印 AWB → 交接给 noon 配送）；唯一区别是 FBP 全靠人工在后台点，FBPI 多了一个「集成仓（Integration Warehouse）」，可以让易抵达通过接口自动收单、自动回传。
¶ 怎么判断自己现在在哪一边
任选一条自检，三条结论一致：
- 看 Seller Lab 左侧菜单：
Fulfilled by noon、Fulfilled by Partner、Fulfilled by Partner Integration是三个并列的独立板块。建仓、看订单都必须走 Fulfilled by Partner Integration 这个板块。 - 看仓库设置页：只有 FBPI 集成仓的 Warehouse Settings 里才有 Webhook 字段和 Choose Integrator 入口。FBP 仓没有 Webhook 这一项——这是 noon 的设计，不是权限不够看不到，也不是被藏起来了。
- 看订单在哪个界面：FBPI 订单只出现在 Fulfilled by Partner Integration → Orders Dashboard。如果订单是在 DirectShip 的界面（
directship.noon.partners）里看到、每行带「Create Shipment」按钮，那它走的是 FBP 人工通道，易抵达抓不到，这是正常的，不是系统故障。
¶ 已经在 FBP 仓做业务了，怎么办
FBPI 集成仓是「另外新建的一个仓」，不是给现有 FBP 仓打开一个开关。 需要：
- 在 Fulfilled by Partner Integration → Warehouse 新建集成仓（见 2.3），完成 Choose Integrator 与 Webhook 配置（见 2.4），仓库状态置为 Active；
- 把商品和库存挂到这个新仓上——新仓没有上架商品和库存，就不会有订单落进来，仓建了也是空的；
- 存量迁移与库存维护方式，请提前与 noon 客户经理确认这三件事：
- 贵司账号能不能开通 FBPI；
- 现有 FBP 仓的商品 listing 和库存怎么迁到 FBPI 仓、在途订单怎么处理；
- FBPI 仓的库存和价格用什么方式维护（Seller Lab 手工维护，还是必须走 noon 的 Stock / Pricing 接口推送）。易抵达不提供向 noon 推送库存与价格的能力，这部分需由贵司在 noon 侧解决。
建好 FBPI 集成仓后，易抵达这边只需要把抓单接口里的 Warehouse Code 换成新仓的编码（其余参数不变），订单即可正常推送进来。
¶ 一、业务流程全景
先看整体：一张 noon 订单从产生到运单完结，要经过下面 8 个环节。🔵 = 系统自动完成，⬜ = 需要人工操作。
| # | 环节 | 谁做 / 在哪做 | 说明 |
|---|---|---|---|
| 1 | 买家在 noon 下单 | noon 平台 | 订单进入卖家的 noon FBPI 仓库 |
| 2 | Webhook 推送 + 抓单落库 | 🔵 系统自动 | noon 把订单变更推给易抵达，易抵达随即回查该订单详情，生成海外仓一件代发出仓运单（一个 noon 订单 = 一票易抵达运单） |
| 3 | 库存预检与预扣 | 🔵 系统自动 | 按 SKU 检查海外仓库存并预扣。库存不足时按机构的抓单策略处理，并自动向 noon 回传缺货（详见第六章） |
| 4 | 拣货、复核、打包 | ⬜ 海外仓 | 在一件代发(出仓)业务的「待发货」页签找到该运单，用底部按钮组的「打印」/「打印单件标签」打出标签供拣货作业。这类标签只作仓库内部识别，不是物流面单 |
| 5 | 贴 noon 预印 AWB | ⬜ 海外仓 | 从卖家提前提供给仓库的 noon 预印 AWB 标签中取一张贴到包裹上 |
| 6 | 转单助手绑定 AWB | ⬜ 海外仓操作 → 🔵 系统自动回传 | 扫易抵达系统单号 + 扫 noon AWB 完成绑定；绑定动作即触发易抵达调用 noon CreateShipment，把订单、商品与 AWB 回传（详见第七章） |
| 7 | Handover / Manifest 与实物交接 | ⬜ 卖家在 noon Seller Lab | 卖家或授权人员创建 Handover/Manifest，由 noon 上门 Pickup 或仓库 Drop-off |
| 8 | 运输派送 → 上网 / 签收 | noon 配送 + ⬜ 人工确认 | 包裹由 noon 负责配送；因 noon 暂无公开轨迹接口，易抵达的上网与签收由工作人员人工确认，运单完结 |
异常分支（都不阻断主流程）：
- 订单没抓进来 / 抓单失败 → 进「noon 订单同步情况」面板，可看报文、可重试、可「不再处理」（第五章）
- 库存不足 → 按策略落可履约部分 + 生成问题件 + 自动回传缺货给 noon（第六章）
- 回传 noon 失败 → 保留已绑 AWB、写运单日志，可用底部按钮「运单回传」手动补发（第七章）
¶ 各环节配置与操作在文档中的位置
| 你要做的事 | 看哪一章 |
|---|---|
| 分不清 FBP 和 FBPI / 仓库该建在哪 / 订单一直不进来 | 开篇「开始前必读」 |
| 首次对接，在 noon 侧填 Webhook 和拿凭证 | 第二章 |
| 在易抵达建 noon 抓单接口并授权 | 第三章 |
| 决定库存/资料有问题时是拒绝还是尽量落库 | 第四章 |
| 问题件在哪看、有哪几类 | 第四章末 |
| 从 FBP 模式迁移库存到 FBPI 集成仓 | 「订单从FBP模式到FBPI模式迁移指南」 |
| 日常盯订单有没有正常同步进来 | 第五章 |
| 缺货了怎么处理、怎么回传 | 第六章 |
| 仓库绑 AWB、回传失败了怎么补 | 第七章 |
| 运单怎么走到「已签收」完结 | 第七章末 |
¶ 能力边界（先说清楚不做什么）
- 本对接只覆盖 FBPI 集成仓的订单。FBP / DirectShip 人工模式的订单 noon 不提供订单接口，易抵达抓不到（见上方「开始前必读」）。
- 本次对接只支持 noon 平台物流发货（noon logistics）。卖家自有物流的 Direct Delivery 模式不在范围内。
- noon 公开接口暂无物流轨迹能力，所以运单的上网与签收由工作人员人工确认，不会自动变「已签收」。
- 面单使用卖家在 noon 提前申请的预印 AWB 标签；易抵达打印的标签仅作仓库内部识别用，不能当物流面单。
- Handover / Manifest 需由卖家或卖家授权人员在 noon Seller Lab 完成，易抵达不代做。
- noon 侧的 Shipment 一旦创建，AWB 不可修改。
¶ 二、前置：在 noon 侧完成配置
对接 noon 需要在 noon Partners 后台准备四项参数，并配置好订单推送。四项参数与来源：
| 参数 | 说明 | 在哪拿 |
|---|---|---|
| Project Code | 项目号，形如 PRJxxxxxx |
2.1 创建项目后在项目列表查看 |
| Key ID | Service Account（集成用户）的密钥 ID | 2.2 创建集成用户时获得 |
| Private Key | Service Account 私钥，支持 PKCS#1 / PKCS#8 PEM 格式 | 同上 |
| Warehouse Code | noon FBPI 仓库代码，形如 Wxxxxxxxxxx |
2.3 创建仓库后在仓库卡片查看 |
⚠️ Private Key 属于敏感凭证，请通过安全方式传递，不要贴在聊天或公开文档里。易抵达会加密保存该私钥且不回显。
¶ 2.1 创建项目（获取 Project Code）
左上角菜单 → Admin → Organizations and Projects：
在 Organizations 列表中找到贵司组织，点右侧 Create Project 创建项目（组织名会自动带出，填写项目名即可）。创建完成后，项目列表的 Project ID 列即为易抵达需要的 Project Code（形如 PRJxxxxxx）：
¶ 2.2 创建集成用户（获取 Key ID / Private Key）
易抵达需要用卖家的 noon Service Account 主动调用 noon 接口（查订单、创建 Shipment、回传缺货）。在 noon Partners 的 User Access → API Users 中点 Add New User 为该项目创建一个集成用户：
按向导填写 Display Name、Username，并完成 Sign In Methods（登录方式） 与 Role Assignment（角色） 配置。创建后的用户名形如 xxx@pXXXXXX.idp.noon.partners：
从刚刚创建的用户打开 Manage User 后获取 Key ID 和 Private Key：
在该用户的登录方式配置中获取易抵达需要的 Key ID 与 Private Key。
¶ 2.3 创建 FBPI 仓库（获取 Warehouse Code）
⚠️ 必须从
Fulfilled by Partner Integration板块进入建仓，不要在Fulfilled by Partner板块建仓。 两个板块在左侧菜单里并列、名字只差一个词，极易走错。在 FBP 板块建出来的仓库同样有Wxxxxxxxxxx编码，填进易抵达也能「授权成功」，但永远抓不到订单（详见开篇「开始前必读」）。
切换到 noon.com → Fulfilled by Partner Integration → Warehouse：
在 Integration Warehouses 页面点右上角 Add New Warehouse，填写仓库名称并选择运营国家：
创建完成后，仓库卡片上仓名下方的编码（形如 Wxxxxxxxxxx）即为易抵达需要的 Warehouse Code。
¶ 2.4 仓库设置：配置 Integrator 与 Webhook（订单推送地址）
noon 通过 Webhook 把订单变更实时推给易抵达。在仓库卡片点 Configure Warehouse 进入 Warehouse Settings，依次完成 Choose Integrator 与 Warehouse General Configurations（处理时效、配送模式与节假日）：
Integrator（Webhook）配置要点：
-
集成方式选择 Webhook。
-
Webhook URL 填写（
<易抵达域名>换成贵司实际使用的易抵达访问域名）：https://<易抵达域名>/itdida-api/open/noon/webhook -
x-api-key 填写该卖家在易抵达客户档案中的「电商 KEY」（获取方式见下方 2.5）。易抵达凭这个 key 识别订单属于哪个机构、哪个客户，填错或漏填会导致 noon 推送过来的订单无法入账。
-
订阅事件选择
FBPI::ORDER_SYNC。
配置完成后，Warehouse Settings 左侧信息栏会显示 Webhook 地址，且 Warehouse Status 应处于 Active（如上图）。
¶ 2.5 在易抵达获取「电商 KEY」
电商 KEY 是易抵达为每个客户生成的身份标识，noon 调用易抵达 Webhook 时凭它定位客户。
菜单 → 客户档案 → 按编号/名称找到该客户 → 双击打开详情 → 「电商对接」标签页，复制其中的 KEY 值，填到 noon 后台的 x-api-key。
注意：
- 电商 KEY 是按客户的，不同卖家各有各的 KEY，不能混用。
- 该 KEY 只用于 noon 调用易抵达时的身份识别，与 noon Service Account 的 Key ID 是两回事，不要互相填错。
关于投递状态：noon 后台会显示每条 Webhook 的投递结果（Acknowledged / Failed / Pending）。易抵达接收成功即返回 HTTP 200；若因配置缺失等原因返回非 2xx，noon 会按自身策略重投，配置补齐后重投即可正常入队，订单不会丢。
¶ 三、在易抵达配置 noon 抓单接口
¶ 入口
菜单 → 抓单接口，打开「抓单对接设置」。
在列表左下角点击 「添加」 新建接口（列表中也能看到已建接口的类型、最近抓取时间与状态）。
¶ 步骤 1：基本信息
在「编辑设置 → 基本」标签页：
- 类型：选择 noon。
- 名称：填写便于识别的接口名，例如「noon 中国仓」。
noon 是 Webhook 实时推送，不参与定时轮询，所以不需要配置抓单间隔时间。
如需补抓，在接口列表选中该接口点下方的 「立即抓单」 —— 它会拉取该 noon 仓库最近 7 天的有效订单并完整翻页，不受「上次抓取时间」限制。该按钮只有员工账号可见，且提示「仅用于快速排查，慎用」，日常不要当常规手段用。
¶ 步骤 2：参数页 → 发起授权
切换到 「参数」 标签页，可以看到接口说明、授权状态（绿色「已授权」/ 红色「未授权」）以及右上角的操作指引链接。
点击 「noon 授权」 按钮打开授权弹窗。
¶ 步骤 3：在授权弹窗中填写并校验
「noon 授权」弹窗中的字段全部必填：
| 字段 | 说明 |
|---|---|
| 客户 | 该接口归属的客户（员工操作时选择；客户自己登录时自动锁定为本人） |
| 收货渠道 | noon 订单进入易抵达后使用的收货渠道，需为一件代发出仓类渠道 |
| 仓库(海外仓) | noon 订单实际出货的易抵达海外仓 |
| Key ID | noon Service Account 的 Key ID |
| Project Code | noon 项目号 |
| Warehouse Code | noon FBPI 仓库代码 |
| Private Key | noon Service Account 私钥；加密保存不回显，重新授权时留空表示沿用已保存的密钥 |
填好后点击 「授权并校验」，系统会实时调用 noon 校验凭证：
- 校验成功 → 提示「授权校验成功，请点击「保存」完成接口配置」，弹窗关闭，授权状态变为已授权。
- 有必填项没填 → 弹窗保持打开并逐项提示（如「请选择仓库(海外仓)（必填）」），补齐后重试。
- 凭证有误 → 弹窗保持打开并显示 noon 返回的失败原因，核对 Key ID / Project Code / Private Key 后重试。
提示：授权信息会先暂存在当前接口，点击「保存」后才真正写入系统。客户、收货渠道、海外仓在这个弹窗里填完即可，不必再切到「默认」标签页。
¶ 步骤 4：保存接口
回到「编辑设置」，确认信息无误后点击 「保存」，接口创建完成。
¶ 四、抓单异常处理方式（机构级设置）
系统参数 → 电商对接 → 通用抓单策略，可选择「电商抓单异常处理方式」：
| 选项 | 行为 |
|---|---|
| 校验不通过时拒绝导入（默认） | 订单存在任何校验不通过的情况（库存不足、品名资料缺失等）时整单不落库，noon 侧订单在易抵达没有运单，需人工排查后重抓 |
| 尽最大可能落库并生成问题件 | 能落多少落多少：正常商品行照常落库并预扣库存，有问题的商品行剔除；同时生成客户可见的问题件，写明缺货明细或资料问题，交由人工处理 |
该设置只对电商抓单接口生效，不影响 API 接单、手工建单和 Excel 导入。
选择「尽最大可能落库」时的具体表现：
- 部分缺货：只落可履约的商品行并预扣，生成「库存不足」问题件写明每个 SKU 需要多少、已预扣多少、还缺多少；同时自动向 noon 回传缺货状态。
- 品名资料缺失：品名数据不存在、或存在但未审核（机构开启了品名审核时）的商品行会被剔除并写入「电商抓单异常」问题件，其余商品照常落库。
- 全部缺货：主运单仍然落库（保留一件空单件），申报信息为空，缺货状态回传 noon。
- 这些运单不会自动取号，需人工核对处理后继续走正常流程。
¶ 问题件在哪里看
上面提到的「问题件」不是单独的菜单，而是运单上的一个标记。查看方式：
- 一件代发(出仓) → 点页面顶部状态页签最右侧的「问题件」页签，列表即为所有带问题件的运单；
- 双击运单打开详情 → 「问题处理」标签页，查看每条问题件的具体内容，也可在下方留言与客服沟通。
noon 对接会产生这三类问题件：
| 问题件标题 | 什么时候产生 | 怎么处理 |
|---|---|---|
| 库存不足 | 抓单时海外仓可用库存不够（第六章） | 补货后重新抓单 |
| 电商抓单异常 | 商品的品名资料不存在或未审核（第四章） | 到品名管理建档/审核后重新抓单 |
| noon转单号不可修改 | 已回传成功的运单被改绑或清空了转单号（第七章） | 需人工到 noon 侧处理，noon 的 AWB 创建后不可改 |
¶ 订单从FBP模式到FBPI模式迁移指南
适用于已在 FBP 模式下运营、需要将商品库存迁入新建 FBPI 集成仓的场景。完成迁移后，新订单将通过 API 或 Webhook 自动推送到 ERP 系统。
¶ 第一步：确认 FBPI 仓库已创建并激活
更新库存前，请先确认 FBPI 仓库已创建完成并处于激活状态。创建与配置方式请参考 2.3 创建 FBPI 仓库（获取 Warehouse Code）。
¶ 第二步：向 FBPI 仓库添加新库存
仓库激活后，可通过 Seller Lab 的「批量导入」功能添加库存：
- 进入导入页面：在 Seller Lab 顶部菜单点击 Catalog（目录）→ Imports（导入）。
- 新建导入任务：点击 Add Import（添加导入）。
- 选择导入类型：
- Main Type（主类型）：选择 Stock（库存）；
- Sub Type（子类型）：选择 FBP stock update（FBP 库存更新）。
- 选择仓库并导出模板：在 Customize（自定义） 区域的下拉菜单中选择刚创建的 FBPI 仓库，点击 Request Export（请求导出） 下载模板文件。
- 编辑模板文件：打开下载的 CSV 或 Excel 文件，在
stock_gross列为每个商品填写要设置的新库存数量。 - 上传并提交：保存文件后回到 noon 导入页面，上传文件并提交。文件较大时处理可能需要一段时间，可刷新页面查看状态。
¶ 切换逻辑
- 旧模式（FBP）：需要在 Seller Lab 后台手动处理订单。
- 新模式（FBPI）：当 FBPI 仓库库存到位后，所有新订单会通过 API 或 Webhook 自动推送到 ERP 系统，无需在 Seller Lab 后台手动操作。
简单来说：新库存到位后，新订单会自动切换到 FBPI 模式。完成以上操作，即可完成从 FBP 模式到 FBPI 模式的迁移。
**注意：**产品状态不是“Live”（在线），就无法成功上架库存并进行销售。
¶ 五、订单同步情况面板
系统参数 → 电商对接 → noon 卡片 → 「订单同步情况」。
这个面板只放还没成功生成运单的 noon 订单；成功生成运单的订单会自动从面板消失。
顶部四个统计：
| 统计 | 含义 |
|---|---|
| 等待处理 | 已收到 noon 推送、正在排队等机器人处理 |
| 处理不了 | 处理过但失败了，会自动重试；重试次数与失败原因在列表里 |
| 卡最久的 | 「处理不了」中最早那条卡了多久，用于判断是否需要人工介入 |
| 共计 | 未成功生成运单的订单总数 |
列表按失败优先、最早优先排序，最多显示最早的 20 条。订单较多时上方会提示当前共有多少条 —— 处理或「不再处理」掉前面的订单后点「刷新」，后续订单会依次显示；要找特定订单请在搜索框输入完整的 noon 订单号（精确匹配，不支持部分单号）。
每行可以：
- 平台推送报文：查看 noon 推过来的原始通知（含请求头、请求体、易抵达的响应）。
- 抓单报文：查看易抵达向 noon 查询该订单的请求与响应，失败原因通常在这里能看到细节。
- 不再处理：确实处理不了的订单可以停止重试。注意：该订单从此不再自动处理，也会从面板消失；如果 noon 之后再次推送同一订单，它会重新出现并恢复处理。
¶ 六、缺货处理与缺货回传
¶ 什么时候触发
抓单落库时按 SKU 检查海外仓可用库存并预扣。只要有任何一个商品行库存不足，就进入缺货处理。
¶ 落库行为（取决于第四章的抓单策略）
| 策略 | 缺货时的行为 |
|---|---|
| 校验不通过时拒绝导入（默认） | 整单不落库。noon 侧订单在易抵达没有运单，需补货后重抓 |
| 尽最大可能落库并生成问题件 | 有多少落多少：够的商品行照常落库并预扣；不够的按实际可用量部分预扣或整行剔除 |
选「尽最大可能落库」时，具体分三种情况：
- 部分缺货：可履约部分正常落库预扣，缺口写入「库存不足」问题件，写明每个 SKU 需要多少、已预扣多少、还缺多少，以及对应的 noon 平台商品行号（问题件内容样例见第四章末尾截图）。
- 全部缺货：主运单仍然落库（保留一件空单件），申报信息为空。
- 无论哪种，这些运单都不会自动取号，需人工核对处理。
¶ 自动回传给 noon
缺货信息会自动回传给 noon，让平台知道这些商品发不出去：
- 回传内容：把缺货的商品行状态置为
OUT_OF_STOCK - 触发方式：落库时自动投递事件，由回传机器人异步执行，无需人工操作、也无需单独配置回传接口
- 回传失败时：写入运单日志说明「noon 平台尚未收到缺货通知」，可用**「运单回传」**手动补发（见第七章「手动补发回传」）
¶ 补货之后怎么办
补货后对该订单重新抓单，易抵达会按最新库存重新落库并预扣。两种触发方式：
- 等 noon 再次推送（订单在 noon 侧有任何变更时会重新推过来）；
- 员工手动补抓：抓单接口列表选中该接口点「立即抓单」，抓最近 7 天订单（客户账号看不到这个按钮，需联系客服）。
重抓走的是全覆盖重建：出仓前会重建申报并自动清理、重新分配库存预占，不需要手工删申报或改库存；已出仓的运单只做增量，不会被改坏。
¶ 七、转单助手绑定 AWB 与回传 noon
这是 noon 订单履约的关键一步 —— 绑定 AWB 的动作会直接触发向 noon 回传发货信息。
¶ 操作步骤（海外仓）
- 包裹拣货复核完成后，从卖家提前提供给仓库的 noon 预印 AWB 标签中取一张贴到包裹上。
- 打开 菜单 → 转单助手（在一件代发(出仓)业务下）。
- 页面左上角有上下两行输入框，每行前面都有一个单号类型下拉：
- 上面一行 = 查询单号：下拉默认是「客户单号」，扫内部标签时要先改成「系统单号」，然后扫描或输入易抵达系统单号。
- 下面一行 = 需要更换的单号：下拉保持默认的「转单号」，扫描或输入该包裹上贴的 noon AWB 号。
- 回车，这一条会加入下方待处理列表；继续扫下一票。
- 全部扫完后点 「确认」 保存，绑定生效。
批量场景：右侧的快速录入框支持粘贴「查询单号 → Tab → 转单号」的多行内容（可直接从 Excel 复制），回车一次性录入。
⚠️ 易抵达打印的标签只是仓库内部识别用，noon 预印 AWB 才是实际物流面单，两者不要混淆。
¶ 绑定后系统自动做什么
绑定动作触发易抵达调用 noon 的 CreateShipment 接口，把以下内容回传给 noon：
- 该 noon 订单号
- 本次实际发出的有效商品行
- 刚绑定的 AWB（承运商标记为 noon）
回传成功后运单进入「已发货 / 待上网」；回传是否成功不阻塞易抵达自身的发货流转。
¶ 回传相关规则
| 情况 | 系统行为 | 你要做什么 |
|---|---|---|
| 回传成功 | 运单正常流转 | 无需操作 |
| 回传失败 | 保留已绑定的 AWB，失败原因写入运单日志 | 处理掉失败原因后用**「运单回传」**手动补发（见下节）；同时会补发尚未成功的缺货商品行 |
| 重复绑定同一个 AWB | 幂等跳过，不会在 noon 侧重复创建 Shipment | 无需操作 |
| 改绑成另一个 AWB / 清空转单号 | 生成「noon转单号不可修改」问题件 | 需人工到 noon 侧处理 —— noon 的 Shipment 一旦创建，AWB 就不能改了 |
¶ 手动补发回传（回传失败后的兜底）
回传失败不会自动无限重试，需要人工补发。操作位置：
一件代发(出仓) → 切到「全部」页签 → 找到该运单并勾选 → 底部按钮组右侧「更多」下拉 → 「运单回传」（该按钮在「全部」页签下提供；扫单助手里也有同名按钮，效果一样）
点击后弹出「运单回传」确认框，确认即重新向 noon 发起回传。这一次会一并处理两件事：
- 重新调用
CreateShipment把订单与 AWB 回传给 noon； - 补发此前记录过、但一直没成功回传的缺货商品行。
「运单回传」是缺货回传的最终兜底入口 —— 如果缺货事件投递失败或回传机器人始终发不出去，只有走这里才能补上。
回传结果（成功或失败原因）都会写入该运单的运单日志：双击运单打开详情 → 「日志」标签页，noon 相关记录的留言人显示为
noon，失败时附平台返回的原始原因。
¶ 之后的交接
CreateShipment 成功只代表 noon 知道了这个包裹。实物交接仍需卖家或授权人员在 noon Seller Lab 创建 Handover / Manifest，再由 noon 上门 Pickup 或仓库 Drop-off。易抵达不代做这一步，也没有对应的 API。
¶ 运单如何完结（人工确认上网与签收）
包裹交给 noon 后由 noon 负责运输派送。因为 noon 目前没有公开的物流轨迹接口，易抵达无法自动获取妥投状态，所以最后两步需要人工完成。
noon 运单在易抵达的状态流转：
待发货 ──绑定 AWB 并回传成功──▶ 待上网 ──人工确认上网──▶ 待签收 ──人工确认签收──▶ 已签收
操作位置：一件代发(出仓) 业务列表页顶部的状态页签
- 确认上网：包裹已实际交给 noon（Pickup 或 Drop-off 完成）后，到「待上网」页签选中运单，执行确认上网，运单转入「待签收」。
- 确认签收：在 noon Seller Lab 看到该 AWB 已妥投后，到「待签收」页签选中运单，执行确认签收，运单转入「已签收」完结。
什么时候确认，以 noon Seller Lab 的实际状态为准 —— 易抵达这边没有轨迹数据可依据。
¶ 八、常见问题
Q：抓单接口显示「已授权」，但点「立即抓单」提示没有运单可抓，「订单同步情况」面板也一直是 0，noon 后台明明有订单？
最常见的原因是仓库建错了板块：订单落在 FBP / DirectShip 仓，而不是 FBPI 集成仓。请按开篇「开始前必读」的三条自检核对——重点看这批订单是不是在 directship.noon.partners 的界面里、每行带「Create Shipment」按钮；如果是，它们走的是 FBP 人工通道，接口天然查不到，需要在 Fulfilled by Partner Integration 板块新建集成仓并把商品库存挂过去。
注意：「已授权」只代表 Service Account 凭证能正常登录 noon，不代表填写的 Warehouse Code 是一个 FBPI 集成仓。
Q：仓库设置里找不到 Webhook / Choose Integrator？
说明当前打开的是 FBP 仓，不是 FBPI 集成仓。Webhook 是 FBPI 集成仓独有的配置项，FBP 仓没有这一项，换账号或加权限也不会出现。请回到左侧菜单的 Fulfilled by Partner Integration 板块操作；如果整个板块都看不到，说明贵司账号尚未开通 FBPI，请联系 noon 客户经理开通。
Q：noon 后台显示订单已推送，但易抵达没有这张运单？
先看「订单同步情况」面板：如果订单在面板里，说明已收到推送、正在处理或处理失败，点「抓单报文」看失败原因；如果面板里没有，看 noon 后台该条 Webhook 的投递状态是否为 Failed，并核对 Webhook URL 与 x-api-key 是否填对。
Q：面板里的订单一直「处理不了」怎么办？
点「抓单报文」看 noon 返回的具体错误。常见原因：Service Account 凭证失效或 Warehouse Code 填错（重新走一次「noon 授权」校验）、订单在 noon 侧已取消或不存在、商品 SKU 在易抵达没有对应品名资料。确实处理不了的可以点「不再处理」。
Q：报错「品名数据不存在 / 尚未审核」？
该商品的 SKU 在易抵达品名管理中没有建档，或者机构开启了品名审核而这条品名还没审核通过。到品名管理中新建或完成审核后重抓即可。若机构的抓单策略选的是「尽最大可能落库」，这类商品行会被剔除并写入问题件，其余商品照常落库。
Q：库存不足的订单怎么处理？
按机构抓单策略：选「拒绝导入」则整单不落库；选「尽最大可能落库」则落可履约部分、生成「库存不足」问题件，并自动向 noon 回传缺货状态。补货后可重新抓单。
Q：绑定 AWB 后 noon 侧没有 Shipment？
查看运单日志中的回传结果。回传失败时 AWB 仍然保留，处理掉失败原因后，在一件代发(出仓)选中该运单点底部的「运单回传」补发即可。
Q：可以改已经回传成功的 AWB 吗？
不可以。noon 侧 Shipment 创建后 AWB 不能修改，易抵达检测到改绑会生成「noon转单号不可修改」问题件，需要人工在 noon 侧处理。