【升级】账单相关API【应付金额】字段调整的公告
Dec 09, 2025
阿里云国际站控制台影响时间
2026-01-06 00:00:00 (UTC+08)
为提升账单数据的准确性与一致性,提供更透明的原始数据,便于客户核对账单明细。阿里云将于2026年1月6日对部分账单查询API的应付金额字段返回值逻辑进行调整。此次调整涉及API返回的"应付金额"字段,具体说明如下:
变更内容
调整前逻辑
- 返回值:支付币种的税前应付金额
- 说明:金额基于客户实际支付所用币种(如USD、HKD等)。
调整后逻辑
- 返回值:定价币种的税前应付金额
- 说明:金额基于阿里云定价所使用的币种(USD)
变更影响
影响范围:仅适用于2026-01-06 00:00之后开始调用相关API。
影响的API清单:
以下API的PretaxAmount(应付金额)字段将受到影响:
- 查询分账明细:QuerySplitItemBill、DescribeSplitItemBill、
- 实例账单查询服务:QueryInstanceBill、DescribeInstanceBill
- 账号账单查询服务:QueryAccountBill
示例场景
假设账单明细如下:定价币种应付金额为 100.25 USD,以 HKD 支付 779.95 HKD(汇率:1 USD = 7.78 HKD)
API的应付金额变化:
- 调整前返回值(支付币种税前):"PretaxAmount": 779.95
- 调整后返回值(定价币种税前):"PretaxAmount": : 100.25
特别说明:本次调整后,阿里云还将持续提升应付金额的精度,对已经进行账单精度及字段调整 灰度的客户精度从2位小数 调整成 最大支持10位小数。
重要提示。
- 检查系统逻辑:若您的系统使用上述API且依赖PretaxAmount字段的支付币种的应付金额,请于2026年1月6日前更新逻辑,手动应用汇率转换或调整报表规则。
- 联系支持:如有任何疑问,请通过工单提交问题。
如对调整有疑问,可通过工单咨询。感谢您对阿里云的信任与支持!