查询订单关联发票接口

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

接口说明

查询订单所开发票（包括被冲红）和合并冲销的开票单，以及它们与订单内商品的关联关系。

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

请求地址

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

公共请求参数（消息头）

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

公共请求参数（消息体）

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

私有请求参数

参数名	类型	必填	长度	说明	示例
originalOrderNo	String	否	64	订单编号	ceshijuese1111
saleTaxNum	String	否	20	销方税号	339902999999789004
needInvoiceSourceDetail	String	是	1	是否需要发票所来源的订单明细，1-是, 0-否(不填默认 0) 当为0时，将不回传orderDetailCallBackVOS	1

响应参数

参数名	类型	必填	长度	说明	示例
message	String	否	-	请求状态描述	请求成功
status	String	否	-	状态码	0000
data	Array	否	-	返回内容	-
└ sid	String	否	-	发票流水号，返回合并冲销的开票单为空	-
└ orderNo	String	否	-	开票单号	-
└ createtime	String	否	-	开票单的创建时间	-
└ invoiceType	Number	否	-	发票类型，合并冲销时为空；1：蓝票 2：红票	-
└ invoiceLine	String	否	-	发票种类，合并冲销时为空 p：普通发票（电票） c：普通发票（纸票） s：专用发票（纸票） b：专用发票（电子） e：收购发票（电票） f：收购发票（纸质） r：普通发票（卷式） bs：数电专票（电子） pc：数电普票（电子） es：数电专票（纸质） ec：数电普票（纸质）	-
└ specificFactor	String	否	-	1 成品油、35 矿产品；普通发票为空	-
└ invoiceState	Number	否	-	开票状态，合并冲销时为空 1：开票成功 2：开票失败 3:开票失败重试	-
└ exceptionMessage	String	否	-	开票异常信息，开票失败状态时返回	-
└ invoiceCode	String	否	-	发票代码，仅开票成功会返回，发票种类为bs和pc时为空	-
└ invoiceNumber	String	否	-	发票号码，仅开票成功会返回，发票种类为bs和pc时为空	-
└ allElectronicInvoiceNumber	String	否	-	数电发票号码，仅数电发票开票成功会返回	-
└ oldInvoiceCode	String	否	-	原发票代码（红字发票开票成功后若有值回传），发票种类为bs和pc时为空	-
└ oldInvoiceNumber	String	否	-	原发票号码（红字发票开票成功后若有值回传），发票种类为bs和pc时为空	-
└ oldAllElectronicInvoiceNu	String	否	-	原数电发票号码（数电发票开票成功后若有值回传）	-
└ invoiceTime	String	否	-	开票日期，仅开票成功会返回	-
└ invalidTime	String	否	-	作废日期，暂时未用到	-
└ rushRedState	String	否	-	发票冲红状态（0 未冲红，1 全部冲红，2 部分冲红)	-
└ pdfUrl	String	否	-	发票pdf地址，仅开票成功时返回	-
└ ofdUrl	String	否	-	发票ofd地址，仅开票成功时返回	-
└ imageUrl	String	否	-	发票jpg地址，仅开票成功时返回	-
└ calcExcludingTaxAmount	Number	否	-	不含税金额，开票失败时不返回，含税金额和不含税金额任一数值返回为0，即为合并冲销	-
└ calcTaxAmount	Number	否	-	税额，开票失败时不返回	-
└ caleOrderAmount	Number	否	-	含税金额，开票失败时不返回，含税金额和不含税金额任一数值返回为0，即为合并冲销	-
└ sellerTaxNo	String	否	-	销方税号	-
└ sellerName	String	否	-	销方名称，仅开票成功会返回	-
└ taxNo	String	否	-	购方税号，仅开票成功会返回	-
└ buyerName	String	否	-	购方名称，仅开票成功会返回	-
└ remark	String	否	-	发票备注	-
└ clerker	String	否	-	开票员	-
└ payee	String	否	-	收款人	-
└ checker	String	否	-	复核人	-
└ clerkId	String	否	-	所属开票员id	-
└ deptId	String	否	-	所属部门id	-
└ bField1	String	否	-	主表自定义字段1	-
└ bField2	String	否	-	主表自定义字段2	-
└ bField3	String	否	-	主表自定义字段3	-
└ orderDetailCallBackVOS	Array	否	-	发票来源的订单明细list	-
└ RowNo	String	否	-	行编号	-
└ goodsName	String	否	-	商品名称	-
└ spbm	String	否	-	商品税收分类编码	-
└ spec	String	否	-	规格型号	-
└ num	Number	否	-	本次开票所提交的数量	-
└ price	Number	否	-	单价，读取含税标志	-
└ unit	String	否	-	单位	-
└ taxAmount	Number	否	-	本次开票所提交的金额，读取含税标志	-
└ hsbz	String	否	-	含税标志 0：不含税 1：含税	-
└ tax	String	否	-	本次开票所提交的税额	-
└ zke	Number	否	-	本次开票所提交的折扣额，读取含税标志	-
└ taxRate	Number	否	-	税率	-
└ dField1	String	否	-	自定义字段1	-
└ dField2	String	否	-	自定义字段2	-
└ dField3	String	否	-	自定义字段3	-
└ dField4	String	否	-	自定义字段4	-
└ dField5	String	否	-	自定义字段5	-
└ relateRedInvoiceList	Array	否	-	蓝票所关联的红票列表，当rushRedState=1和2时，返回，不包含已作废；注：以下字段名称和上方存在相同，请注意区分不同层级	-
└ orderNo	String	否	-	红票开票单号	-
└ sid	String	否	-	红票流水号	-
└ invoiceCode	String	否	-	红票发票代码	-
└ invoiceNumber	String	否	-	红票发票号码	-
└ allElectronicInvoiceNumber	String	否	-	allElectronicInvoiceNumber，红票数电票号码	-
└ invoiceTime	String	否	-	红票开票日期	-
└ orderAmount	Number	否	-	红票含税金额	-
└ excludingTaxAmount	Number	否	-	红票不含税金额	-
└ taxAmount	Number	否	-	红票税额	-

请求报文示例

NNOpenSDK sdk = NNOpenSDK.getIntance();
String taxnum = "23***789"; // 授权企业税号
String appKey = "Hn***XL";
String appSecret = "F65***65F";
String method = "nuonuo.OpeMplatform.findOrderRelationInvoice"; // API方法名
String token = "2d484e**************pdui"; // 访问令牌
String content = "{
  \"originalOrderNo\": \"ceshijuese1111\",
  \"saleTaxNum\": \"339902999999789004\",
  \"needInvoiceSourceDetail\": \"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);

返回码说明

返回码	说明	处理建议
`0000`	请求成功

标签：开放平台

上一篇：诺税通Saas订单状态查询接口

下一篇：批量更新主表自定义字段

查询订单关联发票接口

接口说明

请求地址

公共请求参数（消息头）

公共请求参数（消息体）

私有请求参数

响应参数

请求报文示例

返回码说明

申请试用