文档中心 > API类目 > 电子发票

alibaba.einvoice.tax.opt.billdownloadurl.query (税筹业务账单文件下载URL查询)

税筹业务账单文件下载的URL查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
bill_date String 必须 2021-10-01 指定账单的日期
company_code String 必须 CompanyCode 平台提供的公司编码
user_type String 可选 CONTRACTOR 用户类型,建议传递,供应商请传递固定值:CONTRACTOR
belonging_business_scenario String 可选 EmployerCompanyCode 供应商提供服务的的合作企业的公司编码,当user_type为CONTRACTOR时,建议提供此参数。特别是供应商使用同一主体编码面向多个企业提供服务,务必提供此参数,用于明确区分需要下载哪个合作企业的业务账单。

响应参数

名称 类型 示例值 描述
result ServiceResult alinkappserver系统返回的通用结果类
  • result
  • TaxOptimizationBillDownloadUrlResultDto
  • 系统自动生成
  • └ download_url
  • String
  • https://download.com/testfile
  • 账单文件的下载地址,请求成功后20s内有效
  • └ result_code
  • String
  • isp.system-error
  • 操作结果对象
  • └ result_msg
  • String
  • 系统错误
  • 系统自动生成
  • └ success
  • Boolean
  • false
  • success

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaEinvoiceTaxOptBilldownloadurlQueryRequest req = new AlibabaEinvoiceTaxOptBilldownloadurlQueryRequest();
req.setBillDate("2021-10-01");
req.setCompanyCode("CompanyCode");
req.setUserType("CONTRACTOR");
req.setBelongingBusinessScenario("EmployerCompanyCode");
AlibabaEinvoiceTaxOptBilldownloadurlQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
8
9
10
<alibaba_einvoice_tax_opt_billdownloadurl_query_response>
    <result>
        <result>
            <download_url>https://download.com/testfile</download_url>
        </result>
        <result_code>isp.system-error</result_code>
        <result_msg>系统错误</result_msg>
        <success>false</success>
    </result>
</alibaba_einvoice_tax_opt_billdownloadurl_query_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<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

返回
顶部