接入准备工作

💡

一、票单云接口的安全机制

票单云系统采用TLS传输层安全机制+Token权限管理机制来确保API调用的安全性。TLS避免了中间人攻击或窃听，同时Token机制确保接口的调用在授权下进行，其安全性等价于签名机制，为用户调用接口带来更大的安全性和便利性。

二、票单云账号注册与授权

客户需提供一个有效的手机号或邮箱作为管理员账号，并提供企业名称和税号，由工作人员为其注册并绑定税号。（注，手机号或邮箱后期可以更换）

三、准备电子税务局账号及密码

客户开发人员需提前准备税号在电子税务局的登录账号和密码，并需要对应的开票员或办税员在测试相关功能时配合接收税局验证码及进行扫脸认证。

四、接口调试服务周期

一般建议，接口对接启动后，15天内集中完成相关接口的调试工作，为此，票单云会免费赠送客户15天的测试期，测试期结束后将消耗正式时长。测试期后，技术人员和商务人员仍将持续提供售后服务。

五、Token的使用及有效机制

客户在调用接口时，使用账号和密码获取Token，并将token值添加到请求头Authorization中。token的有效期为30个小时，建议客户每天固定时间更新一次。如果客户多台服务器请求多个token，不会引起挤占冲突，各个token在有效期内均可使用。

六、异步开票机制介绍（必读）

不同于以往税控模式，数电票要求周期性的登录验证和开票验证，这使得传统同步开票模式受到了很大的挑战，由于传统同步开票模式强调24小时实时同步开票，应用在数电票上，就需要企业用户每日进行不定期的频繁认证，使得客户不胜其扰。所以，数电时代需要更多的关注异步开票模式和机制。异步开票模式要求企业用户在设计开票机制时注意以下要点：

将顾客的开票申请与发票交付异步化，顾客提交开票申请后，需要通过查询开票状态来更新发票的开具状态，直至开具成功，实现交付。

企业在设计开票和交付时，24小时接受顾客开票申请，但是开票工作由开票人员在每日固定时间，进行一次开票作业（扫脸认证，截至2025年大多数企业支持最长90天免扫脸），完成当日开票工作，并实现交付，确保顾客24小时内开具成功。

相对于同步开票，异步开票能减少企业认证次数，主动掌握认证时间和频率，同时提升顾客开票体验，避免顾客在实时开票时因认证问题而发生开票失败的情形。

接入准备工作

一、票单云接口的安全机制#

二、票单云账号注册与授权#

三、准备电子税务局账号及密码#

四、接口调试服务周期#