SAP ERP 公有云使用指南 ‣ 如何在会计凭证 API 中添加自定义字段?
分享到:
2024-12-17

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

相关新闻
与相关的新闻有:
暂时还没有与之相关的新闻