一箱一个Return：ShipBob退货记录怎样连接物品与商户编号

电商退货可能在商户系统里先有一个编号，到履约仓又出现另一条记录。ShipBob的2026-07 Returns文档用reference_id解释二者怎样连接：这是来自商户系统的唯一标识，用于把ShipBob退货与商户自身记录关联。[1] 它表达的是记录之间的联系，不能只凭编号存在就说实物已经到仓。

文档将Return定义为处理送回履约中心库存的请求，并以“One Box, One Return”概括箱件关系：每个实物货件需要自己的退货单。这里的计数对象是实物箱件，而不是商品种类总数。一个箱中有多个不同物品，并不要求把每种物品都理解成一箱；多个箱件也不能仅因关联同一商户业务，就在这个规则下被说成一个物理货件。

原页的多物品示例在同一退货记录内放入两个库存条目，并分别列数量。Key Rules还强调，一个库存id不要重复列入；不同实物品项使用各自条目，数字商品或组合包不直接作为这里的实物条目。本文采用的是示例的记录层次，不提供接口请求、商品合并或库存处置办法。箱、条目、数量在这一结构里各有对象。

reference_id又是另一层。它来自商户自己的系统，文档说明其用途是追踪和对照退货记录。箱内的inventory id指向物品条目，reference_id则联系商户记录；二者虽然都能被称作编号，却不应在资料摘要里删成一个没有名称的“退货号码”。保留字段名，才能看见作者分别在连接什么。

Status Reference为退货另列五种状态。[2] AwaitingArrival表示已经建立、等待到仓，Arrived表示已到仓，Processing表示正在仓库处理，Completed表示退货处理完成，Cancelled表示已取消。它们为同一类记录补上进度信息，没有把建立记录、实物到达和处理完成压成同一事件。

一个纯说明用的例子是：资料甲已有商户关联编号，资料乙才记录Arrived，资料丙记录Completed。三者增加的信息不同。甲能让两套记录相连，却不能代替乙的到达状态；乙说明到仓，也没有自行增加丙的完成事实。这个例子没有真实订单，更不判断退回物品能否重新销售、是否已经退款或质量是否合格。

本篇采用2026-07版本的Returns及Status Reference，不与已弃用版本的字段混用，精确首发日期未知。文档将实物处理与商户系统退款分别说明，本文止于箱件、物品、关联编号和状态的定义，不调用接口、不修改库存，也不把仓内处理完成转换成退款、赔付或合同结果。