应收应付业务对接报销单单据小类查询接口
业务场景
供云票系统查询费控中支持应收应付业务对接的报销单单据小类,作为后续字段映射和报销单导入的单据类型来源。
返回的单据小类同时满足以下条件:
- 已启用;
- 开启“应收应付业务对接”;
- 业务场景允许对公费用;
- 业务场景包含到票全部支付。
接口限制
10次/秒/企业
调用说明
调用前需通过平台级接口调用说明获取访问令牌,并在请求 Header 中传入 tokenId。
接口地址
/api/platform/receivable-payable/form-sub-types
请求类型
GET
请求参数
Query 参数
| 字段名称 | 字段类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| entCode | String | 是 | 云票企业编码 |
请求示例
GET /api/platform/receivable-payable/form-sub-types?entCode=YUNPIAO_ENT_CODE
tokenId: ACCESS_TOKEN
响应参数
| 参数名称 | 类型 | 是否必填 | 参数说明 |
|---|---|---|---|
| response_code | Integer | 是 | 响应码,0 表示成功 |
| response_message | String | 否 | 响应信息 |
| data | List<FormSubTypeInfo> | 否 | 单据小类列表 |
FormSubTypeInfo
| 字段名称 | 字段类型 | 字段说明 |
|---|---|---|
| name | String | 单据小类名称 |
| bizCode | String | 单据小类业务编码,后续查询字段和导入报销单时使用 |
正常响应示例
{
"response_code": 0,
"response_message": null,
"data": [
{
"name": "差旅报销单",
"bizCode": "EXP_TRAVEL_001"
},
{
"name": "日常报销单",
"bizCode": "EXP_DAILY_002"
}
]
}
未查询到符合条件的单据小类时,data 返回空数组。
异常响应
| 场景 | response_code | response_message |
|---|---|---|
| 未找到云票企业对应的每刻企业 | 100001 | 未找到云票企业对应的每刻企业 |
完整响应码请参考平台级接口响应码说明。
修改记录
2026-04-27 新增接口文档
2026-08-27 DB-61517 补充当前单据小类过滤规则并合入master文档