接口说明
调用该接口,通过收据流水号或订单号查询收据开具结果。
API 方法名:nuonuo.OpeMplatform.queryInfos 版本:V2.0
请求地址
| 环境 | 请求地址 |
|---|
| 正式环境 | https://sdk.nuonuo.com/open/v1/services |
| 沙箱环境 | https://sandbox.nuonuocs.cn/open/v1/services |
公共请求参数(消息头)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| Content-type | String | 否 | - | MIME类型【消息头】 | - |
公共请求参数(消息体)
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| senid | String | 否 | - | 唯一标识,由企业自己生成32位随机码【消息体】 | - |
私有请求参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| electronicNos | Array | 是 | 50 | 收据流水号列表(流水号与订单号任一必填,都填以收据流水号为准) | ["70926890-00000087","20160125-21223451"] |
| orderNos | Array | 是 | 50 | 订单号列表(流水号与订单号任一必填,都填以收据流水号为准) | ["1234565479830334","2016012513263835571"] |
响应参数
| 参数名 | 类型 | 必填 | 长度 | 说明 | 示例 |
|---|
| code | String | 否 | - | 请求结果 | E0000 |
| describe | String | 否 | - | 描述 | 查询成功 |
| result | Array | 否 | - | 收据信息列表 | - |
| └ buyerTel | String | 否 | - | | - |
| └ issuingDate | String | 否 | - | | 2022-04-24 14:26:59 |
| └ failCause | String | 否 | - | | - |
| └ corpDisplayName | String | 否 | - | | 移动测试盘 |
| └ clerkId | String | 否 | - | | - |
| └ remark | String | 否 | - | 备注 | 备注:123 |
| └ checker | String | 否 | - | | - |
| └ projectNameDisplay | String | 否 | - | 项目名称显示 | 项目名称 |
| └ payee | String | 否 | - | | - |
| └ buyerAddress | String | 否 | - | | - |
| └ pdfUrl | String | 否 | - | 收据PDF地址 | http:nnfp-dev.axnfw.net/openplat/electronic/record/SJ/hBvmnv-gXDZp0 |
| └ buyerTaxNum | String | 否 | - | 购方税号 | 339901999999154 |
| └ invoiceLine | String | 否 | - | 发票种类 | 电子增值税普通发票 |
| └ invalidSource | Number | 否 | - | | 0 |
| └ salerAccount | String | 否 | - | 销方银行账号 | 杭州农业银行13766103980009876 |
| └ orderNo | String | 否 | - | 订单编号 | 18081620564001000232 |
| └ salerTel | String | 否 | - | 销方电话 | 0987-939736 |
| └ electronicNo | String | 否 | - | 收据流水号 | 97068528-00000208 |
| └ deptId | String | 否 | - | | - |
| └ specNameDisplay | String | 否 | - | 规格型号显示 | 规格型号 |
| └ buyerName | String | 否 | - | 购方名称 | xxxx公司 |
| └ addDate | String | 否 | - | | 2022-04-24 14:26:57 |
| └ invalidDate | String | 否 | - | | - |
| └ notifyPhone | String | 否 | - | | - |
| └ orderTotal | Number | 否 | - | 订单总价 | 1.11 |
| └ salerAddress | String | 否 | - | 销方地址 | 杭州西湖 |
| └ clerk | String | 否 | - | 开票员 | 张三 |
| └ buyerAccount | String | 否 | - | | - |
| └ productOilFlag | String | 否 | - | 成品油标志: 0:非成品油; 1:成品油; | 0 |
| └ salerTaxNum | String | 否 | - | 销方税号 | 150301199811285326 |
| └ detail | Array | 否 | - | | - |
| └ specType | String | 否 | - | 规格型号 | 0 |
| └ favouredPolicyName | String | 否 | - | 优惠政策名称(增值税特殊管理) | - |
| └ num | Number | 否 | - | 数量 | 1.107 |
| └ favouredPolicyFlag | String | 否 | - | 优惠政策标识: 0:不使用; 1:使用; | 0 |
| └ taxRate | String | 否 | - | | - |
| └ unit | String | 否 | - | 单位 | 吨 |
| └ deduction | String | 否 | - | | - |
| └ zke | String | 否 | - | 折扣 | - |
| └ price | Number | 否 | - | 单价(含税) | 1 |
| └ zeroRateFlag | String | 否 | - | 零税率标识: 空:非零税率; 1:免税; 2:不征税; 3:普通零税率; | 3 |
| └ goodsCode | String | 否 | - | 商品编码 | 1010101020000000000 |
| └ goodsName | String | 否 | - | 商品名称 | MM测试商品006 |
| └ taxIncludedAmount | Number | 否 | - | 含税金额 | 1.11 |
| └ notifyEmail | String | 否 | - | | - |
| └ status | Number | 否 | - | 0-未开具;1-开具成功;2-开具失败;3-已作废 | 1 |
请求报文示例
NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.queryInfos"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
\"orderNos\": [
\"[\\"1234565479830334\\"\",
\"\\"2016012513263835571\\"]\"
],
\"electronicNos\": [
\"[\\"70926890-00000087\\"\",
\"\\"20160125-21223451\\"]\"
]
}";
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":[{"buyerTel":null,"issuingDate":"2022-04-19 16:11:38","failCause":null,"corpDisplayName":"移动测试盘","clerkId":null,"remark":"","checker":"checker","projectNameDisplay":"项目名称","payee":"payee","buyerAddress":null,"pdfUrl":"http:nnfp-dev.axnfw.net/openplat/electronic/record/SJ/d7oPnv-aApAew","buyerTaxNum":null,"invoiceLine":"p","invalidSource":0,"salerAccount":null,"orderNo":"966008180336828416","salerTel":null,"electronicNo":"97068528-00000184","deptId":null,"specNameDisplay":"规格型号","buyerName":"测试时间2","addDate":"2022-04-19 11:02:12","invalidDate":null,"notifyPhone":"17625915704","orderTotal":1234522349991.11,"salerAddress":null,"clerk":"clerk","buyerAccount":null,"productOilFlag":"0","salerTaxNum":"150301199811285326","detail":[{"specType":"","favouredPolicyName":null,"num":null,"favouredPolicyFlag":null,"taxRate":0.001,"unit":"","deduction":null,"zke":null,"price":null,"zeroRateFlag":null,"goodsCode":"1010101010000000000","goodsName":"MM测试商品006","taxIncludedAmount":1234522349991.11}],"notifyEmail":"","status":1}]}
返回码说明
| 返回码 | 说明 | 处理建议 |
|---|
E9944 | 查询收据流水号和订单号不能同时为空 | 检查查询的收据流水号和收据单号 |
E9999 | 一次性最多查询50条数据 | 检查查询的收据流水号和收据单号 |