发票入账
<p>[TOC]</p>
<h3>使用流程</h3>
<h4>第一步 - 提供企业信息</h4>
<p>使用接口之前，需要联系客服，提供企业信息，客服报备后即可使用。
需提供的企业信息包括：企业名称、企业纳税人识别号、企业所在地区（省份）、联系人手机号
另外由于接口计费方式为包年，需提供包年时间段</p>
<h4>第二步 - 登录税局</h4>
<p>需先调用登录接口去登录税局
详见：[登录相关接口](<a href="https://www.showdoc.com.cn/p/0fb3859cda04befe7b8d85a15cfa3335">https://www.showdoc.com.cn/p/0fb3859cda04befe7b8d85a15cfa3335</a> "登录相关接口")</p>
<h4>第三步 - 发票入账</h4>
<p>可调用此接口完成发票入账或将调整已入账发票的入账类型</p>
<h4>第四步 - 发票入账查询</h4>
<p>通过税号查询入账信息。</p>
<hr />
<h3>接口调用说明</h3>
<h4>请求方式</h4>
<p><strong>POST</strong></p>
<h4>请求格式</h4>
<p><strong>application/json</strong></p>
<h4>请求参数</h4>
<p>请求参数均包括公共参数和业务参数（业务参数见具体接口说明）
需要把<strong>公共参数</strong>放在<strong>请求Header</strong>中提交</p>
<p><a name="公共请求参数"></a></p>
<h5>公共请求参数</h5>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必须</th>
<th><div style="width:420px;">说明</div></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>
</tbody>
</table>
<h5>签名算法说明</h5>
<pre><code>sign = sha256(appId + appSecret + timestamp)</code></pre>
<p>用服务商分配的 <strong>appId</strong>、服务商分配的 <strong>appSecret</strong>，当前时间戳（毫秒） <strong>timestamp</strong>，按上述顺序拼接成字符串，再进行 <strong>sha256</strong> 哈希得到。如下：</p>
<pre><code class="language-java">String appId = &quot;xyzxy2121zxyz&quot;；
String timestamp = &quot;1555378976238&quot;；
String appSecret = &quot;efcefcef1121cefcefc1212121&quot;；
String str = appId + appSecret + timestamp；
String sign = sha256(str)；</code></pre>
<h4>返回说明</h4>
<h5>返回字段说明</h5>
<p>所有接口均返回以下公共字段：</p>
<table>
<thead>
<tr>
<th>字段名</th>
<th><div style="width:420px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>code</td>
<td>返回码，详见：code返回码说明</td>
</tr>
<tr>
<td>msg</td>
<td>code对应的描述</td>
</tr>
<tr>
<td>charge</td>
<td>计费标志 true为计费，false为不计费</td>
</tr>
<tr>
<td>taskNo</td>
<td>本次请求号</td>
</tr>
<tr>
<td>data</td>
<td>返回具体结果，object类型，详见data返回字段描述</td>
</tr>
</tbody>
</table>
<p><a name="code返回码说明"></a></p>
<h5>code返回码说明</h5>
<table>
<thead>
<tr>
<th>code</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>200</td>
<td>成功（计费）</td>
</tr>
<tr>
<td>201</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>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>
<hr />
<h3>发票入账</h3>
<ul>
<li>可调用此接口完成发票入账或将调整已入账发票的入账类型</li>
</ul>
<h4>请求地址</h4>
<p><code>https://api.jumdata.com/invoice/archive/execute</code></p>
<h4>请求格式</h4>
<ul>
<li>application/json</li>
</ul>
<h4>业务参数</h4>
<ul>
<li>样例</li>
</ul>
<pre><code class="language-json">{
&quot;nsrsbh&quot;: &quot;string&quot;,
&quot;data&quot;: {
&quot;params&quot;: [
{
&quot;fphm&quot;: &quot;string&quot;,
&quot;zz_fpdm&quot;: &quot;string&quot;,
&quot;zz_fphm&quot;: &quot;string&quot;,
&quot;kprq&quot;: &quot;string&quot;,
&quot;rzytDm&quot;: &quot;string&quot;,
&quot;rzsj&quot;: &quot;string&quot;,
&quot;fplxDm&quot;: &quot;string&quot;,
&quot;fpkjztDm&quot;: &quot;string&quot;,
&quot;fplyDm&quot;: &quot;string&quot;,
&quot;xsf_nsrsbh&quot;: &quot;string&quot;,
&quot;gmf_nsrsbh&quot;: &quot;string&quot;
}
]
}
}
</code></pre>
<h4>参数说明</h4>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必须</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>nsrsbh</td>
<td>String</td>
<td>是</td>
<td>税号</td>
</tr>
<tr>
<td>data.params</td>
<td>String</td>
<td>是</td>
<td>发票信息，详见data.params说明</td>
</tr>
</tbody>
</table>
<p>data.params说明</p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必须</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>fphm</td>
<td>String</td>
<td>否</td>
<td>数电票号码，数电票必传</td>
</tr>
<tr>
<td>zz_fpdm</td>
<td>String</td>
<td>否</td>
<td>发票代码，增值税发票必传</td>
</tr>
<tr>
<td>zz_fphm</td>
<td>String</td>
<td>否</td>
<td>发票号码，增值税发票必传</td>
</tr>
<tr>
<td>kprq</td>
<td>String</td>
<td>是</td>
<td>开票日期，格式：yyyy-MM-dd HH:mm:ss</td>
</tr>
<tr>
<td>rzytDm</td>
<td>String</td>
<td>是</td>
<td>入账用途代码<br/>02：已入账（企业所得税税前扣除）<br/>03：已入账（企业所得税不扣除）<br/>06：入账撤销<br/>04：已入账(个体工商企业所得税税前扣除)<br/>05：已入账(个体工商所得税不扣除)</td>
</tr>
<tr>
<td>rzsj</td>
<td>String</td>
<td>是</td>
<td>入账时间（yyyy-MM-dd）</td>
</tr>
<tr>
<td>fplxDm</td>
<td>String</td>
<td>否</td>
<td>发票类型代码<br/>01：增值税专用发票<br/>03：机动车销售统一发票<br/>04：增值税普通发票<br/>08：增值税专用发票（电子）<br/>10：增值税普通发票（电子）<br/>11：增值税普通发票（卷票）<br/>14：通行费发票<br/>15：二手车统一销售发票<br/>17：海关缴款书<br/>81：电子发票(增值税专用发票)<br/>82：电子发票(增值税普通发票)<br/>84：纸质发票(增值税专用发票)<br/>85：纸质发票(增值税普通发票)<br/>83：数电票（机动车销售统一发票）<br/>87：数电纸质发票（机动车销售统一发票）<br/>70：数电票（二手车销售统一发票）<br/>88：数电纸质发票（二手车销售统一发票）<br/>51：数电票(铁路)<br/>61：数电票(航空)</td>
</tr>
<tr>
<td>fpkjztDm</td>
<td>String</td>
<td>否</td>
<td>发票状态代码<br/>0：正常<br/>2：已作废<br/>8：已红冲-全额<br/>3：已红冲-全额<br/>7：已红冲-部分</td>
</tr>
<tr>
<td>fplyDm</td>
<td>String</td>
<td>否</td>
<td>发票来源，1：增值税发票管理系统，2：电子发票服务平台</td>
</tr>
<tr>
<td>xsf_nsrsbh</td>
<td>String</td>
<td>否</td>
<td>销售方纳税人识别号</td>
</tr>
<tr>
<td>gmf_nsrsbh</td>
<td>String</td>
<td>否</td>
<td>购买方纳税人识别号</td>
</tr>
</tbody>
</table>
<h4>成功返回样例</h4>
<pre><code class="language-json">{
&quot;code&quot;: 200,//返回码，详见返回码说明
&quot;msg&quot;: &quot;成功&quot;,//返回码对应描述
&quot;taskNo&quot;: &quot;329903325198037812330158&quot;,//本次请求号
&quot;charge&quot;: false,//计费标志
&quot;data&quot;: {
&quot;rzuuid&quot;: &quot;bcb87699dfd94478a462e2ad01234567&quot;//入账uuid
}
}</code></pre>
<h4>失败返回样例</h4>
<pre><code class="language-json">{
&quot;code&quot;: 400,//返回码，详见返回码说明
&quot;msg&quot;: &quot;未查询到入账信息!&quot;//返回码对应描述
}</code></pre>
<hr />
<h3>发票入账查询</h3>
<h4>请求地址</h4>
<p><code>https://api.jumdata.com/invoice/archive/search</code></p>
<h4>请求格式</h4>
<ul>
<li>application/json</li>
</ul>
<h4>业务参数</h4>
<ul>
<li>样例</li>
</ul>
<pre><code class="language-json">{
&quot;nsrsbh&quot;: &quot;string&quot;,
&quot;data&quot;: {
&quot;pageIndex&quot;: &quot;string&quot;,
&quot;pageSize&quot;: &quot;string&quot;,
&quot;params&quot;: [
{
&quot;range&quot;: &quot;string&quot;,
&quot;kprqq&quot;: &quot;string&quot;,
&quot;kprqz&quot;: &quot;string&quot;,
&quot;fply&quot;: &quot;string&quot;,
&quot;fplxDm&quot;: &quot;array[]&quot;,
&quot;fpztDm&quot;: &quot;array[]&quot;,
&quot;fphm&quot;: &quot;string&quot;,
&quot;zz_fpdm&quot;: &quot;string&quot;,
&quot;zz_fphm&quot;: &quot;string&quot;,
&quot;xsfnsrsbh&quot;: &quot;string&quot;,
&quot;xsfmc&quot;: &quot;string&quot;,
&quot;fpkjfxlxDm&quot;: &quot;string&quot;,
&quot;rzyts&quot;: &quot;array[]&quot;
}
]
}
}
</code></pre>
<h4>参数说明</h4>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必须</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>nsrsbh</td>
<td>String</td>
<td>是</td>
<td>税号</td>
</tr>
<tr>
<td>data.pageIndex</td>
<td>String</td>
<td>是</td>
<td>当前页码</td>
</tr>
<tr>
<td>data.pageSize</td>
<td>String</td>
<td>是</td>
<td>每页条数</td>
</tr>
<tr>
<td>data.params</td>
<td>String</td>
<td>是</td>
<td>详见data.params说明</td>
</tr>
</tbody>
</table>
<p>data.params说明</p>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必须</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>range</td>
<td>String</td>
<td>否</td>
<td>获取数据范围，0：全量数据一次性返回 1：全量数据按分页返回</td>
</tr>
<tr>
<td>kprqq</td>
<td>String</td>
<td>是</td>
<td>开票起始日期，yyyy-MM-dd，时间范围不超出3个月</td>
</tr>
<tr>
<td>kprqz</td>
<td>String</td>
<td>是</td>
<td>开票结束日期，yyyy-MM-dd，时间范围不超出3个月</td>
</tr>
<tr>
<td>fply</td>
<td>String</td>
<td>否</td>
<td>1：增值税发票管理系统，2：电子发票服务平台，默认全部</td>
</tr>
<tr>
<td>fplxDm</td>
<td>array</td>
<td>否</td>
<td>发票类型代码，默认全部<br/>01：增值税专用发票<br/>03：机动车销售统一发票<br/>04：增值税普通发票<br/>08：增值税专用发票（电子）<br/>10：增值税普通发票（电子）<br/>11：增值税普通发票（卷票）<br/>14：通行费发票<br/>15：二手车统一销售发票<br/>17：海关缴款书<br/>81：电子发票(增值税专用发票)<br/>82：电子发票(增值税普通发票)<br/>84：纸质发票(增值税专用发票)<br/>85：纸质发票(增值税普通发票)<br/>83：数电票（机动车销售统一发票）<br/>87：数电纸质发票（机动车销售统一发票）<br/>70：数电票（二手车销售统一发票）<br/>88：数电纸质发票（二手车销售统一发票）<br/>51：数电票(铁路)<br/>61：数电票(航空)</td>
</tr>
<tr>
<td>fpztDm</td>
<td>array</td>
<td>否</td>
<td>发票状态代码，默认全部<br/>0：正常<br/>2：已作废<br/>8：已红冲-全额<br/>3：已红冲-全额<br/>7：已红冲-部分</td>
</tr>
<tr>
<td>fphm</td>
<td>String</td>
<td>否</td>
<td>数电票号码</td>
</tr>
<tr>
<td>zz_fpdm</td>
<td>String</td>
<td>否</td>
<td>发票代码</td>
</tr>
<tr>
<td>zz_fphm</td>
<td>String</td>
<td>否</td>
<td>发票号码</td>
</tr>
<tr>
<td>xsfnsrsbh</td>
<td>String</td>
<td>否</td>
<td>销售方纳税人识别号</td>
</tr>
<tr>
<td>xsfmc</td>
<td>String</td>
<td>否</td>
<td>销售方名称</td>
</tr>
<tr>
<td>fpkjfxlxDm</td>
<td>String</td>
<td>否</td>
<td>发票风险等级，默认全部<br/>01：正常<br/>02：异常凭证<br/>03：疑点发票</td>
</tr>
<tr>
<td>rzyts</td>
<td>array</td>
<td>否</td>
<td>入账用途代码，默认全部<br/>02：已入账（企业所得税税前扣除）<br/>03：已入账（企业所得税不扣除）<br/>06：入账撤销<br/>04：已入账(个体工商企业所得税税前扣除)<br/>05：已入账(个体工商所得税不扣除)</td>
</tr>
</tbody>
</table>
<h4>成功返回样例</h4>
<pre><code class="language-json">{
&quot;code&quot;: 200,//返回码，详见返回码说明
&quot;msg&quot;: &quot;成功&quot;,//返回码对应描述
&quot;charge&quot;: false,//计费标志
&quot;taskNo&quot;: &quot;858433144165060857655541&quot;,//本次请求号
&quot;data&quot;: {
&quot;pageIndex&quot;: 1,//当前页码
&quot;records&quot;: 1,//总记录数
&quot;pageSize&quot;: 10,//每页条数
&quot;list&quot;: [
{
&quot;zz_fpdm&quot;: &quot;********1211&quot;,//发票票种代码
&quot;mxuuid&quot;: &quot;&quot;,//入账明细uuid
&quot;rzuuid&quot;: &quot;&quot;,//发票入账uuid
&quot;fpfxdjDm&quot;: &quot;01&quot;,//发票风险等级代码
&quot;fplxmc&quot;: &quot;增值税电子普通发票&quot;,//发票类型名称
&quot;fplyDm&quot;: &quot;1&quot;,//发票来源
&quot;kjhzfpdydlzfphm&quot;: &quot;&quot;,//
&quot;fpkjztmc&quot;: &quot;正常&quot;,//发票开具状态名称
&quot;fppzDm&quot;: &quot;02&quot;,//发票票种代码
&quot;xsf_nsrsbh&quot;: &quot;************G0FB09&quot;,//销售方纳税人识别号
&quot;se&quot;: &quot;17.33&quot;,//税额
&quot;fpfxdjmc&quot;: &quot;正常&quot;,//发票风险等级名称
&quot;fplxDm&quot;: &quot;10&quot;,//发票类型代码
&quot;kprq&quot;: &quot;2024-03-23 10:45:05&quot;,//开票日期
&quot;xsf_nsrmc&quot;: &quot;********有限公司&quot;,//销售方纳税人识别号
&quot;je&quot;: &quot;577.86&quot;,//金额
&quot;fpkjztDm&quot;: &quot;0&quot;,//发票开具状态代码
&quot;zz_fphm&quot;: &quot;****2516&quot;,//发票号码
&quot;gmf_nsrsbh&quot;: &quot;************PDDL2G&quot;,//购买方纳税人识别号
&quot;fphm&quot;: &quot;&quot;,//数电票号码
&quot;fprzztDm&quot;: &quot;00&quot;,//发票入账状态代码
&quot;zhbz&quot;: &quot;N&quot;, //红字锁定标志
&quot;rzsj&quot;: &quot;&quot; //入账时间
}
]
}
}</code></pre>
<h4>失败返回样例</h4>
<pre><code class="language-json">{
&quot;code&quot;: 400,//返回码，详见返回码说明
&quot;msg&quot;: &quot;税号不能为空&quot;//返回码对应描述
}</code></pre>
<hr />