开发指南

星瀚影像

{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
}

6 影像采集

最后修改时间： 1 年前