进项发票勾选
<p>[TOC]</p>
<h3>使用流程</h3>
<h4>第一步 -- 提供企业信息</h4>
<p>使用接口之前，需要联系客服，提供企业信息，客服报备后即可使用。
需提供的企业信息包括：企业名称、企业纳税人识别号、企业所在地区（省份）、联系人手机号
另外由于接口计费方式为包年，需提供包年时间段</p>
<h4>第二步 -- 提交进项发票勾选</h4>
<p>进项发票勾选采用异步的方式，先提交进项发票勾选，成功后会返回reqId，用于查询结果接口</p>
<h4>第三步 -- 查询进项发票勾选结果</h4>
<p>通过返回的reqId调用查询接口，获取结果</p>
<hr />
<h3>接口调用说明</h3>
<h4>请求方式</h4>
<p>如接口没有单独说明，所有接口均为：<strong>POST</strong></p>
<h4>请求格式</h4>
<p>如接口没有单独说明，所有接口均为：<strong>application/form-data</strong></p>
<h4>请求参数</h4>
<p>请求参数均包括公共参数和业务参数（业务参数见具体接口说明）
如接口没有单独说明，所有接口调用时，均需要把<strong>公共参数</strong>和<strong>业务参数</strong>一并放在<strong>请求参数</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/deduction/submit</code></p>
<h4>业务参数</h4>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必须</th>
<th><div style="width:400px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>nsrsbh</td>
<td>String</td>
<td>是</td>
<td>企业纳税人识别号</td>
</tr>
<tr>
<td>skssq</td>
<td>String</td>
<td>是</td>
<td>税款所属期，格式 yyyyMM，必填，退税勾选及撤销退税勾选时，传当前月份</td>
</tr>
<tr>
<td>gxlx</td>
<td>String</td>
<td>是</td>
<td>勾选类型，1：抵扣，2：退税，3：代办退税，4：不抵扣，5：逾期，6：撤销抵扣，7：撤销不抵扣，8：撤销逾期，9：勾选抵扣（出口转内销），10：勾选不抵扣（出口转内销），11：撤销抵扣（出口转内销），12：勾选类型代码撤销不抵扣（出口转内销），13：撤销退税</td>
</tr>
<tr>
<td>bdkyy</td>
<td>Integer</td>
<td>否</td>
<td>不抵扣原因 ，当gxlx=4时不为空，即勾选不抵扣时必填，1：用于非应税项目，2：用于免税项目，3：用于集体福利或者个人消费，4：非正常损失的，5：其他</td>
</tr>
<tr>
<td>bdkyyms</td>
<td>String</td>
<td>否</td>
<td>不抵扣原因描述， 当gxlx=4并且bdkyy=5时必填</td>
</tr>
<tr>
<td>list</td>
<td>String</td>
<td>是</td>
<td>勾选发票列表，数组的JSON字符串，例：[{"fpdm": "3300222133","fphm": "36762501","qdfphm": "","zmbh": ""}]，详见勾选发票列表</td>
</tr>
</tbody>
</table>
<h4>勾选发票列表</h4>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必须</th>
<th><div style="width:400px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>fpdm</td>
<td>String</td>
<td>是</td>
<td>发票代码，增值税发票、全电纸质发票必填</td>
</tr>
<tr>
<td>fphm</td>
<td>Integer</td>
<td>是</td>
<td>发票号码，增值税发票、全电纸质发票必填</td>
</tr>
<tr>
<td>qdfphm</td>
<td>Integer</td>
<td>是</td>
<td>全电发票号码(20位)，为全电电子发票时必填，全电纸质发票可为空</td>
</tr>
<tr>
<td>yxse</td>
<td>Integer</td>
<td>否</td>
<td>有效税额，不填默认税额</td>
</tr>
<tr>
<td>zmbh</td>
<td>Integer</td>
<td>否</td>
<td>出口转内销证明编号，出口转内销发票必填</td>
</tr>
</tbody>
</table>
<p>公共请求参数请参阅：<a href="#公共请求参数">公共请求参数</a></p>
<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;reqId&quot;: &quot;509099847312345&quot;//申请勾选 id，用于查询结果接口
}
}</code></pre>
<h4>失败返回样例</h4>
<pre><code class="language-json">{
&quot;charge&quot;: false,//计费标志
&quot;code&quot;: 999,//返回码，详见返回码说明
&quot;msg&quot;: &quot;税款所属期不一致&quot;,//返回码对应描述
&quot;taskNo&quot;: &quot;978357118142279423026581&quot;
}</code></pre>
<hr />
<h3>进项发票勾选结果查询</h3>
<h4>请求地址</h4>
<p><code>https://api.jumdata.com/invoice/deduction/query-result</code></p>
<h4>业务参数</h4>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必须</th>
<th><div style="width:400px">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>nsrsbh</td>
<td>String</td>
<td>是</td>
<td>企业纳税人识别号</td>
</tr>
<tr>
<td>reqId</td>
<td>String</td>
<td>是</td>
<td>申请勾选 id，申请接口返回值</td>
</tr>
</tbody>
</table>
<p>公共请求参数请参阅：<a href="#公共请求参数">公共请求参数</a></p>
<h4>成功返回样例</h4>
<pre><code class="language-json">{
&quot;msg&quot;: &quot;成功&quot;,//返回码对应描述
&quot;code&quot;: 200,//返回码，详见返回码说明
&quot;taskNo&quot;: &quot;724137130167701427733365&quot;,//本次请求号
&quot;charge&quot;: false,//计费标志
&quot;data&quot;: {
&quot;list&quot;: [
{
&quot;fphm&quot;: &quot;36762500&quot;,//发票号码
&quot;qdfphm&quot;: &quot;&quot;, //全电发票号码
&quot;kprq&quot;: &quot;&quot;, // 开票日期，格式 yyyyMMdd
&quot;zmbh&quot;: &quot;&quot;,//出口转内销证明编号
&quot;gfsbh&quot;: &quot;91330110MA2CC1X505&quot;,//购买方纳税人识别号
&quot;fpdm&quot;: &quot;3300222130&quot;,//发票代码
&quot;code&quot;: &quot;FprzBusinessVerification&quot;,//
&quot;fplx&quot;: &quot;01&quot;,//发票类型，具体见字段说明
&quot;cljg&quot;: &quot;2&quot;,//申请勾选的处理结果，具体见字段说明
&quot;message&quot;: &quot;无此票&quot;,//查询结果描述
&quot;zt&quot;: &quot;2&quot;,//状态，1：申请处理中，2：申请处理失败，3：申请处理完成
&quot;gxsj&quot;: &quot;&quot;, // 勾选时间，格式 yyyyMMdd
&quot;gxzt&quot;: &quot;0&quot;,//勾选状态，0未勾选 1已勾选
&quot;gxlx&quot;: &quot;&quot;, // 勾选类型，具体见字段说明
&quot;je&quot;: 113.0, // 金额
&quot;se&quot;: 13.0, // 税额
&quot;yxse&quot;: 13.0, // 有效税额
&quot;skssq&quot;: &quot;&quot;, // 税款所属期，格式 yyyyMM
&quot;yskssq&quot;: &quot;&quot;, // 原税款所属期，格式 yyyyMM，针对历史已认证当期变异常的发票该字段有值，值为历史认证的所属期
&quot;bdkyy&quot;: &quot;&quot;,//不抵扣原因，1 用于非应税项目 2 用于免税项目 3 用于集体福利或者个人消费 4 非正常损失的 5 其他; 当gxlx=4时不为空
&quot;bdkyyms&quot;: &quot;&quot;//不抵扣原因描述，1、2、3、4 字典描述 5 其他-自定义描述;当gxlx=4并且bdkyy=5时必传
}
]
}
}</code></pre>
<h4>失败返回样例</h4>
<pre><code class="language-json">{
&quot;msg&quot;: &quot;查无数据&quot;,//返回码对应描述
&quot;code&quot;: 201,//返回码，详见返回码说明
&quot;taskNo&quot;: &quot;832359078156879244729823&quot;,//本次请求号
&quot;charge&quot;: false //计费标志
}</code></pre>
<h4>发票类型</h4>
<table>
<thead>
<tr>
<th>类型</th>
<th>类型描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>01</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>10</td>
<td>增值税电子普通发票</td>
</tr>
<tr>
<td>17</td>
<td>海关缴款书</td>
</tr>
<tr>
<td>61</td>
<td>全电发票（航空运输电子客票行程单）</td>
</tr>
<tr>
<td>83</td>
<td>全电发票（铁路电子客票）</td>
</tr>
<tr>
<td>81</td>
<td>全电发票(增值税专用发票)</td>
</tr>
<tr>
<td>82</td>
<td>全电发票（增值税普通发票）</td>
</tr>
<tr>
<td>85</td>
<td>全电纸质发票(增值税专用发票)</td>
</tr>
<tr>
<td>86</td>
<td>全电纸质发票（增值税普通发票）</td>
</tr>
<tr>
<td>87</td>
<td>机动车销售电子统一发票</td>
</tr>
</tbody>
</table>
<p>注 24、30、80 为出口转内销发票类型，61、81、82、83、85、86为全电发票类型</p>
<h4>申请勾选的处理结果</h4>
<table>
<thead>
<tr>
<th>类型</th>
<th>类型描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>成功</td>
</tr>
<tr>
<td>2</td>
<td>无此票</td>
</tr>
<tr>
<td>3</td>
<td>该票异常无法认证</td>
</tr>
<tr>
<td>4</td>
<td>该票已经认证</td>
</tr>
<tr>
<td>5</td>
<td>不在可勾选范围内，可勾选[2017-01-01 至 当前税款所属期]的发票</td>
</tr>
<tr>
<td>6</td>
<td>该票已经申请认证</td>
</tr>
<tr>
<td>7</td>
<td>申请认证月份已过期</td>
</tr>
<tr>
<td>8</td>
<td>其它异常</td>
</tr>
<tr>
<td>9</td>
<td>认证类型错误</td>
</tr>
<tr>
<td>10</td>
<td>该票不可勾选为逾期</td>
</tr>
<tr>
<td>11</td>
<td>有效税额异常（有效税额大于实际税额)</td>
</tr>
<tr>
<td>12</td>
<td>当期已锁定</td>
</tr>
<tr>
<td>13</td>
<td>该缴款书已申请核查</td>
</tr>
<tr>
<td>14</td>
<td>税额为零不可勾选</td>
</tr>
<tr>
<td>15</td>
<td>该票未到期</td>
</tr>
<tr>
<td>16</td>
<td>红票不能抵扣</td>
</tr>
<tr>
<td>17</td>
<td>发票未勾选（确认）</td>
</tr>
<tr>
<td>18</td>
<td>取消操作不匹配</td>
</tr>
<tr>
<td>19</td>
<td>不抵扣原因为空或异常</td>
</tr>
<tr>
<td>20</td>
<td>该票未抵扣，无法撤销抵扣</td>
</tr>
</tbody>
</table>
<h4>勾选类型</h4>
<table>
<thead>
<tr>
<th>类型</th>
<th>类型描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>抵扣</td>
</tr>
<tr>
<td>2</td>
<td>退税</td>
</tr>
<tr>
<td>3</td>
<td>代办退税</td>
</tr>
<tr>
<td>4</td>
<td>不抵扣</td>
</tr>
<tr>
<td>5</td>
<td>逾期</td>
</tr>
<tr>
<td>6</td>
<td>撤销抵扣</td>
</tr>
<tr>
<td>7</td>
<td>撤销不抵扣</td>
</tr>
<tr>
<td>8</td>
<td>撤销逾期</td>
</tr>
<tr>
<td>9</td>
<td>勾选抵扣（出口转内销）</td>
</tr>
<tr>
<td>10</td>
<td>勾选不抵扣（出口转内销）</td>
</tr>
<tr>
<td>11</td>
<td>撤销抵扣（出口转内销）</td>
</tr>
<tr>
<td>12</td>
<td>勾选类型代码撤销不抵扣（出口转内销）</td>
</tr>
<tr>
<td>13</td>
<td>撤销退税</td>
</tr>
</tbody>
</table>