taobao.fenxiao.settlement.statement.get (查询结算单详情)

查询结算单详情

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
settlement_status String 可选 WAIT_INVOICE 结算状态,不传默认查询所有结算单。可选值: CONFIRM(待确认账单)WAIT_SETTLEMENT(待结算)WAIT_INVOICE(待供应商开票)WAIT_WRITE_OFF(待核销发票)WAIT_PAY(发票核销成功待付款)SETTLEMENT_SUCCESS(结算成功)SETTLEMENT_FAIL(结算异常)
identity Number 必须 1 用户身份:1-供货方;2-采购方
page_size Number 可选 10
  • 默认值:10
  • 每页条数。(每页条数不超过50条)
    current_page Number 可选 1
  • 默认值:1
  • 页码。(大于0的整数。默认为1)
    settlement_no_list String 可选 S202411250012 待查询的结算单号列表
    create_date_start Date 可选 2025-01-01 00:00:00 创建日期开始时间(精确到天即可)
    create_date_end Date 可选 2025-01-04 00:00:00 创建日期结束时间(精确到天即可)

    响应参数

    名称 类型 示例值 描述
    data TopSettlementOrderDTO [] 结算单及对应的商品清单信息
    • └ settlement_no
    • String
    • S202411250012
    • 结算单号
    • └ supplier_id
    • Number
    • 2218210667239
    • 供货商淘宝id
    • └ supplier_name
    • String
    • 测试淘直供销全链路供应商
    • 供货商商家名称
    • └ supplier_company_name
    • String
    • 浙江四十五度营养保健有限公司
    • 供货商公司名称
    • └ supplier_credit_code
    • String
    • NOVEL1688
    • 供货商企业营业执照号
    • └ distributor_id
    • Number
    • 2207946040569
    • 纳统淘宝id
    • └ distributor_company_name
    • String
    • 杭州洋橙电子商务有限公司
    • 纳统公司名称(开票抬头)
    • └ didstributor_credit_code
    • String
    • NOVEL1688
    • 纳统纳税人识别号
    • └ expense_num
    • Number
    • 15
    • 费用流水数
    • └ currency
    • String
    • CNY
    • 币种
    • └ settlement_amount
    • Number
    • 10000
    • 结算含税金额(分)
    • └ invoice_amount
    • Number
    • 10000
    • 应开票含税金额(分)
    • └ paid_amount
    • Number
    • 10000
    • 已付款金额(分)
    • └ settlement_status
    • String
    • WAIT_INVOICE
    • 结算状态,CONFIRM(待确认账单)WAIT_SETTLEMENT(待结算)WAIT_INVOICE(待供应商开票)WAIT_WRITE_OFF(待核销发票)WAIT_PAY(发票核销成功待付款)SETTLEMENT_SUCCESS(结算成功)SETTLEMENT_FAIL(结算异常)
    • └ invoice_bill_no
    • String
    • KP0500184560
    • 开票单号
    • detail_list
    • TopSettlementOrderDetailDTO []
    • 商品清单列表
    • └ item_id
    • Number
    • 852561812265
    • 商品id
    • └ sku_id
    • Number
    • 5818019923469
    • skuid
    • └ item_title
    • String
    • 测试【双11立即抢购】blankme半分一透亮小源泉请不要拍
    • 商品名称
    • └ item_price
    • Number
    • 10000
    • 商品单价(分)
    • └ buy_quantity
    • Number
    • 1
    • 购买数量
    • └ write_time
    • Date
    • 2025-02-19 07:00:00
    • 出帐日期
    total_count Number 9999 查询到的结算单总记录数

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    FenxiaoSettlementStatementGetRequest req = new FenxiaoSettlementStatementGetRequest();
    req.setSettlementStatus("WAIT_INVOICE");
    req.setIdentity(1L);
    req.setPageSize(10L);
    req.setCurrentPage(1L);
    req.setSettlementNoList("S202411250012");
    req.setCreateDateStart(StringUtils.parseDateTime("2025-01-01 00:00:00"));
    req.setCreateDateEnd(StringUtils.parseDateTime("2025-01-04 00:00:00"));
    FenxiaoSettlementStatementGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <fenxiao_settlement_statement_get_response>
        <data>
            <top_settlement_order_d_t_o>
                <settlement_no>S202411250012</settlement_no>
                <supplier_id>2218210667239</supplier_id>
                <supplier_name>测试淘直供销全链路供应商</supplier_name>
                <supplier_company_name>浙江四十五度营养保健有限公司</supplier_company_name>
                <supplier_credit_code>NOVEL1688</supplier_credit_code>
                <distributor_id>2207946040569</distributor_id>
                <distributor_company_name>杭州洋橙电子商务有限公司</distributor_company_name>
                <didstributor_credit_code>NOVEL1688</didstributor_credit_code>
                <expense_num>15</expense_num>
                <currency>CNY</currency>
                <settlement_amount>10000</settlement_amount>
                <invoice_amount>10000</invoice_amount>
                <paid_amount>10000</paid_amount>
                <settlement_status>WAIT_INVOICE</settlement_status>
                <invoice_bill_no>KP0500184560</invoice_bill_no>
                <detail_list>
                    <top_settlement_order_detail_d_t_o>
                        <item_id>852561812265</item_id>
                        <sku_id>5818019923469</sku_id>
                        <item_title>测试【双11立即抢购】blankme半分一透亮小源泉请不要拍</item_title>
                        <item_price>10000</item_price>
                        <buy_quantity>1</buy_quantity>
                    </top_settlement_order_detail_d_t_o>
                </detail_list>
                <write_time>2025-02-19 07:00:00</write_time>
            </top_settlement_order_d_t_o>
        </data>
        <total_count>9999</total_count>
    </fenxiao_settlement_statement_get_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

    返回
    顶部