票单云
首页数电发票V2回官网
首页数电发票V2回官网
  1. 首页
  • 票单云·开放API
  • 接入准备工作
  • 附件
  • 数电票接口V2
    • 访问令牌
      • 获取令牌
      • 更新令牌
    • 电票平台
      • 登录电票平台
      • 查询授信额度
      • 获取是否需要人脸识别
      • 获取人脸二维码
    • 蓝字发票
      • 蓝字发票开具
      • 查询发票明细
      • 获取版式文件
    • 红字发票
      • 申请红字前查蓝票信息
      • 申请红字信息表
      • 红字发票开具
    • 特殊票种(支持15种)
      • 成品油蓝字发票开具
      • 稀土蓝字发票开具
      • 货物运输服务蓝字发票开具
      • 旅客运输服务蓝字发票开具
      • 二手车蓝字发票开具
    • 进项接口
      • 进项发票详细查询
      • 进项发票版式文件获取
      • 发票归集查询
      • 发票归集
  1. 首页

票单云·开放API

↖️ 点击左上角,切换不同业务接口点击右侧,快捷跳到文档的相关小节 ➡️
如何接入票单云
1.查看文档了解接口➡️2.进入官网与商务人员联系➡️3.免费安排工程师沟通解决方案
➡️4.签订采购合同➡️5.工程师协助调试和测试(赠送14天测试期)➡️6.正式接入
API工具
本接口使用了 Apifox进行发布管理,可在PC端直接在线运行接口测试 ↗
apifox.png
在线测试,需要自己设置测试环境,配置baseurl和token等常用变量,并在调用参数中插入变量,以方便测试
API地址及公共请求头
1.
API请求地址BaseURL
BaseURL: https://api.piaodanyun.com/test/tax/v2
2.
公共请求头: 注:除获取 token 接口外其他接口适用
Authorization = yourtoken (token有效期为30小时)
Org-Guid = your_org_guid
名称类型示例值必须参数说明
AuthorizationStringecpBC/vvlysZ6xIqsM7e3GUs是访问令牌 Token
Org-GuidString123450000000是企业编号
请求响应
1.
状态码,
正确响应状态码为200;
错误响应状态码为400、401、403、404、405;
服务器异常状态码为500,502,503;
2.
响应头,错误响应时,响应头包含响应标头Trace-Id,用于追踪错误
3.
响应返回数据结构:
4.
错误码,code值为0 时正确响应,其他为错误响应
接口调用流程
1.
通过获取访问令牌接口,获得token(使用票单云账号和密码)
2.
设置公共请求头中:设置Authorization的值为token值;设置Org-Guid的值为您的org_guid
3.
使用 BaseURL + 接口位置 发起数电接口调用
如:
POST https://api.piaodanyun.com/test/tax/v2/qdjk/obtainToken 获取访问令牌
POST https://api.piaodanyun.com/test/tax/v2/qdjk/fullExteriorInvoke/loginDppt 登录电票平台
数电发票基础版接口清单
序号接口名称接口url
1登录电票平台/qdjk/fullExteriorInvoke/loginDppt
2授信额度查询/qdjk/allElectricInvoice/getCreditLine
3获取人脸二维码/qdjk/fullExteriorInvoke/getFaceImg
4获取是否需要人脸识别/qdjk/fullApplets/queryFaceAuthState
5全电蓝票开具/qdjk/fullExteriorInvoke/blueTicket
6发票详细查询/qdjk/fullExteriorInvoke/invoiceQueryMx
7获取版式文件/qdjk/fullExteriorInvoke/getInvoicePdfOfd
本页面仅展示基础版接口,企业版全功能接口请联系商务,可跳转官网与工作人员取得联系
修改于 2025-07-29 05:40:51
下一页
接入准备工作
Built with