要变更的API及要变更的字段

API变更内容

ISV需要做的更改

查询订单列表

aliexpress.trade.seller.orderlist.get

aliexpress.trade.redefining.findorderlistsimplequery

• 按订单状态列表条件查询时服务端无法区分FUND_PROCESSING和FINISH，将同时返回这两种状态的订单。不指定任何状态时将不返回FUND_PROCESSING的订单。详情见附表1
• 查询结果里的订单状态无法区分FUND_PROCESSING和FINISH，这两种状态下都返回FINISH，订单详情接口仍支持区分这两种状态
• 查询取消中的订单返回的结果不能保证100%准确性，在极少数情况下可能会漏单或者返回的订单不是取消中的

• ISV需在结果里自己按订单状态过滤想要的订单，如ISV想查询包括FUND_PROCESSING在内但不包含FINISH的订单，结果里会包含FINISH的订单，ISV需要过滤掉这些订单，副作用是返回的数据可能增多很多，例如原来一页，现在可能返回很多页。如果你原来的查询已经同时包含FUND_RPOCESSING和FINISH，则无需改动。
• 不指定任何状态查询时，不返回FUND_PROCESSING的订单，需要的话请查询FINISH的订单然后再过滤
• 订单列表的订单状态如要区分FUND_PROCESSING和FINISH，请查询详情

订单的超时时间

aliexpress.trade.redefining.findorderlistsimplequery

• result -> order_list -> timeout_left_time

aliexpress.trade.new.redefining.findorderbyid

• target -> over_time_left

aliexpress.trade.seller.orderlist.get

• result -> target_list -> product_list -> timeout_left_time

只支持下面几个状态下的超时时间，其他状态下超时时间不返回

• IN_CANCEL
• WAIT_SELLER_EXAMINE_MONEY
• WAIT_SELLER_SEND_GOODS
• SELLER_PART_SEND_GOODS
• WAIT_BUYER_ACCEPT_GOODS

如果用到其他状态下的超时时间请告知我们是什么状态及其使用场景

佣金、佣金比例

aliexpress.trade.new.redefining.findorderbyid

• target -> escrow_fee（原先就已经废弃）
• target -> logisitcs_escrow_fee_rate（原先就已经废弃）
• target -> child_order_list -> afflicate_fee_rate
• target -> child_order_list -> escrow_fee_rate

aliexpress.trade.seller.orderlist.get

• result -> target_list -> escrow_fee（原先就已经废弃）
• result -> target_list -> escrow_fee_rate（原先就已经废弃）
• result -> target_list -> logistics_escrow_fee_rate
• result -> target_list -> product_list -> afflicate_fee_rate
• result -> target_list -> product_list -> escrow_fee_rate

aliexpress.trade.new.redefining.findorderbyid在支付之后，放款之前会提供试算的佣金比率（但不一定准确），放款之后会提供准确的数据

列表查询不再提供佣金比率，如需佣金比率，请根据订单id查询订单详情

如果你在订单支付之前用到了佣金比率，请移除相应逻辑。

如果你再订单列表查询中用到了佣金比率，请使用

aliexpress.trade.new.redefining.findorderbyid查询佣金比率

订单详情里的操作日志列表

订单详情查询（aliexpress.trade.new.redefining.findorderbyid）

• target -> opr_log_dto_list

废弃，将返回空，如

"opr_log_dto_list": {}

请移除相关逻辑

是否手机订单

aliexpress.trade.seller.orderlist.get

• result -> target_list -> phone

aliexpress.trade.redefining.findordertradeinfo

• result -> is_phone

aliexpress.trade.new.redefining.findorderbyid

• target -> is_phone

废弃，永远返回false或者不返回

请移除相关逻辑

订单详情里的物流信息里的物流订单ID

aliexpress.trade.new.redefining.findorderbyid

• target -> logistic_info_list -> ship_order_id

废弃，不返回

请移除相关逻辑

是否假一赔三产品

aliexpress.trade.redefining.findorderlistsimplequery

• result -> order_list -> product_list -> money_back3x

aliexpress.trade.seller.orderlist.get

• result->target_list -> product_list -> money_back3x

废弃，永远返回false

这个业务已经下线很久了，因此返回false也是正确的。

ISV可不做调整，但推荐去除相关逻辑

买家收货地址里的传真相关信息

aliexpress.trade.redefining.findorderreceiptinfo

• result -> fax_area / fax_country / fax_number

aliexpress.trade.new.redefining.findorderbyid

• target -> receipt_address -> fax_area / fax_country / fax_number

废弃，不返回

传真信息目前在整个网站都已经不再使用了，买家输入的地址里也没有传真，不返回也是正确的。

ISV可不做调整，但推荐去除相关逻辑

退款信息里的退款原因

aliexpress.trade.new.redefining.findorderbyid

• target -> refund_info -> refund_reason
• target -> child_order_list -> refund_info -> refund_reason

原先给的数据是错误的，并非退款原因，会返回新的退款原因，仅供展示使用

原先给的数据是错误的，并非退款原因。

新的数据仅供展示，请注意

查询订单放款信息：

aliexpress.trade.redefining.findloanlistquery

• 不支持查询未放款的订单（loan_status=wait_loan），仅能查询已放款的订单，查询未放款的订单会返回空列表
• 查询结果里的订单状态无法区分FUND_PROCESSING和FINISH，这两种状态下都返回FINISH
• 退款信息仅包含卖家责任的退款，平台赔付且无需卖家赔付的退款不计算在内
• 基于性能考虑，每次仅能查询10条，即page_size最大为10
• 数据会有1-2天的延迟，只能保证T-2及之前的数据能查到。

• 调整page_size为10
• 不要查询当天数据，查不到；前一天的数据不一定有，如果没查到请隔一天再查
• 如果要区分订单状态的FUND_PROCESSING和FINISH，请查询订单详情

付款方式

aliexpress.trade.new.redefining.findorderbyid

• target -> payment_type

aliexpress.trade.seller.orderlist.get

• result->target_list -> payment_type

订单发货时间

aliexpress.trade.seller.orderlist.get

• result->target_list -> gmt_send_goods_time
• result->target_list -> product_list -> send_goods_time