在电商管理系统的日常运营中，订单发货和售后处理是业务复杂度最高的两个环节。有赞订单接口为拆单发货、部分发货、售后退款等场景提供了完整的API支持。本文将深入解析这些场景的集成要点。

一、拆单发货与多包裹场景

在实际业务中，一个订单可能包含多个商品，需要分多个包裹发出。有赞订单接口支持两种拆单发货方式：

方式一：整单发货（一个订单对应一个物流单号）——使用youzan.logistics.online.confirm接口，传入订单号tid和物流信息即可完成发货。

方式二：拆单发货（一个订单对应多个物流单号）——当订单需要拆分多个包裹发货时，需在调用发货接口时指定oids参数。oids为订单交易明细编号（即子订单ID），多个明细编号用半角逗号“,”分隔。例如，一个订单包含3个商品（对应3个oid），第一次发货发2个商品传入oids="oid1,oid2"，第二次发剩余1个传入oids="oid3"。

注意事项：

如果订单下已有部分商品发货，再次调用发货接口时必须指定oids，否则会报错

拆单发货时，系统需在本地维护父订单与各物流包裹的映射关系

每调用一次拆单发货接口，订单会进入“部分发货”状态，直至所有商品发货完成才转为“已发货”

二、逆向流程：售后与退款集成

有赞开放平台为逆向交易场景提供了完整的接口支持：

查看退款列表：youzan.trade.refund.search

查看退款详情：youzan.trade.refund.get

商家同意退款：youzan.trade.refund.agree

商家拒绝退款：youzan.trade.refund.reject

卖家同意退货：youzan.trade.refund.returngoods.agree

商家主动退款：youzan.trade.refund.seller.initiative

售后列表的获取建议采用定时轮询策略，每5-10分钟调用退款列表接口，获取状态为“待处理”的售后申请。售后详情接口可获取完整的退款信息，包括退款金额、退款原因、用户申请凭证等。

售后审核的自动化处理：系统可基于预设规则引擎进行自动化判断——对于订单金额低于阈值且无恶意退款历史的“仅退款”申请，自动调用同意退款接口完成退款；对于退货退款申请，则需获取退货地址发送给用户，待用户上传退货物流单号并签收后，再触发退款执行。

特殊场景处理：未发货状态下的退款申请，ERP系统应在发货前检查订单是否已存在退款申请，避免对已申请退款的订单执行发货操作。

三、发货前校验与状态检查

为防止对已退款或已关闭的订单执行发货，ERP系统在调用发货接口前应进行以下前置校验：

查询订单详情youzan.trade.get，确认当前订单状态为“待发货”

检查退款状态，确认无进行中的退款申请

确认发货商品对应的oids未被其他包裹占用

四、物流信息修改与异常处理

发货后如需修改物流信息，有赞提供了修改订单物流接口。开发者需在系统设计中支持物流信息的更正操作。

常见错误码：

code: 5000；message: trade not found：订单号不存在，需检查订单号格式（有赞订单以“E”开头，24位长度）

“发货商品不合法，无法发货”：通常因未正确传入oids导致

page_no超出最大查询限制：分页参数超过100

五、订单金额字段的正确解析

youzan.trade.get订单详情接口中，pay_info.payment是买家应付金额，pay_info.real_payment是买家实付金额。在大多数场景下两者相等，但在部分场景下（如部分退款后），实付金额会小于应付金额。

点三作为国家高新技术企业，十余年来专注电商全渠道数据对接，已覆盖60+主流电商平台，服务超过50000家企业。点三电商开放平台已全面支持电商订单的拆单发货、部分发货、售后自动化处理等全场景，帮助商家实现高效、稳定的订单履约管理。有需求可咨询点三客服或拨打点三客服热线18975154575免费获取接口文档。