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

诺税通电子收据开具接口

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

接口说明

调用该接口,开具收据(根据配置直接开具或者入库待开具)

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

请求地址

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

公共请求参数(消息头)

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

公共请求参数(消息体)

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

私有请求参数

参数名类型必填长度说明示例
addDateString是-订单时间,格式 yyyy-MM-dd HH:mm:ss 不填时根据提交时间自动生成。-
buyerAccountString是100购方银行开户行及账号工商银行账号88888888
buyerAddressString是100购方地址西湖区
buyerNameString否100购方名称诺诺网
buyerTaxNumString是20购方税号(6-20位字母或数字)339901999999142
buyerTelString是20购方电话1509-87366
checkerString是20复核人复核人
clerkString否20开票人开票人
clerkIdString是32开票员id (诺诺系统中的id),只能为字母和数字-
corpDisplayNameString是100电子收据上企业展示名称,不填默认为企业资质中的名称测试企业
deptIdString是32部门门店id (诺诺系统中的id),只能为字母和数字-
detailArray否-商品明细信息-
   └ favouredPolicyFlagString是1优惠政策标识: 0:不使用; 1:使用;0
   └ favouredPolicyNameString是50优惠政策名称(当favouredPolicyFlag为1时,此项必填)-
   └ goodsCodeString是19商品编码1090511030000000000
   └ goodsNameString否90商品名称大米
   └ numNumber是24数量1
   └ priceNumber是24单价8
   └ specTypeString是40规格型号1
   └ taxIncludedAmountNumber是16含税金额(精确到小数点后两位)8
   └ taxRateNumber是10税率(只支持0.xxx,需要生成二维码时必填)0.13
   └ unitString是20单位(成品油时,必须有且只能是升或者吨)kg
   └ zeroRateFlagString是1零税率标识: 空:非零税率; 1:免税; 2:不征税; 3:普通零税率;-
invoiceLineString是-发票种类(只能传 p:普通发票(电子)、 c:普通发票(纸质)、 b:专用发票(电子)、 s:专用发票(纸质)、 e:收购发票(电子)、 f:收购发票(纸质)、 r:普通发票(卷式)、bs:电子发票(增值税专用发票)-即数电专票(电子)、pc:电子发票(普通发票)-即数电普票(电子)、es:数电纸质发票(增值税专用发票)-即数电专票(纸质)、ec:数电纸质发票(普通发票)-即数电普票(纸质)中的一种)p
needGenerateEwmFlagNumber是11:生成开票二维码 0:不生成开票二维码(不填默认 0)0
notifyEmailString是50购方邮箱19883@qq.com
notifyPhoneString是20购方手机13892827272
orderNoString否64订单号(字母或数字,不支持中文)1234565479830335
orderTotalNumber是16订单总价(精确到小数点后两位)8
payeeString是20收款人收款人
productOilFlagString是1成品油标志(默认:0): 0:非成品油; 1:成品油;0
projectNameDisplayString是20项目名称栏目显示,不填默认为”项目名称”,只能为数字、中文、英文和-、_项目名称
remarkString是230备注信息-
salerAccountString是100销方银行开户行及帐号销方银行账号20200610
salerAddressString是80销方地址金色西溪
salerTaxNumString否20销方税号150301199811285326
salerTelString是20销方电话0571-87022169
specNameDisplayString是20规格型号栏目显示,不填默认为”规格型号”,只能为数字、中文、英文和-、_规格型号

响应参数

参数名类型必填长度说明示例
codeString否-状态编码E0000
describeString否-描述信息开具成功
resultObject否-返回数据-
   └ issuingDateString否-开具日期2022-04-24 14:26:59
   └ ordertotalNumber否-合计金额1.11
   └ electronicNoString否-收据流水号97068528-00000208
   └ pdfUrlString否-收据pdfhttp: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.sj"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
  \"buyerTel\": \"1509-87366\",
  \"corpDisplayName\": \"测试企业\",
  \"clerkId\": \"\",
  \"remark\": \"\",
  \"checker\": \"复核人\",
  \"projectNameDisplay\": \"项目名称\",
  \"payee\": \"收款人\",
  \"buyerAddress\": \"西湖区\",
  \"buyerTaxNum\": \"339901999999142\",
  \"invoiceLine\": \"p\",
  \"needGenerateEwmFlag\": 0,
  \"salerAccount\": \"销方银行账号20200610\",
  \"orderNo\": \"1234565479830335\",
  \"salerTel\": \"0571-87022169\",
  \"deptId\": \"\",
  \"specNameDisplay\": \"规格型号\",
  \"buyerName\": \"诺诺网\",
  \"addDate\": \"\",
  \"notifyPhone\": \"13892827272\",
  \"orderTotal\": 8,
  \"salerAddress\": \"金色西溪\",
  \"clerk\": \"开票人\",
  \"buyerAccount\": \"工商银行账号88888888\",
  \"productOilFlag\": \"0\",
  \"salerTaxNum\": \"150301199811285326\",
  \"detail\": [
    {
      \"specType\": \"1\",
      \"taxRate\": 0.13,
      \"unit\": \"kg\",
      \"favouredPolicyName\": \"\",
      \"price\": 8,
      \"num\": 1,
      \"zeroRateFlag\": \"\",
      \"favouredPolicyFlag\": \"0\",
      \"goodsCode\": \"1090511030000000000\",
      \"goodsName\": \"大米\",
      \"taxIncludedAmount\": 8
    }
  ],
  \"notifyEmail\": \"19883@qq.com\"
}";
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": {
        "issuingDate": "2022-04-24 14:26:59",
        "ordertotal": 1.11,
        "electronicNo": "97068528-00000208",
        "pdfUrl": "http:nnfp-dev.axnfw.net/openplat/electronic/record/SJ/hBvmnv-gXDZp0"
    }
}

保存成功响应:
{
    "code": "E0000",
    "describe": "同步成功",
    "result": {
        "issuingDate": null,
        "ordertotal": 1.11,
        "electronicNo": null,
        "pdfUrl": null
    }
}

返回码说明

返回码说明处理建议
E9999订单号已存在!/开具失败!....检查参数orderno是否正确
E9943收据信息不能为空检查收据信息
E9945收据明细信息不能为空检查收据明细
E9951是否生成离线二维码订单标志只能为0和1检查是否生成离线二维码标志
E9953开票订单号不能为空,且只能包含字母或数字,最大长度为64检查收据订单号
E9952时间格式需为yyyy-MM-dd HH:mm:ss检查时间参数格式
E9513企业资质不存在或已关闭检查企业资质
标签: 诺税通saas
已经是第一篇

申请试用

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