聚美智数


发票下载v2

<p>[TOC]</p> <h3>接口描述</h3> <ul> <li>可通过该接口申请已开具和取得的数电发票 xml、 pdf 、ofd版式文件,目前仅支持数电票(0910、0920、61、83)的版式文件下载。</li> </ul> <h3>请求地址</h3> <p><code>https://api.jumdata.com/invoice/download-v2</code></p> <h3>请求方式</h3> <ul> <li>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>fphm</td> <td>String</td> <td>是</td> <td>发票号码</td> </tr> <tr> <td>kprq</td> <td>String</td> <td>是</td> <td>开票日期</td> </tr> <tr> <td>jshj</td> <td>String</td> <td>是</td> <td>价税合计</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,//返回码,详见返回码说明 &amp;quot;charge&amp;quot;: true,//计费标志 &amp;quot;msg&amp;quot;: &amp;quot;成功&amp;quot;,//返回码对应描述 &amp;quot;taskNo&amp;quot;: &amp;quot;784462943162667865971165&amp;quot;,//本次请求号 &amp;quot;data&amp;quot;: { &amp;quot;pdfUrl&amp;quot;: &amp;quot;https://xxxx.pdf&amp;quot;,//pdf版式文件url &amp;quot;ofdUrl&amp;quot;: &amp;quot;https://xxxx.ofd&amp;quot;,//ofd版式文件url &amp;quot;fplx&amp;quot;: &amp;quot;0920&amp;quot;,//发票类型 &amp;quot;kprq&amp;quot;: &amp;quot;2024-04-25 00:00:00&amp;quot;,//开票日期,仅当任务成功时返回精准的时分秒,任务失败仅返回精确到年月日,时分秒都为0 &amp;quot;qdfphm&amp;quot;: &amp;quot;24112000000029123456&amp;quot;,//数电发票号码 &amp;quot;success&amp;quot;: true,//版式文件下载是否成功 &amp;quot;jshj&amp;quot;: 38842.3,//价税合计 &amp;quot;xmlUrl&amp;quot;: &amp;quot;https://xxxx.xml&amp;quot; //xml版式文件url } } </code></pre> <h3>失败返回样例</h3> <pre><code class="language-json">{ &amp;quot;code&amp;quot;: 400, &amp;quot;msg&amp;quot;: &amp;quot;发票号码不能为空&amp;quot;, }</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> <h3>code返回码说明</h3> <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>399</td> <td>税局异常,请稍候再试</td> </tr> <tr> <td>400</td> <td>参数错误</td> </tr> <tr> <td>500</td> <td>系统维护,请稍候再试</td> </tr> <tr> <td>501</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