平台级报销单导入接口
业务场景
供云票等第三方平台将报销单导入每刻系统。平台传入云票企业编码，系统自动转换为对应的每刻企业编码后保存或提交报销单。
接口限制
10次/秒/企业
注意事项
- 传入
formCode时会校验每刻系统内是否已存在相同单据号。 stagingFlag=true时按暂存逻辑保存，其他必填字段可由提单人后续补充。stagingFlag=false时会保存并提交报销单，正常触发审批流、预算、凭证、智能审核及自定义校验。- 报销单参数与 OpenAPI 报销单导入接口一致，详细字段请参考报销单导入接口。
调用说明
调用前需通过平台级接口调用说明获取访问令牌，并在请求 Header 中传入 tokenId。
接口地址
/api/platform/receive/reimburse
请求类型
POST
请求参数
Body 参数
| 字段名称 | 类型 | 是否必填 | 字段说明 |
|---|---|---|---|
| entCode | String | 是 | 云票企业编码 |
| reimburseTemp | ReceivedReimburseTemp | 是 | 报销单导入请求体，字段结构见报销单导入接口 |
OptionInput 自定义档案选项传值
reimburseTemp.customObject 的 key 为字段业务编码，value 为所选自定义档案明细的业务编码（ReferenceDataDetail.bizCode）。不要传选项名称、选项组编码或每刻系统内部编码。
请求示例
{
"entCode": "YUNPIAO_ENT_CODE",
"reimburseTemp": {
"formSubTypeBizCode": "EXP_TRAVEL_001",
"formCode": "THIRD_PARTY_001",
"stagingFlag": false,
"customObject": {
"paymentCycle": "MONTHLY"
}
}
}
响应参数
| 参数名称 | 类型 | 是否必填 | 参数说明 |
|---|---|---|---|
| response_code | Integer | 是 | 响应码，0 表示成功 |
| response_message | String | 否 | 响应信息 |
| data | String | 否 | 报销单编号 |
正常响应示例
{
"response_code": 0,
"response_message": null,
"data": "RM2026042700001"
}
异常响应
| 场景 | response_code | response_message |
|---|---|---|
| 企业编码为空 | 1008 | 企业编码不存在 |
| 未找到云票企业对应的每刻企业 | 100001 | 未找到云票企业对应的每刻企业 |
| 单据小类业务编码不存在 | 1008 | 单据小类编码错误 |
| 提单阶段系统校验失败 | 1008 | 系统校验失败 |
完整响应码请参考平台级接口响应码说明。
修改记录
2026-04-28 新增接口文档
2026-08-27 DB-61517 补充选项字段传值并合入master文档