请求开具发票接口只是提交开票申请,开票结果不是实时返回,而是税务局侧开票完成后,再异步通知返回,通步通知的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