金蝶云星空与灵当CRM接口配置常见问题及解决方法

客户接口常见报错：

1．客户接口报错显示：检测到有相同名称的客户已存在？

  解决链接：https://help.51mis.com/docs/dFszpjWZ

2．客户接口报错显示：API接口需要的JSON字符串格式错误，请检查配置字段

  解决链接：https://help.51mis.com/docs/TwUYDS0X

3．客户接口报错显示：字段将截断字符串或二进制数据怎么办？

  解决方法：字段值超过数据库字段存储长度。这个主要有可能是默认的对接字段 客户名称对接erp的客户简称，如果不需要可以直接删除这个字段的对接。

4．客户接口报错显示：已审核单据不允许提交怎么办？

  解决方法：erp的单据已经被审批，我们同步默认是审批的单据不进行更新。如果需要更新已经审批的单据需要把单据在erp反审批，然后crm再次满足同步条件后，同步成功。

 

其他接口问题：

1．出库单接口报错显示：errcode:1000002001 description:请求接口返回失败:不符合条件。

  解决方法： 单据已关闭，不能下推！：销售订单已经没有待出库的数量了。 检查单据。

2．费用报销接口报错显示：errcode:1000002001 description:请求接口返回失败:参数paccttype_id不能为空。

  解决方法：检查 应付信息分录-支出类别id pay_type_id 是否有值 及crm和erp的选项是否对应。

3．收款单接口报错显示：Format specifier '%s'。

  解决方法：检查后发现crm的分录有一条空白的导致，删除后重新传递就没问题了。

4．crm->erp开局凭证报错显示：输入字符串的格式不正确。

  解决方法：字段映射对应字段的值不正确，也许是默认是0 给的值是空。

 

审批设置导致的问题：

1．收款单接口报错显示：下推生成预收款失败：eg下推生成预收款退款失败 内码（Id）为：101161的单据不符合下推启动条件。

  解决方法：传递单据调用下推接口，这时候源单可能没有审批导致无法下推。

2．ERP中单据已审核不允许传递:如需重新传,请在ERP反审批单据后,在CRM中反审批编辑的单据,一定不要ERP单据删除！

  解决方法：修改ERP中单据审批状态。

3．报错显示：不允许操作以前期间的单据，请先反结账！

  解决方法：单据的日期字段映射错误导致的。

     eg：比如crm单据日期对应erp单据日期，crm单据日期是2022-01-01 审批后同步 审批时间为2022-02-01  。erp 2022-01的业务已经结账。这时候就会报错 。

4．crm->erp报错显示：已审核单据不允许提交怎么办？

  解决链接：https://help.51mis.com/docs/qoiJeJXy

 

版本问题：调用云星空接口速度很慢，但是使用webapi调用速度很快。

  解决方法：老版本会在tmp里面生成一个唯一的文件，如果文件很多就会导致生成非常慢。 新版本已经不需要生成文件。

 

字段映射配置问题：

1．如何配置下拉框字段映射？

  解决链接：https://help.51mis.com/docs/AAfZw2Vr

2．erp->crm如何实现产品禁用状态字段对接？

  解决链接：https://help.51mis.com/docs/ku5Ru8P3

3．crm->erp如何添加自定义字段映射？

  解决链接：https://help.51mis.com/docs/wZDIjF2X

 

其他常见报错问题实例：

1．报错显示：erp->crm提示Array“[db_content] => Incorrect username or password用户名或密码不正确”。

  解决方法：关闭工作流程定制中的api接口功能。

2．报错显示：FBillNo违反字段唯一性要求：编码唯一怎么办？

  解决链接：https://help.51mis.com/docs/Tyf3UJEp

3．报错显示：字段“客户名称”所有语言必录，请填写其它语言。

  解决方法：客户开启了多语言，fname字段不能指直接赋值而需要修改为所需语言的json, key的值代表语言id 。

  查看对应接口：
           "FName": [
                {
                  "Key": 1033,
                  "Value": "'.$exch_data['fname'].'"
                  },
                {
                  "Key": 2052,
                  "Value": "'.$exch_data['fname'].'"
                  }
                  ],

4．报错显示：解析字段发生异常：请先录入销售组织(FSALEORGID)的内容（销售部门(FSALEDEPTID)）！

  解决方法 ：请先录入销售组织(FSALEORGID)的内容，检查FSALEORGID的映射关系。

