nst查询油类发票

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

接口说明

查询油类发票接口

API 方法名：nuonuo.OpeMplatform.queryOilInvoice　版本：V2.0

请求地址

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

公共请求参数（消息头）

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

公共请求参数（消息体）

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

私有请求参数

参数名	类型	必填	长度	说明	示例
kprqq	String	是	-	开票日期起	2021-01-01
kprqz	String	是	-	开票日期止	2022-01-16
sids	Array	是	-	数组，发票流水号集合。	-
invoiceCode	String	是	-	发票代码	3600212130
invoiceNumber	String	是	-	发票号码	01898218
elecInvoiceNumber	String	是	-	数电票号码	-
checkStatus	Number	否	-	勾选状态：0-未勾选1-勾选中 2-已勾选不传默认查询全部	2
invoiceStatus	Array	是	-	发票状态 1:正常 2:已红冲 3:已锁定 4:已失控 5:非正常 6:已使用不传，默认查询全部状态	1
utimeStart	String	否	-	更新日期起（可用于同步）	-
utimeEnd	String	否	-	更新日期止（可用于同步） PS:更新时间2者要么全传，最大间隔时间为一年；要么都不传	-
page	Number	否	-	当前页码，默认1	1
size	Number	否	-	一页条数，默认50条，最大200	50

响应参数

参数名	类型	必填	长度	说明	示例
code	String	否	-	返回码，E0000为成功	E0000
describe	String	否	-		调用成功
result	Object	否	-	返回的结果	-
└ total	Number	否	-	总条数	100
└ syncTime	String	否	-	数据最新同步时间	2020-01-01 00:00:00
└ data	Array	否	-	发票列表List	-
└ sid	String	否	-	发票流水号	0ad046a4f6634b888397570ca2ccb1a9
└ taxnum	String	否	-	税号	1111111111111111
└ salerName	String	否	-		XXX名称
└ taskNo	String	否	-	购进数据提交任务号	-
└ dealStatus	String	否	-	购进数据提交任务标志 0未处理 1已处理（不代表提交成功） 2处理失败	0
└ invoiceCode	String	否	-	发票代码	131880930142
└ invoiceNumber	String	否	-	发票号码	18907646
└ invoiceTime	String	否	-	开票时间	2020-01-01
└ invoiceLine	String	否	-	01:增值税专用发票,08:增值税电子专用发票,17:海关缴款书,18:电子发票(增值税专用发票)	01
└ invoiceStatus	String	否	-		1
└ number	String	否	-	油品数量（吨）	1.2
└ goodsCode	String	否	-	商品编码	13000135489784
└ checkDate	String	否	-	勾选日期	2020-01-01 00:00:00
└ checkStatus	String	否	-	购进数据提交状态(0-未提交 1-提交中 2-已提交)	2
└ syncStatus	String	否	-	购进数据同步状态(0-已同步)	2
└ totalAmount	String	否	-	油品金额(已勾选才存在)	15.2
└ excludeTaxAmount	String	否	-	油品不含税金额	15
└ oilTax	String	否	-	油品税额消费税税额(已勾选才存在)	0.2
└ jksbz	Number	否	-	0-发票 1-海关缴款书	0
└ respMsg	String	否	-	失败返回信息	-
└ updateTime	String	否	-	本系统更新时间（数据变动更新时间也会变更）	2020-01-01 00:00:00
└ oilType	String	否	-	油品类型	-

请求报文示例

NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.queryOilInvoice"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
  \"sids\": [],
  \"elecInvoiceNumber\": \"\",
  \"utimeEnd\": \"\",
  \"checkStatus\": 2,
  \"size\": 50,
  \"kprqq\": \"2021-01-01\",
  \"utimeStart\": \"\",
  \"invoiceNumber\": \"01898218\",
  \"page\": 1,
  \"invoiceStatus\": [
    \"1\"
  ],
  \"invoiceCode\": \"3600212130\",
  \"kprqz\": \"2022-01-16\"
}";
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`	调用成功

标签：开放平台

上一篇：nst查询抵扣统计信息

下一篇：nst进项发票池列表查询

nst查询油类发票

接口说明

请求地址

公共请求参数（消息头）

公共请求参数（消息体）

私有请求参数

响应参数

请求报文示例

返回码说明

申请试用