You need to enable JavaScript to run this app. API创建付款报错 咨询Post Period字段的请求传递示例
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.04 11:36:01