5．报错显示：基础资料字段不能为空。

  解决方法：①. 检查产品在erp是否存在；②. 检查crm产品是否是金蝶传过来的；③. erp-crm重传产品。

6．报错显示：proto: (line 1:409): invalid value for string type: 1642727983036785664。

  解决方法：传值的类型错误，要传递字符串。

7．报错显示：{"success":false"error_desc":"session数据不正确，请联系系统管理员。 ""error_code":1}。

  解决方法：使用了以前老的应用id获取的token。

8．报错显示：价税合计不等于收款金额。

  解决方法：①.检查含税单价和数量 和收款计划金额是否相等；②.检查是否免费字段是否传值；③.删除分录里面不必要的值；④.检查产品是否可以销售，在erp订单新增界面是否可以选到；⑤. 检查产品在销售组织中是否存在。

  检测方式：删除收款计划的json保存单据看是否成功。成功后查看单据是否有异常主要查看数量和含税单价

9．如果含税单价为空。则删除分录中其他不必须要的字段。

10．报错显示：context id null。

  解决方法：配置的erp帐号密码错误导致。

11．报错显示：Unauthorized, errDescEn: X-Api-TimeStamp is invalid: 1703840343539[GW]认证失败, errDescCn: X-Api-TimeStamp无效: 1703840343539[网关]。

  解决方法：服务器时间不对，修复服务器时间

12．报错显示：errcode:1000302001   description:proto: syntax error (line 1:1302): unexpected token {

  解决方法：传值的参数结构检查。eg：凭证保存的时候items，下面应该为数组。

13．报错显示：https://tf.jdy.com/auth/isv-app获取app-token返回失败！ v7 getServiceList is null。

  解决方法：获取token的时候报错；客户账套更换了管理员导致；需要禁用后重新开启应用。

14．报错显示：excherrormsg|D:\lianjieerp\www\lianjieerp\include\cls_exch_jdyisv2.php:736 getAccessToken descrpiton：不存在的appKey : D1rYk8Zsjson:{"code":1030002003"msg":"不存在的appKey : D1rYk8Zs""data":null}|D:\lianjieerp\www\lianjieerp/include/cls_exch_jdyisv2.php:2 cls_exch_jdyisv2::activeAuthorization  result：{"code":1030002003,"msg":"所指定推送的授权clientId-242687-第三方实例id-270不存在","data":null} url:https://api.kingdee.com/jdyconnector/app_management/push_app_authorize?outerInstanceId=270。

  解决方法：应用过期。

15．报错显示：{"fid":0,"crm_id":111046,"erp_id":"","erp_number":"","label":"CON9511","error_msg":"errcode:1000002001   description:请求接口返回失败:Index:2,Size:2 result: {\"description\":\"请求接口返回失败:Index:2,Size:2\",\"errcode\":1000002001}","exchtime":"2024-11-27 15:37:44.027","mode":"create","modulelabel":"联系人接口"}  。

  解决方法：联系人模块传递的时候，当前客户下的其他联系人只能传递id 否则可能出现这个错误。

16．报错显示：客户联系人被清空。

  解决方法：客户编辑的时候需要把所有联系人的id都传递过去，否则清空联系人。

17．报错显示：同步联系人或客户返回 index2,size1 类似错误。

  解决方法：检查erp客户的联系人和传递的报文中的联系人是否一致, 实在处理不了可以清空erp联系人，然后把crm联系人内码清空 全部重传。

18．报错显示： {\"description\":\"请求接口返回失败:请查看日日志，traceId:1822cd32cf524194\",\"errcode\":1000002001}。

  解决方法：一般是单据id错误导致 请检查单据的id，还出现过一个客户无法同步，但是过了一段时间能同步了。

19．报错显示：新框架接口绑定erp账号显示绑定成功，测试同步提示：会话信息已丢失，请重新登录。连接erp配置的erp的帐号密码不正确,请检查。

  解决方法：重启lianjieerpweb服务后解决，可以打补丁修改云星空token的获取方法。

20．报错显示：分配型基础资料不允许修改"创建组织"!”。

  解决方法：分配型多组织账套，客户模块不能映射使用组织字段fuseorgid，需要用分配组织fpzz字段进行分配。