第三方通过API对接星空系统传递凭证问题释疑（2）
PS：更多更详细内容请参考网址：API中心 (kingdee.com)或金蝶社区搜索“凭证 API”。
相关文章：第三方通过API对接星空系统传递凭证问题释疑（1） (kingdee.com)
l Json数据包中data对象字段解释及推荐值
1.NeedUpDateFields：需要更新的字段，数组类型，格式：[key1,key2,...] （非必录）注（更新字段时Model数据包中必须设置内码，若更新单据体字段还需设置分录内码，如果要新增凭证，一定不要指定内码，否则会视为更新，会自动替换掉该内码对应的凭证，造成原凭证丢失）
2.NeedReturnFields：需返回结果的字段集合，数组类型，格式：[key,entitykey.key,...]（非必录） 注（返回单据体字段格式：entitykey.key，返回单据体内码：FENTITY_FENTRYID）
3.IsDeleteEntry：是否删除已存在的分录，布尔类型，默认true（非必录）
4.SubSystemId：表单所在的子系统内码，字符串类型（非必录），可以指定为“GL”
5.IsVerifyBaseDataField：是否验证所有的基础资料有效性，布尔类，默认false（非必录），推荐值为true,尤其是项目开发阶段时一定要开启验证，否则可能的异常问题未暴露出来，会造成其它古怪的问题，很难排查原因。后期项目稳定了，出于性能考虑，可以设置为false。
6.IsEntryBatchFill：是否批量填充分录，默认true（非必录）
7.ValidateFlag：是否验证数据合法性标志，布尔类型，默认true（非必录）注（设为false时不对数据合法性进行校验），凭证保存一定不要设置为false，这样会跳过保存校验，造成数据问题。
8.NumberSearch：是否用编码搜索基础资料，布尔类型，默认true（非必录）
9.IsAutoAdjustField：是否自动调整JSON字段顺序，布尔类型，默认false（非必录）
10.InterationFlags：交互标志集合，字符串类型，分号分隔，格式："flag1;flag2;..."（非必录） 例如（允许负库存标识：STK_InvCheckResult）
11.IgnoreInterationFlag：是否允许忽略交互，布尔类型，默认true（非必录）
12.IsControlPrecision：是否控制精度，为true时对金额、单价和数量字段进行精度验证，默认false（非必录）
13.ValidateRepeatJson：校验Json数据包是否重复传入，一旦重复传入，接口调用失败，默认false（非必录）
l 系统返回失败信息：汇率类型，币别等是必填项，不能为空
原因分析：明明传递了上述字段的值，却提示未录入，原因很可能是录入的值未通过系统的校验，导致并未真正赋值成功。而未通过的校验常见的有：
1，当前API的登录用户没有相关基础资料的使用权限，可用相同用户手工录入相同内容的凭证测试是否是权限问题。
2，相关基础资料已反审核或禁用，导致不可用，可检查相关基础资料或辅助资料是否为正常状态。
3，科目为分配型且当前组织未分配此科目，如果科目赋值失败，将导致本行分录后面的字段全部赋值失败。如果遇到一行分录中多个基础资料均报“是必填项”时，很可能是科目未正常赋值引起。请检查科目编码是否存在，是否已分配给当前组织使用，是否是细明科目等。也可手工录入相同凭证内容来检验。
解决办法：在json的data包中，指定IsVerifyBaseDataField为True，请系统提前检查基础资料字段的合法性，这样，系统会直接提示出具体基础资料的问题，便于排错。注意：这个检查会影响API性能。
l 系统返回失败信息：某个核算维度为必录维度未录入或不可用
可能原因：
1，科目挂了某个必录维度，但json中没有指定值；
2，指定的维度值不可用（被禁用或反审核了，或未分配给当前组织）
3，维度编码有误，注意前后空格或特殊字符
l 系统返回失败信息：借贷不平
原因：明明传入的json借贷是平的，还提示借贷不平，原因很可能是某行分录的科目未正常赋值成功，导致整行分录数据被系统判为无效分录而自动清除，导致借贷不平。
解决办法：找出具体行的不正确科目，具体方法为：在json的data包中，指定IsVerifyBaseDataField为True，请系统提前检查基础资料字段的合法性，这样，系统会直接提示出具体基础资料的问题。也可手工录入相同凭证，遇到录入异常的科目时，系统会有明显提示。
l 非共享型基础资料发生了串组织的情况，如传入的是A组织的部门，但生成的却是B组织的同编码的部门
原因：其实是因为上面的情况未对基础资料做组织隔离引起的。面引起组织隔离失效的原因很可能是API使用了Administrator做为登录用户，由于该用户只有管理职能，没有业务能力，自然也没有指定归属组织，因此，无法对该用户判断组织属性，导致用该用户做业务时组织隔离功能失败。
解决办法：改用有业务职能的普通用户登录API传递凭证。
强调：一定不要用Administrator登录Web API进行业务操作，否则很可能造成数据问题。
l API中核算维度标识如何获得？
大家都知道核算维度的json格式像这样标识：
"FDetailID": {
"FDETAILID__FFLEX6": { "FNumber": "007" },
"FDETAILID__FFLEX7": { "FNumber": "201801001" }
}即用“FDETAILID__”+核算维度标识的方式来表示具体的维度。但很多新开发者不知道某个核算维度的标识到底是多少。通常情况下，官方预置的核算维度标识是固定不变的，用户自定义的维度维度的标识不确定，需要查询得到。
官方预置的核算维度及标识如下（注意：因数据存在人为改动的可能，以下仅供参考）：
供应商 BD_Supplier FFLEX4
部门 BD_Department FFLEX5
客户 BD_Customer FFLEX6
员工 BD_Empinfo FFLEX7
物料 BD_MATERIAL FFLEX8
费用项目 BD_Expense FFLEX9
资产类别 FA_ASSETTYPE FFLEX10
组织机构 ORG_Organizations FFLEX11
物料分组 AMB_MaterialGroup FFLEX12
客户分组 AMB_CustomerGroup FFLEX13
银行 BD_BANK FFLEX14
银行账户 CN_BANKCNT FFLEX15
其他往来单位 FIN_OTHERS FFLEX16
查询核算维度标识的方法：打开【核算维度】界面，默认不显示维度列标识，可以点【过滤】打开过滤界面的【显示隐藏列】，勾选【单据头-维度列标识】，确定。如下图所示：
赞 51
打赏推荐阅读