轻易云
注册体验
POSThttps://open.youzanyun.com/api/youzan.trades.sold.get/4.0.1access_token(query 传参)

查询卖家已售交易列表(youzan.trades.sold.get)

有赞交易列表查询接口,按创建/更新时间窗口分页拉取订单头、明细与支付信息,是订单同步与电商财务对账的核心取数口。

来源：https://doc.youzanyun.com/detail/api/0/171
## 接口说明 youzan.trades.sold.get 查询卖家店铺在一定条件下卖出的交易列表,支持按创建时间或更新时间窗口分页,返回订单号(tid)、状态(status)、实付(payment)、邮费(post_fee)、商品明细(orders:商品名、数量、单价、实付)、买家与收货信息等。版本号随接口演进(如 4.0.1),调用路径必须带对版本,否则报 4005 非法的 API。 ### 请求要点 1. POST + application/json(也支持 form),access_token 放 URL query。 2. 分页:page_no、page_size(建议 ≤100);时间窗口 start_created/end_created(创建时间)或 start_update/end_update(更新时间),增量同步用 update 口径并重叠数分钟。 3. 响应 response.trades 为订单数组,response.total_results 为总条数;status 枚举(WAIT_PAY、WAIT_SELLER_SEND_GOODS、WAIT_BUYER_CONFIRM_GOODS、TRADE_SUCCESS、TRADE_CLOSED 等)用于区分履约与关闭订单。 4. 退款中的订单金额口径:对账时以 payment - refund_fee 计算净实收,并关联退款单接口明细。 ### 对账场景 轻易云 AI 财务对账方案用本接口拉取有赞订单实收,与微信支付/支付宝账单、ERP 应收三单匹配;差异单(金额不符、缺单、多单)自动归类进入人工处理队列。

代码示例

curl
curl -X POST "https://open.youzanyun.com/api/youzan.trades.sold.get/4.0.1?access_token=TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"start_update":"2026-06-01 00:00:00","end_update":"2026-06-01 01:00:00","page_no":1,"page_size":100}'

错误码

错误码消息含义
4001非法请求地址路径格式错误,应为 /api/{api_name}/{api_version}
4005非法的APIapi_name 或版本不存在,核对版本号
4201非法的请求凭证token 无效或授权关系过期,重新获取
4101请求太频繁触发限流,降速重试