查询对账单下载地址接口注意事项

简介: 接口调用示例流程建议参考:alipay.data.dataservice.bill.downloadurl.query(查询对账单下载地址) 集成流程  一、bill_download_url 下载账单地址参数解析  1、bizType参数是依据下载账单传入的账单类型bill_type来确定的,如果传入的是bill_type是trade那么地址中的 bizType=trade,如果传入的bill_type是signcustomer那么bizType=fnd   2、userId参数是下载的账单对应的用户的pid后拼接上0156(最后四个数字请忽略)。

接口调用示例流程建议参考:alipay.data.dataservice.bill.downloadurl.query(查询对账单下载地址集成流程  

一、bill_download_url 下载账单地址参数解析  

1bizType参数是依据下载账单传入的账单类型bill_type来确定的,

如果传入的是bill_typetrade那么地址中的 bizType=trade

如果传入的bill_typesigncustomer那么bizType=fnd   

2userId参数是下载的账单对应的用户的pid后拼接上0156最后四个数字请忽略)。 

 如示例中的userId=20885016245603350156对应的商户pid=2088501624560335   

3fileType为下载账单格式。fileType=csv.zip表示账单是csv格式的压缩文件   

4bizDates为传入的下载的账单的日期,比如下载201801月的账单bizDates=201801   

5downloadFileName为账单下载地址下载的文件的名称   

6timestamp是账单下载地址的获取时间,token可以用来标记账单下载地址,每一次生成账单下载地址生成的时候这两个参数都不同   

7、如果是使用第三方应用授权调用userIddownloadFileName中的pid参数是授权商户app_auth_token对应的pid也就是账单对应的客户的pid,不是调用接口的商户的pid  

8、账单的下载格式是csv格式的表格,该表格的文字编码是ANSI编码(不同的国家和地区制定了不同的标准,由此产生了 GB2312GBKBig5Shift_JIS 等各自的编码标准。这些使用 1  4 个字节来代表一个字符的各种汉字延伸编码方式,称为 ANSI 编码。在简体中文Windows操作系统中,ANSI 编码代表 GBK 编码;在日文Windows操作系统中,ANSI 编码代表 Shift_JIS 编码。 不同 ANSI 编码之间互不兼容,当信息在国际间交流时,无法将属于两种语言的文字,存储在同一段 ANSI 编码的文本中。)

二 、常见接口报错

1、下载数据乱码

保存账单的文件路径结尾需改成.zip 

示例代码参考:下载账单文件代码示例 

2、下载超时,请重新下载

账单下载地址必须在30秒内使用,超出时间后会报错:"下载超时,请重新下载",如图:  



  

 注:出现这个错误需要调用接口重新获取账单下载地址,这里两次获取的账单下载地址timestamptoken参数就是不同的。 

三、调用接口注意事项  

1、账单类型bill_type参数有两种tradesigncustomer

trade指商户基于支付宝交易收单的业务账单,即调用支付宝交易接口产生的交易信息,不包含非接口交易的账单信息。

signcustomer是指基于商户支付宝余额收入及支出等资金变动的帐务账单,即所有支付宝余额产生的变动的交易信息,包含调用接口产生的交易账单以及非接口交易的账单信息

2、账单下载日期支持下载日账单,月账单,不支持年度账单

日账单:日账单不支持下载当日账单,只能下载前一日24点前的账单(T+1),日期格式如:2018-01-05  

注:建议在第二日10:00以后下载 

月账单:月账单不支持下载当月账单,只能下载上一月的账单信息,日期格式如:2018-01 

注:月账单一般会在次月 4 日或之前生成,建议次月4号或后面日期下载。 

3、历史账单最久可以下载30个月之前的账单,具体的下载时间以实际可下载时间为准。    

