接口名称: 获取售后单
接口英文名: getaftersaleorder
当前问题:
在退货退款场景下,商家通过「同意售后」接口接受买家退货时,需传入 address_id 指定退货收货地址。但通过 getaftersaleorder 接口查询售后单详情时,返回的 return_info
仅包含买家的退货物流信息(waybill_id、delivery_id、delivery_name、return_type),不包含商家在同意退货时指定的退货地址信息。
这导致以下问题:
1. 商家在第三方系统(ERP/客服系统)中无法通过查询售后单获知该售后对应的退货收货地址,无法自动化处理退货签收和退款流程。
2. 同一店铺可能配置多个退货地址(如不同仓库),商家在同意退货时可手动选择不同地址,第三方系统无法区分具体退回哪个地址。
3. 商家需要自行在本地存储每次同意退货时选择的地址,增加了对接成本和数据不一致的风险。
建议方案:
在 return_info 中增加商家退货地址相关字段,例如:
return_info 新增字段:
- merchant_return_address_id: string // 商家退货地址ID(商家同意退货时传入的address_id)
- merchant_return_address: object // 商家退货地址详情(复用现有 address_info 结构)
- user_name: string
- province_name: string
- city_name: string
- county_name: string
- detail_info: string
- tel_number: string
- postal_code: string
期望效果:
第三方系统通过 getaftersaleorder 即可获取完整的售后退货链路信息(买家退货物流 + 商家退货地址),无需额外维护本地地址映射,便于实现退货签收校验、自动化退款等业务流程。
