电子发票/数电发票 Go SDK | 开票、验真、红冲一站式集成|云开票，开票系统

已于 2025-05-13 08:53:10 修改
阅读量227 收藏 5
点赞数 7
分类专栏： 发票 发票sdk 发票接口 文章标签： golang
于 2025-05-07 14:31:44 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/fapiaoapi/article/details/147748656
版权

发票SDK 专为电子发票、数电发票（全电发票）场景设计，支持开票、红冲、版式文件下载等核心功能，快速对接税务平台API。

关键词: 电子发票SDK,数电票go,开票接口,发票接口,发票开具,发票红冲,全电发票集成

📖 核心功能

基础认证

  • ✅ 获取授权 - 快速接入税务平台身份认证
  • ✅ 人脸二维码登录 - 支持数电发票平台扫码登录
  • ✅ 认证状态查询 - 实时获取纳税人身份状态

发票开具

  • 🟦 数电蓝票开具 - 支持增值税普通/专用电子发票
  • 📄 版式文件下载 - 自动获取销项发票PDF/OFD/XML文件

发票红冲

  • 🔍 红冲前蓝票查询 - 精确检索待红冲的电子发票
  • 🛑 红字信息表申请 - 生成红冲凭证
  • 🔄 负数发票开具 - 自动化红冲流程

🚀 快速安装

安装

go get github.com/fapiaoapi/invoice-sdk-golang

📚 查看完整中文文档

🔍 为什么选择此SDK？

  • 精准覆盖中国数电发票标准 - 严格遵循国家最新接口规范
  • 开箱即用 - 无需处理XML/签名等底层细节，专注业务逻辑
  • 企业级验证 - 已在生产环境处理超100万张电子发票

📊 支持的开票类型

发票类型状态
数电发票（普通发票）✅ 支持
数电发票（增值税专用发票）✅ 支持
数电发票（铁路电子客票）✅ 支持
数电发票（航空运输电子客票行程单）✅ 支持
数电票（二手车销售统一发票）✅ 支持
数电纸质发票（增值税专用发票）✅ 支持
数电纸质发票（普通发票）✅ 支持
数电纸质发票（机动车发票）✅ 支持
数电纸质发票（二手车发票）✅ 支持

🤝 贡献与支持

开票

