接口说明
传入合格证二维码的加密字符串 解析返回对应的开具机动车发票所需要的结构化字段信息(需要先开通 扫描合格证开票 增值服务)
1)国产车:合格证编号、车辆生产企业名称、车辆名称、厂牌型号、车架号、发动机号、限乘人数、产地
2)进口车:进口证明书号、车辆生产企业名称、车辆名称、厂牌型号、车架号、发动机号、限乘人数、产地
API 方法名:nuonuo.OpeMplatform.decodeCertificate 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| data | String | 否 | - | 合格证密文 | 10BD84ABB93B2D8BF638BF701B8193ECB7DF91661DB01547F5378F88C7A5B66FA90F7158085A42AB973471EADF42027F55AA44DB85BB06BF6436134BC6BE129BD22A0B91CFB9C63FB7B77660092FBF |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| code | String | 否 | - | 状态码 | E0000 |
| describe | String | 否 | - | 结果描述 | 调用成功 |
| result | Object | 否 | - | 返回数据 | - |
| └ vehicleManufacturer | String | 否 | - | 车辆生产企业名称 | 长城汽车股份有限公司 |
| └ vehicleName | String | 否 | - | 车辆名称 | 多用途乘用车 |
| └ labelModel | String | 否 | - | 厂牌型号 | 哈弗牌CC64123123 |
| └ frameNumber | String | 否 | - | 车架号 | LGWEF5A3232H21313 |
| └ engineNumber | String | 否 | - | 发动机号 | 1723888888 |
| └ limitedOccupancy | Number | 否 | - | 限乘人数 | 5 |
| └ origin | String | 否 | - | 产地 | 河北 |
| └ certificateNumber | String | 否 | - | 合格证编码 | WAN048173123456 |
| └ importCertificateNumber | String | 否 | - | 进口证明书号 | 123213123123 |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.decodeCertificate"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"data\": \"10BD84ABB93B2D8BF638BF701B8193ECB7DF91661DB01547F5378F88C7A5B66FA90F7158085A42AB973471EADF42027F55AA44DB85BB06BF6436134BC6BE129BD22A0B91CFB9C63FB7B77660092FBF\"
}";
String url = "https://sdk.nuonuo.com/open/v1/services"; // SDK请求地址
String senid = UUID.randomUUID().toString().replace("-", ""); // 唯一标识,32位随机码,无需修改,保持默认即可
String result = sdk.sendPostSyncRequest(url, senid, appKey, appSecret, token, taxnum, method, content);
System.out.println(result);
响应报文示例
{
"code": "E0000",
"describe": "调用成功",
"result": {
"vehicleManufacturer": "长城汽车股份有限公司",
"vehicleName": "多用途乘用车",
"labelModel": "哈弗牌CC6450UM05",
"frameNumber": "LGWEF5A58HH002014",
"engineNumber": "1723030765",
"limitedOccupancy": 5,
"origin": "河北",
"certificateNumber": "WAN048173322134"
}
}
返回码说明
| 返回码 | 说明 | 处理建议 |
|---|
E0000 | 调用成功 | |
E9054 | 加密串不能为空 | 检查参数请求体中的data是否正确传值 |
E9051 | 非诺税通企业 | 升级为诺税通企业 |
E9052 | 未开通扫描机动车合格证开票增值服务或次数已用完 | 开通该增值服务/购买次数 |
E9053 | 解密失败 | 检查参数是否正确,无误则联系管理员 |