整合发票第三方--实现自助开票相关功能

已于 2023-08-01 14:57:40 修改
阅读量1.5k 收藏 10
点赞数 2
文章标签： java redis spring
于 2023-07-31 18:26:54 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_48081887/article/details/132025914
版权

整合发票第三方–实现自助开票相关功能

一、背景介绍

码农门,你们好,今天要介绍的是一个第三方的API,主要是用于自助开票或开票系统的相关功能设计。我在项目中用到的是诺诺发票，感觉功能还是比较完善的。具体网址和第三方API文档可以参考诺诺发票官网----->>>>

二、技术准备

首先，需要成为诺诺开放平台的会员，并完成认证审核（需要税号）；这些工作做完之后，就可以创建应用，接入sdk进行开发。有一些注意的点需要留意：
1.开发者的APP证书（包含APP Key 和 APP Secret）需要保存好在这里插入图片描述
2.应用token选择
（1）如果是自己用，或者对于token没有相关安全限制的，可以选择固定token。但是相对安全性较低，但是开发测试比较方便。
（2）如果是企业服务使用，建议使用动态token，但是要做好token存储，这个token是有限制的，每个令牌是存在有效期（24小时）的，且令牌30天内的调用上限为50次。我在项目中，使用的是redis存储在缓存中。

三、相关参数配置

1.yaml配置文件

##发票接口参数---测试
invoice:
  # 接口地址（测试地址）
  baseURL: https://sandbox.nuonuocs.cn/open/v1/services
  # 上文所述需要保存的APP证书
  APPKey: 123456789
  APPSecret: 123456789
  # 销方税号（即开票方税号）
  taxnum: 123456789

2.代码注入配置

	//从缓存中获取token
	private String accessTokenKey = "invoice_accessToken";
    @Value("${invoice.baseURL}")
    private String baseURL;
    @Value("${invoice.APPKey}")
    private String aPPKey;
    @Value("${invoice.APPSecret}")
    private String aPPSecret;
    @Value("${invoice.taxnum}")
    private String taxnum;

四、获取应用token（此处选择的是动态token）

public String getToken() {
        try {
            Object object = cacheService.getDataWithKey(accessTokenKey);
            //Object object = null;如果放开这串代码，表明不走缓存，直接请求获取token
            if(object!=null){
                return object.toString();
            }else {
                String token = NNOpenSDK.getIntance().getMerchantToken(aPPKey,aPPSecret);
                JSONObject jsonObject = JSONObject.parseObject(token);
                String accessToken = jsonObject.getString("access_token");
                if (ObjectUtil.isNotEmpty(accessToken)){
                    cacheService.setDataWithParams(accessTokenKey,accessToken,24, TimeUnit.HOURS);
                    log.info("invoice_accessToken =========>");
                    return accessToken;
                }else {
                    throw new HbsxException("获取token失败");
                }
            }
        }  catch (Exception e){
            log.error("InvoiceSettingServiceImpl.getToken.error==>{}",e.getMessage());

            if(e instanceof XXXException){
                throw new XXXException(ErrorCode.SYSTEM_ERROR.getCode(),e.getMessage());
            }
            throw new XXXException(ErrorCode.SYSTEM_ERROR.getCode(),"系统异常，请稍后再试！");
        }
    }

五、自助开票功能

1.这是请求开具发票的一些相关请求参数
在这里插入图片描述
2.电子发票不存在作废，只能冲红，冲红也是一种开票，只不过票面类型为红票，所以接口与开蓝票接口一致，仅参数不同。
在这里插入图片描述
3.返回参数为发票流水号，开票结果可以用此参数作为唯一标识查询，需要保存。
在这里插入图片描述
4.开票接口返回的异常码需要捕捉：
在这里插入图片描述
5.示例代码

