保存操作API(弹性域)
1 接口介绍
保存操作API是通过在系统中维护接口基本信息、配置请求参数来定义接口具体的功能。
弹性域:金蝶云苍穹表单中的特殊字段,包括核算维度和辅助属性。
2 接口示例
2.1 零代码配置API
以凭证为例,维护API基本信息及请求参数,点击“添加属性”可快速添加请求参数,其中核算维度为弹性域字段。
返回参数目前不允许用户自定义,统一按平台规范返回。点击“保存”按钮,接口创建完成。
2.2 API测试
用户可以点击“参数示例”按钮,查看数据结构示例,如某科目核算维度为供应商(基础资料)、地址类型(辅助资料)和手工输入维度(其他类型),入参如下:
"assgrp": { "id": 8445228273874472960, //核算维度id,若传参,则以下所有核算维度可不填 "供应商": { //核算维度名称-基础资料类型(支持id或number) "number": "SUP000001", }, "地址类型": { //核算维度名称-辅助资料类型,(支持id或number) "number": "Address01", }, "手工输入维度": "自定义文本" //核算维度名称-其他类型 |
点击“API测试”按钮,开始调试API。按规范传入弹性域并构造请求参数,调用API批量保存凭证。
当第三方系统不支持传入核算维度的中文名称时(如使用ABAP开发语言),金蝶云苍穹OpenAPI也支持按核算维度编码赋值,此时入参格式如下:
"assgrp":{ "flextype":"number", "103":{ "number":"00" } } |
保存操作API同时支持维护默认值(两种格式),当弹性域不传值或传空值时,自动按默认值保存凭证。
3 注意事项
核算维度若同时传入了基础资料id、number和name时,保存优先级是id > number > name。
若弹性域需要按编码保存,assgrp参数中需传入 "flextype":"number"。
4 更多资讯
关于OpenAPI的更多资讯,请随时关注新特性公告。
保存操作API(弹性域)
本文2024-09-23 00:26:30发表“云苍穹知识”栏目。
本文链接:https://wenku.my7c.com/article/kingdee-cangqiong-139481.html