票单云
首页数电发票V2回官网
首页数电发票V2回官网
  1. 首页
  • 票单云·开放API
  • 接入准备工作
  • 附件
  • 数电票接口V2
    • 访问令牌
      • 获取令牌
      • 更新令牌
    • 数电基础版
      • 登录电票平台
      • 查询授信额度
      • 获取是否需要人脸识别
      • 获取人脸二维码
      • 查询发票明细
      • 获取版式文件
      • 蓝字发票开具
      • 申请红字前查蓝票信息
      • 申请红字信息表
      • 红字发票开具
  • 数电票接口V1(不推荐)
    • 访问令牌
      • 获取令牌
      • 更新令牌
    • 数电基础版
      • 登录电票平台
      • 授信额度查询
      • 获取是否需要人脸识别
      • 获取人脸二维码
      • 蓝字发票开具
      • 发票详细查询
      • 获取版式文件
    • 数电企业版
      • 开具红字发票
        • 申请红字前查蓝票信息
        • 申请红字信息表
        • 红字发票开具
  1. 首页

票单云·开放API

↖️ 点击左上角,切换不同业务接口点击右侧,快捷跳到文档的相关小节 ➡️
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小时)
名称类型示例值必须参数说明
AuthorizationStringecpBC/vvlysZ6xIqsM7e3GUs是访问令牌 Token
请求响应
1.
状态码,
正确响应状态码为200;
错误响应状态码为400、401、404、404、405;
服务器异常状态码为500,502,503;
2.
响应头,错误响应时,响应头包含响应标头Trace-Id,用于追踪错误
3.
响应返回数据结构:
4.
错误码,code值为0 时正确响应,其他为错误响应
接口调用流程
1.
通过获取访问令牌接口,获得token(使用票单云账号和密码)
2.
将token加入到请求头中:设置Authorization的值为token值
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-06-15 13:12:37
下一页
接入准备工作
Built with