文档中心 > API类目 > 闲鱼电商SAAS

alibaba.idle.isv.order.query (Saas-闲鱼订单查询)

根据订单号,查询闲鱼订单相关信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_appraise_isv_order_query IsvQueryOrderDataQry 必须 订单查询接口入参
  • └ biz_order_id
  • Number
  • 必须
  • 1654923925004256719
  • 订单号
  • └ show_fd10ms
  • Boolean
  • 可选
  • false
  • 是否需要查询服务赔付履约信息-10分钟发货【请谨慎打开,会影响接口RT】
  • └ show_fd24hs
  • Boolean
  • 可选
  • false
  • 是否需要查询服务赔付履约信息-24小时发货【请谨慎打开,会影响接口RT】
  • └ show_vnr
  • Boolean
  • 可选
  • false
  • 是否需要查询服务赔付履约信息-描述不符全额退【请谨慎打开,会影响接口RT】
  • └ show_virtual_delivery_info
  • Boolean
  • 可选
  • false
  • 是否需要查询虚拟收货信息【请谨慎打开,会影响接口RT】
  • └ show_fd48hs
  • Boolean
  • 可选
  • false
  • 是否需要查询服务赔付履约信息-48小时发货【请谨慎打开,会影响接口RT】
  • └ show_gpa
  • Boolean
  • 可选
  • false
  • 是否需要查询服务赔付履约信息-假货包赔【请谨慎打开,会影响接口RT】
  • └ show_nfr
  • Boolean
  • 可选
  • false
  • 是否需要查询服务赔付履约信息-描述不符包邮退【请谨慎打开,会影响接口RT】

响应参数

