聚美智数


区块链发票查验(停用)

<h3>接口描述</h3> <ul> <li>查验区块链发票是否正确</li> </ul> <h3>请求地址</h3> <p><code>https://api.jumdata.com/blockchain-invoice/validate</code></p> <h3>请求方式</h3> <ul> <li>GET/POST</li> </ul> <h3>请求格式</h3> <ul> <li>x-www-form-urlencoded</li> </ul> <h3>请求参数</h3> <table> <thead> <tr> <th>名称</th> <th>类型</th> <th>必须</th> <th>&lt;div style=&quot;width:400px&quot;&gt;说明&lt;/div&gt;</th> </tr> </thead> <tbody> <tr> <td>appId</td> <td>String</td> <td>是</td> <td>服务商分配的唯一标识</td> </tr> <tr> <td>timestamp</td> <td>Long</td> <td>是</td> <td>当前时间戳</td> </tr> <tr> <td>sign</td> <td>String</td> <td>是</td> <td>签名,详见签名算法说明</td> </tr> <tr> <td>fpdm</td> <td>String</td> <td>否</td> <td>发票代码 【注意:全电发票可不输入,其他发票一定要输入】</td> </tr> <tr> <td>fphm</td> <td>String</td> <td>是</td> <td>发票号码</td> </tr> <tr> <td>kprq</td> <td>String</td> <td>是</td> <td>开票日期 格式YYYYMMDD</td> </tr> <tr> <td>fpje</td> <td>String</td> <td>是</td> <td>增值税专用发票、增值税电子专用发票、机动车销售统一发票输入不含税金额;&lt;/br&gt; 增值税普通发票、增值税电子普通发票、增值税普通发票(卷式发票)、 通行费发票 输入校验码后6位;&lt;/br&gt; 二手车发票 输入车价合计金额;&lt;/br&gt; 全电发票、货运运输业增值税专用发票 输入价税合计金额;&lt;/br&gt; 区块链发票 输入【不含税金额#校验码】</td> </tr> </tbody> </table> <h3>签名算法说明</h3> <p><code>sign = sha256(appId + appSecret + timestamp)</code></p> <p>用服务商分配的 appId、服务商分配的 appSecret,当前时间时间戳 timestamp,按上述顺序拼接成字符串,再进行 sha256 哈希得到。如下:</p> <pre><code class="language-java">String appId = &amp;quot;xyzxy2121zxyz&amp;quot;; String timestamp = &amp;quot;1555378976238&amp;quot;; String appSecret = &amp;quot;efcefcef1121cefcefc1212121&amp;quot;; String str = appId + appSecret + timestamp; String sign = sha256(str);</code></pre> <h3>成功返回样例</h3> <pre><code class="language-json">{ &amp;quot;code&amp;quot;: 200,// 详见code返回码说明 &amp;quot;msg&amp;quot;: &amp;quot;成功&amp;quot;,//code对应的描述 &amp;quot;taskNo&amp;quot;: &amp;quot;06291853400264736490&amp;quot;,// 本次请求号 &amp;quot;charge&amp;quot;: true,//计费标志 &amp;quot;data&amp;quot;: { &amp;quot;result&amp;quot;: 1,//1表示一致 2表示不一致 &amp;quot;message&amp;quot;: &amp;quot;一致&amp;quot;, &amp;quot;info&amp;quot;: { &amp;quot;xfsbh&amp;quot;: &amp;quot;91370125MA3N4MYJ7Q&amp;quot;,//销方税号 &amp;quot;mxzb&amp;quot;: [//明细 { &amp;quot;sE&amp;quot;: &amp;quot;***&amp;quot;,//税额 &amp;quot;sPSL&amp;quot;: &amp;quot;&amp;quot;,//数量 &amp;quot;dW&amp;quot;: &amp;quot;&amp;quot;,//单位 &amp;quot;mC&amp;quot;: &amp;quot;*农副食品*农副产品&amp;quot;,//名称 &amp;quot;dJ&amp;quot;: &amp;quot;&amp;quot;,//单价 &amp;quot;sL&amp;quot;: &amp;quot;免税&amp;quot;,//税率 &amp;quot;jE&amp;quot;: &amp;quot;61.70&amp;quot;,//金额 &amp;quot;gGXH&amp;quot;: &amp;quot;&amp;quot;//规格型号 } ], &amp;quot;gfsbh&amp;quot;: &amp;quot;&amp;quot;,//购方税号 &amp;quot;fpdm&amp;quot;: &amp;quot;037002200104&amp;quot;,//发票代码 &amp;quot;gfyhzh&amp;quot;: &amp;quot;&amp;quot;,//购方银行账户 &amp;quot;gfmc&amp;quot;: &amp;quot;个人&amp;quot;,//购方名称 &amp;quot;fplx&amp;quot;: &amp;quot;山东增值税普通发票&amp;quot;,//发票类型 01专票,03机动车,04普票,08 电子专票,09 区块链发票,10电子票,11卷式发票,14通行费发票,15二手车发票,81 全电专票,82全电普票 &amp;quot;xfyhzh&amp;quot;: &amp;quot;齐鲁银行济阳闻韶支行86611752101421000522&amp;quot;,//销方银行账户 &amp;quot;se&amp;quot;: &amp;quot;***&amp;quot;,//税额 &amp;quot;fplxdm&amp;quot;: &amp;quot;04&amp;quot;,//发票类型代码 详见(发票类型代码列表) &amp;quot;kprq&amp;quot;: &amp;quot;20221112&amp;quot;,//开票日期 &amp;quot;gfdzdh&amp;quot;: &amp;quot;&amp;quot;,////购方地址电话 &amp;quot;bz&amp;quot;: &amp;quot;&amp;quot;,//备注 &amp;quot;jshj&amp;quot;: &amp;quot;61.70&amp;quot;,//价税合计 &amp;quot;xfdzdh&amp;quot;: &amp;quot;济南市济阳区济北开发区富强街38号(颐仙阁小区对过) 13505414169&amp;quot;,//销方地址电话 &amp;quot;je&amp;quot;: &amp;quot;61.70&amp;quot;,//金额 &amp;quot;xfmc&amp;quot;: &amp;quot;济南瑞福业商贸有限公司&amp;quot;,//销方名称 &amp;quot;zfbz&amp;quot;: &amp;quot;N&amp;quot;,//作废标志Y:作废,N正常3代表红冲 7代表部分红冲 8代表全额冲红 &amp;quot;fphm&amp;quot;: &amp;quot;03397415&amp;quot;,//发票号码 &amp;quot;qdbz&amp;quot;: &amp;quot;N&amp;quot;//清单标志,此值部分情况下可能不准确,部分渠道来源此标志丢失,系统根据是否超过8行生成 } } } </code></pre> <h3>失败返回样例</h3> <pre><code class="language-json">{ &amp;quot;msg&amp;quot;: &amp;quot;发票代码不能为空&amp;quot;, &amp;quot;code&amp;quot;: 400 }</code></pre> <h3>返回字段说明</h3> <table> <thead> <tr> <th>字段名</th> <th>&lt;div style=&quot;width:400px&quot;&gt;说明&lt;/div&gt;</th> </tr> </thead> <tbody> <tr> <td>code</td> <td>返回码,详见返回码说明</td> </tr> <tr> <td>msg</td> <td>code对应的描述</td> </tr> <tr> <td>charge</td> <td>计费标志</td> </tr> <tr> <td>taskNo</td> <td>本次请求号</td> </tr> <tr> <td>data</td> <td>返回具体结果,详见成功返回样例</td> </tr> </tbody> </table> <h4>发票类型代码列表</h4> <table> <thead> <tr> <th>字段名</th> <th>&lt;div style=&quot;width:420px&quot;&gt;说明&lt;/div&gt;</th> </tr> </thead> <tbody> <tr> <td>01</td> <td>增值税专用发票</td> </tr> <tr> <td>02</td> <td>货运运输业增值税专用发票</td> </tr> <tr> <td>03</td> <td>机动车销售统一发票</td> </tr> <tr> <td>04</td> <td>增值税普通发票</td> </tr> <tr> <td>08</td> <td>增值税专用发票(电子票)</td> </tr> <tr> <td>09</td> <td>区块链发票</td> </tr> <tr> <td>10</td> <td>增值税普通发票(电子票)</td> </tr> <tr> <td>11</td> <td>增值税普通发票(卷式发票)</td> </tr> <tr> <td>14</td> <td>通行费发票</td> </tr> <tr> <td>15</td> <td>二手车发票</td> </tr> <tr> <td>81</td> <td>全电专票</td> </tr> <tr> <td>82</td> <td>全电普票</td> </tr> </tbody> </table> <h4>code返回码说明</h4> <table> <thead> <tr> <th>code</th> <th>&lt;div style=&quot;width:400px&quot;&gt;说明&lt;/div&gt;</th> </tr> </thead> <tbody> <tr> <td>200</td> <td>成功(计费)</td> </tr> <tr> <td>201</td> <td>查无数据(计费)</td> </tr> <tr> <td>202</td> <td>查询发票不规范(修改数据后进行查验)(计费)</td> </tr> <tr> <td>203</td> <td>超过一年的不能查验(废弃 支持五年之内的发票查验)(计费)</td> </tr> <tr> <td>204</td> <td>超过该张票当天查验次数(计费)</td> </tr> <tr> <td>400</td> <td>参数错误</td> </tr> <tr> <td>404</td> <td>请求地址不正确</td> </tr> <tr> <td>500</td> <td>服务商维护,请稍候再试</td> </tr> <tr> <td>601</td> <td>接口未开通</td> </tr> <tr> <td>602</td> <td>账号停用</td> </tr> <tr> <td>603</td> <td>余额不足请充值</td> </tr> <tr> <td>604</td> <td>接口停用</td> </tr> <tr> <td>606</td> <td>调用超限,请稍候再试</td> </tr> <tr> <td>607</td> <td>ip不在白名单</td> </tr> <tr> <td>609</td> <td>请求过于频繁,请稍候再试</td> </tr> <tr> <td>610</td> <td>请求超时</td> </tr> <tr> <td>999</td> <td>其他,以实际返回为准</td> </tr> </tbody> </table>

页面列表

ITEM_HTML