API创建付款报错 咨询Post Period字段的请求传递示例
API创建付款接口报错排查与Post Period字段传参指南
报错原因分层定位
- 第一类全局参数校验报错:请求体缺失
Entity必填字段,触发框架层的入参校验,返回modelState对应的错误提示 - 第二类业务落库校验报错:写入CA Transaction记录时,系统检测过账期字段值为空,触发数据库层面的字段非空校验,抛出
FinPeriodID: 'Post Period' cannot be empty错误
字段映射规则
Post Period 业务字段在API请求中的对应参数名为 FinPeriodID
传值要求:需与系统财年配置模块中维护的期次编码完全一致,禁止使用期次中文展示名、自然日期格式作为传值
合规请求示例
以下是创建付款接口的标准请求体结构,已覆盖报错涉及的所有必填参数:
{ "Entity": "对应业务主体的系统主数据标识", "PayeeID": "收款方主数据ID", "PaymentAmount": 1800.50, "PaymentDate": "2021-04-10", "FinPeriodID": "202104" }
高频传参踩坑提示
- 不得用付款日期字段
PaymentDate替代FinPeriodID传值,系统不会自动根据付款日期匹配所属过账期,必须显式传入期次编码 - 多账套部署场景下,需在请求上下文同步指定对应账套标识,避免系统在无有效2021财年配置的默认账套下执行写入操作
FinPeriodID传值需严格匹配系统存储格式,注意分隔符、大小写差异,例如系统存储格式为2021-04时,不得传递无分隔符的202104
内容的提问来源于stack exchange,提问作者Andrew
相关产品推荐
相关产品推荐