名称 类型 示例值 描述
result CommonResult 返回结果
  • module
  • IdleOrderQueryTopVO
  • 订单信息
  • └ biz_order_id
  • Number
  • 123
  • 订单号
  • └ buy_amount
  • Number
  • 1
  • 商品购买数量
  • buyer_address
  • IdleOrderAddressTopSubVO
  • 买家收货地址
  • └ address
  • String
  • 文一西路969号
  • 详细地址
  • └ area
  • String
  • 余杭区
  • 行政区
  • └ city
  • String
  • 杭州
  • 城市
  • └ name
  • String
  • Jack
  • 收件人姓名
  • └ phone
  • String
  • 13654345789
  • 电话号码
  • └ prov
  • String
  • 浙江
  • 省份
  • └ town
  • String
  • 五常街道
  • 城镇/街道
  • └ buyer_nick
  • String
  • sdf_efdf
  • 买家昵称(不唯一且买家可以自己更改)
  • └ create_time
  • Number
  • 1616153546557
  • 订单创建时间,时间戳,毫秒
  • item
  • IdleOrderItemTopSubVO
  • 商品信息
  • └ item_id
  • Number
  • 13242343543
  • 商品ID
  • └ pic_url
  • String
  • http://gw.cdn.com/asdkqrw.png
  • 商品图片,绝对途径
  • └ price
  • Number
  • 300000
  • 商品价格,单位分
  • └ title
  • String
  • IphoneXR Max. 9成新手机
  • 商品标题
  • └ outer_id_spu
  • String
  • 11111111
  • 商品外部编码(SPU维度)
  • └ outer_id_sku
  • String
  • 11111111
  • 商品外部编码(SKU维度)
  • └ order_status
  • Number
  • 1
  • 0:未知状态、1:订单已创建、2:订单已付款、3:已发货、4:交易成功、5:已退款、6:交易关闭
  • └ pay_time
  • Number
  • 1616153546557
  • 订单下单付款时间,时间戳,毫秒
  • └ payment
  • Number
  • 290000
  • 实付金额, 单位分
  • └ post_fee
  • Number
  • 1500
  • 邮费
  • └ seller_nick
  • String
  • hehhe
  • 卖家昵称(不唯一且买家可以自己更改)
  • └ ship_time
  • Number
  • 1616153546557
  • 订单发货时间,时间戳,毫秒
  • └ end_time
  • Number
  • 1616153546557
  • 订单完结时间,时间戳,毫秒
  • └ sku
  • String
  • 4688553803343|颜色分类:浅灰色;配置等级:配置8
  • sku信息(格式: skuId|属性名:属性值;属性名:属性值)
  • logistics
  • IdleOrderLogisticsTopSubVO
  • 物流信息
  • └ express_no
  • String
  • SF11223344
  • 快递单号
  • └ express_comp_name
  • String
  • 顺丰
  • 快递公司名称
  • └ out_pay_id
  • String
  • 2020062022001157591427162361
  • 支付宝订单号(流水号)
  • └ encryption_buyer_id
  • String
  • RAzN8214YLDBs4AJxFJBYp5DdeHrBPKq4QsbFLosQe7pbuQ9DjGGbRKLFWFKm3EBm7wDQyY3XTkwrSKQ
  • 加密的买家id(唯一且不会改变)
  • └ encryption_seller_id
  • String
  • RAzN8214YLDBs4AJxFJBYp5DdeHrBPKq4QsbFLosQe7pbuQ9DjGGbRKLFWFKm3EBm7wDQyY3XTkwrSKQ
  • 加密的卖家id(唯一且不会改变)
  • service_compensate_list
  • IdleOrderCompensateTopSubVO []
  • 服务赔付单信息列表,多个
  • └ biz_order_id
  • Number
  • 134523413453534
  • 主订单号
  • └ apply_id
  • Number
  • 234345134523
  • 赔付单申请id
  • └ service_type
  • String
  • NFR
  • 服务赔付单类型: NFR(描述不符包邮退),VNR(虚拟-描述不符全额退),FD_24HS(极速发货-24小时),FD_10MS(极速发货-10分钟)
  • └ amount
  • Number
  • 3500
  • 赔付金额,单位分
  • └ status
  • Number
  • 1
  • 赔付单状态(10:已创建, 30:卖家已拒绝, 40:人工审核中, 50:卖家同意履约单结束, 51:人工审核同意结束, 52:人工审核拒绝履约单结束, 53:买家超时未处理,自动结束, 54:卖家超时未处理,自动支付, 1001:处理前买家取消, 1002:卖家拒绝买家取消)
  • └ create_time
  • Number
  • 43512341234
  • 赔付单创建时间,时间戳,毫秒
  • └ cancel_times
  • Number
  • 3
  • 取消的次数
  • refuse_reason
  • IdleOrderCompensateRefuseReasonData
  • 卖家拒绝原因
  • └ reason_choices
  • String []
  • 卖家选择的拒绝原因
  • └ reason_desc
  • String
  • 不符合赔付要求
  • 拒绝的描述
  • └ refuse_proofs
  • String []
  • 拒绝原因凭证
  • compensate_service_create_apply_info
  • CompensateServiceCreateApplyInfo
  • 买家申请索赔的信息
  • └ apply_reason
  • String
  • 描述不符
  • 申请原因
  • └ pic_list
  • String []
  • 上传的图片凭证
  • supplement_poofs
  • CompensateServiceAddEvidenceInfo []
  • 补充凭证(卖家补充信息)
  • └ apply_reason
  • String
  • 不符合赔付要求
  • 申请原因
  • └ pic_list
  • String []
  • 上传的图片凭证
  • └ order_sub_status
  • String
  • init
  • 订单子状态
  • virtual_delivery_info
  • VirtualDeliveryInfoVO
  • 虚拟收货信息
  • └ account
  • String
  • 1000000
  • 虚拟收货账号
  • └ ip
  • String
  • 10.10.10.10
  • 买家下单ip
  • └ x_global_biz_code
  • String
  • test
  • 子业务标识
  • └ og_id
  • String
  • 56245354413245635
  • 合并下单的订单关联id
  • └ forbid_actions
  • String []
  • 需要屏蔽的操作(ORDER_CLOSE : 关单,ADJUST_PRICE : 改价)
  • └ prom_related_order_ids
  • String
  • 2146417896225173387,2146417896226173387,2146417896227173387,2146417896228173387,2146417896229173387
  • 所有优惠关联订单
  • fa_che_order
  • IdleTrendyFaCheOrderVO
  • 发车订单信息
  • trendy_fc_order_memo_list
  • TrendyBuyerMemo []
  • 潮玩发车订单备注列表
  • └ title
  • String
  • 手机号
  • 备注title
  • └ content
  • String
  • 13xxxxx
  • 备注content
  • └ trendy_fc_order_status
  • Number
  • 34
  • 潮玩发车订单状态
  • └ trendy_fc_order_status_desc
  • String
  • 补邮完成,待发货
  • 潮玩发车订单状态描述
  • └ trendy_fc_order_postage_price
  • Number
  • 1
  • 发车支付邮费 单位:分
  • └ unit_price
  • Number
  • 1
  • 单价 单位:分
  • └ total_price
  • Number
  • 1
  • 总价 单位:分
  • └ actual_price
  • Number
  • 1
  • 实收金额
  • └ close_reason
  • String
  • 买家关闭了这笔交易
  • 关单类型
  • └ refund_status
  • String
  • 退款关闭
  • 退款类型
  • pre_sale_order
  • IdleTrendyPreSaleOrderVO
  • 预售订单信息
  • └ pre_sale_order_status
  • Number
  • 20
  • 潮玩发预售订单状态
  • └ pre_sale_order_status_desc
  • String
  • 买家已支付定金
  • 潮玩预售订单状态描述
  • └ deposit_price
  • Number
  • 10
  • 潮玩预售定金金额
  • └ balance_price
  • Number
  • 10
  • 潮玩预售尾款金额
  • └ post_price
  • Number
  • 10
  • 潮玩预售邮费金额
  • └ pre_sale_payment
  • Number
  • 10
  • 潮玩预售实付金额
  • └ balance_pay_time
  • Number
  • 1726824891000
  • 预售尾款支付时间
  • └ idle_biz_code
  • String
  • 61,62
  • 订单类型
  • virtual_flow_card
  • IdleTrendyVirtualFlowCardVO
  • 虚拟流量号卡信息
  • └ phone_number
  • String
  • 137****2356
  • 手机号
  • └ verify_code
  • String
  • 123456
  • 验证码
  • └ item_code
  • String
  • 442453
  • 商品code
  • chou_shang_order
  • IdleTrendyChouShangOrderVO
  • 二次元抽赏订单信息
  • prize_list
  • IdleTrendyChouShangPrizeVO []
  • 二次元抽赏订单奖品信息
  • └ prize_id
  • Number
  • 12
  • 奖品id
  • └ prize_title
  • String
  • 测试奖品
  • 奖品标题
  • └ prize_level
  • String
  • A赏
  • 奖品等级
  • └ prize_pic_url
  • String
  • https://rtrtrtr
  • 奖品图片url
  • └ prize_property_desc
  • String
  • 全新
  • 奖品属性描述
  • └ prize_delivery_status_desc
  • String
  • 现货
  • 奖品发货状态
  • └ prize_count
  • Number
  • 奖品数量
  • 奖品数量
  • └ could_post
  • Boolean
  • true
  • 是否支持发货
  • postage_compensate_list
  • IdleOrderPostageTopSubVO []
  • 邮费单逆向信息
  • └ apply_id
  • Number
  • 234345134523
  • 履约单id
  • └ refund_id
  • Number
  • 234345134523
  • 逆向单id
  • └ amount
  • Number
  • 3500
  • 赔付金额,单位分
  • └ refund_postage_type
  • String
  • 1
  • 0-BUYER-买家责任;1-SELLER-卖家责任;2-DISCUSS-协商
  • apply_dto
  • PostageRefundApplyNodeDTO
  • 履约信息
  • └ service_scene_type
  • String
  • FAST_DELIVERY_48_HOUR
  • 场景类型
  • └ refund_postage_type
  • String
  • 1
  • 0-BUYER-买家责任;1-SELLER-卖家责任;2-DISCUSS-协商
  • └ amount
  • Number
  • 300
  • 申诉金额
  • └ compensate_amount
  • Number
  • 300
  • 赔付金额
  • └ compensate_type
  • String
  • "DEPOSIT_COMPENSATE"
  • "DEPOSIT_COMPENSATE","保证金垫付";"DIRECT_COMPENSATE","直接垫付"
  • └ logistics_no
  • String
  • SF123
  • 物流单号
  • └ sub_status
  • Number
  • 30
  • 状态
  • └ delivery_way
  • String
  • SELF_DELIVER
  • 发货类型:SELF_DELIVER("自行寄件"),CAINIAO_DELIVER_IN_AMOUNT("菜鸟发货"),CAINIAO_DELIVER_OVER_AMOUNT("菜鸟发货-超额")
  • └ record_action_type
  • String
  • 1
  • 流水类型
  • seller_refuse_reason
  • PostageServiceRefuseReason
  • 卖家拒绝原因
  • └ reason_desc
  • String
  • 金额不符
  • 拒绝原因的描述
  • └ evidence
  • String
  • aaa
  • 拒绝凭证的图片
  • └ refuse_tag
  • String
  • aaa
  • 拒绝原因标签
  • apply_info
  • PostageServiceApplyInfo
  • 发起时的申请信息
  • └ amount
  • Number
  • 100
  • 赔付金额
  • └ apply_reason
  • String
  • 描述不符
  • 创建申请原因
  • └ evidence
  • String
  • aaa
  • 上传的图片凭证
  • └ fail_reason
  • String
  • 111
  • 异常原因
  • chou_shang_post_order
  • IdleTrendyChouShangPostOrderVO
  • 二次元抽赏邮费订单信息
  • prize_list
  • IdleTrendyChouShangPostStockVO []
  • 二次元抽赏邮费订单奖品信息
  • └ prize_id
  • Number
  • 123456
  • 奖品id
  • └ prize_title
  • String
  • 犬夜叉
  • 奖品名称
  • └ prize_pic_url
  • String
  • http://sss
  • 奖品图片
  • └ prize_property_desc
  • String
  • 全新
  • 奖品属性描述
  • └ prize_delivery_status_desc
  • String
  • 立即开售
  • 奖品发货状态描述 (现货/ 预售)
  • └ prize_count
  • Number
  • 10
  • 奖品数量
  • idle_coin_deduction_order
  • IdleCoinDeductionOrderVO
  • 闲鱼币抵扣信息
  • └ xyb_de_rate
  • String
  • 30
  • 闲鱼币抵扣比例
  • └ xyb_rate
  • String
  • 100
  • 商业化抽佣比例,默认100,全抽
  • └ xyb_ratio
  • String
  • 10
  • 闲鱼币与金额兑换比例
  • └ xyb_fee_p
  • String
  • 1800
  • 平台补偿闲鱼币数量
  • └ xyb_fee_b
  • String
  • 0
  • 买家付款闲鱼币
  • └ xyb_fee_s
  • String
  • 1800
  • 卖家应收闲鱼币
  • └ success
  • Boolean
  • false
  • 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaIdleIsvOrderQueryRequest req = new AlibabaIdleIsvOrderQueryRequest();