// 配置信息  https://open.fa-piao.com 注册获取
 
   appKey := "your_app_key"
   appSecret := "you_app_secret"

   nsrsbh := "91500112MADFAQ9xxx" // 统一社会信用代码
   // title := "重庆悦江河科技有限公司"         // 名称（营业执照）
   username := "19122840406" // 手机号码（电子税务局）
   password := ""            // 个人用户密码（电子税务局）
   // sf := "01"                     // 身份（电子税务局）
   fphm := "24502000000045823936"
   kprq := ""
   token := ""

   // 创建客户端
   client := invoice.NewClient(appKey, appSecret)

   // 获取授权
   if token != "" {
   	client.SetToken(token)
   } else {
   	authResult, err := client.GetAuthorization(nsrsbh)
   	if err != nil {
   		fmt.Printf("授权失败: %v\n", err)
   		return
   	}
   	token = authResult.Token
   	client.SetToken(token)
   	fmt.Printf("授权成功，Token: %s\n", token)
   }

   // 查询认证状态
   loginResult, err := client.QueryFaceAuthState(nsrsbh, map[string]string{
   	"username": username,
   })
   if err != nil {
   	fmt.Printf("查询认证状态失败: %v\n", err)
   	return
   }

   switch loginResult.Code {
   case 200:
   	fmt.Println("可以开发票了")

   	// 税额计算
   	amount := 200.0
   	taxRate := 0.01
   	isIncludeTax := true // 是否含税
   	se := invoice.CalculateTax(amount, taxRate, isIncludeTax)

   	fmt.Printf("价税合计：%.2f\n", amount)
   	fmt.Printf("税率：%.2f\n", taxRate)
   	seFloat, _ := strconv.ParseFloat(se, 64)
   	fmt.Printf("合计金额：%.2f\n", amount-seFloat)
   	if isIncludeTax {
   		fmt.Printf("含税 合计税额：%s\n", se)
   	} else {
   		fmt.Printf("不含税 合计税额：%s\n", se)
   	}

   	// // 授信额度查询
   	// creditLimitResponse, err := client.QueryCreditLimit(nsrsbh, map[string]string{
   	// 	"username": username,
   	// })
   	// if err != nil {
   	// 	fmt.Printf("授信额度查询失败: %v\n", err)
   	// } else if creditLimitResponse.Code == 200 {
   	// 	fmt.Printf("授信额度查询结果: %s\n", string(creditLimitResponse.Data))
   	// }

   	// 开具蓝票
   	invoiceParams := map[string]string{
   		"fpqqlsh":  appKey + strconv.FormatInt(time.Now().Unix(), 10),
   		"fplxdm":   "82",
   		"kplx":     "0",
   		"xhdwsbh":  nsrsbh,
   		"xhdwmc":   "重庆悦江河科技有限公司",
   		"xhdwdzdh": "重庆市渝北区仙桃街道汇业街1号17-2 19122840xxxx",
   		"xhdwyhzh": "中国工商银行 310008670920023xxxx",
   		"ghdwmc":   "个人",
   		"zsfs":     "0",
   		"hjje":     "9.9",
   		"hjse":     "0.1",
   		"jshj":     "10",
   	}

   	items := []invoice.InvoiceItem{
   		{
   			Fphxz: "0",
   			Spmc:  "*信息技术服务*软件开发服务",
   			Je:    "10",
   			Sl:    "0.01",
   			Se:    "0.1",
   			Hsbz:  "1",
   			Spbm:  "3040201010000000000",
   		},
   	}

   	invoiceResponse, err := client.BlueTicket(invoiceParams, items)
   	if err != nil {
   		fmt.Printf("开票失败: %v\n", err)
   	} else {
   		fmt.Printf("%d 开票结果: %s\n", loginResult.Code, loginResult.Msg)
   		fphm = invoiceResponse.Fphm
   		kprq = invoiceResponse.Kprq
   		fmt.Printf("发票号码: %s\n", fphm)
   		fmt.Printf("开票日期: %s\n", kprq)
   	}

   	// 下载发票
   	pdfResponse, err := client.GetVersionFile(nsrsbh, fphm, "4", map[string]string{
   		"kprq":     kprq,
   		"username": username,
   	})
   	if err != nil {
   		fmt.Printf("下载发票失败: %v\n", err)
   	} else if pdfResponse.Code == 200 {
   		fmt.Printf("下载发票结果: %s\n", string(pdfResponse.Data))
   	}

   case 420:
   	fmt.Println("登录(短信认证)")

   	// 1. 发短信验证码
   	loginResponse, err := client.LoginDppt(nsrsbh, username, password, "")
   	if err != nil {
   		fmt.Printf("发送短信验证码失败: %v\n", err)
   		return
   	}
   	if loginResponse.Code == 200 {
   		fmt.Println(loginResponse.Msg)
   		fmt.Printf("请%s接收验证码\n", username)
   		time.Sleep(60 * time.Second) // 等待60秒
   	}

   	// 2. 输入验证码
   	fmt.Println("请输入验证码")
   	var smsCode string
   	fmt.Scanln(&smsCode) // 获取用户输入的验证码

   	loginResponse2, err := client.LoginDppt(nsrsbh, username, password, smsCode)
   	if err != nil {
   		fmt.Printf("验证码登录失败: %v\n", err)
   		return
   	}
   	if loginResponse2.Code == 200 {
   		fmt.Println(string(loginResponse2.Data))
   		fmt.Println("验证成功")
   	}

   case 430:
   	fmt.Println("人脸认证")

   	// 1. 获取人脸二维码
   	qrCodeResponse, err := client.GetFaceImg(nsrsbh, map[string]string{
   		"username": username,
   		"type":     "1",
   	})
   	if err != nil {
   		fmt.Printf("获取人脸二维码失败: %v\n", err)
   		return
   	}
   	fmt.Printf("二维码: %+v\n", qrCodeResponse)

   	switch qrCodeResponse.Ewmly {
   	case "swj":
   		fmt.Println("请使用税务局app扫码")
   	case "grsds":
   		fmt.Println("个人所得税app扫码")
   	}

   	// 2. 认证完成后获取人脸二维码认证状态
   	rzid := qrCodeResponse.Rzid
   	faceStatusResponse, err := client.GetFaceState(nsrsbh, rzid, map[string]string{
   		"username": username,
   		"type":     "1",
   	})
   	if err != nil {
   		fmt.Printf("获取人脸认证状态失败: %v\n", err)
   		return
   	}
   	fmt.Printf("code: %d\n", loginResult.Code)
   	fmt.Printf("data: %+v\n", faceStatusResponse)

   	if faceStatusResponse != nil {
   		switch faceStatusResponse.Slzt {
   		case "1":
   			fmt.Println("未认证")
   		case "2":
   			fmt.Println("成功")
   		case "3":
   			fmt.Println("二维码过期-->重新获取人脸二维码")
   		}
   	}

   case 401:
   	fmt.Printf("%d 授权失败: %s\n", loginResult.Code, loginResult.Msg)

   default:
   	fmt.Printf("%d %s\n", loginResult.Code, loginResult.Msg)
   }

