请求开具发票接口只是提交开票申请,开票结果不是实时返回,而是税务局侧开票完成后,再异步通知返回,通步通知的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": ""
}
返回参数说明
参数接口 | 参数类型 | 例子 | 说明 |
---|---|---|---|
action | String | nuonuo_billing_new_notice | nuonuo_billing_new_notice表示开票结果返回 |
sale_tax_num | String | 91310117568051222X | 销售方的税号 |
order_no | String | 开发者侧请求的订单号,蜂巢原样返回,用于开发者找到原始请求记录 | |
invoice_down_url | String | https://inv.jss.com.cn/fp2/7B_nQ3OJ3-2NJfvYvIWK2y_iM4Na41Laty9izcQPzmyeu448MWu7sx-Otdv0m4azSYGjYKCnv7aZHLA6uC88-w.pdf | 开票成功才会有, 发票PDF下载地址 |
invoice_no | String | 20882312250039010320 | 开票成功才会有,电子发票上面的发票号 |
status | int | 1 | 开票结果状态, 1:开票完成、2:开票失败、 3:开票成功签章失败(电票时) |
message | String | [9999]本次操作需登录电子发票服务平台,请先使用短信验证码登录 | 开票失败原因, status为2,3 |
文档更新时间: 2024-01-22 16:49 作者:admin