票单云
首页接入管理销项管理进项管理自然人代开税控发票回官网
首页接入管理销项管理进项管理自然人代开税控发票回官网
  1. 首页
  • 票单云·开放API
  • 接入准备工作
  • 附件
  • 接入管理
    • 获取令牌
      • 获取票单云令牌
      • 获取令牌
      • 更新令牌
    • 接入税局
      • 接入税局
      • 登录电票平台
      • 登出电票平台
      • 查询授信额度
      • 获取是否需要人脸识别
      • 获取人脸二维码
  • 销项管理
    • 销项开票
      • 蓝字发票
        • 蓝字发票开具
        • 查询发票明细
      • 红字发票
        • 申请红字前查蓝票信息
        • 申请红字信息表
        • 红字发票开具
      • 获取版式
        • 获取版式文件
    • 特定要素(支持15种)
      • 成品油蓝字发票开具
      • 二手车蓝字发票开具
      • 稀土蓝字发票开具
      • 货物运输服务蓝字发票开具
      • 旅客运输服务蓝字发票开具
    • 销项归集
      • 销项归集流程
      • 发票查询
      • 发票归集
      • 销项发票详细查询
      • 销项发票版式文件获取
  • 进项管理
    • 进项归集
      • 进项归集流程
      • 发票查询
      • 发票归集
      • 进项发票详细查询
      • 进项发票版式文件获取
    • 进项勾选
    • 进项入账
    • 报销套件(识别验真查重)
      • 识别验真查重
  • 自然人代开
    • 自然人代开
  • 税控发票
    • 税控电子发票版式文件
      • 获取进项税控电普版式文件
      • 获取税控电专发票的版式文件地址
  • 数据模型
    • Schemas
      • 公共响应模型
首页接入管理销项管理进项管理自然人代开税控发票回官网
首页接入管理销项管理进项管理自然人代开税控发票回官网
  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-Id = your_org_id
名称类型示例值必须参数说明
AuthorizationStringecpBC/vvlysZ6xIqsM7e3GUs是访问令牌 Token
Org-IdString123450000000是企业编号
请求响应
1.
状态码,
正确响应状态码为200;
错误响应状态码为400、401、403、404、405;
服务器异常状态码为500,502,503;
2.
响应头,错误响应时,响应头包含响应标头Trace-Id,用于追踪错误
3.
响应返回数据结构:
4.
错误码,code值为0 时正确响应,其他为错误响应
接口调用流程
1.
通过获取访问令牌接口,获得token(使用票单云账号和密码)
2.
设置公共请求头中:设置Authorization的值为token值;设置Org-Id的值为您的org_id
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-09-09 02:54:56
下一页
接入准备工作
Built with