开发指南
星瀚影像
{baseUrl}为苍穹MC中domain参数的值，其实就是打开苍穹的url地址
1 API通用约定
详见https://vip.kingdee.com/knowledge/specialDetail/226337046514476288?category=239331354741842688&id=218694224487485696&productLineId=29
2 影像调阅（获取eventCode版）
2.1 获取eventCode（影像接口/1.基础接口/1.01获取eventCode）
请求地址：{baseUrl}/kapi/app/bds/getEventCode?access_token=${access_token}
通过影像编码获取eventCode,可以使用多影像编码，用逗号隔开。
请求参数示例：
{
"scanBillNo": "KDKDC-04-20210310-00105, KDKDC-04-20210310-00106",
"resource":"REG_SDJ"
}
返回值示例：
{
"data": {
"eventCode": "dfd349aeba2a41c1bb02d741c2c5a99a0"
},
"message": "成功",
"errorCode": "0000",
"success": true
}
2.2 PC端影像调阅（影像接口/2.影像页面/2.01PC端影像调阅）
拼接url,将2.1获取的eventCode作为参数传入。
示例：调阅Url：{baseUrl}/index.html?formId=rim_view_invoice&eventCode=dfd349aeba2a41c1bb02d741c2c5a99a0
2.3 移动端影像调阅（影像接口/2.影像页面/2.02移动端影像调阅）
拼接url,将2.1获取的eventCode作为参数传入。
示例：调阅Url：{baseUrl}/mobile.html?formId=rim_invoice_list_mobile&eventCode=dfd349aeba2a41c1bb02d741c2c5a99a0
2.4 影像采集（影像接口/2.影像页面/2.03影像采集页面）
拼接url,将2.1获取的eventCode作为参数传入。
示例：调阅Url：{baseUrl}/index.html?formId=bds_scanner&eventCode=dfd349aeba2a41c1bb02d741c2c5a99a0
2.5 影像匹配结果（影像接口/2.影像页面/2.04影像匹配结果页面）
拼接url,将2.1获取的eventCode作为参数传入。
示例：调阅Url：{baseUrl}/index.html?formId=bds_match_list&eventCode=dfd349aeba2a41c1bb02d741c2c5a99a0
2.4 URL处理
将登录access_token写入浏览器缓存，保障流畅页面切换进行。
包装：String encodeUrl= URLEncoder.encode(调阅Url, "utf-8");
String requestUrl="https://${baseUrl}/accessTokenLogin.do?encode=true&access_token={access_token}&redirect={encodeUrl}"
3 影像调阅（获取URL版）
3.1 获取PC端影像调阅页面地址（影像接口/3.影像操作/3.04获取PC端影像调阅页面地址）
请求地址：{baseUrl}/kapi/app/bds/operate?access_token=${access_token}
请求参数示例：
{
"operateType":"getPCScanUrl",
"operateId":"",//一串随机码
"data":{
"scanBillNo": "KDKDC-04-20210310-00105, KDKDC-04-20210310-00106",
"resource":"REG_SDJ"
}
}
返回值示例：
{
"data": {
"url": "https://feature.kingdee.com:1026/devscm/accessTokenLogin.do?encode=true&access_token=1640678884833757184_RWnxlF74ENhHMjF0srY22IgRECYSan29XdbK7C7d3JRqad1pmSJHEGVqAiI2XLQXbxHAg5oGe8QfGcq366OzCcjfAHp2XwJFubBc&redirect=https%3A%2F%2Ffeature.kingdee.com%3A1026%2Fdevscm%2Findex.html%3FformId%3Drim_view_invoice%26eventCode%3DSSCASWEWEQW"
},
"message": "成功",
"errorCode": "0000",
"success": true
}
3.2 获取移动端影像调阅页面地址（影像接口/3.影像操作/3.05获取移动端影像调阅页面地址）
请求地址：{baseUrl}/kapi/app/bds/operate?access_token=${access_token}
请求参数示例：
{
"operateType":"getMobScanUrl",
"operateId":"",//一串随机码
"data":{
"scanBillNo": "KDKDC-04-20210310-00105, KDKDC-04-20210310-00106",
"resource":"REG_SDJ"
}
}
返回值示例：
{
"data": {
"url": "https://feature.kingdee.com:1026/devscm/accessTokenLogin.do?encode=true&access_token=1640678884833757184_RWnxlF74ENhHMjF0srY22IgRECYSan29XdbK7C7d3JRqad1pmSJHEGVqAiI2XLQXbxHAg5oGe8QfGcq366OzCcjfAHp2XwJFubBc&redirect=https%3A%2F%2Ffeature.kingdee.com%3A1026%2Fdevscm%2Fmobile.html%3FformId%3Drim_invoice_list_mobile%26eventCode%3DSSCASWEWEQW"
},
"message": "成功",
"errorCode": "0000",
"success": true
}
4 影像操作
4.1 影像退扫（影像接口/3.影像操作/3.01影像退扫）
请求地址：{baseUrl}/kapi/app/bds/operate?access_token=${access_token}
请求参数示例：
{
"operateType":"backScan",
"operateId":"",//一串随机码
"data":{
"scanBillNo": "KDKDC-04-20210310-00105",//单条
"operateUser":"刘德华",
"operateRemark":"影像退扫",
"resource":"REG_SDJ"
}
}
返回值示例：
{
"data": {},
"message": "成功",
"errorCode": "0000",
"success": true
}
4.2 影像取消退扫（影像接口/3.影像操作/3.02影像取消退扫）
请求地址：{baseUrl}/kapi/app/bds/operate?access_token=${access_token}
请求参数示例：
{
"operateType":"cancelBackScan",
"operateId":"",//一串随机码
"data":{
"scanBillNo": "KDKDC-04-20210310-00105",//单条
"operateUser":"刘德华",
"operateRemark":"取消影像退扫",
"resource":"REG_SDJ"
}
}
返回值示例：
{
"data": {},
"message": "成功",
"errorCode": "0000",
"success": true
}
4.3 影像删除（影像接口/3.影像操作/3.03影像删除）
请求地址：{baseUrl}/kapi/app/bds/operate?access_token=${access_token}
请求参数示例：
{
"operateType":"delScan",
"operateId":"",//一串随机码
"data":{
"scanBillNo": "KDKDC-04-20210310-00105",//单条
"operateUser":"刘德华",
"operateRemark":"影像删除",
"resource":"REG_SDJ"
}
}
返回值示例：
{
"data": {},
"message": "成功",
"errorCode": "0000",
"success": true
}
4.4 影像删除（影像接口/3.影像操作/3.06影像状态查询）
请求地址：{baseUrl}/kapi/app/bds/operate?access_token=${access_token}
请求参数示例：
{
"operateType":"queryBillStatus",
"operateId":"",//一串随机码
"data":{
"scanBillNo": "KDKDC-04-20210310-00105",//单条
"resource":"REG_SDJ"
}
}
返回值示例：
{
"data": {},
"message": "成功",
"errorCode": "0000",
"success": true
}
5 接收ERP单据推送接口（影像接口/1.基础接口/1.02接收ERP单据推送接口）
请求地址：{baseUrl}/kapi/app/bds/erpBillPush?access_token=${access_token}
请求参数实例：
{
"fscanBillNo": "88888",
"fbillId": "er_dailyreimbursebill_949790889272690688",
"fbillTypeCode": "FYBX",
"fbillTypeDes": "费用报销单",
"fapplyUserName": "刘德华",
"fapplyUserPhone": "18818789334",
"fapplyErpUserName": "liudehua",
"fapplyOrganizationCode": "ORG_CODE",
"fapplyOrganizationName": "发票云",
"fresource": "EAS"
}
返回值示例：
{
"data": {},
"message": "成功",
"errorCode": "0000",
"success": true
}