请求开具发票接口

请求开具发票接口

填写发票销方、购方、明细等信息并发起开票请求。

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/nuonuo/invoice/billingnew

2. 请求示例代码(Java)

   @Test
    public void  NNBillingNEW() throws Exception {

        // 销售方公司全名
        String saleName = "上海XXX科技有限公司";
        // 销售方公司税号
        String saleTaxNum = "xxxxxxxxxx";
        // 回调地址，需要公网能访问
        String notifyUrl = "http://youdomain.com/fc/nuonuo/notify";

        BillingNewRequest billingNewRequest = new BillingNewRequest();
        Order order =new Order();
        // 以下入参是必须或是重要
        order.setBuyerName("上海xxxxxx科技有限公司");
        order.setBuyerTaxNum("91310000MA7EFBKaa3");
        order.setSalerTel("0571-77777777");
        order.setSalerAddress("杭州市西湖区文三路200号");
        // 生成订单号，按规则年月日小时分秒+6位流水号
        String orderNo = Utils.generateOrderNumber();
        order.setOrderNo(orderNo);
        order.setInvoiceDate("2023-12-13 12:30:00");
        order.setClerk("张三");
        // 清单标志：非清单:0；清单:1，默认:0，电票固定为0
        order.setListFlag("0");
        // 买方的推送邮箱（pushMode为0或2时，此项为必填，同时受企业资质是否必填控制）
         order.setEmail("xxxxxxxxxxx@163.com");
        // 推送方式：-1,不推送;0,邮箱;1,手机（默认）;2,邮箱、手机
        order.setPushMode("0");
        order.setInvoiceType("1");
        // 回调地址
        order.setCallBackUrl(notifyUrl);
        // 全电就是代表全电账号，电子税务局是用账号来开发票的,税盘的是税盘本来就有的分机号，税局发行的上面有
        order.setExtensionNumber("923");
        // 发票种类, bs:电子发票(增值税专用发票)-即数电专票(电子)
        order.setInvoiceLine("bs");
        order.setRemark("我是发票备注处的内容");
        // 销方税号 
        order.setSalerTaxNum(saleTaxNum);
        // 发票明细
        InvoiceDetail invoiceDetail= new InvoiceDetail();
        invoiceDetail.setSpecType("120x80");
        invoiceDetail.setDField1("");
        invoiceDetail.setTaxExcludedAmount("100");
        invoiceDetail.setInvoiceLineProperty("0");
        invoiceDetail.setFavouredPolicyName("0");
        invoiceDetail.setDField3("");
        invoiceDetail.setDField2("");
        invoiceDetail.setDField5("");
        invoiceDetail.setNum("1");
        invoiceDetail.setDField4("");
        invoiceDetail.setWithTaxFlag("0");
        invoiceDetail.setTax("13");
        invoiceDetail.setFavouredPolicyFlag("0");
        invoiceDetail.setTaxRate("0.13");
        invoiceDetail.setUnit("张");
        invoiceDetail.setDeduction("0");
        invoiceDetail.setPrice("100");
        invoiceDetail.setZeroRateFlag("0");
        invoiceDetail.setImmediateTaxReturnType("");
        invoiceDetail.setGoodsCode("1090511030000000000");
        invoiceDetail.setSelfCode("130005426000000000");
        invoiceDetail.setGoodsName("EM蓝板");
        invoiceDetail.setTaxIncludedAmount("113");
        List<InvoiceDetail> invoiceDetails = new ArrayList<InvoiceDetail>();
        invoiceDetails.add(invoiceDetail);
        order.setInvoiceDetail(invoiceDetails);
        billingNewRequest.setOrder(order);
        String content = JSON.toJSONString(billingNewRequest);

        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("tax_num", saleTaxNum);
        data.put("sale_name", saleName);
        data.put("request_data",content);
        // 签名
        data.put("sign", Utils.Sign(data,Config.AppSecret));
        // 调用服务API
        String resp = doHttpRequest(Config.NN_BILLING_NEW, data);
        BillingNewResponse billingNewResponse = JSON.parseObject(resp, BillingNewResponse.class);
        System.out.println("code:" + billingNewResponse.getCode());
    }

2.1 请求参数说明

请求入参request_data是json格式的业务报文字段，其中包含的字段含义说明如下。

3. 返回结果

本次接口只是提交开票申请，开票结果不是实时返回，而是税务局侧开票完成后，再异步通知返回。

注意：若相同使用订单号相同的开票申请，而之前开票又是成功情况下，则接口直接返回开票结果（发票pdf下载地址和发票号）。

3.1 首次开票成功

，返回结果如下

  {
  "code": 0,
  "invoice_serial_num": "23122512180201522056",
  "message": "开票提交成功"
}

开票提交成功后，平台将通知税务局生成发票结果（如发票号，pdf下载地址等）， 并通过通步通知将结果回调给开发者, 见文档： https://doc.fw199.com/docs/h7b/nuonuo-billingnew-notify

3.1 重复提交开票成功返回

如果是相同的订单号重复提交，并且之前已经开具成功，则返回如下：

{
  "code": 100,
  "invoice_down_url": "https://inv.jss.com.cn/fp2/7B_nQ3OJ3-2NJfvYvIWK2y_iM4Na41Laty9izcQPzmyeu448MWu7sx-Otdv0m4azSYGjYKCnv7aZHLA6uC88-w.pdf",
  "invoice_no": "20882312250039010320",
  "message": "发票已经生成，不需要重复提交"
}

如果code返回100时，说明开票已经成功，返回字段会包含发票下载地址invoice_down_url和发票号invoice_no。

3.1 开票失败时返回

比如开票提交的数据不对，逻辑上有问题，开票请求没有被受理，则返回code为其他值（注意：code不是0或100），不一定只是code为3是失败，或存在其他值。

{
  "code": 3,
  "message": "NN返回错误:第1条明细中(不含税金额+税额)不等于含税金额",
  "trace_id": ""
}

4 返回参数说明