文档中心 > API类目 > 天猫服务平台

alibaba.service.settlement.query (服务平台结算单明细查询服务)

给服务商提供结算单明细查询功能

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
gmt_create_start Date 可选 2019-03-26 17:15:28 账单查询开始时间。格式示例 2019-03-26 17:15:28
gmt_create_end Date 可选 2019-03-26 19:15:28 账单查询结束时间,时间区间限制未15分钟。 格式示例 2019-03-26 17:15:28
current_page Number 可选 1 当前页面,开始值为1
page_size Number 可选 20 页面展示条数大小
workcard_id Number 可选 22222 工单ID
parent_trade_order_id Number 可选 11111111111111111 交易主订单号码
service_order_id Number 可选 2222222222 服务单号
master_trade_order_id Number 可选 111111111111111122 交易实物订单号
service_trade_order_id Number 可选 111111111111111123 交易服务订单号
gmt_modified_end Date 可选 2019-03-26 17:15:28 账单修改开始时间。
gmt_modified_start Date 可选 2019-03-26 19:15:28 账单修改结束时间,时间区间限制未15分钟。

响应参数

名称 类型 示例值 描述
settlement_detail_query_result FulfilplatformResult 结算明细查询结果
  • └ msg_info
  • String
  • 错误描述
  • └ msg_code
  • String
  • 错误码
  • └ success
  • Boolean
  • true
  • true:成功;false:失败
  • result_data
  • PagedResult
  • 每页数据信息
  • └ total_count
  • Number
  • 总条数
  • └ page_size
  • Number
  • 每页条数
  • data_list
  • Datalist []
  • 结算明细list
  • └ workcard_id
  • Number
  • 33333
  • 工单ID
  • └ workcard_sequence
  • Number
  • 22
  • 工单多次作业时的批次号
  • └ transfer_amount
  • Number
  • 30000
  • 转帐金额,单位分
  • └ in_user_alipay_account_id
  • String
  • 20889338388333332
  • 入款方支付宝账号
  • └ service_trade_order_id
  • Number
  • 3333333333
  • 交易服务子订单ID
  • └ currency
  • String
  • CNY
  • 货币类型 人民币(CNY)
  • └ id
  • String
  • 333
  • 账单ID
  • └ out_user_nick
  • String
  • 出款方nick
  • 出款方nick
  • └ action
  • String
  • serviceOrder-cancel
  • 触发本次打款的动作类型。serviceOrder-tradeSuccess: 商家扣款到中间账户;serviceOrder-cancel: 退款;huijin-commision: 门店抽佣;huijin-store-transfer: 转账给门店
  • └ out_user_alipay_account_id
  • String
  • 208893383883838
  • 出款方支付宝账号
  • └ in_user_nick
  • String
  • 入款方nick
  • 入款方nick
  • └ master_trade_order_id
  • Number
  • 222221222222
  • 交易实物订单号
  • └ seller_nick
  • String
  • 测试卖家nick
  • 卖家nick
  • └ out_user_role
  • String
  • PLATFORM
  • 出款方用户角色 BUYER:买家 SELLER:卖家, STORE:门店, TP:服务商, PLATFORM:平台
  • └ status
  • String
  • FINISH
  • 状态;销帐:FINISH ;未销账:ONGOING
  • └ service_store_code
  • String
  • 测试门店code
  • 门店Code
  • └ alipay_order_id
  • String
  • 2098844444444
  • 支付宝交易订单号
  • └ parent_trade_order_id
  • Number
  • 334444444
  • 交易主订单号
  • └ pay_time
  • String
  • 2020-08-11
  • 支付时间
  • └ in_user_role
  • String
  • STORE
  • 入款方用户角色 BUYER:买家 SELLER:卖家, STORE:门店, TP:服务商, PLATFORM:平台
  • └ create_time
  • String
  • 2020-08-11 11:11:12
  • 创建时间
  • └ service_order_id
  • Number
  • 22222222
  • 服务单号
  • └ service_store_name
  • String
  • 测试门店名称
  • 门店名称
  • └ attributes
  • String
  • 扩展信息;json格式
  • └ service_store_id
  • Number
  • 111111111
  • 门店Id
  • └ comment
  • String
  • 佣金
  • 打款备注

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaServiceSettlementQueryRequest req = new AlibabaServiceSettlementQueryRequest();
req.setGmtCreateStart(StringUtils.parseDateTime("2019-03-26 17:15:28"));
req.setGmtCreateEnd(StringUtils.parseDateTime("2019-03-26 19:15:28"));
req.setCurrentPage(1L);
req.setPageSize(20L);
req.setWorkcardId(22222L);
req.setParentTradeOrderId(11111111111111111L);
req.setServiceOrderId(2222222222L);
req.setMasterTradeOrderId(111111111111111122L);
req.setServiceTradeOrderId(111111111111111123L);
req.setGmtModifiedEnd(StringUtils.parseDateTime("2019-03-26 17:15:28"));
req.setGmtModifiedStart(StringUtils.parseDateTime("2019-03-26 19:15:28"));
AlibabaServiceSettlementQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_service_settlement_query_response>
    <settlement_detail_query_result>
        <msg_info></msg_info>
        <msg_code></msg_code>
        <success>true</success>
        <result_data>
            <total_count></total_count>
            <page_size></page_size>
            <data_list>
                <datalist>
                    <workcard_id>33333</workcard_id>
                    <workcard_sequence>22</workcard_sequence>
                    <transfer_amount>30000</transfer_amount>
                    <in_user_alipay_account_id>20889338388333332</in_user_alipay_account_id>
                    <service_trade_order_id>3333333333</service_trade_order_id>
                    <currency>CNY</currency>
                    <id>333</id>
                    <out_user_nick>出款方nick</out_user_nick>
                    <action>serviceOrder-cancel</action>
                    <out_user_alipay_account_id>208893383883838</out_user_alipay_account_id>
                    <in_user_nick>入款方nick</in_user_nick>
                    <master_trade_order_id>222221222222</master_trade_order_id>
                    <seller_nick>测试卖家nick</seller_nick>
                    <out_user_role>PLATFORM</out_user_role>
                    <status>FINISH</status>
                    <service_store_code>测试门店code</service_store_code>
                    <alipay_order_id>2098844444444</alipay_order_id>
                    <parent_trade_order_id>334444444</parent_trade_order_id>
                    <pay_time>2020-08-11</pay_time>
                    <in_user_role>STORE</in_user_role>
                    <create_time>2020-08-11 11:11:12</create_time>
                    <service_order_id>22222222</service_order_id>
                    <service_store_name>测试门店名称</service_store_name>
                    <attributes></attributes>
                    <service_store_id>111111111</service_store_id>
                    <comment>佣金</comment>
                </datalist>
            </data_list>
        </result_data>
    </settlement_detail_query_result>
</alibaba_service_settlement_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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部