一键红冲（调试中）
<h5>简要描述</h5>
<ul>
<li>根据蓝票信息，自动申请确认单，开具红票，返回红票信息。</li>
<li>仅支持全额红冲</li>
<li>如果购方做了发票用途确认，需要等对方同意后，才会开出红票。</li>
<li>重复调用此接口时，会返回已开具的红票信息。</li>
<li>由于后端集成接口较多，红冲一张发票大约需要10s~15s，注意http请求超时时间设置。</li>
</ul>
<h5>服务码</h5>
<ul>
<li>yspt_sdp_kshc</li>
</ul>
<h5>数据格式</h5>
<ul>
<li><code>JSON</code></li>
</ul>
<h5>请求数据</h5>
<h6>请求报文中datagram数据项说明:</h6>
<table>
<thead>
<tr>
<th>序号</th>
<th>数据项</th>
<th>数据项名称</th>
<th>类型</th>
<th>长度</th>
<th>必须</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>1.</td>
<td>kpfsbh</td>
<td>开票方识别号</td>
<td>varchar</td>
<td>20</td>
<td>否</td>
<td>开票方纳税人识别号</td>
</tr>
<tr>
<td>2.</td>
<td>fplxdm</td>
<td>发票类型代码</td>
<td>varchar</td>
<td>10</td>
<td>是</td>
<td>发票类型代码，见字典表：发票种类</td>
</tr>
<tr>
<td>3.</td>
<td>fpdm</td>
<td>发票代码</td>
<td>varchar</td>
<td>12</td>
<td>否</td>
<td>蓝票发票代码，数电票可以空</td>
</tr>
<tr>
<td>4.</td>
<td>fphm</td>
<td>发票号码</td>
<td>varchar</td>
<td>20</td>
<td>是</td>
<td>蓝票发票号码</td>
</tr>
<tr>
<td>5.</td>
<td>kprq</td>
<td>开票日期</td>
<td>varchar</td>
<td>20</td>
<td>是</td>
<td>开票日期，格式yyyy-MM-dd</td>
</tr>
<tr>
<td>6.</td>
<td>gxfxz</td>
<td>购销方性质</td>
<td>varchar</td>
<td>1</td>
<td>是</td>
<td>0销售方</br>1购买方</td>
</tr>
<tr>
<td>7.</td>
<td>chyydm</td>
<td>冲红原因代码</td>
<td>varchar</td>
<td>1</td>
<td>是</td>
<td>冲红原因代码 01开票有误 02销售退货 03服务终止 04销售折让</td>
</tr>
<tr>
<td>8.</td>
<td>kpy</td>
<td>开票员</td>
<td>varchar</td>
<td>20</td>
<td>是</td>
<td>开票员中文姓名</td>
</tr>
<tr>
<td>9.</td>
<td>cjr</td>
<td>创建人</td>
<td>varchar</td>
<td>20</td>
<td>否</td>
<td>人员代码。如果人名重复，通过kpy不能唯一确定创建人时，需要传此字段</td>
</tr>
</tbody>
</table>
<h5>返回数据</h5>
<table>
<thead>
<tr>
<th>参数</th>
<th>参数名</th>
<th>类型</th>
<th>长度</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>rtnCode</td>
<td>响应代码</td>
<td>string</td>
<td>4</td>
<td>请求结果反馈代码</td>
</tr>
<tr>
<td>rtnMsg</td>
<td>响应消息</td>
<td>string</td>
<td></td>
<td>请求结果反馈信息</td>
</tr>
<tr>
<td>fpzt</td>
<td>发票状态</td>
<td>string</td>
<td>2</td>
<td>开票状态： </br>2 :开票完成（ 最终状态），其他状态分别为: 20:开票中;21:开票成功签章中;22:开票失败;24:开票成功签章失败;</br>3:发票已作废；31:发票作废中</br>4:发票已红冲</br>备注：22、24 状态时，无需再查询，请确认开票失败原因以及签章失败原因；3、31 只针对纸票注：请以该状态码区分发票状态</td>
</tr>
<tr>
<td>fjh</td>
<td>分机号</td>
<td>string</td>
<td>10</td>
<td>分机号</td>
</tr>
<tr>
<td>jqbh</td>
<td>机器编号</td>
<td>string</td>
<td>10</td>
<td>机器编号</td>
</tr>
<tr>
<td>fpqqlsh</td>
<td>发票请求流水号</td>
<td>string</td>
<td>30</td>
<td>发票请求流水号</td>
</tr>
<tr>
<td>fwm</td>
<td>校验码</td>
<td>string</td>
<td>32</td>
<td>校验码</td>
</tr>
<tr>
<td>fpdm</td>
<td>发票代码</td>
<td>string</td>
<td>12</td>
<td>发票代码，数电发票时为空</td>
</tr>
<tr>
<td>fphm</td>
<td>发票号码</td>
<td>string</td>
<td>20</td>
<td>发票号码</td>
</tr>
<tr>
<td>zzfphm</td>
<td>纸质发票号码</td>
<td>string</td>
<td>8</td>
<td>纸质发票号码</td>
</tr>
<tr>
<td>kprq</td>
<td>开票日期</td>
<td>string</td>
<td>18</td>
<td>开票日期</td>
</tr>
<tr>
<td>fplx</td>
<td>发票类型</td>
<td>string</td>
<td>2</td>
<td>0:专票 2:普票 12机动车发票 41:卷票 42:二手车 51:电子普票 52：电子专票 81:全电发票(专用发票)，82:全电发票(普通发票)</td>
</tr>
<tr>
<td>hjbhsje</td>
<td>合计不含税金额</td>
<td>string</td>
<td>16.2</td>
<td>开票成功时返回</td>
</tr>
<tr>
<td>kphjse</td>
<td>合计税额</td>
<td>string</td>
<td>16.2</td>
<td>开票成功时返回</td>
</tr>
<tr>
<td>fpmw</td>
<td>发票密文</td>
<td>string</td>
<td>112</td>
<td>开票成功时返回</td>
</tr>
<tr>
<td>pdf_file</td>
<td>base64格式发票pdf</td>
<td>string</td>
<td></td>
<td>开票成功时返回（电票专有）</td>
</tr>
<tr>
<td>pdf_url</td>
<td>发票pdf下载路径</td>
<td>string</td>
<td></td>
<td>开票成功时返回（电票专有） pdf外网下载地址，有效期6个月</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code>{
&quot;kpfsbh&quot;: &quot;开票方识别号&quot;,
&quot;fplxdm&quot;: &quot;发票类型代码&quot;,
&quot;fpdm&quot;: &quot;发票代码&quot;,
&quot;fphm&quot;: &quot;发票号码&quot;,
&quot;kprq&quot;: &quot;开票日期&quot;,
&quot;gxfxz&quot;: &quot;购销方性质&quot;,
&quot;chyydm&quot;: &quot;冲红原因代码&quot;,
&quot;kpy&quot;: &quot;开票员&quot;,
&quot;cjr&quot;: &quot;创建人&quot;
}</code></pre>
<h5>返回示例</h5>
<pre><code>成功：
{
&quot;rtnCode&quot;:&quot;success&quot;,
&quot;rtnMsg&quot;:&quot;操作成功&quot;，
&quot;fpzt&quot;:&quot;2&quot;,
&quot;fjh&quot;:&quot;0-1&quot;,
&quot;jqbh&quot;:&quot;1234567890&quot;,
&quot;fpqqlsh&quot;:&quot;20210101121314123456&quot;,
&quot;fwm&quot;:&quot;123123123&quot;,
&quot;ewm&quot;:&quot;123&quot;,
&quot;fpdm&quot;:&quot;014000001234&quot;,
&quot;fphm&quot;:&quot;00001234&quot;,
&quot;zzfphm&quot;:&quot;00001234&quot;,
&quot;kprq&quot;:&quot;2021-01-01&quot;,
&quot;fplx&quot;:&quot;0&quot;,
&quot;hjbhsje&quot;:&quot;12.0&quot;,
&quot;kphjse&quot;:&quot;0.1&quot;,
&quot;fpmw&quot;:&quot;123&quot;,
&quot;pdf_file&quot;:&quot;123&quot;,
&quot;pdf_url&quot;:&quot;http://***/***&quot;
}
失败：
{&quot;rtnCode&quot;:&quot;9999&quot;,&quot;rtnMsg&quot;:&quot;参数错误&quot;}
</code></pre>