/**
     * 开具发票
     * @param invoiceSettingDTO
     * @param request
     */
    @Override
    @Transactional(rollbackFor = HbsxException.class)
    public Map<String,Object> createFP(InvoiceSettingDTO invoiceSettingDTO, HttpServletRequest request) {
        try {
            Map<String,Object> map = new HashMap<>();
            String token = getToken();
            NNOpenSDK sdk = NNOpenSDK.getIntance();
            String method = "nuonuo.electronInvoice.requestBillingNew";//API方法名
            InvoiceSetting detail = this.getDetail();
            String url = baseURL; //SDK请求地址
            JSONObject order = new JSONObject();
            JSONObject jsonObject = new JSONObject();
            order.put("buyerName",invoiceSettingDTO.getInvoiceTitle());
            //纳税人识别号
            if (ObjectUtil.isNotEmpty(invoiceSettingDTO.getTaxPayerId())&&invoiceSettingDTO.getTitleType().equals("2")){
                order.put("buyerTaxNum",invoiceSettingDTO.getTaxPayerId());
            }
            //电话
            if (ObjectUtil.isNotEmpty(invoiceSettingDTO.getCtel())&&invoiceSettingDTO.getTitleType().equals("2")){
                order.put("buyerTel",invoiceSettingDTO.getCtel());
            }
            //地址
            if (ObjectUtil.isNotEmpty(invoiceSettingDTO.getAddress())&&invoiceSettingDTO.getTitleType().equals("2")){
                order.put("buyerAddress",invoiceSettingDTO.getAddress());
            }
            //开户行和卡号
            if (ObjectUtil.isNotEmpty(invoiceSettingDTO.getBankName())&&ObjectUtil.isNotEmpty(invoiceSettingDTO.getBankaccountname())&&invoiceSettingDTO.getTitleType().equals("2")){
                order.put("buyerAccount",invoiceSettingDTO.getBankName()+invoiceSettingDTO.getBankaccountname());
            }
            order.put("salerTaxNum",detail.getTaxPayerId());
            order.put("salerTel",detail.getCtel());
            order.put("salerAddress",detail.getAddress());
            order.put("salerAccount",detail.getBankName()+detail.getBankaccountname());
            order.put("orderNo",invoiceSettingDTO.getOrderId());
            order.put("invoiceDate",invoiceSettingDTO.getOrderTime());
            order.put("checker",detail.getReviewedName());
            order.put("payee",detail.getPayeeName());
            order.put("clerk",detail.getDrawerName());
            order.put("pushMode","-1");
            order.put("invoiceType","1");
            JSONObject invoiceDetail = new JSONObject();
            //单价和数量
            invoiceDetail.put("price",invoiceSettingDTO.getPayedFee());
            invoiceDetail.put("num","1");
            //invoiceDetail.put("goodsName",invoiceSettingDTO.getCname());
            invoiceDetail.put("withTaxFlag","1");
            invoiceDetail.put("taxExcludedAmount",invoiceSettingDTO.getPayedFee());
            invoiceDetail.put("taxRate",detail.getActivityTaxrate());
            order.put("invoiceDetail",invoiceDetail);
            jsonObject.put("order",order);
            String content = jsonObject.toJSONString();
            String senid = UUID.randomUUID().toString().replace("-", ""); // 唯一标识，由企业自己生成32位随机码
            String json = sdk.sendPostSyncRequest(url, senid, aPPKey, aPPSecret, token, taxnum, method, content);
            JSONObject result = JSONObject.parseObject(json);
            String code = result.getString("code");
            System.out.println(json+"==========>>");
            System.out.println(json+"==========>>");
            System.out.println(json+"==========>>");
            if (!code.equals("E0000")){
                String errormsg = result.getString("describe");
                throw new XXXException(errormsg+"，开票失败，请稍后再试");
            }else {
                JSONObject result1 = result.getJSONObject("result");
                //获取发票流水号
                String invoiceSerialNum = result1.getString("invoiceSerialNum");
                invoiceSettingDTO.setInvoiceId(invoiceSerialNum);
                System.out.println(json+"========><");
                //查询发票开具状态
                invoiceSettingDTO.setInvoiceRed("1");//蓝票
                getInfoCX(invoiceSettingDTO);
                map.put("invoiceId",invoiceSerialNum);
                return map;
            }
        } catch (Exception e){
            log.error("InvoiceSettingServiceImpl.createFP.error==>{}",e.getMessage());
            if(e instanceof XXXException){
                throw new XXXException(ErrorCode.SYSTEM_ERROR.getCode(),e.getMessage());
            }
            throw new XXXException(ErrorCode.SYSTEM_ERROR.getCode(),"系统异常，请稍后再试！");
        }
    }