4、该接口支持沙箱测试 但是沙箱下载的账单信息为空没有实际数据,建议以正式账号下载的账单信息为准。   

 四、demo分享(仅供参考  

 alipay.data.dataservice.bill.downloadurl.query.zip   

注:在demo中配置好自己的appid以及秘钥调用即可。   

如有其它疑问,欢迎大家在帖子后面追问!

目录
相关文章
|
1月前
|
分布式计算 运维 DataWorks
DataWorks常见问题之查出所有字段失败如何解决
DataWorks是阿里云提供的一站式大数据开发与管理平台,支持数据集成、数据开发、数据治理等功能;在本汇总中,我们梳理了DataWorks产品在使用过程中经常遇到的问题及解答,以助用户在数据处理和分析工作中提高效率,降低难度。
|
1月前
|
DataWorks NoSQL 关系型数据库
DataWorks常见问题之数据下载形成接口如何解决
DataWorks是阿里云提供的一站式大数据开发与管理平台,支持数据集成、数据开发、数据治理等功能;在本汇总中,我们梳理了DataWorks产品在使用过程中经常遇到的问题及解答,以助用户在数据处理和分析工作中提高效率,降低难度。
34 2
|
1月前
|
SQL 分布式计算 DataWorks
DataWorks常见问题之运行官方提供的示例报错如何解决
DataWorks是阿里云提供的一站式大数据开发与管理平台,支持数据集成、数据开发、数据治理等功能;在本汇总中,我们梳理了DataWorks产品在使用过程中经常遇到的问题及解答,以助用户在数据处理和分析工作中提高效率,降低难度。
25 0
|
1月前
|
分布式计算 DataWorks 监控
DataWorks常见问题之打开执行后费率计算预估弹窗如何解决
DataWorks是阿里云提供的一站式大数据开发与管理平台,支持数据集成、数据开发、数据治理等功能;在本汇总中,我们梳理了DataWorks产品在使用过程中经常遇到的问题及解答,以助用户在数据处理和分析工作中提高效率,降低难度。
32 1
|
1月前
|
分布式计算 DataWorks 关系型数据库
DataWorks常见问题之脚本运行失败计算费用如何解决
DataWorks是阿里云提供的一站式大数据开发与管理平台,支持数据集成、数据开发、数据治理等功能;在本汇总中,我们梳理了DataWorks产品在使用过程中经常遇到的问题及解答,以助用户在数据处理和分析工作中提高效率,降低难度。
31 4
|
2月前
|
存储 SQL 分布式计算
MaxCompute资源问题之显示签名失败如何解决
MaxCompute资源指的是在MaxCompute项目中使用的计算资源和存储资源;本合集旨在向用户展示如何高效管理MaxCompute资源,包括资源包管理、配额调整和性能优化等方面。
27 0
|
2月前
|
监控 搜索推荐 虚拟化
VMwarepro16安装完整流程——注意事项全部详解
VMwarepro16安装完整流程——注意事项全部详解
44 0
|
4月前
|
存储 JSON API
1688订单详情接口使用指南:含代码实现获取订单信息
随着电子商务的飞速发展,越来越多的企业开始通过1688平台进行采购和销售。为了更好地管理订单,提高客户满意度,许多企业选择使用1688订单详情接口来获取订单信息。本文将详细介绍如何使用1688订单详情接口,并提供示例代码,帮助企业快速实现订单信息的获取
|
9月前
|
缓存 JSON 监控
深入了解商品详情API接口的使用方法与数据获取
通过详细介绍商品详情API接口的使用方法和步骤,帮助程序员了解如何调用API接口获取淘宝商品的详细信息。同时,提供了实际应用示例和一些注意事项和技巧,希望能够对开发者在实际开发中有所帮助。调用API接口获取商品详情数据是优化和扩展电商业务的关键步骤,希望读者能够通过本文的指导顺利使用商品详情API接口,提升应用程序的功能和性能。
|
10月前
|
XML 存储 JSON
常用的API接口对接方式和注意事项
常用的API对接方式和注意事项 随着互联网的发展,API(应用程序接口)已经成为了不可或缺的一部分。API允许不同的软件系统进行通信和数据交互,为开发者提供了一种简单、灵活和高效的方式来集成不同的软件系统