接口说明
用户作废已开票成功的发票
API 方法名：nuonuo.OpeMplatform.invoiceCancellation 版本：V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数（消息头）
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数（消息体）
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识，由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| invoiceId | String | 否 | 25 | 发票流水号 | 20052622361801000032 |
| invoiceCode | String | 否 | 12 | 发票代码 | 5000201530 |
| invoiceNo | String | 否 | 8 | 发票号码 | 23501899 |
| invalidReason | String | 是 | 1 | 作废原因（全电纸票时需要传（1:销货退回;2:开票有误;3:服务中止;4:其他），默认 2） | - |
| specificReason | String | 是 | 255 | 其他作废原因详情（全电纸票且作废原因选择4-其他时需要传） | - |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| invoiceId | String | 否 | - | 发票流水号(提交成功则返回发票请求流水号) | 11121212121212 |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.invoiceCancellation"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"specificReason\": \"\",
\"invoiceId\": \"20052622361801000032\",
\"invoiceNo\": \"23501899\",
\"invoiceCode\": \"5000201530\",
\"invalidReason\": \"\"
}";
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": {
"invoiceId": "19051413444101000011"
}
}
返回码说明
| 返回码 | 说明 | 处理建议 |
|---|
E0000 | 作废提交成功 | 作废提交成功 |
EXXXX | 其它编码有相应错误信息 | 其它编码有相应错误信息 |
