接入说明
<h4>快速入门</h4>
<p>在接入前置接口之前，首先要联系服务商，登记并注册项目信息。
> #### 第一步、注册组织：企业提供企业税号、企业名称、联系人、电话</p>
<h4>第二步、注册服务：企业提供要开通的服务名称</h4>
<h4>第三步、登记注册：服务商为企业登记注册并开通服务</h4>
<h4>第四步、返回信息：服务商返给企业组织代码、注册码、组织授权码、签名密钥和数据密钥，企业注意保密保存</h4>
<h4>接入步骤</h4>
<ul>
<li>
<p>接口授权（服务商提供项目代码、授权码、注册码、签名密钥、数据密钥）</p>
</li>
<li>
<p>获取令牌（access_token）</p>
</li>
<li>调用接口</li>
</ul>
<h4>接口列表</h4>
<table>
<thead>
<tr>
<th style="text-align: left;">服务码</th>
<th style="text-align: left;">接口名称</th>
<th>接口说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">yspt_sdyh_login</td>
<td style="text-align: left;">数电用户登录</td>
<td>通过此接口，实现企业账户登录电子税务局的操作，因不同区域不同身份类型设置不同，需要用户选择地区和责任人类型并填写账号对应手机号收到的手机验证码。只有本接口调用成功，才能进行后续进项业务接口的调用。</td>
</tr>
<tr>
<td style="text-align: left;">yspt_sdyh_hqewm</td>
<td style="text-align: left;">获取实名认证二维码</td>
<td>此接口用于获取二维码进行二次认证接口，实人认证用户信息</td>
</tr>
<tr>
<td style="text-align: left;">yspt_sdyh_ecrzztcxjk</td>
<td style="text-align: left;">二次认证状态查询接口</td>
<td>此接口用于获取二次认证结果的接口</td>
</tr>
<tr>
<td style="text-align: left;">yspt_sdp_djxz</td>
<td style="text-align: left;">单据新增接口</td>
<td>实现单据新增，不开票</td>
</tr>
<tr>
<td style="text-align: left;">yspt_sdp_kp</td>
<td style="text-align: left;">开票请求接口</td>
<td>实现正数和红字发票开具，返回开票请求流水号</td>
</tr>
<tr>
<td style="text-align: left;">yspt_sdp_fplbcxhlp</td>
<td style="text-align: left;">发票列表查询红蓝票</td>
<td>根据条件查询用户已有发票(全电票+增值税发票)</td>
</tr>
<tr>
<td style="text-align: left;">yspt_sdp_dzfpcx</td>
<td style="text-align: left;">单票查询接口</td>
<td>此接口为查询单张发票接口，可以通过该接口查询单张发票详情信息</td>
</tr>
<tr>
<td style="text-align: left;">yspt_sdyh_fpxz</td>
<td style="text-align: left;">发票下载</td>
<td>下载已开具成功的数电发票</td>
</tr>
<tr>
<td style="text-align: left;">yspt_sdyh_yxjf</td>
<td style="text-align: left;">发票邮箱交付接口</td>
<td>此接口用于将开具的发票通过邮箱交付给用户</td>
</tr>
<tr>
<td style="text-align: left;">yspt_sdp_ewmjf</td>
<td style="text-align: left;">数电票二维码交付</td>
<td>将开具成功的发票通过访问此接口返回地址进行下载</td>
</tr>
<tr>
<td style="text-align: left;">yspt_sdp_smkp</td>
<td style="text-align: left;">数电扫码开票</td>
<td>实现单据新增，返回取票码、开票Url</td>
</tr>
<tr>
<td style="text-align: left;">yspt_sdp_fpztcx</td>
<td style="text-align: left;">发票状态查询</td>
<td>通过销售单号获取发票状态信息</td>
</tr>
<tr>
<td style="text-align: left;">yspt_sdp_hzqrdlzfpcx</td>
<td style="text-align: left;">可开具红字确认单蓝票查询</td>
<td>此接口查询可开具红字确认单的蓝票列表</td>
</tr>
<tr>
<td style="text-align: left;">yspt_sdp_schzqrdxx</td>
<td style="text-align: left;">生成红字确认单信息接口</td>
<td>此接口为生成红字确认单信息(新版本接口用来整合用票信息接口和单票查询接口，新对接用户推荐使用2023-08-10)</td>
</tr>
<tr>
<td style="text-align: left;">yspt_sdp_fpypxxztcx</td>
<td style="text-align: left;">用票信息获取接口</td>
<td>此接口用于获取用票信息</td>
</tr>
<tr>
<td style="text-align: left;">yspt_sdp_hzqrdbc</td>
<td style="text-align: left;">红字确认单开具</td>
<td>开具红票前，需先进行红字确认单的申请，此接口用户红字确认单的申请提交</td>
</tr>
<tr>
<td style="text-align: left;">yspt_sdp_hzqrdxqcx</td>
<td style="text-align: left;">红字确认单详情查询</td>
<td>可以通过该接口查询红字确认单详情</td>
</tr>
<tr>
<td style="text-align: left;">yspt_sdp_hzqrdlbcx</td>
<td style="text-align: left;">红字确认单列表查询</td>
<td>查询用户的红字确认单列表</td>
</tr>
<tr>
<td style="text-align: left;">yspt_sdp_qrjkpjgcx</td>
<td style="text-align: left;">确认即开票结果查询</td>
<td>此接口用于在确认即开票后获取对应的红票信息</td>
</tr>
<tr>
<td style="text-align: left;">yspt_sdp_hzqrdcl</td>
<td style="text-align: left;">红字确认单处理</td>
<td>可以通过该接口对已提交的红字确认单处理</td>
</tr>
<tr>
<td style="text-align: left;">yspt_sdp_tspz_hwys_kp</td>
<td style="text-align: left;">货物运输</td>
<td>调用特殊票种-货物运输开票接口的请求报文</td>
</tr>
<tr>
<td style="text-align: left;">yspt_sdp_tspz_jzfw_kp</td>
<td style="text-align: left;">建筑服务</td>
<td>调用特殊票种-货物运输开票接口的请求报文</td>
</tr>
<tr>
<td style="text-align: left;">yspt_sdp_tspz_bdczl_kp</td>
<td style="text-align: left;">不动产租赁</td>
<td>此接口用于不动产租赁发票，目前支持通用蓝/红字发票和差额票的开具（注意该票种只能有一条明细）</td>
</tr>
<tr>
<td style="text-align: left;">yspt_sdp_tspz_bdcxs_kp</td>
<td style="text-align: left;">不动产销售</td>
<td>此接口用于不动产销售发票，目前支持通用蓝/红字发票和差额票的开具</td>
</tr>
<tr>
<td style="text-align: left;">yspt_sdp_tspz_lkys_kp</td>
<td style="text-align: left;">旅客运输</td>
<td>此接口用于开具发票，目前支持旅客运输蓝字发票和差额票的开具</td>
</tr>
</tbody>
</table>
<h4>发票类型说明</h4>
<table>
<thead>
<tr>
<th>发票类型编码</th>
<th>发票种类说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>0</td>
<td>增值税专用发票</td>
</tr>
<tr>
<td>2</td>
<td>增值税普通发票</td>
</tr>
<tr>
<td>12</td>
<td>机动车销售统一发票</td>
</tr>
<tr>
<td>41</td>
<td>增值税普通发票（卷票）</td>
</tr>
<tr>
<td>42</td>
<td>二手车销售统一发票</td>
</tr>
<tr>
<td>51</td>
<td>增值税普通发票（电子）</td>
</tr>
<tr>
<td>52</td>
<td>增值税电子专用发票</td>
</tr>
<tr>
<td>81</td>
<td>全电发票（专用发票）</td>
</tr>
<tr>
<td>82</td>
<td>全电发票（普通发票）</td>
</tr>
</tbody>
</table>
<h4>用户接入流程图图示</h4>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitfile/sign/f1df296370f5b45a2391f6c03c2b7aaf" alt="" /></p>