接口说明
根据订单号查询审核开票库中待开票数据信息 一次最多查询50个订单号
API 方法名:nuonuo.OpeMplatform.queryInvoiceAuditing 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| orderNos | Array | 否 | 50 | 订单号列表(一次最多查询50个订单号) | [ "20181212094118569653" ] |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| code | String | 否 | - | 状态码 | E0000 |
| describe | String | 否 | - | 描述 | 同步成功 |
| result | Array | 否 | - | 返回结果 | - |
| └ buyerName | String | 否 | - | 购方名称 | 诺诺网络科技有限公司5 |
| └ buyerTaxNum | String | 否 | - | 购方税号 | 339901999999198 |
| └ buyerPhone | String | 否 | - | 交付手机(开票成功会短信提醒购方) | 13888888888 |
| └ buyerAddress | String | 否 | - | 购方地址 | 浙江省杭州市西湖区文一西路888号 |
| └ buyerAccount | String | 否 | - | 购方银行账号及开户行地址 | 中国银行94646464646464 |
| └ buyerTel | String | 否 | - | 购方电话 | 0571-88888888 |
| └ orderNo | String | 否 | - | 订单号 | 20210611110626403734 |
| └ invoiceDate | String | 否 | - | 开票请求时间 | 2021-06-11 11:06:26 |
| └ clerk | String | 否 | - | 开票员 | 99922331 |
| └ salerAccount | String | 否 | - | 销方银行账号和开户行地址 | a2222211112221 |
| └ salerTel | String | 否 | - | 销方电话 | 0937-938423512221 |
| └ salerAddress | String | 否 | - | 销方地址 | 杭州文一路888号 |
| └ salerTaxNum | String | 否 | - | 销方税号 | 150301199811285326 |
| └ invoiceType | String | 否 | - | 开票类型:1,正票;2,红票 | 1 |
| └ remark | String | 否 | - | 备注信息 | 备注 |
| └ payee | String | 否 | - | 收款人 | 1a12331 |
| └ checker | String | 否 | - | 复核人 | 12312331 |
| └ pushMode | String | 否 | - | 推送方式:-1,不推送;0,邮箱;1,手机(默认);2,邮箱、手机 | 2 |
| └ email | String | 否 | - | 交付邮箱 | test@163.com |
| └ listFlag | String | 否 | - | 清单标志:0-非清单;1-清单 | 0 |
| └ listName | String | 否 | - | 清单项目名称:打印清单时对应发票票面项目名称(listFlag为1时有) | - |
| └ proxyInvoiceFlag | String | 否 | - | 代开标志:0-非代开;1-代开 | - |
| └ departmentId | String | 否 | - | 部门门店id(诺诺系统中的id) | - |
| └ clerkId | String | 否 | - | 开票员id(诺诺系统中的id) | - |
| └ invoiceLine | String | 否 | - | 发票种类(p:普通发票(电子) c:普通发票(纸质) s:专用发票 e:收购发票(电子) f:收购发票(纸质) r:普通发票(卷式)) | - |
| └ productOilFlag | String | 否 | - | 成品油标志:0-非成品油,1-成品油 | - |
| └ callBackUrl | String | 否 | - | 开票完成回调地址 | - |
| └ terminalNumber | String | 否 | - | 终端号 | - |
| └ extensionNumber | String | 否 | - | 分机号 | - |
| └ billInfoNo | String | 否 | - | 红字信息表编号 | - |
| └ machineCode | String | 否 | - | 机器编号 | - |
| └ oriInvoiceCode | String | 否 | - | 原蓝票发票代码(冲红时填写对应蓝票发票代码) | 123456789012 |
| └ oriInvoiceNum | String | 否 | - | 原蓝票发票号码(冲红时填写对应蓝票发票号码) | 12345678 |
| └ requestId | String | 否 | - | 发票请求流水号 | - |
| └ saleName | String | 否 | - | 销售方名称 | - |
| └ vehicleFlag | String | 否 | - | 机动车标识字段0:非机动车 1:机动车 | - |
| └ applySource | String | 否 | - | 订单来源平台: 0-其他(默认) 1-出租车代开 | - |
| └ hiddenBmbbbh | String | 否 | - | 签章时是否隐藏编码表版本号 1:隐藏 | - |
| └ status | String | 否 | - | 开票状态 0:不可开票,1:未开票,2:提交失败 | - |
| └ invoiceDetail | Array | 否 | - | 发票明细列表 | - |
| └ goodsName | String | 否 | - | 商品名称 | 大米 |
| └ num | String | 否 | - | 商品数量 | 10.666666666666666 |
| └ withTaxFlag | String | 否 | - | 含税标志,0:不含税,1:含税 | 1 |
| └ price | String | 否 | - | 单价 | 3 |
| └ taxRate | String | 否 | - | 税率 | 0.09 |
| └ specType | String | 否 | - | 规格型号 | - |
| └ unit | String | 否 | - | 单位 | - |
| └ goodsCode | String | 否 | - | 商品编码 | 1030102010100000000 |
| └ selfCode | String | 否 | - | 自行编码 | - |
| └ invoiceLineProperty | String | 否 | - | 发票行性质:0,正常行;1,折扣行;2,被折扣行 | 0 |
| └ favouredPolicyFlag | String | 否 | - | 优惠政策标识:0,不使用;1,使用 | 0 |
| └ favouredPolicyName | String | 否 | - | 增值税特殊管理(优惠政策名称) | - |
| └ zeroRateFlag | String | 否 | - | 零税率标识:空,非零税率;1,免税;2,不征税;3,普通零税率 | - |
| └ deduction | String | 否 | - | 扣除额 | - |
| └ tax | String | 否 | - | 税额 | 2.64 |
| └ taxIncludedAmount | String | 否 | - | 含税金额 | 32.00 |
| └ taxExcludedAmount | String | 否 | - | 不含税金额 | 29.36 |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.queryInvoiceAuditing"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"orderNos\": [
\"[ \\"20181212094118569653\\" ]\"
]
}";
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 | 同步成功 | |
E9501 | 订单号列表不能为空 | 订单号列表输入合适的参数 |
E9513 | 企业资质不存在或已关闭 | 联系诺诺运维员 |
E9562 | 未查询到审核开票待开票信息 | 检查参数是否正确 |
E9999 | 异常处理 | 联系诺诺运维员 |
E9564 | 订单号列表长度不大于50个 | 修改订单号列表长度小于50个 |