文档中心 > API类目 > 飞猪推广平台

alibaba.fliggy.promote.orders.list (读取飞猪分销订单列表)

读取飞猪分销订单列表。接口注意事项如下 1. 订单列表是根据佣金的修改时间倒序排列 2. 翻页时如果有新订单产生可能重复读取到已读取的订单ID,请调用时兼容 3. 订单被删除时佣金记录会写入为0 4. 如果订单佣金被提现后又发生退款(极少见),会生成一条佣金追缴记录。追缴记录的佣金金额为负,是否是追缴记录可使用recover字段判断

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
page_no Number 可选 0
  • 默认值:0
  • 页码:从0开始第一页
    before_modify_time Date 可选 2022-07-05 20:14:00 过滤早于(不包含)指定修改时间的订单
    after_modify_time Date 可选 2022-07-05 20:14:00 过滤晚于(不包含)指定修改时间的订单

    响应参数

    名称 类型 示例值 描述
    model PromoteUserOrderListResponse 查询结果
    • list
    • Order []
    • 订单列表
    • └ commission_money
    • String
    • 26.17
    • 佣金金额。单位:元
    • └ commission_status
    • String
    • 提现成功
    • 佣金状态。中文描述,建议直接使用,目前有:提现成功/提现中/追缴成功/追缴中
    • └ cover_url
    • String
    • https://xxx.alicdn.com/xxx/xxx
    • 封面图
    • └ item_name
    • String
    • 杭州西溪雷迪森大酒店豪华大床房
    • 宝贝名称
    • └ modify_time
    • String
    • 2022-07-05 20:57:00
    • 佣金修改时间。当订单状态发生变化时佣金会重新计算,比如订单退款、订单关闭 等场景
    • └ order_id
    • String
    • 2739917052767361744
    • 订单ID
    • └ order_money
    • String
    • 832.12
    • 订单金额。单位:元
    • └ order_status
    • String
    • 订单关闭
    • 订单状态。中文描述,建议直接引用。比如:支付成功/订单关闭/交易成功
    • └ order_time
    • String
    • 2022-07-05 20:14:00
    • 订单创建时间
    • └ recover
    • Boolean
    • false
    • 是否是追缴订单(当订单佣金被提现,订单又发生了退款时可能产生追缴订单),追缴订单的佣金金额为负
    • └ fpsid
    • String
    • xx_xxx_xx
    • fpsid 跟踪时的外部自定义参数
    • └ settle_time
    • String
    • 2022-07-15 20:14:00
    • 佣金结算时间。指订单确定发放佣金的时间(非可提现时间)
    • └ pay_time
    • String
    • 2022-07-05 20:12:03
    • 订单支付时间
    • └ order_status_value
    • Number
    • 20
    • 订单状态枚举值,建议使用该字段判断订单状态。(20:支付成功、30:交易成功、40:订单关闭)
    • └ promote_plan_entity_type
    • Number
    • 0
    • 0:优惠劵,1:标准酒店,2:酒店tate,3:火车票,4:宝贝,5:机票,6:国际机票,7:国内租车,8:汽车票
    • └ out_user_id
    • String
    • abc
    • 任意形式的字符串
    • └ media_id
    • String
    • 0
    • 数字
    • └ position_id
    • String
    • 0
    • 数字

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaFliggyPromoteOrdersListRequest req = new AlibabaFliggyPromoteOrdersListRequest();
    req.setPageNo(0L);
    req.setBeforeModifyTime(StringUtils.parseDateTime("2022-07-05 20:14:00"));
    req.setAfterModifyTime(StringUtils.parseDateTime("2022-07-05 20:14:00"));
    AlibabaFliggyPromoteOrdersListResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_fliggy_promote_orders_list_response>
        <model>
            <list>
                <order>
                    <commission_money>26.17</commission_money>
                    <commission_status>提现成功</commission_status>
                    <cover_url>https://xxx.alicdn.com/xxx/xxx</cover_url>
                    <item_name>杭州西溪雷迪森大酒店豪华大床房</item_name>
                    <modify_time>2022-07-05 20:57:00</modify_time>
                    <order_id>2739917052767361744</order_id>
                    <order_money>832.12</order_money>
                    <order_status>订单关闭</order_status>
                    <order_time>2022-07-05 20:14:00</order_time>
                    <recover>false</recover>
                    <fpsid>xx_xxx_xx</fpsid>
                    <settle_time>2022-07-15 20:14:00</settle_time>
                    <pay_time>2022-07-05 20:12:03</pay_time>
                    <order_status_value>20</order_status_value>
                    <promote_plan_entity_type>0</promote_plan_entity_type>
                    <out_user_id>abc</out_user_id>
                    <media_id>0</media_id>
                    <position_id>0</position_id>
                </order>
            </list>
        </model>
    </alibaba_fliggy_promote_orders_list_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>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部