金额大写转换

接口标识: amountupper 价格: 0.005 元/次同步响应

接口介绍
接口文档
在线测试

接口简介

金额大写转换接口将数字金额转换为符合中国人民银行票据规范的人民币中文大写金额，并同步返回口语读法。支持 0.01 元至 999999999999.99 元，第三位小数起四舍五入到分；自动处理中间零位补写、连续零合并、整节为零桥接，以及无角分以「整」结尾、有角无分以「角整」结尾、有分不带「整」等规则。适用于财务报销、合同票据、银行凭证填写与金额语音播报等场景，单次调用毫秒级返回。

详细介绍

![金额大写转换接口封面](https://fujian.phpwc.com/pyapi/uploads/site/20261110/apiops_amountupper__1794261702_78712789414e.png)

财务报销、合同开票、银行结算单里，金额既要写阿拉伯数字又要写中文大写，手写易错、程序拼接更易错。金额大写转换接口把数字金额一次转成符合票据规范的中文大写与口语读法。

## 接口概述
面向财务、报销、合同与票据类业务场景，输入一个数字金额，接口按中国人民银行《支付结算办法》的中文大写金额规范自动完成位权、节权、零位补写与「整/角整」结尾判断，输出标准中文大写金额与口语读法两种结果，可直接回填到单据模板、打印件与对账系统中，无需自行维护转换规则。

## 核心能力
1. **规范转换**：数字用壹贰叁肆伍陆柒捌玖，位权拾佰仟、节权万亿，完全遵循票据中文大写规范。
2. **零位智能**：金额中间的 0 按位补「零」、连续 0 只写一个、整节为 0 自动桥接补零。
3. **结尾判定**：无角分以「整」结尾、有角无分以「角整」结尾、有分不带「整」。
4. **双读法输出**：同时返回票据大写与口语读法（如「一千零五块零二分」），一套调用两种用途。
5. **精度可控**：支持 0.01 元至 999999999999.99 元，第三位小数起四舍五入到分。

## 产品优势
1. **接入简单**：单次 POST 传一个金额即得结果，无文件、无回调、无轮询。
2. **响应迅速**：纯本地算法计算，毫秒级返回，不依赖任何上游服务。
3. **准确规范**：转换规则与银行票据口径一致，避免人工拼接造成的「零」「整」错漏。
4. **稳定可靠**：无外部依赖即无上游抖动风险，服务可用性只取决于平台本身。
5. **降本增效**：省去财务系统自研转换模块的开发与回归测试成本。
6. **生态开放**：与平台其余查询类接口共用同一套签名与响应结构，接入一次处处复用。

## 效果展示
一句话理解：它就像一位熟记票据规范的老会计，你报出数字金额，他立刻写出规范的大写金额并顺口念给你听。

以一次真实调用为例，你要传的参数：

| 参数 | 本次示例值 | 说明 |
|------|-----------|------|
| amount | 1005.02 | 要转换的数字金额，单位元，支持 0.01~999999999999.99，第三位小数起四舍五入 |
| currency | CNY | 币种代码，首期仅支持人民币 CNY，可省略 |

你会拿到的结果：

| 返回内容 | 本次示例值 | 对应字段 |
|---------|-----------|---------|
| 票据中文大写金额 | 壹仟零伍元零贰分 | `amount_upper`，可直接写入报销单、合同与发票 |
| 口语读法 | 一千零五块零二分 | `amount_readable`，适合语音播报与人工核对 |

API请求示例：

```text
POST /api/amountupper
amount=1005.02&currency=CNY
```

API响应示例：

```json
{
  "code": 0,
  "desc": "成功",
  "data": {
    "amount_upper": "壹仟零伍元零贰分",
    "amount_readable": "一千零五块零二分"
  },
  "request_id": "amt-demo-1005020001"
}
```

中间的两个 0 只补一个「零」、有分不带「整」，这两处正是人工转换最容易出错的地方，接口已按规范自动处理。

## 应用场景
1. **财务报销**：报销单与付款审批流自动补写大写金额，减少退单。
2. **合同票据**：合同金额栏、收据与结算单生成规范大写，规避涂改争议。
3. **银行对接**：支票、汇款申请等凭证填写前的大写校验与生成。
4. **语音播报**：收银与对账场景用口语读法做金额语音提示。
5. **教学工具**：财会培训系统演示数字与大写的对照关系。

## 应用案例
某商贸公司的出纳每天要把手工录入的采购金额誊写成大写填入付款单，忙时经常漏写「零」或多写「整」被银行退单；接入接口后付款单模板直接引用返回的大写字段，退单基本消失。

一家报销 SaaS 厂商的产品经理希望审批通过后自动给出金额读法用于语音提醒，但自研转换规则要覆盖零位与结尾判断，测试用例繁多；接入接口后一次调用同时拿到大写与口语读法，两周内上线该功能。

一位自由职业设计师给客户开收据时需要手写大写金额，常因「角整」写法不确定而反复查表；现在把金额发给自己的记账小程序，小程序调用接口回填大写，出票一次通过。

常见问题

Q：支持哪些币种？

A：首期仅支持人民币（currency=CNY），传其它币种代码会返回参数错误；保留 currency 参数是为后续币种扩展预留。

Q：小数位数超过两位怎么处理？

A：从第三位小数起按四舍五入保留到分，例如 1005.025 会按 1005.03 转换后再输出大写。

Q：金额范围有限制吗？

A：支持 0.01 元至 999999999999.99 元，超出范围返回参数错误；0 元不在支持范围内。

Q：amount_upper 和 amount_readable 有什么区别？

A：amount_upper 是票据规范的中文大写（如壹仟零伍元零贰分），用于单据、合同与发票；amount_readable 是口语读法（如一千零五块零二分），用于语音播报与人工核对。

金额大写中文大写财务工具票据规范数字转换口语读法

接口地址： https://www.phpwc.cn/api/amountupper

请求方式： POST

业务请求参数

参数名	类型	必填	默认值	说明
`amount`	float	必填	-	金额数字，范围 0.01 ~ 999999999999.99，最多两位小数（第三位起四舍五入）
`currency`	string	选填	`CNY`	币种，首期仅支持 CNY（人民币），字段为后续多币种预留

查看签名算法查看调用示例

响应参数

字段名	类型	说明
`code`	int	状态码，0=成功
`desc`	string	状态描述
`data`−	object	业务数据（成功时返回）
`amount_upper`	string	人民币中文大写金额，如壹仟零伍元零贰分
`amount_readable`	string	金额口语读法，如一千零五块零二分
`request_id`	string	请求追踪ID

JSON 示例：

调用成功：

{
  "code": 0,
  "desc": "success",
  "data": { ... },
  "request_id": "abc123..."
}

调用失败：

{
  "code": 999,
  "desc": "错误描述",
  "request_id": "abc123..."
}

请先登录后使用在线测试