APIs/parameters to be changed

API changes

Impact to API users

Query order list

aliexpress.trade.seller.orderlist.get

aliexpress.trade.redefining.findorderlistsimplequery

• The server side cannot distinguish FUND_PROCESSING and FINISH. If "order_status_list" includes one (but not both) of these two statuses, the result will include orders of both of these two statuses. Please refer to Appendix I for details.
• The result cannot distinguish FUND_PROCESSING and FINISH. Orders in these two statuses will be in status "FINISH" in result.
• The result of querying IN_CANCEL orders may not be 100% accurate. In rare cases some IN_CANCEL orders are not in result or some orders in result are not really IN_CANCEL. 

• If you only want to have FUND_PROCESSING of FINISH orders in the result, you need to filter out the result by yourself. Note the number of FINISH orders is usually larger than the number of FUND_PROCESSING orders. We recommend not to distinguish FUND_PROCESSING and FINISH.
• If you want to distinguish FUND_PROCESSING and FINISH, you can query the single order details to get the correct order status.

The expiration time of order operations

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

Now we only support expiration time of below order statuses. Will return null when order is in other order statuses

• IN_CANCEL
• WAIT_SELLER_EXAMINE_MONEY
• WAIT_SELLER_SEND_GOODS
• SELLER_PART_SEND_GOODS
• WAIT_BUYER_ACCEPT_GOODS

Please let us know other cases if you're using

The escrow fee rate and affiliate fee rate

aliexpress.trade.new.redefining.findorderbyid

• target -> escrow_fee (inactive already)
• target -> logisitcs_escrow_fee_rate (inactive already)
• target -> child_order_list -> afflicate_fee_rate
• target -> child_order_list -> escrow_fee_rate

aliexpress.trade.seller.orderlist.get

• result -> target_list -> escrow_fee (inactive already)
• result -> target_list -> escrow_fee_rate (inactive already)
• 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 will provide trial fee rates (may not be accurate) after buyer's payment and before loan settlement. The accurate fee rates will be provided after loan settlement.

The APIs to query order list will not provide fee rates.

If you have the logic to use fee rates before order payment, please remove the logic.

If you use fee rates when querying order list, plese use 

aliexpress.trade.new.redefining.findorderbyid to get the fee rates.

Operation log list of single order details query

aliexpress.trade.new.redefining.findorderbyid

• target -> opr_log_dto_list

This field will be null in response

Please remove related logic if you're using the operation log list.

Whether the order is placed by mobile phone

aliexpress.trade.seller.orderlist.get

• result -> target_list -> phone

aliexpress.trade.redefining.findordertradeinfo

• result -> is_phone

aliexpress.trade.new.redefining.findorderbyid

• target -> is_phone

Removed, always returns false

Please remove related logic

The ship order id in logistics informations of order details

aliexpress.trade.new.redefining.findorderbyid

• target -> logistic_info_list -> ship_order_id

Removed

Please remove related logic

Whether the product guarantees triple refund for fake products

aliexpress.trade.redefining.findorderlistsimplequery

• result -> order_list -> product_list -> money_back3x

aliexpress.trade.seller.orderlist.get

• result->target_list -> product_list -> money_back3x

Removed, always returns false

The business has been inactive for a long time. So it's correct behavior to return false

You can ignore this change but it's recommended to remove related logic.

Fax related information in buyer's receipt information

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

Removed

The fax related information is not used anywhere. So the change doesn't matter.

You can ignore this change but it's recommended to remove related logic.

Refund reason in refund information

aliexpress.trade.new.redefining.findorderbyid

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

Current data returned is incorrect. The new refund reason will be returned (only for display purpose)

Query order's loan list

aliexpress.trade.redefining.findloanlistquery

• Only supports querying orders whose loan is settled to seller (loan_status=loan_ok). Will not support querying orders whose loan is pending (loan_status=wait_loan)
• The order status of orders in result will be FINISH for orders whose actual status is FUND_PROCESSING or FINISH
• The refund information will only include refund from seller. The refund from platform not from seller will not be included
• The maximum page_size is 10 due to performance
• The data will have 1-2 days' delay. Only data before T-2 (including T-2) is guaranteed

• Adujst the page_size to 10
• Don't query today's data. T-1 data may not be always available. If you fail to get T-1 data, please query it one day later
• To distinguish the order statuses FUND_PROCESSING and FINISH, please use aliexpress.trade.new.redefining.findorderbyid

Payment Type

aliexpress.trade.new.redefining.findorderbyid

• target -> payment_type

aliexpress.trade.seller.orderlist.get

• result->target_list -> payment_type

The time when the goods is sent

aliexpress.trade.seller.orderlist.get

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