金蝶小微开放平台API对接常见Q&A原创
李秉宸
6人赞赏了该文章
3,076次浏览
编辑于2022年01月05日 15:30:08
摘要由AI智能服务提供本文为金蝶云系列软件（星辰、精斗云、KIS云）的API对接常见问题与解答，涵盖了小微生态API、金蝶云·星辰、精斗云及二次开发的相关问题。包括错误码解析、订阅服务问题、配置错误及权限问题的解决方案，并建议详细阅读对应产品的对接指导文档，必要时联系金蝶技术支持。
本Q&A适用于金蝶云·星辰、金蝶精斗云及金蝶KIS云的API对接
一、小微生态API共用Q&A
1.接口返回519
打印接口返回详情信息，或者通过postman重试查看报错信息
2.
{
"errcode": 4013,
"description": "Forbidden, App has not subscribe this service ,client_id=205022, sname=auth[GW]",
"description_cn": "禁止访问, 应用没有订阅服务, client_id=205022, sname=auth [网关]"
}
参考《金蝶云·星辰》-《对接指导》-《指导文档》第1点，使用的应用需要订阅相应服务
3.若仔细阅读指导文档之后依然解决问题，请在云之家-《小微生态开放平台交流群》联系金蝶技术。接口请求问题可通过postman复现，将接口生成完整请求，私发给技术
二、金蝶云·星辰API对接Q&A
1.请务必通读《金蝶云·星辰》-《对接指导》-《指导文档》，能避免绝大多数问题。
2.
{
"message": "no Route matched with those values"
}
{
"description_cn": "参数错误:不能获取租户ID，请联系系统管理员！",
"description": "参数错误:不能获取租户ID，请联系系统管理员！",
"errorcode": "apiRequestInvalidParameters"
}
参考《金蝶云·星辰》-《对接指导》-《指导文档》第3点、第4点，配置正确的header参数
3.
{
"success": false,
"message": "v7 services is null",
"errorCode": "500"
}
应用订阅了金蝶云·星辰接口的请求服务，但是实际该账户未购买金蝶云·星辰的账套服务
4.
{
"success": false,
"reachPlugin": true,
"message": "无匹配规则",
"errorCode": "fail"
}
可能是下推的接口未审核
5.用户无dbId对应的账套的使用权限
注意是否账套未初始化，需要先在网页登录初始化账套
三、金蝶精斗云（云进销存与云会计）API对接Q&A
1.请务必通读《精斗云云进销存》/《精斗云云会计》-《产品对接指导》-《指导文档》，能避免绝大多数问题。
2.
<html>
<head>
<title>502 Bad Gateway </title>
</head>
<body bgcolor="white">
<center>
<h1>502 Bad Gateway </h1>
</center>
<hr>
<center>openresty</center>
</body>
</html>
联系金蝶技术人员，将该账套拉出灰度
四、金蝶云·星辰二次开发相关对接Q&A
1.请务必通读《金蝶云·星辰二开单据WebApi开发指南》，能避免绝大多数问题。
2.
{"errcode": 4002,
"description": "Unauthorized, APP_ID is empty[GW]",
"description_cn": "认证失败, 应用ID为空[网关]"
}
新上架的接口类型配置成功能类了，一般用户级别的接口需要配置成资源类接口。
