升级公告

【升级】账单相关API【应付金额】字段调整的公告

影响时间

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(应付金额)字段将受到影响:

  1. 查询分账明细:QuerySplitItemBillDescribeSplitItemBill
  2. 实例账单查询服务:QueryInstanceBillDescribeInstanceBill
  3. 账号账单查询服务: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日前更新逻辑,手动应用汇率转换或调整报表规则。
  • 联系支持:如有任何疑问,请通过工单提交问题。

如对调整有疑问,可通过工单咨询。感谢您对阿里云的信任与支持!