数电发票开具前置接口

云税平台开票前置接口规范


发票状态查询

<h5>简要描述</h5> <ul> <li>通过销售单号获取发票状态信息</li> </ul> <h5>服务码</h5> <ul> <li>yspt_sdp_fpztcx</li> </ul> <h5>数据格式</h5> <ul> <li><code>JSON</code></li> </ul> <h5>请求数据</h5> <table> <thead> <tr> <th>参数</th> <th>参数名</th> <th>类型</th> <th>长度</th> <th>必须</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>xsdh</td> <td>销售单号</td> <td>string</td> <td>50</td> <td>是</td> <td>销售单号</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>开票状态: &lt;/br&gt;2 :开票完成( 最终状态),其他状态分别为: 20:开票中;21:开票成功签章中;22:开票失败;24:开票成功签章失败;&lt;/br&gt;3:发票已作废;31:发票作废中&lt;/br&gt;4:发票已红冲&lt;/br&gt;备注: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>1</td> <td>0:专票 2:普票 12机动车发票 41:卷票 42:二手车 51:电子普票 52:电子专票</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>sl</td> <td>税率</td> <td>string</td> <td>10</td> <td>开票成功时返回</td> </tr> <tr> <td>kpr</td> <td>开票人</td> <td>string</td> <td>20</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外网下载地址</td> </tr> <tr> <td>ewm_url</td> <td>发票下载路径</td> <td>string</td> <td></td> <td>开票成功时返回(电票专用),可以将此链接转成二维码交付给客户。此页面支持pdf/ofd/xml三种格式发票下载。</td> </tr> </tbody> </table> <h5>请求示例</h5> <pre><code class="language-java">{ &amp;quot;xsdh&amp;quot;:&amp;quot;2021101100000001&amp;quot; }</code></pre> <h5>返回示例</h5> <pre><code class="language-json">成功: { &amp;quot;rtnCode&amp;quot;:&amp;quot;success&amp;quot;, &amp;quot;rtnMsg&amp;quot;:&amp;quot;操作成功&amp;quot;, &amp;quot;fpzt&amp;quot;:&amp;quot;2&amp;quot;, &amp;quot;fjh&amp;quot;:&amp;quot;0-1&amp;quot;, &amp;quot;jqbh&amp;quot;:&amp;quot;1234567890&amp;quot;, &amp;quot;fpqqlsh&amp;quot;:&amp;quot;20210101121314123456&amp;quot;, &amp;quot;fwm&amp;quot;:&amp;quot;123123123&amp;quot;, &amp;quot;fpdm&amp;quot;:&amp;quot;014000001234&amp;quot;, &amp;quot;fphm&amp;quot;:&amp;quot;00001234&amp;quot;, &amp;quot;zzfphm&amp;quot;:&amp;quot;00001234&amp;quot;, &amp;quot;kprq&amp;quot;:&amp;quot;2021-01-01&amp;quot;, &amp;quot;fplx&amp;quot;:&amp;quot;0&amp;quot;, &amp;quot;hjbhsje&amp;quot;:&amp;quot;12.0&amp;quot;, &amp;quot;kphjse&amp;quot;:&amp;quot;0.1&amp;quot;, &amp;quot;fpmw&amp;quot;:&amp;quot;123&amp;quot;, &amp;quot;sl&amp;quot;:&amp;quot;0.13&amp;quot;, &amp;quot;kpr&amp;quot;:&amp;quot;张三&amp;quot;, &amp;quot;pdf_file&amp;quot;:&amp;quot;&amp;quot;, &amp;quot;pdf_url&amp;quot;:&amp;quot;http://***/***&amp;quot;, &amp;quot;ewm_url&amp;quot;:&amp;quot;http://***/***&amp;quot; } 失败: {&amp;quot;rtnCode&amp;quot;:&amp;quot;error&amp;quot;,&amp;quot;rtnMsg&amp;quot;: &amp;quot;企业信息没有备案&amp;quot;} </code></pre>

页面列表

ITEM_HTML