六、查询开票结果

1.相关请求参数
在这里插入图片描述
2.响应结果示例：

{
    "code": "E0000",
    "describe": "获取成功",
    "result": [
        {
            "serialNo": "19010211130401000006",
            "orderNo": "1001000011161",
            "status": "2",
            "statusMsg": "开票完成（最终状态）",
            "failCause": "",
            "pdfUrl": "https://invtest.jss.com.cn/group1/M00/0D/A4/wKjScVwsK6CAFzLgAABsVO-OKaE630.pdf",
            "pictureUrl": "nnfpkf.jss.com.cn/ArQ6dFE3-9o5x4B",
            "invoiceTime": 1546398919000,
            "invoiceCode": "131880930142",
            "invoiceNo": "18757776",
            "exTaxAmount": "0.38",
            "taxAmount": "0.02",
            "payerName": "个人2",
            "payerTaxNo": "110101TRDX8RQU1",
            "invoiceKind": "电子增值税普通发票",
            "checkCode": "72969719882523170140",
            "invoiceItems": [
                {
                    "itemName": "门票",
                    "itemUnit": "张",
                    "itemPrice": "0.300000000000000000",
                    "itemTaxRate": "0.06",
                    "itemNum": "2.000000000000000000",
                    "itemAmount": "0.60",
                    "itemTaxAmount": "0.03",
                    "itemSpec": "",
                    "itemCode": "3070101000000000000",
                    "isIncludeTax": "true",
                    "invoiceLineProperty": "2",
                    "zeroRateFlag": "",
                    "favouredPolicyName": "",
                    "favouredPolicyFlag": "0"
                },
                ……
            ]
        },
        ……
    ]
}

3.示例代码

public Map<String,Object> getInfo(InvoiceSettingDTO invoiceSettingDTO) {
        try {
            Map<String,Object> map = new HashMap<>();
            String status ="";
            String pdfUrl ="";
            String pictureUrl ="";
            String invoiceCode ="";//发票代码
            String invoiceNo ="";//发票号码
            LambdaQueryWrapper<InvoiceInfo> lq1 = new LambdaQueryWrapper<>();
            lq1.eq(InvoiceInfo::getOrderId,invoiceSettingDTO.getOrderId());
            InvoiceInfo invoiceInfo = invoiceInfoMapper.selectOne(lq1);
            String senid = UUID.randomUUID().toString().replace("-", ""); // 唯一标识，32位随机码，无需修改，保持默认即可
            String method = "nuonuo.ElectronInvoice.queryInvoiceResult"; // API方法名
            NNOpenSDK sdk = NNOpenSDK.getIntance();
            String token = getToken();
            JSONObject jsonObject = new JSONObject();
            jsonObject.put("serialNos",invoiceSettingDTO.getInvoiceId());
            jsonObject.put("isOfferInvoiceDetail","0");
            String content = jsonObject.toJSONString();

            log.info("author in ==>"+content);
            String json = sdk.sendPostSyncRequest(baseURL, senid, aPPKey, aPPSecret, token, taxnum, method, content);
            log.info("author out ==>"+json);
            //获取结果json
            JSONObject result = JSONObject.parseObject(json);

            String code = result.getString("code");
            if (code.equals("E0000")){
                //获取结果集
                List<InvoiceInfoVO> infoVOS = result.getJSONArray("result").toJavaList(InvoiceInfoVO.class);
                invoiceSettingDTO.getInvoiceSerialNum();
                if (infoVOS.size()>=0){
                    status = infoVOS.get(0).getStatus();
                    pdfUrl = infoVOS.get(0).getPdfUrl();
                    pictureUrl = infoVOS.get(0).getPictureUrl();
                    invoiceCode = infoVOS.get(0).getInvoiceCode();
                    invoiceNo = infoVOS.get(0).getInvoiceNo();
                    String failCause = infoVOS.get(0).getFailCause();
                    System.out.println(json+"======>>>");
                    System.out.println(json+"======>>>");
                    System.out.println(json+"======>>>");
                    System.out.println(json+"======>>>");
                    if (ObjectUtil.isNotEmpty(failCause)){
                        throw new XXXException(failCause+",请稍后再试，或致电010-88545091");
                    }
                }else {
                    throw new XXXException("调用查询发票接口失败!");
                }
                map.put("status",status);
                map.put("pdfUrl",pdfUrl);
                map.put("pictureUrl",pictureUrl);
                return map;
            }else {
                String errormsg = result.getString("describe");
                throw new HbsxException(errormsg+",请稍后再试");
            }
        } catch (Exception e){
            log.error("InvoiceSettingServiceImpl.getInfo.error==>{}",e.getMessage());

            if(e instanceof XXXException){
                throw new XXXException(ErrorCode.SYSTEM_ERROR.getCode(),e.getMessage());
            }
            throw new XXXException(ErrorCode.SYSTEM_ERROR.getCode(),"系统异常，请稍后再试！");
        }
    }