发票红冲

// 配置信息
	appKey := "your_app_key"
	appSecret := "your_app_secret"
	nsrsbh := "915101820724315xxx" // 纳税人识别号
	username := "19122840xxx"      // 手机号码（电子税务局）
	fphm := "25502000000038381718"
	kprq := "2025-04-13 13:35:27"
	token := ""

	// 创建客户端
	client := invoice.NewClient(appKey, appSecret)

	if token != "" {
		client.SetToken(token)
	} else {
		// 获取授权
		authResponse, err := client.GetAuthorization(nsrsbh)
		if err != nil {
			fmt.Printf("授权失败: %v\n", err)
			return
		}
		fmt.Printf("授权成功，Token: %s\n", authResponse.Token)
	}

	// 1. 数电申请红字前查蓝票信息接口
	sqyy := "2"
	queryInvoiceParams := map[string]string{
		"nsrsbh":   nsrsbh,
		"fphm":     fphm,
		"sqyy":     sqyy,
		"username": username,
		"ghdwsbh":  nsrsbh,
	}
	queryInvoiceResponse, err := client.QueryBlueInvoice(queryInvoiceParams)
	if err != nil {
		fmt.Printf("查询发票信息失败: %v\n", err)
		return
	}

	if queryInvoiceResponse.Code == 200 {
		fmt.Println("1 可以申请红字")
		time.Sleep(2 * time.Second)

		// 2. 申请红字信息表
		applyRedParams := map[string]string{
			"xhdwsbh":  nsrsbh,
			"yfphm":    fphm,
			"username": username,
			"sqyy":     "2",
			"chyydm":   "01",
		}
		applyRedResponse, err := client.ApplyRedInfo(applyRedParams)
		if err != nil {
			fmt.Printf("申请红字信息表失败: %v\n", err)
			return
		}

		if applyRedResponse.Code == 200 {
			fmt.Println("2 申请红字信息表")
			time.Sleep(2 * time.Second)

			// 从响应中提取红字信息表编号
			var redInfoData struct {
				Xxbbh string `json:"xxbbh"`
			}
			if err := invoice.ParseResponseData(applyRedResponse, &redInfoData); err != nil {
				fmt.Printf("解析红字信息表编号失败: %v\n", err)
				return
			}

			// 3. 开具红字发票
			redInvoiceParams := map[string]string{
				"fpqqlsh":  "red" + fphm,
				"username": username,
				"xhdwsbh":  nsrsbh,
				"tzdbh":    redInfoData.Xxbbh,
				"yfphm":    fphm,
			}
			redInvoiceResponse, err := client.RedTicket(redInvoiceParams, nil)
			if err != nil {
				fmt.Printf("数电票负数开具失败: %v\n", err)
				return
			}

			if redInvoiceResponse.Code == 200 {
				fmt.Println("3 负数开具成功")
			} else {
				fmt.Printf("%d 数电票负数开具失败: %s\n", redInvoiceResponse.Code, redInvoiceResponse.Msg)
				fmt.Printf("错误详情: %s\n", string(redInvoiceResponse.Data))
			}
		} else {
			fmt.Printf("%d 申请红字信息表失败: %s\n", applyRedResponse.Code, applyRedResponse.Msg)
			fmt.Printf("错误详情: %s\n", string(applyRedResponse.Data))
		}
	} else {
		fmt.Printf("%d 查询发票信息失败: %s\n", queryInvoiceResponse.Code, queryInvoiceResponse.Msg)
		fmt.Printf("错误详情: %s\n", string(queryInvoiceResponse.Data))
	}
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值