首页 > 开放平台 > 诺税通saas > 电子收据
开放平台/电子收据/诺税通电子收据作废接口

诺税通电子收据作废接口

2026-09-24 更新 阅读 版本 v1.0

接口说明

调用该接口,作废电子收据

API 方法名:nuonuo.OpeMplatform.invalidElectronic 版本:V2.0

请求地址

环境请求地址
正式环境https://sdk.nuonuo.com/open/v1/services
沙箱环境https://sandbox.nuonuocs.cn/open/v1/services

公共请求参数(消息头)

参数名类型必填长度说明示例
Content-typeString否-MIME类型【消息头】-

公共请求参数(消息体)

参数名类型必填长度说明示例
senidString否-唯一标识,由企业自己生成32位随机码【消息体】-

私有请求参数

参数名类型必填长度说明示例
ordernoString否64订单号1024975114819612672
electronicNoString否17收据流水号70926890-00000086
invalidReasonTypeString否1作废原因类型:0-转开发票 1-销货退回 2-服务终止 3-开具有误 4-其他1
invalidReasonString是100作废原因,当invalidReasonType为4时必填双方协商

响应参数

参数名类型必填长度说明示例
codeString否-状态编码E0000
describeString否-描述信息作废成功
resultObject否-数据内容-
   └ invalidDateString否-2022-04-24 14:30:23
   └ electronicNoString否-97068528-00000208
   └ pdfUrlString否-http:nnfp-dev.axnfw.net/openplat/electronic/record/SJ/hBvmnv-gXDZp0

请求报文示例

NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.invalidElectronic"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
  \"orderno\": \"1024975114819612672\",
  \"invalidReasonType\": \"1\",
  \"electronicNo\": \"70926890-00000086\",
  \"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":{
        "invalidDate":"2022-04-19 20:57:05",
        "electronicNo":"97068528-00000185",
       "pdfUrl":"http:nnfp-dev.axnfw.net/openplat/electronic/record/SJ/bJ=Mrv-b8My0w"
    }
}

返回码说明

返回码说明处理建议
E9323订单编号不能为空检查订单编号
E9947收据流水号不能为空检查收据流水号
E9946收据不存在检查收据流水号和收据单号
E9948收据流水号和收据单号并非同一收据检查收据流水号和收据单号
E9949该收据已经作废
E9950非已开具状态收据不能作废
E9999收据作废失败
标签: 诺税通saas

申请试用

请留下您的联系方式,我们将在一个工作日内与您联系