AlibabaIdleIsvOrderQueryRequest.IsvQueryOrderDataQry obj1 = new AlibabaIdleIsvOrderQueryRequest.IsvQueryOrderDataQry();
obj1.setBizOrderId(1654923925004256719L);
obj1.setShowFd10ms(false);
obj1.setShowFd24hs(false);
obj1.setShowVnr(false);
obj1.setShowVirtualDeliveryInfo(false);
obj1.setShowFd48hs(false);
obj1.setShowGpa(false);
obj1.setShowNfr(false);
req.setParamAppraiseIsvOrderQuery(obj1);
AlibabaIdleIsvOrderQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_idle_isv_order_query_response>
    <result>
        <module>
            <biz_order_id>123</biz_order_id>
            <buy_amount>1</buy_amount>
            <buyer_address>
                <address>文一西路969号</address>
                <area>余杭区</area>
                <city>杭州</city>
                <name>Jack</name>
                <phone>13654345789</phone>
                <prov>浙江</prov>
                <town>五常街道</town>
            </buyer_address>
            <buyer_nick>sdf_efdf</buyer_nick>
            <create_time>1616153546557</create_time>
            <item>
                <item_id>13242343543</item_id>
                <pic_url>http://gw.cdn.com/asdkqrw.png</pic_url>
                <price>300000</price>
                <title>IphoneXR Max. 9成新手机</title>
                <outer_id_spu>11111111</outer_id_spu>
                <outer_id_sku>11111111</outer_id_sku>
            </item>
            <order_status>1</order_status>
            <pay_time>1616153546557</pay_time>
            <payment>290000</payment>
            <post_fee>1500</post_fee>
            <seller_nick>hehhe</seller_nick>
            <ship_time>1616153546557</ship_time>
            <end_time>1616153546557</end_time>
            <sku>4688553803343|颜色分类:浅灰色;配置等级:配置8</sku>
            <logistics>
                <express_no>SF11223344</express_no>
                <express_comp_name>顺丰</express_comp_name>
            </logistics>
            <out_pay_id>2020062022001157591427162361</out_pay_id>
            <encryption_buyer_id>RAzN8214YLDBs4AJxFJBYp5DdeHrBPKq4QsbFLosQe7pbuQ9DjGGbRKLFWFKm3EBm7wDQyY3XTkwrSKQ</encryption_buyer_id>
            <encryption_seller_id>RAzN8214YLDBs4AJxFJBYp5DdeHrBPKq4QsbFLosQe7pbuQ9DjGGbRKLFWFKm3EBm7wDQyY3XTkwrSKQ</encryption_seller_id>
            <service_compensate_list>
                <idle_order_compensate_top_sub_v_o>
                    <biz_order_id>134523413453534</biz_order_id>
                    <apply_id>234345134523</apply_id>
                    <service_type>NFR</service_type>
                    <amount>3500</amount>
                    <status>1</status>
                    <create_time>43512341234</create_time>
                    <cancel_times>3</cancel_times>
                    <refuse_reason>
                        <reason_desc>不符合赔付要求</reason_desc>
                    </refuse_reason>
                    <compensate_service_create_apply_info>
                        <apply_reason>描述不符</apply_reason>
                    </compensate_service_create_apply_info>
                    <supplement_poofs>
                        <compensate_service_add_evidence_info>
                            <apply_reason>不符合赔付要求</apply_reason>
                        </compensate_service_add_evidence_info>
                    </supplement_poofs>
                </idle_order_compensate_top_sub_v_o>
            </service_compensate_list>
            <order_sub_status>init</order_sub_status>
            <virtual_delivery_info>
                <account>1000000</account>
                <ip>10.10.10.10</ip>
            </virtual_delivery_info>
            <x_global_biz_code>test</x_global_biz_code>
            <og_id>56245354413245635</og_id>
            <prom_related_order_ids>2146417896225173387,2146417896226173387,2146417896227173387,2146417896228173387,2146417896229173387</prom_related_order_ids>
            <fa_che_order>
                <trendy_fc_order_memo_list>
                    <trendy_buyer_memo>
                        <title>手机号</title>
                        <content>13xxxxx</content>
                    </trendy_buyer_memo>
                </trendy_fc_order_memo_list>
                <trendy_fc_order_status>34</trendy_fc_order_status>
                <trendy_fc_order_status_desc>补邮完成,待发货</trendy_fc_order_status_desc>
                <trendy_fc_order_postage_price>1</trendy_fc_order_postage_price>
                <unit_price>1</unit_price>
                <total_price>1</total_price>
                <actual_price>1</actual_price>
            </fa_che_order>
            <close_reason>买家关闭了这笔交易</close_reason>
            <refund_status>退款关闭</refund_status>
            <pre_sale_order>
                <pre_sale_order_status>20</pre_sale_order_status>
                <pre_sale_order_status_desc>买家已支付定金</pre_sale_order_status_desc>
                <deposit_price>10</deposit_price>
                <balance_price>10</balance_price>
                <post_price>10</post_price>
                <pre_sale_payment>10</pre_sale_payment>
                <balance_pay_time>1726824891000</balance_pay_time>
            </pre_sale_order>
            <idle_biz_code>61,62</idle_biz_code>
            <virtual_flow_card>
                <phone_number>137****2356</phone_number>
                <verify_code>123456</verify_code>
                <item_code>442453</item_code>
            </virtual_flow_card>
            <chou_shang_order>
                <prize_list>
                    <idle_trendy_chou_shang_prize_v_o>
                        <prize_id>12</prize_id>
                        <prize_title>测试奖品</prize_title>
                        <prize_level>A赏</prize_level>
                        <prize_pic_url>https://rtrtrtr</prize_pic_url>
                        <prize_property_desc>全新</prize_property_desc>
                        <prize_delivery_status_desc>现货</prize_delivery_status_desc>
                        <prize_count>奖品数量</prize_count>
                    </idle_trendy_chou_shang_prize_v_o>
                </prize_list>
                <could_post>true</could_post>
            </chou_shang_order>
            <postage_compensate_list>
                <idle_order_postage_top_sub_v_o>
                    <apply_id>234345134523</apply_id>
                    <refund_id>234345134523</refund_id>
                    <amount>3500</amount>
                    <refund_postage_type>1</refund_postage_type>
                    <apply_dto>
                        <service_scene_type>FAST_DELIVERY_48_HOUR</service_scene_type>
                        <refund_postage_type>1</refund_postage_type>
                        <amount>300</amount>
                        <compensate_amount>300</compensate_amount>
                        <compensate_type>&quot;DEPOSIT_COMPENSATE&quot;</compensate_type>
                        <logistics_no>SF123</logistics_no>
                        <sub_status>30</sub_status>
                        <delivery_way>SELF_DELIVER</delivery_way>
                        <record_action_type>1</record_action_type>
                        <seller_refuse_reason>
                            <reason_desc>金额不符</reason_desc>
                            <evidence>aaa</evidence>
                            <refuse_tag>aaa</refuse_tag>
                        </seller_refuse_reason>
                        <apply_info>
                            <amount>100</amount>
                            <apply_reason>描述不符</apply_reason>
                            <evidence>aaa</evidence>
                        </apply_info>
                        <fail_reason>111</fail_reason>
                    </apply_dto>
                </idle_order_postage_top_sub_v_o>
            </postage_compensate_list>
            <chou_shang_post_order>
                <prize_list>
                    <idle_trendy_chou_shang_post_stock_v_o>
                        <prize_id>123456</prize_id>
                        <prize_title>犬夜叉</prize_title>
                        <prize_pic_url>http://sss</prize_pic_url>
                        <prize_property_desc>全新</prize_property_desc>
                        <prize_delivery_status_desc>立即开售</prize_delivery_status_desc>
                        <prize_count>10</prize_count>
                    </idle_trendy_chou_shang_post_stock_v_o>
                </prize_list>
            </chou_shang_post_order>
            <idle_coin_deduction_order>
                <xyb_de_rate>30</xyb_de_rate>
                <xyb_rate>100</xyb_rate>
                <xyb_ratio>10</xyb_ratio>
                <xyb_fee_p>1800</xyb_fee_p>
                <xyb_fee_b>0</xyb_fee_b>
                <xyb_fee_s>1800</xyb_fee_s>
            </idle_coin_deduction_order>
        </module>
        <success>false</success>
    </result>
</alibaba_idle_isv_order_query_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案
TOP_NOT_SELLER 登录用户不是订单卖家 非当前卖家订单,不能查询
TOP_SELLER_NOTALLOW_ACCESS 卖家未通过闲鱼招商 联系闲鱼运营报名入驻
isp.call-limited 开放平台错误 群答疑@智能小开机器人
ORDER_NOT_EXSIT 订单不存在 订单id非法,需要服务商更换订单id
TOP_USER_NOT_LOGIN 用户未登录或者登录态失效 重新获取登录token

API工具

如何获得此API

FAQ

返回
顶部