4.返回码说明：
在这里插入图片描述

以上就是诺诺发票的自助开票和查询接口的使用，其他冲红等接口与这两个接口调用方式一致，如有侵权，请联系我删除文章，学习之路山高路远，还请各位大佬指正！

老叶把把C
关注
  • 2
    点赞
  • 踩
  • 10
    收藏
    觉得还不错? 一键收藏
  • 4
    评论
税航_开票组件_接口文档v2.3.docx
07-24
航天金税接口文档，里面详细描述金税发票接口的详细信息，及相应的使用方法，希望给大家提供一些对接金税的接口。
诺诺电子发票接口文档 企业扫码开票对接文档 企业同步发票通用版
11-28
企业扫码开票对接文档 企业同步发票通用版 .Net 4.0调用诺诺接口加密文件
诺诺电子发票文档pdf格式对接接口文档
03-14
诺诺电子发票文档pdf格式对接接口文档
基于诺诺电子发票平台开发开具电子发票
热门推荐
tyc_054600的博客
05-08 1万+
springboot 电子发票 诺诺开放平台 诺诺电子发票
航天信息接口.rar
02-20
航天信息接口.rar
诺诺开放平台请求开具发票接口(2.0)接口对接文档【外部用】
03-28
诺诺开放平台请求开具发票接口(2.0)接口对接文档【外部用】
税控发票开票软件发票信息数据接口规范V4.0（含电子发票接口）
06-19
税控发票开票软件发票信息数据接口规范V4.0，增值税普通发票（电子）企业端（单机版数据文件）接口规范V1.1，增值税普通发票（电子）企业端（服务器版可编程）接口规范V1.1。国家税务总局最新发票接口规范，含电子发票接口。
全电发票开票接口
Michael__mai的博客
03-07 4235
全电发票自动开票的实现，全电发票开票接口文档说明
c/s架构的ERP系统对接开票接口
票点云电子发票接口
07-25 1063
一些传统C/S架构的ERP软件，也有对接开票的需求，但他们的业务系统是只能在本地局域网使用。但是之前我们提到的电商网站如何快速接入电子发票功能？是针对SASS部署的，因为需要用到外部http请求。那么针对这种本地部署的ERP系统怎么实现开票自动功能呢？ 我们可以采用数据库直连的方式，无需财务单独整理开票数据，所有开票信息来自ERP系统，并将已开票信息自动回填到ERP系统中。核心的功能点如下：单据选择：选择ERP系统中相关单据信息，可实现单据号、日期批量导入！也可以购方名称或单据编码精确查找等多种组合条件查
【数电发票】数电发票财务对接开票接口
f805122102的博客
04-11 5437
{“Result”:“1”,“Message”:“成功”,“ErrList”:[],“SucessList”:[{“xtlsh”:“144115188078732376”,“fpzl”:“026”,“fpdm”:“”,“fphm”:“”,“kprq”:“”,“skm”:“”,“jym”:“”,“jqbh”:“”,“ewm”:“”,“url”:“”,“kpjg”:“0”,“pdfxx”:“”,“kpfk”:“数据保存成功”}]}{“Result”:“1”,“Message”:“成功，离线开票模式！
诺诺发票发票开具请求接口2.0.rar
03-24
诺诺开放平台发票开具请求接口2.0 ，欢迎加入交流群，下载获取入群方式。
增值税开票接口规范v3
07-25
增值税开票接口规范v3,可以参考本文档进行开票软件的二次开发工作。实现开票的自动化，提高开票时的工作效率。
行业资料-交通装置-一种便携式自助开票系统的控制方法.zip
09-08
行业资料-交通装置-一种便携式自助开票系统的控制方法.zip
基于PHP的发票申请管理系统源码-课程设计.zip
09-05
【资源说明】 基于PHP的发票申请管理系统源码-课程设计.zip基于PHP的...3、如果基础还行，也可在此代码基础上进行修改，以实现其他功能，也可直接用于毕设、课设、作业等。 欢迎下载，沟通交流，互相学习，共同进步！
财税实务-金三-切换对开票软件操作有啥影响-八问八答保您一看就懂!.doc
11-30
财税实务-金三-切换对开票软件操作有啥影响-八问八答保您一看就懂!.doc
财税实务：-金三-切换对开票软件操作有啥影响-八问八答保您一看就懂!.pdf
11-29
财税实务：-金三-切换对开票软件操作有啥影响-八问八答保您一看就懂!.pdf
Python-票根网psstxffpcom的发票批量下载和批量开票
08-12
票根网(pss.txffp.com)的发票批量下载和批量开票
【数据结构】二叉树
最新发布
m0_73911405的博客
05-05 446
前序：根，左子树，右子树中序：左子树，根，右子树后序：左子树，右子树，根N代表空元素前序 1 2 3 N N N 4 5 N N 6 N N中序 N 3 N 2 N 1 N 5 N 4 N 6 N后序 N N 3 N 2 N N 5 N N 6 4 1层序 1 2 4 3 5 6一层层从左到右一个树分成根和子树，子树再分为根和子树。
Spring Cloud——LoadBalancer
????
05-01 1804
这里只是简单的讲解了一下LoadBalancer如何使用，因为实际上我们使用的不是很多，主要还是使用OpenFeign。
小程序申请开票功能开发
09-09
要开发小程序的开票功能，你可以按照以下步骤进行操作： 1. 首先，你需要在小程序中创建一个新的页面用于用户提交开票申请。用户应该能够填写必要的信息，包括抬头、税号、金额、发票内容和快递地址等。 2. 在后台中，你需要创建一个发票管理模块，以便财务人员可以查看和处理发票申请。这个模块应该显示所有的开票申请，并提供相应的操作，比如审核通过或拒绝。 3. 为了实现开票功能，你需要使用微信小程序支付的接口。在开始之前，你需要注册并开通一个后台账号，并获得一个专属域名。在准备工作完成后，你可以根据官方文档中的指引，集成小程序支付功能。 4. 对于每个开票申请，你需要在后台调用微信支付的接口，生成一个支付链接。这个链接应该包含用户的openid和开票信息。当用户点击链接并完成支付后，你可以发送发票给用户的快递地址。 综上所述，要开发小程序的开票功能，你需要创建一个页面用于用户提交开票申请，创建一个发票管理模块供财务人员处理申请，并集成微信小程序支付接口以实现支付功能。记得在支付过程中，要生成支付链接并发送发票给用户。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 4
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值