跳转到内容
返回官网

请求开具发票异步通知

请求开具发票接口只是提交开票申请,开票结果不是实时返回,而是税务局侧开票完成后,再异步通知返回,通步通知的url由调用“请求开具发票接口”时指定传入。

一、异步通知回调接收

异步通知回调接收侧的Java示例代码

@RequestMapping("/fc/nuonuo/notify")
@ResponseBody
public String fcNuoNuoNotify(HttpServletRequest req,@RequestBody String jsonData) throws IOException {
System.out.println("fcNuoNuoNotify收到数据:" + jsonData);
BillingNewNotify billingNewNotify = JSON.parseObject(jsonData, BillingNewNotify.class);
// 处理业务逻辑,根据返回的订单号更新订单状态,并写入pdf下载地址,发票号等。
// 若处理成功,则返回success字符串给蜂巢,返回其他字符串内容,蜂巢会尝试再次推送。
return "success";
}

二、异步通知回数据内容

异步通知内容jsonData里的示例字段

{
"action": "nuonuo_billing_new_notice",
"sale_tax_num": "91310117568051222X",
"order_no": "20240122150518179382",
"invoice_down_url": "https://inv.jss.com.cn/fp2/_du8ccsApfF5aFxZaYEBkckAQ2xe8yafOkSoUyQt9Po8-KM11E_Yx2g-dd4e4lP5i-2j5waUWLpqbkFgmT79TQ.pdf",
"invoice_no": "24312000000022669098",
"status": 1,
"message": ""
}

三、返回参数说明

参数接口参数类型例子说明
actionStringnuonuo_billing_new_noticenuonuo_billing_new_notice表示开票结果返回
sale_tax_numString91310117568051222X销售方的税号
order_noString开发者侧请求的订单号,蜂巢原样返回,用于开发者找到原始请求记录
invoice_down_urlStringhttps://inv.jss.com.cn/fp2/7B_nQ3OJ3-2NJfvYvIWK2y_iM4Na41Laty9izcQPzmyeu448MWu7sx-Otdv0m4azSYGjYKCnv7aZHLA6uC88-w.pdf开票成功才会有, 发票PDF下载地址
invoice_noString20882312250039010320开票成功才会有,电子发票上面的发票号
statusint1开票结果状态, 1:开票完成、2:开票失败、 3:开票成功签章失败(电票时)
messageString[9999]本次操作需登录电子发票服务平台,请先使用短信验证码登录开票失败原因, status为2,3