首页 > 开放平台 > 诺税通saas > 进项管理
开放平台/进项管理/nst发票签收

nst发票签收

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

接口说明

具有诺税通saas企业资质,才可以调用此接口。调用该接口,签收发票、取消签收发票、编辑签收发票。签收:只能针对未签收发票2、取消签收:只能针对已经签收发票3、编辑:只能针对已签收发票(发票代码+号码不可编辑),编辑的时候值为覆盖关系,用编辑新传入的值进行覆盖。

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

请求地址

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

公共请求参数(消息头)

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

公共请求参数(消息体)

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

私有请求参数

参数名类型必填长度说明示例
taxNumString否-100000000001000
signMethodNumber否-签收方式1:签收、2:取消签收、3:编辑1
taxCalculationTypeNumber是-计税方式1:全额抵扣、2:不可抵扣、3:计算抵扣、4:加计抵扣1
signVoucherNoString是-记账凭证号:30个字或60个字符,凭证日期不为空时,凭证号也不能为空。第2020xxx
voucherCreateTimeString否-凭证日期2021-01-01
generalTypeNumber是-计算抵扣种类 1.农产品 2.税控类 3.运输服务 99.其他1
userCodeString是-签收人用户编码154
departmentCodeString是-签收部门编码CEE147
customField1String是50自定义字段1-
customField2String是50自定义字段2-
customField3String是50自定义字段3-
customField4String是50自定义字段4-
customField5String是50自定义字段5-
customField6String是50自定义字段6-
customField7String是50自定义字段7-
customField8String是50自定义字段8-
customField9String是50自定义字段9-
customField10String是50自定义字段10-
invoiceListArray否--
   └ invoiceCodeString是-发票号码长度为8位时,发票代码必填。发票号码长度为20位时,发票代码必须为空0000000001
   └ invoiceNumberString否-发票号码长度只支持8或2000000008

响应参数

参数名类型必填长度说明示例
codeString否-操作成功E0000
messageString否-返回码描述成功
resultObject否--
   └ invoiceListArray否--
      └ invoiceCodeString否-发票代码0000000001
      └ invoiceNumberString否-发票号码00000008
      └ signResultString否-操作是否成功true:成功、false:失败true
      └ signStatusNumber否-签收状态1
      └ remarksString否-失败原因-
   └ totalNumber否-发票总条数2
   └ successNumber否-操作成功条数0

请求报文示例

NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.invoiceSign"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
  \"generalType\": 1,
  \"customField5\": \"\",
  \"customField6\": \"\",
  \"customField7\": \"\",
  \"customField8\": \"\",
  \"customField1\": \"\",
  \"customField2\": \"\",
  \"customField3\": \"\",
  \"customField10\": \"\",
  \"departmentCode\": \"CEE147\",
  \"customField4\": \"\",
  \"userCode\": \"154\",
  \"signVoucherNo\": \"第2020xxx\",
  \"invoiceList\": [
    {
      \"invoiceNumber\": \"00000008\",
      \"invoiceCode\": \"0000000001\"
    }
  ],
  \"taxCalculationType\": 1,
  \"voucherCreateTime\": \"2021-01-01\",
  \"taxNum\": \"100000000001000\",
  \"customField9\": \"\",
  \"signMethod\": 1
}";
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);

返回码说明

返回码说明处理建议
E0000操作成功
标签: 开放平台

申请试用

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