API Journal Entry Post 是一项强大的服务,可以让用户从外部系统过账日记账分录到 SAP S/4HANA Cloud 系统中。通过使用此入站服务,企业能够有效地整合不同系统间的财务数据,确保信息的一致性和及时性。此外,API 还允许根据业务需求进行扩展,满足企业的各种定制化需求。
为什么需要添加自定义字段?
在实际业务应用中,标准的日记账分录字段可能无法涵盖所有企业特定的业务需求。例如,一些公司可能需要记录特定的项目编号、部门编号、或是合同信息等。此外,添加自定义字段可以帮助企业更细致地分类和分析财务数据,从而提高财务报表的精度和业务决策的可靠性。
SAP S/4HANA Cloud 系统为以下 Journal Entry API 启用了扩展字段:
► API Journal Entry – Post (Synchronous)
► API Journal Entry – Post (Asynchronous)
同步与异步模式下的 API Journal Entry – Post,在项目(item)、编码块(coding block)和利润段层面(profitability segment)支持扩展字段。
如何创建扩展字段并在会计凭证 API 中启用它?
1.登录 customizing 系统
登录 customizing 系统中,确保用户具有权限。
Business catalog:
SAP_CORE_BC_EXT_FLD 或 SAP_CORE_BC_EXT_BLE
具体权限请点击“阅读原文”查看。
2. 选择 app “自定义字段”,点击“创建”
3.在“新字段”屏幕上,填写以下内容
● 商业环境:选择扩展字段所属的环境。
API Journal Entry – Post(同步)和 Journal Entry – Post(异步)支持在以下商业环境中使用扩展字段:
Accounting: Coding Block、
Accounting: Journal Entry Item
和 Accounting: Market Segment。
API Journal Entry – Change(异步)支持在商业环境 Accounting: Coding Block 中使用扩展字段。
● 标签:输入扩展字段的名称。
● 类型:选择扩展字段的数据类型。
● 长度:输入扩展字段的长度。
4. 点击“创建并编辑”
切换到“SOAP API”选项卡。 如果是为 Journal Entry – Post(同步)和 Journal Entry – Post(异步)API 启用的,请点击“启用”
JournalEntryBulkCreationRequest_In和 JournalEntryCreateRequestConfirmation_In
如果是为 Journal Entry – Change(异步)API 启用的,请点击“启用”
JournalEntryBulkChangeRequest_In
5. 扩展字段在 app“管理日记账分录”可用
如果您希望扩展字段在 app“管理日记账分录”中可用,请切换到“UI 和报表”选项卡,然后点击“启用”。
启用
FAC_FINANCIAL_DOCUMENT_SRV_01 以便在 app“管理日记账分录_旧版本(F0717)”中查看自定义字段;
启用 UI_JOURNALENTRY_MANAGE 以便在app “管理日记账分录_新版本(F0717A)”中查看自定义字段。
点击“保存”,然后点击“发布”。
常见问题
自定义字段已按照以上指引,在 Journal Entry - Post API 和 app“管理日记账分录”创建并启用,然而如果在已过账的凭证中没有显示自定义字段的值,那是哪一步出现问题了呢?
我们接下来将介绍如何在使用 API Journal Entry - Post 时正确地在 payload 中添加自定义字段。常见问题以及解决方案如下:
► 常见原因一
payload 首行中未使用正确的Envelope xmlns。一个简单的解决方法是从应用“通信安排(Communication Arrangement)”中直接下载 WSDL/Service Metadata,然后在 SoapUI 等工具中导入即可。
例如,正确格式应如下所示:
XML 命名空间是在应用“自定义字段”-> “SOAP API” 中确定的。
► 常见原因二
在 payload 中的自定义字段缺少自定义字段命名空间前缀。
正确的使用方法是,自定义字段前必须加上常见原因一中已定义好的前缀(本例中为yy1),例如:
► 常见原因三
自定义字段大小写错误。自定义字段是区分大小写的,请确保严格使用应用“自定义字段”中的“字段名称”定义。
例如,错误格式:
正确格式:
► 常见原因四
没有将自定义字段添加到 payload 的正确服务节点。如果填在错误的节点将导致自定义字段添加失败。业务上下文决定了数据在屏幕上的显示位置。在此情况下,有三种方法:
方法一:如果自定义字段的业务上下文是 Coding Block 类型,请将自定义字段添加到服务节点
方法二:如果自定义字段的业务上下文是 Journal Entry Item 类型,请将自定义字段添加到服务节点
方法三:如果自定义字段的业务上下文是 Market Segment,请将自定义字段添加到服务节点
参考地址:https://mp.weixin.qq.com/s?__biz=MzU2NzU0MjI0MA==&mid=2247526310&idx=1&sn=2d79cb7548786e14635345364140bdef&chksm=fdc5b7935ed8f2b2f8827535d2884a757fb14b37a2e1fb220ee535d73c36179d714263658618&mpshare=1&scene=1&srcid=1128rJLoJCKrqGBOX7qS34CJ&sharer_shareinfo