发票开具-数电
<p>[TOC]</p>
<h3>1 使用流程</h3>
<h4>1.1 第一步 -- 登录税局</h4>
<p>发票开具需先调用登录接口去登录税局
详见：[登录相关接口](<a href="https://www.showdoc.com.cn/p/0fb3859cda04befe7b8d85a15cfa3335">https://www.showdoc.com.cn/p/0fb3859cda04befe7b8d85a15cfa3335</a> "登录相关接口")
> 登录之后，如果登录未过期，可一直发起开票任务，如果过期则再次调用登录接口
> 每次发起开票任务，需要判断登录是否过期（调用判断登录状态接口）</p>
<h4>1.2 第二步 -- 实名认证</h4>
<p>登录之后还需要实名认证，步骤如下：</p>
<ol>
<li>调用获取人脸识别认证二维码接口获取二维码</li>
<li>用<strong>税务App</strong>扫码进行人脸识别</li>
<li>再调用获取人脸识别认证结果接口获取认证结果</li>
</ol>
<h4>1.3 第三步 -- 开票</h4>
<p>发票开具为异步方式，步骤如下：</p>
<ol>
<li>调用发起开票任务接口，返回任务id</li>
<li>用返回的任务id，调用发票开具结果查询接口，即可查询开票结果，结果主要包括：发票号码和开票日期</li>
<li>再用返回的发票号码和开票日期，调用发票下载接口，即可获取发票文件，支持（PDF, OFD, XML）</li>
</ol>
<hr />
<h3>2 接口调用说明</h3>
<h4>2.1 请求方式</h4>
<p>如接口没有单独说明，均为：<strong>POST</strong></p>
<h4>2.2 请求格式</h4>
<p>如接口没有单独说明，所有接口均为：application/x-www-form-urlencoded</p>
<h4>2.3 请求参数</h4>
<p>请求参数包括公共参数和业务参数（业务参数见具体接口说明）
如果请求格式为application/x-www-form-urlencoded的，需要把<strong>公共参数</strong>和<strong>业务参数</strong>一并放在<strong>请求参数</strong>中提交
如果请求格式为application/json的，需要把<strong>公共参数</strong>放在<strong>请求Header</strong>中提交</p>
<h5>2.3.1 公共参数</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>签名，详见<a href="#签名算法">签名算法说明</a></td>
</tr>
</tbody>
</table>
<h5>2.3.2 签名算法说明</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>2.4 返回说明</h4>
<h5>2.4.1 公共返回字段说明</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>taskNo</td>
<td>本次请求号</td>
</tr>
<tr>
<td>data</td>
<td>返回具体结果，object类型，详见各接口返回说明</td>
</tr>
</tbody>
</table>
<p><a name="code返回码说明"></a></p>
<h5>2.4.2 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>202</td>
<td>商品编码不存在</td>
</tr>
<tr>
<td>211</td>
<td>已生成二维码未扫脸</td>
</tr>
<tr>
<td>212</td>
<td>二维码已过期</td>
</tr>
<tr>
<td>220</td>
<td>本次开具任务未开具新的发票，开具结果为上次开具成功的信息</td>
</tr>
<tr>
<td>221</td>
<td>开票任务执行中</td>
</tr>
<tr>
<td>222</td>
<td>开票任务待下一次执行</td>
</tr>
<tr>
<td>229</td>
<td>开票任务执行失败</td>
</tr>
<tr>
<td>301</td>
<td>纳税人未登录或登录失效, 请重新登录</td>
</tr>
<tr>
<td>302</td>
<td>开票员须扫脸认证</td>
</tr>
<tr>
<td>399</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>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>
</tbody>
</table>
<hr />
<h3>3 基础接口</h3>
<h4>3.1 获取人脸识别认证二维码</h4>
<ul>
<li>通过本接口可获取当前登录用户人脸识别认证使用的二维码</li>
<li>用<strong>税务App</strong>或<strong>个税App</strong>扫码进行人脸识别认证</li>
<li>因税局变更，在调完本接口，完成人脸识别后必须去请求：获取人脸识别认证结果，该扫脸认证方可生效</li>
</ul>
<h5>3.1.1 请求地址</h5>
<p><code>https://api.jumdata.com/invoice/makeout/authentication/qrcode</code></p>
<h5>3.1.2 业务参数</h5>
<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>type</td>
<td>String</td>
<td>是</td>
<td>扫码方式，1-税务app，2-个税app</td>
</tr>
</tbody>
</table>
<h5>3.1.3 返回说明</h5>
<pre><code class="language-json">{
&quot;code&quot;: 200, // 详见code返回码说明
&quot;msg&quot;: &quot;成功&quot;,
&quot;taskNo&quot;: &quot;69564903663951243279&quot;,
&quot;data&quot;: {
&quot;qrcodeContent&quot;:&quot;&quot;, // 二维码内容
&quot;qrcodeImageUrl&quot;:&quot;&quot;, // 二维码图片地址，有效期30分钟
&quot;authenticationId&quot;:&quot;&quot; // 认证ID，通过该ID可查询是否已刷脸状态
}
}</code></pre>
<h4>3.2 获取人脸识别认证结果</h4>
<ul>
<li>通过本接口可获取当前登录用户人脸识别的结果</li>
</ul>
<h5>3.2.1 请求地址</h5>
<p><code>https://api.jumdata.com/invoice/makeout/authentication/result</code></p>
<h5>3.2.2 业务参数</h5>
<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>authenticationId</td>
<td>String</td>
<td>是</td>
<td>获取人脸识别认证二维码返回的认证ID</td>
</tr>
<tr>
<td>type</td>
<td>String</td>
<td>是</td>
<td>扫码方式，1-税务app，2-个税app</td>
</tr>
</tbody>
</table>
<h5>3.2.3 返回样例</h5>
<ul>
<li>认证成功</li>
</ul>
<pre><code class="language-json">{
&quot;code&quot;: 200,
&quot;msg&quot;: &quot;成功&quot;,
&quot;taskNo&quot;: &quot;69564903663951243279&quot;
}</code></pre>
<ul>
<li>已生成二维码未扫脸</li>
</ul>
<pre><code class="language-json">{
&quot;code&quot;: 211,
&quot;msg&quot;: &quot;已生成二维码未扫脸&quot;,
&quot;taskNo&quot;: &quot;69564903663951243279&quot;
}</code></pre>
<ul>
<li>二维码已过期</li>
</ul>
<pre><code class="language-json">{
&quot;code&quot;: 212,
&quot;msg&quot;: &quot;二维码已过期&quot;,
&quot;taskNo&quot;: &quot;69564903663951243279&quot;
}</code></pre>
<h4>3.3 开票人授信查询</h4>
<ul>
<li>通过本接口可获取当前登录纳税人的风险等级，预警等级等授信信息</li>
</ul>
<h5>3.3.1 请求地址</h5>
<p><code>https://api.jumdata.com/invoice/makeout/authentication/query</code></p>
<h5>3.3.2 业务参数</h5>
<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>
</tbody>
</table>
<h5>3.3.3 返回样例</h5>
<ul>
<li>成功</li>
</ul>
<pre><code class="language-json">{
&quot;code&quot;: 200,
&quot;msg&quot;: &quot;成功&quot;,
&quot;taskNo&quot;: &quot;69564903663951243279&quot;,
&quot;data&quot;: {
&quot;sfsl&quot;: &quot;Y&quot;, // 开票前是否需要刷脸, Y或null - 需要刷脸, N - 无需刷脸，建议用户在获取到sfsl不为&#039;N&#039;时，触发刷脸程序
&quot;yjjb&quot;: &quot;01&quot;, // 预警级别 01 - 无预警, 02 - 红色预警, 03 - 黄色预警, 04 - 蓝色预警
&quot;sxlb&quot;: &quot;3&quot; // 授信类别 1 - 高风险纳税人, 2 - 中风险纳税人, 3 - 低风险纳税人, 4 - 无风险纳税人
}
}</code></pre>
<h4>3.4 获取企业基本信息</h4>
<ul>
<li>通过本接口从局端实时获取当前登录的企业基本信息</li>
</ul>
<h5>3.4.1 请求地址</h5>
<p><code>https://api.jumdata.com/invoice/makeout/enterprise/info</code></p>
<h5>3.4.2 业务参数</h5>
<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>
</tbody>
</table>
<h5>3.4.3 返回样例</h5>
<ul>
<li>成功</li>
</ul>
<pre><code class="language-json">{
&quot;msg&quot;: &quot;成功&quot;,
&quot;code&quot;: 200,
&quot;taskNo&quot;: &quot;611371840179292970761885&quot;,
&quot;data&quot;: {
&quot;Nsrmc&quot;: &quot;********信息有限公司&quot;,//纳税人名称
&quot;Yxqz&quot;: &quot;&quot;,
&quot;JdxzDm&quot;: &quot;310118105&quot;,
&quot;Nsrsbh&quot;: &quot;************PDDL2G&quot;,//纳税人识别号
&quot;Sfkkjzzfp&quot;: &quot;Y&quot;,//是否可开具增值税发票
&quot;Qyhyxz&quot;: [],//企业行业性质
&quot;Kpr&quot;: &quot;**鑫&quot;,//默认开票人
&quot;Tdys&quot;: [
{
&quot;Tdyslxdm&quot;: &quot;03&quot;,//特定业务类型代码
&quot;Tdyslxmc&quot;: &quot;建筑服务&quot;//特定业务类型名称
}
],
&quot;Bsrxm&quot;: &quot;*磊&quot;,//办税人姓名
&quot;Fpzldms&quot;: [//可开具的发票种类代码
{
&quot;Fpzldm&quot;: &quot;01&quot;,//发票种类代码,01：增值税专用发票， 02：普通发票
&quot;Fpzlmc&quot;: &quot;增值税专用发票&quot; //发票种类名称
}
],
&quot;ProvinceId&quot;: &quot;3100&quot;,//所在省市
&quot;Nsrztdm&quot;: &quot;03&quot;,//纳税人状态代码
&quot;Fxnsrlx&quot;: &quot;&quot;,
&quot;Xdpsdqybz&quot;: &quot;&quot;,
&quot;Djzclxdm&quot;: &quot;173&quot;,//登记注册类型代码
&quot;Jyfw&quot;: &quot;许可项单位xxxxx&quot;,//经营范围
&quot;Ssdabh&quot;: &quot;************PDDL2G&quot;,
&quot;Qxjswjgdm&quot;: &quot;13102290000&quot;,
&quot;Ckqyfldm&quot;: &quot;&quot;,
&quot;Province&quot;: &quot;上海&quot;,//所在省或市
&quot;Dqskssq&quot;: &quot;202403&quot;,//当前税款所属期
&quot;Xfsnsrlx&quot;: [],
&quot;Zcdz&quot;: &quot;******************弄1-72号B座12层&quot;,//注册地址
&quot;Yxqq&quot;: &quot;&quot;,
&quot;Djxh&quot;: &quot;************00644278&quot;,//纳税人登记序号
&quot;Rylb&quot;: &quot;09&quot;,
&quot;Zfjglxdm&quot;: &quot;0&quot;,
&quot;Jzjtbz&quot;: &quot;N&quot;,
&quot;Djrq&quot;: &quot;2021-07-19 00:00:00&quot;,
&quot;Xydj&quot;: &quot;&quot;,
&quot;Fxnsrbz&quot;: &quot;&quot;,
&quot;Sbzt&quot;: &quot;&quot;,
&quot;Scjydz&quot;: &quot;******************弄1-72号B座12层&quot;,//生产经营地址
&quot;Scjydlxdh&quot;: &quot;******98617&quot;,//生产经营地联系电话
&quot;ProviceId&quot;: &quot;3100&quot;,//地区代码
&quot;Nsryjjb&quot;: &quot;&quot;,
&quot;Cwfzrxm&quot;: &quot;*敏&quot;,//财务负责人姓名
&quot;Hydm&quot;: &quot;6599&quot;,//行业代码
&quot;Zcdlxdh&quot;: &quot;******98617&quot;,//注册地联系电话
&quot;Dsjswjgdm&quot;: &quot;13100000000&quot;,
&quot;Dqsj&quot;: &quot;20240308&quot;,//当前时间
&quot;Ssglyxm&quot;: &quot;&quot;,
&quot;Swjgdm&quot;: &quot;13102295000&quot;,//税务机关代码
&quot;Qdbz&quot;: &quot;Y&quot;,
&quot;Smkpid&quot;: &quot;&quot;,//扫码开票id
&quot;Ssjswjgdm&quot;: &quot;13100000000&quot;,//所属局税务机关代码
&quot;Swjgmc&quot;: &quot;**************局第十八税务所&quot;,//税务机关名称
&quot;Nsrlx&quot;: &quot;1&quot;,//纳税人类型
&quot;YhxxList&quot;: [//对公账号信息
{
&quot;Yhzh&quot;: &quot;**********10301&quot;,//银行账户
&quot;YhzhxzDm&quot;: &quot;1110&quot;,//银行账户行政代码
&quot;Yhyywdmc&quot;: &quot;**********上海青浦支行&quot;,//银行营业网点名称
&quot;YhyywdDm&quot;: &quot;********3861&quot; //银行营业网点代码
}
],
&quot;Zcdyzbm&quot;: &quot;********3861&quot;, //注册地邮政编码
&quot;Ssglydm&quot;: &quot;********3861&quot; //所属税管员代码
}
}</code></pre>
<hr />
<h4>3.5 获取开票统计信息</h4>
<ul>
<li>通过本接口获取企业发票统计信息</li>
</ul>
<h5>3.5.1 请求地址</h5>
<p><code>https://api.jumdata.com/invoice/makeout/stat</code></p>
<h5>3.5.2 业务参数</h5>
<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>
</tbody>
</table>
<h5>3.5.3 返回样例</h5>
<ul>
<li>成功</li>
</ul>
<pre><code class="language-json">{
&quot;code&quot;: 200,//返回code
&quot;msg&quot;: &quot;成功&quot;,//code对应的说明描述
&quot;taskNo&quot;: &quot;241537187216475387284242&quot;,//本次请求号
&quot;data&quot;: {
&quot;sbbz&quot;: &quot;Y&quot;,
&quot;zsxed&quot;: &quot;7500000.00&quot;,//发票总额度
&quot;syzzfpzs&quot;: &quot;0&quot;,//当前可用纸票数量
&quot;sysxed&quot;: &quot;7457547.17&quot;,//可用发票额度
&quot;bykjlpzs&quot;: &quot;6&quot;,//本月已开具蓝票张数
&quot;zrbz&quot;: &quot;N&quot;,
&quot;fpejse&quot;: &quot;2549.21&quot;,//发票累计税额
&quot;ysyfpzs&quot;: &quot;0&quot;,//已使用发票张数
&quot;ysysxed&quot;: &quot;42452.83&quot;,//已使用发票额度
&quot;fphjje&quot;: &quot;42486.83&quot;//发票合计金额
}
}
</code></pre>
<ul>
<li>失败</li>
</ul>
<pre><code class="language-json">{
&quot;msg&quot;: &quot;税号不能为空&quot;,
&quot;code&quot;: 400
}
</code></pre>
<hr />
<h4>3.6 商品分类查询接口</h4>
<ul>
<li>在电子税务局查询商品分类</li>
</ul>
<h5>3.6.1 请求地址</h5>
<p><code>https://api.jumdata.com/invoice/makeout/product/category</code></p>
<h5>3.6.2 业务参数</h5>
<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>
</tbody>
</table>
<h5>3.6.3 返回样例</h5>
<ul>
<li>成功</li>
</ul>
<pre><code class="language-json">{
&quot;code&quot;: 200, // 返回码，详见code返回码说明
&quot;msg&quot;: &quot;成功&quot;, //code对应的描述
&quot;taskNo&quot;: &quot;12552230716560623515&quot;, // 本次唯一请求号
&quot;charge&quot;: false, // 计费标志
&quot;data&quot;: {
&quot;list&quot;: [
{
&quot;children&quot;: [],//子分类
&quot;fluuid&quot;: &quot;00&quot;,//分类uuid
&quot;tdysFlsDm&quot;: &quot;00&quot;,//目录树代码
&quot;flmc&quot;: &quot;项目信息分类&quot;//分类名称
}
]
}
}</code></pre>
<hr />
<h4>3.7 商品列表查询接口</h4>
<ul>
<li>从电子税务局查询已存在的商品信息列表</li>
</ul>
<h5>3.7.1 请求地址</h5>
<p><code>https://api.jumdata.com/invoice/makeout/product/list</code></p>
<h5>3.7.2 业务参数</h5>
<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>pageNo</td>
<td>Number</td>
<td>是</td>
<td>当前页码</td>
</tr>
<tr>
<td>pageSize</td>
<td>Number</td>
<td>是</td>
<td>每页行数</td>
</tr>
<tr>
<td>xmmc</td>
<td>String</td>
<td>否</td>
<td>指定发票号码查询</td>
</tr>
<tr>
<td>jm</td>
<td>String</td>
<td>否</td>
<td>简码</td>
</tr>
<tr>
<td>ggxh</td>
<td>String</td>
<td>否</td>
<td>对方税号</td>
</tr>
<tr>
<td>slv</td>
<td>String</td>
<td>否</td>
<td>对方纳税人名称</td>
</tr>
<tr>
<td>dj</td>
<td>String</td>
<td>否</td>
<td>单价</td>
</tr>
<tr>
<td>spfwbm</td>
<td>String</td>
<td>否</td>
<td>税收分类编码</td>
</tr>
<tr>
<td>spfwjc</td>
<td>String</td>
<td>否</td>
<td>税收分类名称</td>
</tr>
<tr>
<td>dwdm</td>
<td>String</td>
<td>否</td>
<td>计量单位代码</td>
</tr>
<tr>
<td>dwmc</td>
<td>String</td>
<td>否</td>
<td>计量单位名称</td>
</tr>
<tr>
<td>fluuid</td>
<td>String</td>
<td>否</td>
<td>分类uuid，要查询的商品分类ID, 默认为00</td>
</tr>
</tbody>
</table>
<h5>3.7.3 返回样例</h5>
<ul>
<li>成功</li>
</ul>
<pre><code class="language-json">{
&quot;code&quot;: 200, // 返回码，详见code返回码说明
&quot;msg&quot;: &quot;成功&quot;, //code对应的描述
&quot;taskNo&quot;: &quot;12552230716560623515&quot;, // 本次唯一请求号
&quot;charge&quot;: false, // 计费标志
&quot;data&quot;: {
&quot;records&quot;: 1,//总记录数
&quot;list&quot;: [
{
&quot;zzstsgl&quot;: &quot;&quot;,//增值税简易计税类型 03:免税；08:按3%简易征收
&quot;uuid&quot;: &quot;aa3a19d649374e119881c254710fec28&quot;,//商品UUID
&quot;fluuid&quot;: &quot;00&quot;,//商品分类UUID
&quot;yhzsbz&quot;: &quot;N&quot;,//是否享受优惠政策标志 Y是 / N否 枚举值:01 02 03 04
&quot;spfwbm&quot;: &quot;3040101000000000000&quot;,////税收服务编码
&quot;spfwjc&quot;: &quot;研发和技术服务&quot;,//税收服务简称
&quot;hsbz&quot;: &quot;Y&quot;,
&quot;xmmc&quot;: &quot;技术服务费&quot;,//项目名称
&quot;slv&quot;: &quot;0.06&quot;,//税率
&quot;ggxh&quot;: &quot;0.06&quot;,//规格型号
&quot;dwdm&quot;: &quot;0.06&quot;,//计量单位名称
&quot;jm&quot;: &quot;3040101000000000000&quot;,//简码
&quot;dj&quot;: &quot;0.06&quot;,//单价
&quot;hsbz&quot;: &quot;0.06&quot;,//含税标记 Y含税 / N不含税
}
]
}
}
</code></pre>
<hr />
<h4>3.8 根据商品名称查询税收信息</h4>
<ul>
<li>通过商品名称智能查询相匹配税收编码列表</li>
</ul>
<h5>3.8.1 请求地址</h5>
<p><code>https://api.jumdata.com/invoice/makeout/product/search-taxcode</code></p>
<h5>3.8.2 业务参数</h5>
<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>xmmc</td>
<td>String</td>
<td>是</td>
<td>项目名称/商品名称</td>
</tr>
</tbody>
</table>
<h5>3.8.3 返回样例</h5>
<ul>
<li>成功</li>
</ul>
<pre><code class="language-json">{
&quot;code&quot;: 200, // 返回码，详见code返回码说明
&quot;msg&quot;: &quot;成功&quot;, //code对应的描述
&quot;taskNo&quot;: &quot;12552230716560623515&quot;, // 本次唯一请求号
&quot;charge&quot;: false, // 计费标志
&quot;data&quot;: {
&quot;list&quot;: [
{
&quot;slvList&quot;: [//适用税率
&quot;0.06&quot;
],
&quot;spsjbm&quot;: &quot;3040100000000000000&quot;,//上级编码
&quot;jzjtskbz&quot;: &quot;02&quot;,
&quot;zzscezsbj&quot;: &quot;N&quot;,//增值税差额征收标记 (Y/N)
&quot;zzstsnrdmjh&quot;: &quot;1.06E+08&quot;,//增值税特殊内容代码
&quot;spfwjc&quot;: &quot;研发和技术服务&quot;,//税收简称 (开票时两个**号里面的内容)
&quot;qyrq&quot;: &quot;2019-04-01&quot;,//启用日期
&quot;sphfwssflhbbm&quot;: &quot;3040105000000000000&quot;,//税收编码
&quot;sfhzx&quot;: &quot;N&quot;,
&quot;zzszcyj&quot;: &quot;《财政部 国家税务总局关于印发＜资源综合利用产品和劳务增值税优惠目录＞的通知》（财税〔2015〕78号）&quot;,
&quot;sfbzsbz&quot;: &quot;N&quot;,
&quot;zslList&quot;: [//适用征收率
&quot;0.03&quot;
],
&quot;sm&quot;: &quot;指气象服务、地震服务、海洋服务、测绘服务、城市规划、环境与生态监测服务等专项技术服务。&quot;,//商品说明
&quot;zt&quot;: &quot;Y&quot;,//状态 (Y：正常)
&quot;zzsslhzzsl&quot;: &quot;6%&quot;,
&quot;zzstsglList&quot;: [//增值税特殊管理列表
&quot;即征即退70%&quot;,
&quot;简易征收&quot;
],
&quot;tdyslxDm&quot;: &quot;&quot;,//应税类型代码
&quot;tdyslxmc&quot;: &quot;&quot;,//应税类型名称
&quot;zsljh&quot;: &quot;3%&quot;,
&quot;hyjh&quot;: &quot;I651、I65362&quot;,
&quot;hwhlwmc&quot;: &quot;专业技术服务&quot;//税收名称
}
]
}
}
</code></pre>
<hr />
<h4>3.9 根据商品编码查询税收信息</h4>
<ul>
<li>通过商品编号智能查询相匹配税收编码列表</li>
</ul>
<h5>3.9.1 请求地址</h5>
<p><code>https://api.jumdata.com/invoice/makeout/product/detail</code></p>
<h5>3.9.2 业务参数</h5>
<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>spfwbm</td>
<td>String</td>
<td>是</td>
<td>商品编码</td>
</tr>
</tbody>
</table>
<h5>3.9.3 返回样例</h5>
<ul>
<li>成功</li>
</ul>
<pre><code class="language-json">{
&quot;code&quot;: 200, // 返回码，详见code返回码说明
&quot;msg&quot;: &quot;成功&quot;, //code对应的描述
&quot;taskNo&quot;: &quot;12552230716560623515&quot;, // 本次唯一请求号
&quot;charge&quot;: false, // 计费标志
&quot;data&quot;: {
&quot;list&quot;: [
{
&quot;slvList&quot;: [//适用税率
&quot;0.06&quot;
],
&quot;spsjbm&quot;: &quot;3040100000000000000&quot;,//上级编码
&quot;jzjtskbz&quot;: &quot;02&quot;,
&quot;zzscezsbj&quot;: &quot;N&quot;,//增值税差额征收标记 (Y/N)
&quot;zzstsnrdmjh&quot;: &quot;1.06E+08&quot;,//增值税特殊内容代码
&quot;spfwjc&quot;: &quot;研发和技术服务&quot;,//税收简称 (开票时两个**号里面的内容)
&quot;qyrq&quot;: &quot;2019-04-01&quot;,//启用日期
&quot;sphfwssflhbbm&quot;: &quot;3040105000000000000&quot;,//税收编码
&quot;sfhzx&quot;: &quot;N&quot;,
&quot;zzszcyj&quot;: &quot;《财政部 国家税务总局关于印发＜资源综合利用产品和劳务增值税优惠目录＞的通知》（财税〔2015〕78号）&quot;,
&quot;sfbzsbz&quot;: &quot;N&quot;,
&quot;zslList&quot;: [//适用征收率
&quot;0.03&quot;
],
&quot;sm&quot;: &quot;指气象服务、地震服务、海洋服务、测绘服务、城市规划、环境与生态监测服务等专项技术服务。&quot;,//商品说明
&quot;zt&quot;: &quot;Y&quot;,//状态 (Y：正常)
&quot;zzsslhzzsl&quot;: &quot;6%&quot;,
&quot;zzstsglList&quot;: [//增值税特殊管理列表
&quot;即征即退70%&quot;,
&quot;简易征收&quot;
],
&quot;tdyslxDm&quot;: &quot;&quot;,//应税类型代码
&quot;tdyslxmc&quot;: &quot;&quot;,//应税类型名称
&quot;zsljh&quot;: &quot;3%&quot;,
&quot;hyjh&quot;: &quot;I651、I65362&quot;,
&quot;hwhlwmc&quot;: &quot;专业技术服务&quot;//税收名称
}
]
}
}
</code></pre>
<hr />
<h3>4 开票相关接口</h3>
<h4>4.1 发起开票任务</h4>
<ul>
<li>通过本接口可实现开具全面数字化电子发票</li>
<li>异步方式，调用本接口发起开票任务后，还需要调用<a href="#发票开具结果查询">获取开票结果</a></li>
</ul>
<h5>4.1.1 请求地址</h5>
<p><code>https://api.jumdata.com/invoice/makeout/request</code></p>
<h5>4.1.2 请求格式</h5>
<ul>
<li>application/json</li>
</ul>
<p>> 注：本接口公共参数需要放在请求Header中</p>
<h5>4.1.3 业务参数</h5>
<ul>
<li>样例</li>
</ul>
<pre><code class="language-json">{
&quot;nsrsbh&quot;: &quot;string&quot;,
&quot;data&quot;: {
&quot;ly_ddbh&quot;: &quot;string&quot;,
&quot;fplxdm&quot;: &quot;030&quot;,
&quot;xsf_nsrsbh&quot;: &quot;string&quot;,
&quot;xsf_nsrmc&quot;: &quot;string&quot;,
&quot;xsf_dz&quot;: &quot;string&quot;,
&quot;xsf_dh&quot;: &quot;string&quot;,
&quot;xsf_yhmc&quot;: &quot;string&quot;,
&quot;xsf_yhzh&quot;: &quot;string&quot;,
&quot;gmf_lx&quot;: &quot;string&quot;,
&quot;gmf_nsrsbh&quot;: &quot;string&quot;,
&quot;gmf_nsrmc&quot;: &quot;string&quot;,
&quot;gmf_dz&quot;: &quot;string&quot;,
&quot;gmf_dh&quot;: &quot;string&quot;,
&quot;gmf_yhmc&quot;: &quot;string&quot;,
&quot;gmf_yhzh&quot;: &quot;string&quot;,
&quot;hjje&quot;: &quot;string&quot;,
&quot;hjse&quot;: &quot;string&quot;,
&quot;jshj&quot;: &quot;string&quot;,
&quot;bz&quot;: &quot;string&quot;,
&quot;hsslbs&quot;: &quot;string&quot;,
&quot;xgm_xsyhzc&quot;: &quot;string&quot;,
&quot;gfxx_confirm&quot;: &quot;string&quot;,
&quot;kjje_confirm&quot;: &quot;string&quot;,
&quot;xmmx&quot;: [
{
&quot;fphxz&quot;: &quot;string&quot;,
&quot;spbm&quot;: &quot;string&quot;,
&quot;spmc&quot;: &quot;string&quot;,
&quot;xmmc&quot;: &quot;string&quot;,
&quot;ggxh&quot;: &quot;string&quot;,
&quot;dw&quot;: &quot;string&quot;,
&quot;spsl&quot;: &quot;string&quot;,
&quot;dj&quot;: &quot;string&quot;,
&quot;sl&quot;: &quot;string&quot;,
&quot;je&quot;: &quot;string&quot;,
&quot;se&quot;: &quot;string&quot;,
&quot;slbs&quot;: &quot;string&quot;,
&quot;ssyhzclx&quot;: &quot;string&quot;,
&quot;tdzsfsdm&quot;: &quot;string&quot;
}
],
&quot;tdyslxdm&quot;: &quot;string&quot;,
&quot;hwysfwdzfpmxbList&quot;: [
{
&quot;xh&quot;: &quot;string&quot;,
&quot;ysgjzl&quot;: &quot;string&quot;,
&quot;ysgjhp&quot;: &quot;string&quot;,
&quot;qyd&quot;: &quot;string&quot;,
&quot;ddd&quot;: &quot;string&quot;,
&quot;yshwmc&quot;: &quot;string&quot;
}
],
&quot;bdczyzlxxs&quot;: [
{
&quot;fwcqzshm&quot;: &quot;string&quot;,
&quot;bdcdz&quot;: &quot;string&quot;,
&quot;bdcxxdz&quot;: &quot;string&quot;,
&quot;zlqq&quot;: &quot;string&quot;,
&quot;zlqz&quot;: &quot;string&quot;,
&quot;kdsbz&quot;: &quot;string&quot;,
&quot;mjdw&quot;: &quot;string&quot;,
&quot;cph&quot;: &quot;string&quot;
}
],
&quot;bdcjyxsxxs&quot;: [
{
&quot;fwcqzshm&quot;: &quot;string&quot;,
&quot;bdcdz&quot;: &quot;string&quot;,
&quot;bdcxxdz&quot;: &quot;string&quot;,
&quot;wqhtbabm&quot;: &quot;string&quot;,
&quot;tdzzsxmbh&quot;: &quot;string&quot;,
&quot;hdjsjg&quot;: &quot;string&quot;,
&quot;sjcjhsje&quot;: &quot;string&quot;,
&quot;kdsbz&quot;: &quot;string&quot;,
&quot;mjdw&quot;: &quot;string&quot;
}
],
&quot;jdctyxsxx&quot;: {
&quot;xxmc&quot;: &quot;string&quot;,
&quot;spmc&quot;: &quot;string&quot;,
&quot;spjc&quot;: &quot;string&quot;,
&quot;ssflbm&quot;: &quot;string&quot;,
&quot;je&quot;: &quot;string&quot;,
&quot;sv&quot;: &quot;string&quot;,
&quot;se&quot;: &quot;string&quot;,
&quot;jsheXx&quot;: &quot;string&quot;,
&quot;jshjDx&quot;: &quot;string&quot;,
&quot;cllxDm&quot;: &quot;string&quot;,
&quot;cpxh&quot;: &quot;string&quot;,
&quot;cd&quot;: &quot;string&quot;,
&quot;hgzh&quot;: &quot;string&quot;,
&quot;jkzmsh&quot;: &quot;string&quot;,
&quot;sjdh&quot;: &quot;string&quot;,
&quot;fdjhm&quot;: &quot;string&quot;,
&quot;clsbdh&quot;: &quot;string&quot;,
&quot;cldw&quot;: &quot;string&quot;,
&quot;xcrs&quot;: &quot;string&quot;,
&quot;wspzhm&quot;: &quot;string&quot;,
&quot;scqymc&quot;: &quot;string&quot;,
&quot;swjgmc&quot;: &quot;string&quot;,
&quot;swjgdm&quot;: &quot;string&quot;,
&quot;tdzsfsdm&quot;: &quot;string&quot;,
&quot;zzstsgldm&quot;: &quot;string&quot;,
&quot;jdctzclsbdhuuid&quot;: &quot;string&quot;
},
&quot;dsccsxx&quot;: {
&quot;sfyytljdj&quot;: &quot;string&quot;,
&quot;chhcbdjh&quot;: &quot;string&quot;,
&quot;skssq&quot;: &quot;string&quot;,
&quot;dsccsje&quot;: &quot;string&quot;,
&quot;znjje&quot;: &quot;string&quot;,
&quot;hjje&quot;: &quot;string&quot;,
&quot;cjh&quot;: &quot;string&quot;
},
&quot;lkysfwxx&quot;: [
{
&quot;cxr&quot;: &quot;string&quot;,
&quot;cxrzjlx&quot;: &quot;string&quot;,
&quot;sfzjhm&quot;: &quot;string&quot;,
&quot;cxrq&quot;: &quot;string&quot;,
&quot;cfd&quot;: &quot;string&quot;,
&quot;ddd&quot;: &quot;string&quot;,
&quot;jtgjlx&quot;: &quot;string&quot;,
&quot;dj&quot;: &quot;string&quot;
}
],
&quot;tljlhsgjxx&quot;: {
&quot;sfyytljdj&quot;: &quot;string&quot;,
&quot;fdjbh&quot;: &quot;string&quot;,
&quot;dphgzbh&quot;: &quot;string&quot;
},
&quot;bdcjyxsxx&quot;: {
&quot;fwcqzshm&quot;: &quot;string&quot;,
&quot;bdcdz&quot;: &quot;string&quot;,
&quot;bdcxxdz&quot;: &quot;string&quot;,
&quot;wqhtbabm&quot;: &quot;string&quot;,
&quot;tdzzsxmbh&quot;: &quot;string&quot;,
&quot;hdjsjg&quot;: &quot;string&quot;,
&quot;sjcjhsje&quot;: &quot;string&quot;,
&quot;kdsbz&quot;: &quot;string&quot;,
&quot;mjdw&quot;: &quot;string&quot;
},
&quot;bdczyzlxx&quot;: {
&quot;fwcqzshm&quot;: &quot;string&quot;,
&quot;bdcdz&quot;: &quot;string&quot;,
&quot;bdcxxdz&quot;: &quot;string&quot;,
&quot;zlqq&quot;: &quot;string&quot;,
&quot;zlqz&quot;: &quot;string&quot;,
&quot;kdsbz&quot;: &quot;string&quot;,
&quot;mjdw&quot;: &quot;string&quot;
},
&quot;jzfwxx&quot;: {
&quot;jzfwfs&quot;: &quot;string&quot;,
&quot;fsdxxdz&quot;: &quot;string&quot;,
&quot;jzxmmc&quot;: &quot;string&quot;,
&quot;kdsbz&quot;: &quot;string&quot;,
&quot;tdzzsxmbh&quot;: &quot;string&quot;
},
&quot;escxx&quot;: {
&quot;sdfphm&quot;: &quot;string&quot;,
&quot;zzfpdm&quot;: &quot;string&quot;,
&quot;zzfphm&quot;: &quot;string&quot;,
&quot;escxsfzrrbs&quot;: &quot;string&quot;,
&quot;escxsfdz&quot;: &quot;string&quot;,
&quot;escxsflxdh&quot;: &quot;string&quot;,
&quot;escxsfmc&quot;: &quot;string&quot;,
&quot;escxsfnsrsbh&quot;: &quot;string&quot;,
&quot;escyqrhyxz&quot;: &quot;string&quot;,
&quot;escfwList&quot;: [
{
&quot;clsbdh&quot;: &quot;string&quot;,
&quot;cphm&quot;: &quot;string&quot;,
&quot;cpxh&quot;: &quot;string&quot;,
&quot;djzh&quot;: &quot;string&quot;,
&quot;zrdclglsmc&quot;: &quot;string&quot;
}
]
},
&quot;sfzsgmfyhzh&quot;: &quot;string&quot;,
&quot;sfzsxsfyhzh&quot;: &quot;string&quot;,
&quot;sfzsgmfdzdh&quot;: &quot;string&quot;,
&quot;sfzsxsfdzdh&quot;: &quot;string&quot;,
&quot;cezslxDm&quot;: &quot;string&quot;,
&quot;cepzmxList&quot;: [
{
&quot;fpdm&quot;: &quot;string&quot;,
&quot;fphm&quot;: &quot;string&quot;,
&quot;zzfphm&quot;: &quot;string&quot;,
&quot;pzhm&quot;: &quot;string&quot;,
&quot;kjrq&quot;: &quot;string&quot;,
&quot;bz&quot;: &quot;string&quot;,
&quot;bckcje&quot;: &quot;string&quot;,
&quot;pzhjje&quot;: &quot;string&quot;
}
]
}
}</code></pre>
<ul>
<li>字段说明</li>
</ul>
<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</td>
<td>Object</td>
<td>是</td>
<td>开具内容</td>
</tr>
</tbody>
</table>
<ul>
<li>data字段说明</li>
</ul>
<table>
<thead>
<tr>
<th>字段</th>
<th>类型</th>
<th>必需</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>ly_ddbh</td>
<td>String</td>
<td>是</td>
<td>来源订单编号，指业务系统中对应的订单编号，销售单号或合同单号等，本接口同一个单号仅能开具一次发票</td>
</tr>
<tr>
<td>fplxdm</td>
<td>String</td>
<td>是</td>
<td>发票类型代码，030-全电普票，032-全电专票</td>
</tr>
<tr>
<td>xsf_nsrsbh</td>
<td>String</td>
<td>是</td>
<td>销方税号</td>
</tr>
<tr>
<td>xsf_nsrmc</td>
<td>String</td>
<td>是</td>
<td>销方名称</td>
</tr>
<tr>
<td>xsf_dz</td>
<td>String</td>
<td>是</td>
<td>销售方地址</td>
</tr>
<tr>
<td>xsf_dh</td>
<td>String</td>
<td>是</td>
<td>销售方电话</td>
</tr>
<tr>
<td>xsf_yhmc</td>
<td>String</td>
<td>是</td>
<td>销售方开户银行</td>
</tr>
<tr>
<td>xsf_yhzh</td>
<td>String</td>
<td>是</td>
<td>销售方银行账号</td>
</tr>
<tr>
<td>gmf_lx</td>
<td>String</td>
<td>是</td>
<td>购方类型，0-企业， 1-个人</td>
</tr>
<tr>
<td>gmf_nsrsbh</td>
<td>String</td>
<td>否</td>
<td>购方税号，购方类型为：个人时可不填或自定义抬头</td>
</tr>
<tr>
<td>gmf_nsrmc</td>
<td>String</td>
<td>是</td>
<td>购方名称</td>
</tr>
<tr>
<td>gmf_dz</td>
<td>String</td>
<td>否</td>
<td>购买方地址</td>
</tr>
<tr>
<td>gmf_dh</td>
<td>String</td>
<td>否</td>
<td>购买方电话</td>
</tr>
<tr>
<td>gmf_yhmc</td>
<td>String</td>
<td>否</td>
<td>购买方开户银行</td>
</tr>
<tr>
<td>gmf_yhzh</td>
<td>String</td>
<td>否</td>
<td>购买方银行账号</td>
</tr>
<tr>
<td>hjje</td>
<td>String</td>
<td>否</td>
<td>合计金额，不传时会自动通过明细计算，为保证您的票面金额的准确性，在开具不含税发票时，建议您传入合计金额</td>
</tr>
<tr>
<td>hjse</td>
<td>String</td>
<td>否</td>
<td>合计税额，不传时会自动通过明细计算</td>
</tr>
<tr>
<td>jshj</td>
<td>String</td>
<td>否</td>
<td>价税合计，不传时会自动计算，为保证您的票面金额的准确性，在开具含税发票时，建议您传入价税合计</td>
</tr>
<tr>
<td>bz</td>
<td>String</td>
<td>否</td>
<td>备注</td>
</tr>
<tr>
<td>hsslbs</td>
<td>String</td>
<td>否</td>
<td>含税标识 <br> 1-不含税价, <br>2-含税价 （默认）<br>注：本参数仅用于价税分离，如您的请求报文已包含项目金额、税额，则本参数无任何意义</td>
</tr>
<tr>
<td>xgm_xsyhzc</td>
<td>String</td>
<td>否</td>
<td>小规模享受优惠政策<br> 04-前期已开具发票，发生销售折让、中止或者退回等情形需要开具红字发票，或者开票有误需要重新开具<br>05-因为实际经营业务需要，放弃享受减按1%征收率征收增值税政策<br>注：本参数仅适用于小规模企业1%优惠政策对象，<br>一、以上04和05均为不享受优惠政策，仍按3%或6%正常开票<br>二、如享受优惠政策，请直接将项目税率设置为1%，本参数传空或传05<br>三、如您不是小规模优惠对象，本参数请传空或不传。</td>
</tr>
<tr>
<td>gfxx_confirm</td>
<td>String</td>
<td>否</td>
<td>购方信息确认<br>0-忽略购方信息错误，直接开具; <br>空或不传-则会提示购方信息错误</td>
</tr>
<tr>
<td>kjje_confirm</td>
<td>String</td>
<td>否</td>
<td>大金额信息确认<br>0-忽略大金额提示，直接开具; <br>空或不传，则会提示开具金额较大</td>
</tr>
<tr>
<td>xmmx</td>
<td>Array</td>
<td>是</td>
<td>开票明细项目. 详见xmmx字段说明</td>
</tr>
<tr>
<td>tdyslxdm</td>
<td>String</td>
<td>否</td>
<td>特定业务类型代码, 15-二手车、03-建筑服务发票、06-不动产经营租赁服务、05-不动产销售服务发票、13-拖拉机和联合收割机发票、09-旅客运输服务发票、14-机动车、04-货物运输服务发票、07-代收车船税</td>
</tr>
<tr>
<td>hwysfwdzfpmxbList</td>
<td>Array</td>
<td>否</td>
<td>货物运输明细, 当特定业务类型为04时必须，详见hwysfwdzfpmxbList字段说明</td>
</tr>
<tr>
<td>jdctyxsxx</td>
<td>object</td>
<td>否</td>
<td>机动车统一销售信息（当特定业务类是机动车统一销售信息），详见jdctyxsxx字段说明</td>
</tr>
<tr>
<td>dsccsxx</td>
<td>object</td>
<td>否</td>
<td>代收车船税(当特定业务类型时代收车船税时必填)，详见dsccsxx字段说明</td>
</tr>
<tr>
<td>lkysfwxx</td>
<td>Array</td>
<td>否</td>
<td>旅客运输服务发票(当特定业务类型是旅客运输服务时必填)，详见lkysfwxx字段说明</td>
</tr>
<tr>
<td>tljlhsgjxx</td>
<td>object</td>
<td>否</td>
<td>拖拉机和联合收割机信息（当特定业务时拖拉机和联合收割机时必填)，详见tljlhsgjxx字段说明</td>
</tr>
<tr>
<td>bdcjyxsxxs</td>
<td>Array</td>
<td>否</td>
<td>不动产经营销售服务(当特定业务类型时不动产经营销售服务时必填)，详见bdcjyxsxxs字段说明</td>
</tr>
<tr>
<td>bdczyzlxxs</td>
<td>Array</td>
<td>否</td>
<td>不动产经营租赁信息(当特定业务类型时不动产经营租赁服务时必填)，详见bdczyzlxxs字段说明</td>
</tr>
<tr>
<td>jzfwxx</td>
<td>object</td>
<td>否</td>
<td>建筑服务信息(当特定业务为建筑服务信息时必填)，详见jzfwxx字段说明</td>
</tr>
<tr>
<td>escxx</td>
<td>object</td>
<td>否</td>
<td>二手车信息(当特定业务二手车信息时必填)，详见escxx字段说明</td>
</tr>
<tr>
<td>sfzsgmfyhzh</td>
<td>String</td>
<td>否</td>
<td>是否展示购买方银行账号 1 展示 0或空不展示</td>
</tr>
<tr>
<td>sfzsxsfyhzh</td>
<td>String</td>
<td>否</td>
<td>是否展示销售方银行账号 1 展示 0或空不展示</td>
</tr>
<tr>
<td>sfzsgmfdzdh</td>
<td>String</td>
<td>否</td>
<td>是否展示购买方地址电话 1 展示 0或空不展示</td>
</tr>
<tr>
<td>sfzsxsfdzdh</td>
<td>String</td>
<td>否</td>
<td>是否展示销售方地址电话 1 展示 0或空不展示</td>
</tr>
<tr>
<td>cezslxDm</td>
<td>String</td>
<td>否</td>
<td>差额开票代码 （ 01 全额 02 差额）</td>
</tr>
<tr>
<td>cepzmxList</td>
<td>Array</td>
<td>否</td>
<td>差额明细列表，详见cepzmxList字段说明</td>
</tr>
</tbody>
</table>
<p>> 注：非必需节点，可以不带此节点</p>
<ul>
<li>xmmx字段说明</li>
</ul>
<table>
<thead>
<tr>
<th>字段</th>
<th>类型</th>
<th>必需</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>fphxz</td>
<td>String</td>
<td>是</td>
<td>发票行性质 0-正常行, 1-折扣行, 2-被折扣行</td>
</tr>
<tr>
<td>spbm</td>
<td>String</td>
<td>是</td>
<td>税收商品编码, 19位的商品编码</td>
</tr>
<tr>
<td>spmc</td>
<td>String</td>
<td>是</td>
<td>税收商品名称, 19位商品编码对应的名称</td>
</tr>
<tr>
<td>xmmc</td>
<td>String</td>
<td>是</td>
<td>自定义的商品名称</td>
</tr>
<tr>
<td>ggxh</td>
<td>String</td>
<td>否</td>
<td>商品规格型号</td>
</tr>
<tr>
<td>dw</td>
<td>String</td>
<td>否</td>
<td>单位</td>
</tr>
<tr>
<td>spsl</td>
<td>Number</td>
<td>否</td>
<td>商品数量</td>
</tr>
<tr>
<td>dj</td>
<td>Number</td>
<td>否</td>
<td>单价</td>
</tr>
<tr>
<td>sl</td>
<td>Number</td>
<td>是</td>
<td>税率, 传小数，如：6%，则传：0.06</td>
</tr>
<tr>
<td>je</td>
<td>Number</td>
<td>是</td>
<td>金额</td>
</tr>
<tr>
<td>se</td>
<td>Number</td>
<td>否</td>
<td>税额 <br>不传时会自动计算<br>价税计算存在以下三种情况：<br>1、如果传入了税额，不管使用含税还是不含税计算方式，金额(je)必须传入不含税价。<br>2、如果不传入税额，且使用不含税计算方式，则金额(je)须传入不含税金额<br>3、如果不传入税额，且使用含税计算方式，则金额(je)须传入含税金额，系统会自动反算成不含税金额。</td>
</tr>
<tr>
<td>slbs</td>
<td>String</td>
<td>否</td>
<td>税率标识 空：非零税率， 1-免税, 2-不征税, 3-普通零税率</td>
</tr>
<tr>
<td>ssyhzclx</td>
<td>String</td>
<td>否</td>
<td>税收优惠政策类型, 01-简易征收，02- 稀土产品，03- 免税，04- 不征税，05- 先征后退，06- 100%先征后退，07- 50%先征后退，08-按3%简易征收，09-按5%简易征收，10- 按5%简易征收减按1.5%计征，11-即征即退30%，12- 即征即退50%，13- 即征即退70%，14- 即征即退100%，15- 超税负3%即征即退，16- 超税负8%即征即退，17- 超税负12%即征即退，18- 超税负6%即征即退</td>
</tr>
<tr>
<td>tdzsfsdm</td>
<td>String</td>
<td>否</td>
<td>特定征税方式代码，01-不征税，02-零税率，03-差额征税，04-免税，05-简易征税，06-减按征税</td>
</tr>
</tbody>
</table>
<p>> 注：非必需节点，可以不带此节点</p>
<ul>
<li>hwysfwdzfpmxbList字段说明</li>
</ul>
<table>
<thead>
<tr>
<th>字段</th>
<th>类型</th>
<th>必需</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>xh</td>
<td>String</td>
<td>否</td>
<td>序号</td>
</tr>
<tr>
<td>ysgjzl</td>
<td>String</td>
<td>否</td>
<td>运输工具种类</td>
</tr>
<tr>
<td>ysgjhp</td>
<td>String</td>
<td>否</td>
<td>运输工具号牌</td>
</tr>
<tr>
<td>qyd</td>
<td>String</td>
<td>否</td>
<td>起始地</td>
</tr>
<tr>
<td>ddd</td>
<td>String</td>
<td>否</td>
<td>到达地</td>
</tr>
<tr>
<td>yshwmc</td>
<td>String</td>
<td>否</td>
<td>运输货物名称</td>
</tr>
</tbody>
</table>
<ul>
<li>bdczyzlxxs字段说明</li>
</ul>
<table>
<thead>
<tr>
<th>字段</th>
<th>类型</th>
<th>必需</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>fwcqzshm</td>
<td>String</td>
<td>是</td>
<td>房屋产权证书/不动产权证号码</td>
</tr>
<tr>
<td>bdcdz</td>
<td>String</td>
<td>是</td>
<td>不动产地址,应为省市区</td>
</tr>
<tr>
<td>bdcxxdz</td>
<td>String</td>
<td>否</td>
<td>动产详细地址</td>
</tr>
<tr>
<td>zlqq</td>
<td>String</td>
<td>是</td>
<td>租赁期起(yyyy-MM-dd）</td>
</tr>
<tr>
<td>zlqz</td>
<td>String</td>
<td>是</td>
<td>租赁期止(yyyy-MM-dd)</td>
</tr>
<tr>
<td>kdsbz</td>
<td>String</td>
<td>是</td>
<td>跨地市标志(Y/N)</td>
</tr>
<tr>
<td>mjdw</td>
<td>String</td>
<td>是</td>
<td>平方米,亩,m²,平方千米,公顷,hm²,km²</td>
</tr>
<tr>
<td>cph</td>
<td>String</td>
<td>否</td>
<td>车牌号,商品编码是3040502020200000000时传入车牌号会在备注中显示其他税编无效</td>
</tr>
</tbody>
</table>
<p>> 不动产经营租赁信息(当特定业务类型是不动产经营租赁服务时必填)</p>
<ul>
<li>bdcjyxsxxs字段说明</li>
</ul>
<table>
<thead>
<tr>
<th>字段</th>
<th>类型</th>
<th>必需</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>fwcqzshm</td>
<td>String</td>
<td>否</td>
<td>房屋产权证书/不动产权证号码</td>
</tr>
<tr>
<td>bdcdz</td>
<td>String</td>
<td>是</td>
<td>不动产地址</td>
</tr>
<tr>
<td>bdcxxdz</td>
<td>String</td>
<td>否</td>
<td>动产详细地址</td>
</tr>
<tr>
<td>wqhtbabm</td>
<td>String</td>
<td>否</td>
<td>不动产单元代码/网签合同备案编码</td>
</tr>
<tr>
<td>tdzzsxmbh</td>
<td>String</td>
<td>否</td>
<td>土地增值税项目编号</td>
</tr>
<tr>
<td>hdjsjg</td>
<td>String</td>
<td>否</td>
<td>核定计税价格</td>
</tr>
<tr>
<td>sjcjhsje</td>
<td>String</td>
<td>否</td>
<td>实际成交含税金额</td>
</tr>
<tr>
<td>kdsbz</td>
<td>String</td>
<td>是</td>
<td>跨地市标志(Y/N)</td>
</tr>
<tr>
<td>mjdw</td>
<td>String</td>
<td>是</td>
<td>面积单位，平方米,亩,m²,平方千米,公顷,hm²,km²</td>
</tr>
</tbody>
</table>
<p>> 不动产经营租销售服务(当特定业务类型是不动产经营销售服务时必填)</p>
<ul>
<li>jdctyxsxx字段说明</li>
</ul>
<table>
<thead>
<tr>
<th>字段</th>
<th>类型</th>
<th>必需</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>xxmc</td>
<td>String</td>
<td>是</td>
<td>项目名称</td>
</tr>
<tr>
<td>spmc</td>
<td>String</td>
<td>是</td>
<td>商品名称</td>
</tr>
<tr>
<td>spjc</td>
<td>String</td>
<td>是</td>
<td>商品简称</td>
</tr>
<tr>
<td>ssflbm</td>
<td>String</td>
<td>是</td>
<td>税收分类编码</td>
</tr>
<tr>
<td>je</td>
<td>String</td>
<td>是</td>
<td>不含税价（小写）</td>
</tr>
<tr>
<td>sv</td>
<td>String</td>
<td>是</td>
<td>增值税税率/征税率</td>
</tr>
<tr>
<td>se</td>
<td>String</td>
<td>是</td>
<td>增值税税额</td>
</tr>
<tr>
<td>jsheXx</td>
<td>String</td>
<td>是</td>
<td>价税合计（小写）</td>
</tr>
<tr>
<td>jshjDx</td>
<td>String</td>
<td>是</td>
<td>价税合计（大写）</td>
</tr>
<tr>
<td>cllxDm</td>
<td>String</td>
<td>是</td>
<td>车辆类型代码</td>
</tr>
<tr>
<td>cpxh</td>
<td>String</td>
<td>是</td>
<td>厂牌型号</td>
</tr>
<tr>
<td>cd</td>
<td>String</td>
<td>是</td>
<td>产地</td>
</tr>
<tr>
<td>hgzh</td>
<td>String</td>
<td>是</td>
<td>合格证号</td>
</tr>
<tr>
<td>jkzmsh</td>
<td>String</td>
<td>是</td>
<td>进口证明书号</td>
</tr>
<tr>
<td>sjdh</td>
<td>String</td>
<td>是</td>
<td>商险单号</td>
</tr>
<tr>
<td>fdjhm</td>
<td>String</td>
<td>是</td>
<td>发动机号码</td>
</tr>
<tr>
<td>clsbdh</td>
<td>String</td>
<td>是</td>
<td>车辆识别代码/车架号码</td>
</tr>
<tr>
<td>cldw</td>
<td>String</td>
<td>是</td>
<td>吨位</td>
</tr>
<tr>
<td>xcrs</td>
<td>String</td>
<td>是</td>
<td>限乘人数</td>
</tr>
<tr>
<td>wspzhm</td>
<td>String</td>
<td>是</td>
<td>完税凭证号码</td>
</tr>
<tr>
<td>scqymc</td>
<td>String</td>
<td>是</td>
<td>生产企业名称</td>
</tr>
<tr>
<td>swjgmc</td>
<td>String</td>
<td>是</td>
<td>主管税务机关名称</td>
</tr>
<tr>
<td>swjgdm</td>
<td>String</td>
<td>是</td>
<td>特定征收方式代码</td>
</tr>
<tr>
<td>zzstsgldm</td>
<td>String</td>
<td>是</td>
<td>增值税特殊管理代码</td>
</tr>
<tr>
<td>jdctzclsbdhuuid</td>
<td>String</td>
<td>是</td>
<td>机动车车辆识别号uuid</td>
</tr>
</tbody>
</table>
<ul>
<li>dsccsxx字段说明</li>
</ul>
<table>
<thead>
<tr>
<th>字段</th>
<th>类型</th>
<th>必需</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>sfyytljdj</td>
<td>String</td>
<td>是</td>
<td>保险单号</td>
</tr>
<tr>
<td>chhcbdjh</td>
<td>String</td>
<td>是</td>
<td>车船号船舶登记号</td>
</tr>
<tr>
<td>skssq</td>
<td>String</td>
<td>是</td>
<td>税款所属期 yyyy-MM</td>
</tr>
<tr>
<td>dsccsje</td>
<td>String</td>
<td>是</td>
<td>代收车船税金额</td>
</tr>
<tr>
<td>znjje</td>
<td>String</td>
<td>是</td>
<td>滞纳金金额</td>
</tr>
<tr>
<td>hjje</td>
<td>String</td>
<td>是</td>
<td>合计金额</td>
</tr>
<tr>
<td>cjh</td>
<td>String</td>
<td>否</td>
<td>车架号</td>
</tr>
</tbody>
</table>
<ul>
<li>lkysfwxx字段说明</li>
</ul>
<table>
<thead>
<tr>
<th>字段</th>
<th>类型</th>
<th>必需</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>cxr</td>
<td>String</td>
<td>是</td>
<td>出行人</td>
</tr>
<tr>
<td>cxrzjlx</td>
<td>String</td>
<td>是</td>
<td>出行人证件类型，详见cxrzjlx字段说明</td>
</tr>
<tr>
<td>sfzjhm</td>
<td>String</td>
<td>是</td>
<td>出行人证件号码</td>
</tr>
<tr>
<td>cxrq</td>
<td>String</td>
<td>是</td>
<td>出行日期(yyyy-MM-dd)</td>
</tr>
<tr>
<td>cfd</td>
<td>String</td>
<td>是</td>
<td>出发地 按行政区划名称填写，包括县（市、区）名称，可在县（市、区）后自主增添具体地址</td>
</tr>
<tr>
<td>ddd</td>
<td>String</td>
<td>是</td>
<td>到达地 按行政区划名称填写，包括县（市、区）名称，可在县（市、区）后自主增添具体地址</td>
</tr>
<tr>
<td>jtgjlx</td>
<td>String</td>
<td>是</td>
<td>交通工具类型 "1":飞机; "2":火车; "3":长途汽车; "4":公共交通; "5":出租车; "6":汽车; "7":船舶; "9":其他</td>
</tr>
<tr>
<td>dj</td>
<td>String</td>
<td>否</td>
<td>等级，若交通工具为火车、飞机、船舶，则该要素为必填； 等级类型: 1、交通工具-飞机:经济舱、头等舱、公务舱 2、交通工具-船舶:一等舱、二等舱、三等舱) 3、交通工具-火车:一等座、二等座、软席(软座、软卧)、硬席(硬座、硬卧))</td>
</tr>
</tbody>
</table>
<ul>
<li>cxrzjlx字段说明</li>
</ul>
<table>
<thead>
<tr>
<th>值</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>101</td>
<td>组织机构代码证</td>
</tr>
<tr>
<td>102</td>
<td>营业执照</td>
</tr>
<tr>
<td>103</td>
<td>税务登记证</td>
</tr>
<tr>
<td>199</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>205</td>
<td>军队离退休干部证</td>
</tr>
<tr>
<td>206</td>
<td>残疾人证</td>
</tr>
<tr>
<td>207</td>
<td>残疾军人证（1-8级）</td>
</tr>
<tr>
<td>208</td>
<td>外国护照</td>
</tr>
<tr>
<td>210</td>
<td>港澳居民来往内地通行证</td>
</tr>
<tr>
<td>212</td>
<td>中华人民共和国往来港澳通行证</td>
</tr>
<tr>
<td>213</td>
<td>台湾居民来往大陆通行证</td>
</tr>
<tr>
<td>214</td>
<td>大陆居民往来台湾通行证</td>
</tr>
<tr>
<td>215</td>
<td>外国人居留证</td>
</tr>
<tr>
<td>216</td>
<td>外交官证</td>
</tr>
<tr>
<td>217</td>
<td>使（领事）馆证</td>
</tr>
<tr>
<td>218</td>
<td>海员证</td>
</tr>
<tr>
<td>219</td>
<td>香港永久性居民身份证</td>
</tr>
<tr>
<td>220</td>
<td>台湾身份证</td>
</tr>
<tr>
<td>221</td>
<td>澳门特别行政区永久性居民身份证</td>
</tr>
<tr>
<td>222</td>
<td>外国人身份证件</td>
</tr>
<tr>
<td>224</td>
<td>就业失业登记证</td>
</tr>
<tr>
<td>225</td>
<td>退休证</td>
</tr>
<tr>
<td>226</td>
<td>离休证</td>
</tr>
<tr>
<td>227</td>
<td>中国护照</td>
</tr>
<tr>
<td>228</td>
<td>城镇退役士兵自谋职业证</td>
</tr>
<tr>
<td>229</td>
<td>随军家属身份证明</td>
</tr>
<tr>
<td>230</td>
<td>中国人民解放军军官转业证书</td>
</tr>
<tr>
<td>231</td>
<td>中国人民解放军义务兵退出现役证</td>
</tr>
<tr>
<td>232</td>
<td>中国人民解放军士官退出现役证</td>
</tr>
<tr>
<td>233</td>
<td>外国人永久居留身份证（外国人永久居留证）</td>
</tr>
<tr>
<td>234</td>
<td>就业创业证</td>
</tr>
<tr>
<td>235</td>
<td>香港特别行政区护照</td>
</tr>
<tr>
<td>236</td>
<td>澳门特别行政区护照</td>
</tr>
<tr>
<td>237</td>
<td>中华人民共和国港澳居民居住证</td>
</tr>
<tr>
<td>238</td>
<td>中华人民共和国台湾居民居住证</td>
</tr>
<tr>
<td>239</td>
<td>《中华人民共和国外国人工作许可证》（A类）</td>
</tr>
<tr>
<td>240</td>
<td>《中华人民共和国外国人工作许可证》（B类）</td>
</tr>
<tr>
<td>241</td>
<td>《中华人民共和国外国人工作许可证》（C类）</td>
</tr>
<tr>
<td>291</td>
<td>医学出生证明</td>
</tr>
<tr>
<td>299</td>
<td>其他个人证件</td>
</tr>
</tbody>
</table>
<ul>
<li>tljlhsgjxx字段说明</li>
</ul>
<table>
<thead>
<tr>
<th>字段</th>
<th>类型</th>
<th>必需</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>sfyytljdj</td>
<td>String</td>
<td>是</td>
<td>是否用于联合机登记</td>
</tr>
<tr>
<td>fdjbh</td>
<td>String</td>
<td>是</td>
<td>发动机号码</td>
</tr>
<tr>
<td>dphgzbh</td>
<td>String</td>
<td>是</td>
<td>地盘合格证编号</td>
</tr>
</tbody>
</table>
<ul>
<li>bdcjyxsxx字段说明</li>
</ul>
<table>
<thead>
<tr>
<th>字段</th>
<th>类型</th>
<th>必需</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>fwcqzshm</td>
<td>String</td>
<td>否</td>
<td>房屋产权证书/不动产权证号码</td>
</tr>
<tr>
<td>bdcdz</td>
<td>String</td>
<td>是</td>
<td>不动产地址</td>
</tr>
<tr>
<td>bdcxxdz</td>
<td>String</td>
<td>否</td>
<td>不动产详细地址</td>
</tr>
<tr>
<td>wqhtbabm</td>
<td>String</td>
<td>否</td>
<td>不动产单元代码/网签合同备案编码</td>
</tr>
<tr>
<td>tdzzsxmbh</td>
<td>String</td>
<td>否</td>
<td>土地增值税项目编号</td>
</tr>
<tr>
<td>hdjsjg</td>
<td>String</td>
<td>否</td>
<td>核定计税价格</td>
</tr>
<tr>
<td>sjcjhsje</td>
<td>String</td>
<td>否</td>
<td>实际成交含税金额</td>
</tr>
<tr>
<td>kdsbz</td>
<td>String</td>
<td>是</td>
<td>跨地市标志(Y/N)</td>
</tr>
<tr>
<td>mjdw</td>
<td>String</td>
<td>是</td>
<td>面积单位 平方米,亩,m²,平方千米,公顷,hm²,km²</td>
</tr>
</tbody>
</table>
<ul>
<li>bdczyzlxx字段说明</li>
</ul>
<table>
<thead>
<tr>
<th>字段</th>
<th>类型</th>
<th>必需</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>fwcqzshm</td>
<td>String</td>
<td>是</td>
<td>房屋产权证书/不动产权证号码</td>
</tr>
<tr>
<td>bdcdz</td>
<td>String</td>
<td>是</td>
<td>不动产地址</td>
</tr>
<tr>
<td>bdcxxdz</td>
<td>String</td>
<td>否</td>
<td>不动产详细地址</td>
</tr>
<tr>
<td>zlqq</td>
<td>String</td>
<td>是</td>
<td>租赁期起(yyyy-MM-dd）</td>
</tr>
<tr>
<td>zlqz</td>
<td>String</td>
<td>是</td>
<td>租赁期止(yyyy-MM-dd)</td>
</tr>
<tr>
<td>kdsbz</td>
<td>String</td>
<td>是</td>
<td>跨地市标志(Y/N)</td>
</tr>
<tr>
<td>mjdw</td>
<td>String</td>
<td>是</td>
<td>面积单位 平方米,亩,m²,平方千米,公顷,hm²,km²</td>
</tr>
</tbody>
</table>
<ul>
<li>jzfwxx字段说明</li>
</ul>
<table>
<thead>
<tr>
<th>字段</th>
<th>类型</th>
<th>必需</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>jzfwfs</td>
<td>String</td>
<td>是</td>
<td>建筑服务发生地</td>
</tr>
<tr>
<td>fsdxxdz</td>
<td>String</td>
<td>否</td>
<td>发生地详细地址</td>
</tr>
<tr>
<td>jzxmmc</td>
<td>String</td>
<td>是</td>
<td>建筑项目名称</td>
</tr>
<tr>
<td>kdsbz</td>
<td>String</td>
<td>是</td>
<td>跨地市标志(只能为Y/N)</td>
</tr>
<tr>
<td>tdzzsxmbh</td>
<td>String</td>
<td>否</td>
<td>土地增值税项目编号</td>
</tr>
</tbody>
</table>
<ul>
<li>escxx字段说明</li>
</ul>
<table>
<thead>
<tr>
<th>字段</th>
<th>类型</th>
<th>必需</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>sdfphm</td>
<td>String</td>
<td>否</td>
<td>数电发票号码</td>
</tr>
<tr>
<td>zzfpdm</td>
<td>String</td>
<td>否</td>
<td>发票代码</td>
</tr>
<tr>
<td>zzfphm</td>
<td>String</td>
<td>否</td>
<td>发票号码</td>
</tr>
<tr>
<td>escxsfzrrbs</td>
<td>String</td>
<td>否</td>
<td>卖方自然人标识</td>
</tr>
<tr>
<td>escxsfdz</td>
<td>String</td>
<td>否</td>
<td>卖方地址</td>
</tr>
<tr>
<td>escxsflxdh</td>
<td>String</td>
<td>否</td>
<td>卖方电话</td>
</tr>
<tr>
<td>escxsfmc</td>
<td>String</td>
<td>否</td>
<td>卖方名称</td>
</tr>
<tr>
<td>escxsfnsrsbh</td>
<td>String</td>
<td>是</td>
<td>卖方税号</td>
</tr>
<tr>
<td>escyqrhyxz</td>
<td>String</td>
<td>是</td>
<td>二手车企业性质，07-二手车市场 08-二手车经销企业 09-二手车拍卖企业</td>
</tr>
<tr>
<td>escfwList</td>
<td>array</td>
<td>否</td>
<td>二手车服务信息</td>
</tr>
<tr>
<td>escfwList.clsbdh</td>
<td>String</td>
<td>是</td>
<td>车辆识别代号/车架号码</td>
</tr>
<tr>
<td>escfwList.cphm</td>
<td>String</td>
<td>是</td>
<td>车牌照号</td>
</tr>
<tr>
<td>escfwList.cpxh</td>
<td>String</td>
<td>是</td>
<td>厂牌型号</td>
</tr>
<tr>
<td>escfwList.djzh</td>
<td>String</td>
<td>是</td>
<td>登记证号</td>
</tr>
<tr>
<td>escfwList.zrdclglsmc</td>
<td>String</td>
<td>是</td>
<td>转入地车辆管理所名称</td>
</tr>
</tbody>
</table>
<ul>
<li>cepzmxList字段说明</li>
</ul>
<table>
<thead>
<tr>
<th>字段</th>
<th>类型</th>
<th>必需</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<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>pzlx</td>
<td>String</td>
<td>否</td>
<td>凭证类型(默认 01数电票)，01：数电票，02：增值税专用发票，03：增值税普通发票，04：营业税发票，05：财政票据，06：法院裁决书，07：契税完税凭证，08：其他发票类，09：其他扣除凭证</td>
</tr>
<tr>
<td>zzfphm</td>
<td>String</td>
<td>否</td>
<td>纸质发票号码</td>
</tr>
<tr>
<td>pzhm</td>
<td>String</td>
<td>否</td>
<td>凭证号码</td>
</tr>
<tr>
<td>kjrq</td>
<td>String</td>
<td>是</td>
<td>开具日期</td>
</tr>
<tr>
<td>bz</td>
<td>String</td>
<td>否</td>
<td>备注</td>
</tr>
<tr>
<td>bckcje</td>
<td>String</td>
<td>是</td>
<td>本次扣除金额</td>
</tr>
<tr>
<td>pzhjje</td>
<td>String</td>
<td>是</td>
<td>凭证合计金额</td>
</tr>
</tbody>
</table>
<h5>4.1.4 返回说明</h5>
<ul>
<li>发起开票任务成功</li>
</ul>
<pre><code class="language-json">{
&quot;code&quot;: 200,
&quot;msg&quot;: &quot;发起开票成功，请调用获取开票结果接口获取开票结果&quot;,
&quot;taskNo&quot;: &quot;69564903663951243279&quot;, // 本次唯一请求号
&quot;data&quot;: {
&quot;requestId&quot;: &quot;&quot;, // 发起开票的任务id
}
}</code></pre>
<p>> 如果用相同订单号ly_ddbh, 重复调用本接口，会返回已开具或正在开具，详见以下说明：相同的订单号已开具、相同的订单号已发起未完成</p>
<ul>
<li>相同的订单号已开具</li>
</ul>
<pre><code class="language-json">{
&quot;code&quot;: 220,
&quot;msg&quot;: &quot;订单号78901123456本次未在局端开具新的发票，开具结果为上次开具成功的信息&quot;,
&quot;taskNo&quot;: &quot;69564903663951243279&quot;, // 本次唯一请求号
&quot;data&quot;: {
&quot;kplx&quot;: &quot;0&quot;, // 开票类型 ,固定值 0：蓝票
&quot;kplsh&quot;: &quot;&quot;, // 开票流水号
&quot;gmfNsrsbh&quot;: &quot;&quot;, // 购买方税号
&quot;gmfNsrmc&quot;: &quot;&quot;, // 购买方名称
&quot;xsfNsrsbh&quot;: &quot;&quot;, // 销售方税号
&quot;xsfNsrmc&quot;: &quot;&quot;, // 销售方名称
&quot;fplxdm&quot;: &quot;030&quot;, // 发票类型 030-全电普票, 032-全电专票
&quot;kprq&quot;: &quot;2024-03-05 14:45:55&quot;, // 开票日期
&quot;jshj&quot;: &quot;30.00&quot;, // 价税合计
&quot;fphm&quot;: &quot;&quot; // 发票代码, 仅旧版发票有值
}
}</code></pre>
<ul>
<li>相同的订单号已发起未完成</li>
</ul>
<pre><code class="language-json">{
&quot;code&quot;: 221,
&quot;msg&quot;: &quot;存在相同订单号:789011123456未完成的任务&quot;,
&quot;taskNo&quot;: &quot;69564903663951243279&quot;, // 本次唯一请求号
}</code></pre>
<hr />
<p><a name="发票开具结果查询"></a></p>
<h4>4.2 开具结果查询</h4>
<ul>
<li>调用发起开票任务接口后，需要本接口获取开票结果</li>
</ul>
<h5>4.2.1 请求地址</h5>
<p><code>https://api.jumdata.com/invoice/makeout/result/get</code></p>
<h5>4.2.2 业务参数</h5>
<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>requestId</td>
<td>String</td>
<td>是</td>
<td>发起开票接口返回的任务id</td>
</tr>
</tbody>
</table>
<h5>4.2.3 返回说明</h5>
<ul>
<li>已开具</li>
</ul>
<pre><code class="language-json">{
&quot;code&quot;: 200,
&quot;msg&quot;: &quot;成功&quot;,
&quot;taskNo&quot;: &quot;69564903663951243279&quot;,
&quot;data&quot;: {
&quot;kplsh&quot;: &quot;string&quot;, // 开票流水号
&quot;fplxdm&quot;: &quot;string&quot;, // 发票类型代码
&quot;fpdm&quot;: &quot;string&quot;, // 发票代码, 仅旧版发票有值
&quot;fphm&quot;: &quot;string&quot;, // 发票号码, 旧版为8位发票号码，新数电为20位数电号码
&quot;kprq&quot;: &quot;string&quot;,// 开票日期与时间
&quot;kplx&quot;: &quot;0&quot;, // 开票类型 ,固定值: 0-蓝票
&quot;jshj&quot;: 0, // 价税合计
&quot;gmfNsrsbh&quot;: &quot;string&quot;,// 购买方税号
&quot;gmfNsrmc&quot;: &quot;string&quot;,// 购买方名称
&quot;xsfNsrsbh&quot;: &quot;string&quot;,// 销售方税号
&quot;xsfNsrmc&quot;: &quot;string&quot;// 销售方名称
}
}
</code></pre>
<ul>
<li>执行中</li>
</ul>
<pre><code class="language-json">{
&quot;code&quot;: 221,
&quot;msg&quot;: &quot;开票任务执行中&quot;,
&quot;taskNo&quot;: &quot;69564903663951243279&quot;
}</code></pre>
<ul>
<li>待下一次执行</li>
</ul>
<pre><code class="language-json">{
&quot;code&quot;: 222,
&quot;msg&quot;: &quot;开票任务待下一次执行&quot;,
&quot;taskNo&quot;: &quot;69564903663951243279&quot;
}</code></pre>
<ul>
<li>执行失败</li>
</ul>
<pre><code class="language-json">{
&quot;code&quot;: 229,
&quot;msg&quot;: &quot;开票任务执行失败&quot;,
&quot;taskNo&quot;: &quot;69564903663951243279&quot;
}</code></pre>
<hr />
<h4>4.3 已开发票查询</h4>
<ul>
<li>从局端查询符合指定条件的发票列表</li>
</ul>
<h5>4.3.1 请求地址</h5>
<p><code>https://api.jumdata.com/invoice/makeout/result/list</code></p>
<h5>4.3.2 业务参数</h5>
<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>pageNo</td>
<td>Integer</td>
<td>否</td>
<td>当前页码，默认：1</td>
</tr>
<tr>
<td>pageSize</td>
<td>Integer</td>
<td>否</td>
<td>每页记录数，可选值：10、20、50、100，默认：10</td>
</tr>
<tr>
<td>kprqq</td>
<td>String</td>
<td>是</td>
<td>开票起始日期，格式：yyyy-MM-dd，起止日期必传且为一年内</td>
</tr>
<tr>
<td>kprqz</td>
<td>String</td>
<td>否</td>
<td>开票结束日期，默认：今天，格式： yyyy-MM-dd，起止日期必传且为一年内</td>
</tr>
<tr>
<td>fphm</td>
<td>String</td>
<td>否</td>
<td>发票号码</td>
</tr>
<tr>
<td>dfnsrsbh</td>
<td>String</td>
<td>否</td>
<td>对方税号</td>
</tr>
<tr>
<td>dfnsrmc</td>
<td>String</td>
<td>否</td>
<td>对方纳税人名称</td>
</tr>
</tbody>
</table>
<h5>4.3.3 返回说明</h5>
<pre><code class="language-json">{
&quot;code&quot;: 200,
&quot;msg&quot;: &quot;成功&quot;,
&quot;taskNo&quot;: &quot;69564903663951243279&quot;,
&quot;data&quot;: {
&quot;records&quot;: 16, //
&quot;pageNo&quot;: 1,
&quot;pageSize&quot;: 10,
&quot;list&quot;: [
{
&quot;fphm&quot;: &quot;************77370805&quot;, // 发票号码
&quot;kpf_nsrsbh&quot;: &quot;************PDDL2G&quot;,// 开票方纳税人识别号
&quot;fplxdm&quot;: &quot;030&quot;, // 发票类型代码 030-全电普票，032-全电专票
&quot;fpztdm&quot;: &quot;03&quot;, // 发票状态代码 01-正常，02-已作废(电票无此状态)，03-已全额红冲，04-已部份红冲
&quot;kplx&quot;: &quot;0&quot;, // 开票类型 0-正常票，1-红冲票
&quot;kprq&quot;: &quot;2023-09-13 15:10:13&quot;,// 开票日期
&quot;xsf_nsrmc&quot;: &quot;********信息有限公司&quot;, // 销方名称
&quot;xsf_nsrsbh&quot;: &quot;************PDDL2G&quot;, // 销方税号
&quot;gmf_nsrmc&quot;: &quot;**********术有限公司&quot;, // 购方税号
&quot;gmf_nsrsbh&quot;: &quot;************BDRR90&quot;, // 购方名称
&quot;hjje&quot;: 3,// 合计金额
&quot;hjse&quot;: 0.18,// 合计税额
&quot;jshj&quot;: 3.18,// 价税合计
&quot;kpr&quot;: &quot;**飞&quot;,// 开票员姓名
&quot;lpFphm&quot;: null,// 原发票号码 仅冲红发票有值，代表原蓝字发票的号码
&quot;zz_fpdm&quot;: &quot;&quot;, // 纸质发票代码
&quot;zz_fphm&quot;: &quot;&quot; // 纸质发票号码
}
]
}
}</code></pre>
<hr />
<h4>4.4 发票下载</h4>
<ul>
<li>下载指定发票的PDF/OFD/XML格式版式文件</li>
</ul>
<h5>4.4.1 请求地址</h5>
<p><code>https://api.jumdata.com/invoice/makeout/result/file</code></p>
<h5>4.4.2 业务参数</h5>
<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>fphm</td>
<td>String</td>
<td>是</td>
<td>发票号码</td>
</tr>
<tr>
<td>kprq</td>
<td>String</td>
<td>是</td>
<td>开票日期</td>
</tr>
<tr>
<td>wjgs</td>
<td>String</td>
<td>是</td>
<td>文件格式, PDF, OFD, XML</td>
</tr>
<tr>
<td>xzlx</td>
<td>String</td>
<td>是</td>
<td>下载类型, base64, url</td>
</tr>
</tbody>
</table>
<h5>4.4.3 返回说明</h5>
<pre><code class="language-json">{
&quot;code&quot;: 200,
&quot;msg&quot;: &quot;成功&quot;,
&quot;taskNo&quot;: &quot;69564903663951243279&quot;,
&quot;data&quot;: {
&quot;wjgs&quot;: &quot;string&quot;, // 文件格式
&quot;base64&quot;: &quot;string&quot;, // 文件内容(Base64格式)
&quot;url&quot;: &quot;string&quot;, // 文件内容（url格式）
&quot;fpdm&quot;: &quot;string&quot;, // 发票代码, 数电时不返回
&quot;fphm&quot;: &quot;string&quot;, // 发票号码
&quot;kprq&quot;: &quot;string&quot; // 开票日期
}
}</code></pre>
<hr />
<h4>4.5 发票多文件下载</h4>
<ul>
<li>下载指定发票的PDF/OFD/XML格式版式文件</li>
</ul>
<h5>4.5.1 请求地址</h5>
<p><code>https://api.jumdata.com/invoice/makeout/result/fileBatch</code></p>
<h5>4.5.2 业务参数</h5>
<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>fphm</td>
<td>String</td>
<td>是</td>
<td>发票号码</td>
</tr>
<tr>
<td>kprq</td>
<td>String</td>
<td>是</td>
<td>开票日期</td>
</tr>
<tr>
<td>wjgs</td>
<td>String</td>
<td>是</td>
<td>文件格式, PDF, OFD, XML，多个以,隔开</td>
</tr>
<tr>
<td>xzlx</td>
<td>String</td>
<td>是</td>
<td>下载类型, base64, url</td>
</tr>
</tbody>
</table>
<h5>4.5.3 返回说明</h5>
<pre><code class="language-json">{
&quot;msg&quot;: &quot;成功&quot;,
&quot;code&quot;: 200,
&quot;taskNo&quot;: &quot;026356369237790498783395&quot;,
&quot;data&quot;: {
&quot;list&quot;: [
{
&quot;wjgs&quot;: &quot;XML&quot;,//文件格式
&quot;base64&quot;: &quot;string&quot;,//文件内容(Base64格式)
&quot;url&quot;: &quot;string&quot;,// 文件内容（url格式）
&quot;fpdm&quot;: &quot;string&quot;, // 发票代码, 数电时不返回
&quot;fphm&quot;: &quot;string&quot;,//发票号码
&quot;kprq&quot;: &quot;2024-04-25 15:47:44&quot;//开票日期
},
{
&quot;wjgs&quot;: &quot;OFD&quot;,
&quot;base64&quot;: &quot;string&quot;,
&quot;url&quot;: &quot;string&quot;,
&quot;fpdm&quot;: &quot;string&quot;,
&quot;fphm&quot;: &quot;string&quot;,
&quot;kprq&quot;: &quot;2024-04-25 15:47:44&quot;
},
{
&quot;wjgs&quot;: &quot;PDF&quot;,
&quot;base64&quot;: &quot;string&quot;,
&quot;url&quot;: &quot;string&quot;,
&quot;fpdm&quot;: &quot;string&quot;,
&quot;fphm&quot;: &quot;string&quot;,
&quot;kprq&quot;: &quot;2024-04-25 15:47:44&quot;
}
]
}
}</code></pre>
<hr />
<h4>4.6 发票邮件交付</h4>
<ul>
<li>本接口可实现发送数电发票版式文件到用户邮箱</li>
</ul>
<h5>4.6.1 请求地址</h5>
<p><code>https://api.jumdata.com/invoice/makeout/result/email</code></p>
<h5>4.6.2 业务参数</h5>
<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>fphm</td>
<td>String</td>
<td>是</td>
<td>发票号码</td>
</tr>
<tr>
<td>kprq</td>
<td>String</td>
<td>是</td>
<td>开票日期</td>
</tr>
<tr>
<td>wjgs</td>
<td>String</td>
<td>是</td>
<td>文件格式, PDF, OFD, XML</td>
</tr>
<tr>
<td>email</td>
<td>String</td>
<td>是</td>
<td>email</td>
</tr>
</tbody>
</table>
<h5>4.6.3 返回说明</h5>
<pre><code class="language-json">{
&quot;code&quot;: 200,
&quot;msg&quot;: &quot;成功&quot;,
&quot;taskNo&quot;: &quot;69564903663951243279&quot;
}</code></pre>
<hr />
<h4>4.7 已开发票明细查询</h4>
<ul>
<li>从局端查询符合指定条件的发票详细明细信息。</li>
</ul>
<h5>4.7.1 请求地址</h5>
<p><code>https://api.jumdata.com/invoice/makeout/result/detail</code></p>
<h5>4.7.2 业务参数</h5>
<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>fphm</td>
<td>String</td>
<td>是</td>
<td>发票号码，20位数电发票号码</td>
</tr>
<tr>
<td>kprq</td>
<td>String</td>
<td>是</td>
<td>开票日期，格式yyyy-MM-dd HH:mm:ss</td>
</tr>
<tr>
<td>dataScope</td>
<td>String</td>
<td>否</td>
<td>获取的数据范围字段，0 或者空默认值 只获取发票预览的数据 1 获取勾选状态 2.获取入账状态 3 获取入账，勾选，预览数据</td>
</tr>
</tbody>
</table>
<h5>4.7.3 返回说明</h5>
<pre><code class="language-json">{
&quot;msg&quot;: &quot;成功&quot;,
&quot;code&quot;: 200,
&quot;taskNo&quot;: &quot;304007405210108423770574&quot;,
&quot;data&quot;: {
&quot;kplx&quot;: &quot;1&quot;,//开票类型 0：正常票，1：红冲票
&quot;xsf_dz&quot;: &quot;******************弄1-72号B座12层&quot;,//销方地址
&quot;gmf_dz&quot;: &quot;**************906号001&quot;,//购方地址
&quot;xsf_yhzh&quot;: &quot;**********10301&quot;,//销方银行账号
&quot;kce&quot;: 0,//扣除额
&quot;hjje&quot;: -0.94,//合计金额
&quot;gmf_dh&quot;: &quot;********7376&quot;,//购方电话
&quot;xsf_nsrsbh&quot;: &quot;************PDDL2G&quot;,//销方纳税人识别号
&quot;jshj_chn&quot;: &quot;（负数）壹圆整&quot;,//价税合计（中文大写）
&quot;kprq&quot;: &quot;2024-02-29 10:59:02&quot;,//开票日期时间
&quot;bz&quot;: &quot;******************************************号：************02704133&quot;,//备注
&quot;xmmx&quot;: [//项目明细
{
&quot;ggxh&quot;: null,//规格型号
&quot;spsl&quot;: null,//商品数量
&quot;yhzcbs&quot;: &quot;N&quot;,//优惠政策标识 N-未享受, Y-享受
&quot;dj&quot;: null,//商品单价
&quot;spmc&quot;: &quot;研发和技术服务&quot;,//商品税收名称
&quot;yhzclxDm&quot;: null,//优惠政策类型代码（&quot;03&quot;:&quot;免税&quot;,&quot;04&quot;:&quot;不征税&quot;, &quot;08&quot;:&quot;按3%简易征收&quot;,&quot;09&quot;:&quot;按5%简易征收&quot;）,yhzcbs=‘Y&#039;时有值
&quot;xmmc2&quot;: &quot;*研发和技术服务*技术服务费&quot;,//项目名称全称 带税收名称和星号
&quot;kce&quot;: 0,//扣除额
&quot;xsyhzcbz&quot;: null,//
&quot;lzMxxh&quot;: 1,//对应蓝字明细序 仅负数发票有值
&quot;xh&quot;: 1,//行序号
&quot;fphxz&quot;: &quot;0&quot;,//发票行性质 0：正常行 1：折扣行 2：被折扣行
&quot;se&quot;: -0.06,//
&quot;dw&quot;: null,//单位
&quot;xmmc&quot;: &quot;技术服务费&quot;,//项目名称 不带税收名称
&quot;sl&quot;: &quot;0.06&quot;,//
&quot;je&quot;: -0.94,//
&quot;spbm&quot;: &quot;3040105000000000000&quot; //商品税收编码 19位税收分类代码
}
],
&quot;gmf_nsrmc&quot;: &quot;**********术有限公司&quot;,//购方名称
&quot;zz_fpdm&quot;: null,//纸质发票代码
&quot;xsf_yhmc&quot;: &quot;**********上海青浦支行&quot;,//销方开户银行
&quot;kpf_nsrsbh&quot;: &quot;************PDDL2G&quot;,//开票方纳税人识别号
&quot;hjse&quot;: -0.06,//合计税额
&quot;gmf_yhmc&quot;: &quot;**************首体科技金融支行&quot;,//购方开户银行
&quot;kpr&quot;: &quot;**飞&quot;,//开票人
&quot;xsf_dh&quot;: &quot;******98617&quot;,//销方电话
&quot;fplxdm&quot;: &quot;030&quot;,//发票类型代码, 增值税纸质专用发票：004 增值税纸质普通发票：007 增值税纸质普通发票（卷式发票）：025 增值税电子普通发票：026 增值税电子专用发票：028 全面数字化电子普通发票：030 全面数字化电子专用发票：032 机动车发票：005;
&quot;xsf_nsrmc&quot;: &quot;********信息有限公司&quot;,//销方纳税人名称
&quot;ewm&quot;: &quot;01,32, ,************54513944,-1,20240229, ,F3F7&quot;,//发票二维码
&quot;jshj&quot;: -1,//价税合计
&quot;zz_fphm&quot;: null,//纸质发票号码
&quot;gmf_nsrsbh&quot;: &quot;************BDRR90&quot;,//购方纳税人识别号
&quot;gmf_yhzh&quot;: &quot;**********10702&quot;,//购方银行账号
&quot;fphm&quot;: &quot;************54513944&quot; //发票号码
}
}
</code></pre>
<hr />
<h3>5 红冲相关接口</h3>
<h4>5.1 红字确认单申请</h4>
<ul>
<li>对数电发票进行红冲前，需先申请红字信息确认单，可通过本接口发起红字信息确认单申请流程</li>
</ul>
<h5>5.1.1 请求地址</h5>
<p><code>https://api.jumdata.com/invoice/makeout/deficit/apply</code></p>
<h5>5.1.2 请求格式</h5>
<ul>
<li>application/json
> 注：本接口公共参数需要放在请求Header中</li>
</ul>
<h5>5.1.3 业务参数</h5>
<ul>
<li>样例</li>
</ul>
<pre><code>{
&quot;nsrsbh&quot;: &quot;string&quot;,
&quot;data&quot;: {
&quot;lrfsf&quot;: &quot;0&quot;,
&quot;gmfNsrsbh&quot;: &quot;string&quot;,
&quot;xsfNsrsbh&quot;: &quot;string&quot;,
&quot;lzFphm&quot;: &quot;string&quot;,
&quot;lzKprq&quot;: &quot;string&quot;,
&quot;fplxdm&quot;: &quot;string&quot;,
&quot;hcyydm&quot;: &quot;string&quot;,
&quot;hcjshj&quot;: &quot;string&quot;,
&quot;bfhc&quot;: {
&quot;bfhcbz&quot;: &quot;string&quot;,
&quot;hsslbs&quot;: &quot;string&quot;,
&quot;hcmx&quot;: [
{
&quot;lzmxxh&quot;: &quot;string&quot;,
&quot;hcsl&quot;: &quot;string&quot;,
&quot;hcje&quot;: &quot;string&quot;,
&quot;hcse&quot;: &quot;string&quot;
}
]
}
}
}
</code></pre>
<ul>
<li>字段说明</li>
</ul>
<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</td>
<td>Object</td>
<td>是</td>
<td>请求内容</td>
</tr>
</tbody>
</table>
<ul>
<li>data字段说明</li>
</ul>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必须</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>lrfsf</td>
<td>String</td>
<td>否</td>
<td>录入方身份 0-销方发起（默认），1-购方发起</td>
</tr>
<tr>
<td>gmfNsrsbh</td>
<td>String</td>
<td>是</td>
<td>购买方识别号</td>
</tr>
<tr>
<td>xsfNsrsbh</td>
<td>String</td>
<td>否</td>
<td>销售方识别号</td>
</tr>
<tr>
<td>lzFphm</td>
<td>String</td>
<td>是</td>
<td>蓝字数电号码，20位发票号码</td>
</tr>
<tr>
<td>lzKprq</td>
<td>String</td>
<td>是</td>
<td>原开票日期，yyyy-MM-dd HH:mm:ss</td>
</tr>
<tr>
<td>fplxdm</td>
<td>String</td>
<td>是</td>
<td>发票类型代码，030-数电普票，032-数电专票</td>
</tr>
<tr>
<td>hcyydm</td>
<td>String</td>
<td>是</td>
<td>红冲原因代码，01-开票有误，02-销货退回 ， 03-服务中止， 04-销售折让</td>
</tr>
<tr>
<td>hcjshj</td>
<td>Number</td>
<td>否</td>
<td>红冲价税合计，传本次红冲的总金额+总税额，此参数可不传，传入是为了确认本次红冲的金额与原蓝字发票票面金额的一致性</td>
</tr>
<tr>
<td>bfhc</td>
<td>Object</td>
<td>否</td>
<td>部分红冲，不传表示全额红冲，详见bfhc字段说明</td>
</tr>
</tbody>
</table>
<ul>
<li>bfhc字段说明</li>
</ul>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必须</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>bfhcbz</td>
<td>String</td>
<td>否</td>
<td>部分红冲标志， 1-部分红冲，0-全额红冲（默认）</td>
</tr>
<tr>
<td>hsslbs</td>
<td>String</td>
<td>否</td>
<td>部分红冲时使用的计税方式，1-不含税价, 2-含税价（默认）</td>
</tr>
<tr>
<td>hcmx</td>
<td>Array</td>
<td>否</td>
<td>部分红冲明细，详见hcmx字段说明</td>
</tr>
</tbody>
</table>
<ul>
<li>hcmx字段说明</li>
</ul>
<table>
<thead>
<tr>
<th>名称</th>
<th>类型</th>
<th>必须</th>
<th><div style="width:420px;">说明</div></th>
</tr>
</thead>
<tbody>
<tr>
<td>lzmxxh</td>
<td>String</td>
<td>是</td>
<td>对应的蓝字发票明细项序号，注（行号序号从1开始，除拆扣行，依次为1,2,3...行)</td>
</tr>
<tr>
<td>hcsl</td>
<td>Number</td>
<td>否</td>
<td>本次红冲数量，如果原蓝字发票没有数量和单价，则无需传值</td>
</tr>
<tr>
<td>hcje</td>
<td>Number</td>
<td>是</td>
<td>本次红冲金额</td>
</tr>
<tr>
<td>hcse</td>
<td>Number</td>
<td>否</td>
<td>本次红冲税额 不传时会自动计算。<br>价税计算存在以下三种情况：<br>1、如果传入了税额，不管使用含税还是不含税计算方式，金额(je)必须传入不含税价。<br>2、如果不传入税额，且使用不含税计算方式，则金额(je)须传入不含税金额<br>3、如果不传入税额，且使用含税计算方式，则金额(je)须传入含税金额，系统会自动反算成不含税金额</td>
</tr>
</tbody>
</table>
<h5>5.1.4 返回说明</h5>
<pre><code class="language-json">{
&quot;code&quot;: 200,
&quot;msg&quot;: &quot;成功&quot;,
&quot;taskNo&quot;: &quot;69564903663951243279&quot;,
&quot;data&quot;: {
&quot;hzuuid&quot;: &quot;string&quot;, // 红字申请uuid
&quot;gmfNsrsbh&quot;: &quot;string&quot;, // 购买方识别号
&quot;xsfNsrsbh&quot;: &quot;string&quot;, // 销售方识别号
&quot;qrjkpbz&quot;: &quot;Y&quot; // 是否立即开具红票。Y-申请后立即开具工票，无需确认，也不能撤销；N-在红字申请单确认后，需要手工发起红字发票（负数发票）的开具。 数电电子发票通常为Y，纸票可能存在为N的情况
}
}</code></pre>
<hr />
<h4>5.2 红字确认单确认</h4>
<ul>
<li>销方发起红字信息确认单申请后，购方可通过该接口进行红字单确认，并自动开具相对应的负数发票</li>
</ul>
<h5>5.2.1 请求地址</h5>
<p><code>https://api.jumdata.com/invoice/makeout/deficit/confirm</code></p>
<h5>5.2.2 业务参数</h5>
<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>xsfNsrsbh</td>
<td>String</td>
<td>是</td>
<td>销方纳税人识别号</td>
</tr>
<tr>
<td>hzuuid</td>
<td>String</td>
<td>是</td>
<td>红字信息UUID</td>
</tr>
<tr>
<td>qrlx</td>
<td>String</td>
<td>是</td>
<td>Y/N, Y - 确认， N - 拒绝</td>
</tr>
</tbody>
</table>
<h5>5.2.3 返回说明</h5>
<pre><code class="language-json">{
&quot;code&quot;: 200,
&quot;msg&quot;: &quot;成功&quot;,
&quot;taskNo&quot;: &quot;69564903663951243279&quot;
}</code></pre>
<hr />
<h4>5.3 红字确认单撤销</h4>
<ul>
<li>购方（销方）发起红字信息确认单申请后，可通过该接口进行红字确认单撤销操作</li>
</ul>
<h5>5.3.1 请求地址</h5>
<p><code>https://api.jumdata.com/invoice/makeout/deficit/cancel</code></p>
<h5>5.3.2 业务参数</h5>
<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>xsfNsrsbh</td>
<td>String</td>
<td>是</td>
<td>销方纳税人识别号</td>
</tr>
<tr>
<td>hzuuid</td>
<td>String</td>
<td>是</td>
<td>红字信息UUID</td>
</tr>
</tbody>
</table>
<h5>5.3.3 返回说明</h5>
<pre><code class="language-json">{
&quot;code&quot;: 200,
&quot;msg&quot;: &quot;成功&quot;,
&quot;taskNo&quot;: &quot;69564903663951243279&quot;
}</code></pre>
<hr />
<h4>5.4 红字确认单查询</h4>
<ul>
<li>对数电发票红冲时，需先完成红字信息确认单申请，本接口可查询本纳税主体下已申请或待确认的红字信息确认单列表</li>
</ul>
<h5>5.4.1 请求地址</h5>
<p><code>https://api.jumdata.com/invoice/makeout/deficit/list</code></p>
<h5>5.4.2 业务参数</h5>
<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>pageNo</td>
<td>Integer</td>
<td>否</td>
<td>当前页码，默认：1</td>
</tr>
<tr>
<td>pageSize</td>
<td>Integer</td>
<td>否</td>
<td>每页记录数，可选值：10、20、50，默认：10</td>
</tr>
<tr>
<td>kprqq</td>
<td>String</td>
<td>是</td>
<td>开票起始日期，格式：yyyy-MM-dd，起止日期必传且为一年内</td>
</tr>
<tr>
<td>kprqz</td>
<td>String</td>
<td>否</td>
<td>开票结束日期，默认：今天，格式： yyyy-MM-dd，起止日期必传且为一年内</td>
</tr>
<tr>
<td>hzqrztDm</td>
<td>String</td>
<td>否</td>
<td>红字确认状态代码<br>01 - 无需确认（全电大多数情况是自动01）<br> 02 - 销方录入待购方确认<br> 03 - 购方录入待销方确认<br> 04 - 购销双方已确认<br> 05 - 作废（销方录入购方否认）<br> 06 - 作废（购方录入销方否认）<br> 07 - 作废（超 72 小时未确认）<br> 08 - 发起方撤销 <br>09 - 确认后撤销</td>
</tr>
<tr>
<td>dfnsrmc</td>
<td>String</td>
<td>否</td>
<td>对方纳税人名称</td>
</tr>
<tr>
<td>gxflx</td>
<td>String</td>
<td>是</td>
<td>购销方类型，0 - 我是销方，1 - 我是购方</td>
</tr>
</tbody>
</table>
<h5>5.4.3 返回说明</h5>
<pre><code class="language-json">{
&quot;code&quot;: 200,
&quot;msg&quot;: &quot;成功&quot;,
&quot;taskNo&quot;: &quot;69564903663951243279&quot;,
&quot;data&quot;: {
&quot;records&quot;: 16, //
&quot;pageNo&quot;: 1,
&quot;pageSize&quot;: 10,
&quot;list&quot;: [
{
&quot;hzuuid&quot;: &quot;********************c0223d26e97e&quot;, // 红字确认单UUID
&quot;hzqrdbh&quot;: &quot;31022924011005502771&quot;, // 红字确认单编号
&quot;gmfNsrsbh&quot;: &quot;************BDRR90&quot;, // 购买方纳税人识别号
&quot;gmfNsrmc&quot;: &quot;**********术有限公司&quot;, // 购买方纳税人名称
&quot;xsfNsrsbh&quot;: &quot;************PDDL2G&quot;, // 销售方纳税人识别号
&quot;xsfNsrmc&quot;: &quot;********信息有限公司&quot;, // 销售方纳税人名称
&quot;lrfsf&quot;: &quot;0&quot;, // 录入方身份 0：销方，1：购方
&quot;hzqrztDm&quot;: &quot;01&quot;, // 红字确认状态代码 01：无需确认（全电大多数情况是自动01） 02：销方录入待购方确认 03：购方录入待销方确认 04：购销双方已确认 05：作废（销方录入购方否认） 06：作废（购方录入销方否认） 07：作废（超 72 小时未确认） 08：发起方撤销 09：确认后撤销
&quot;hcyydm&quot;: &quot;01&quot;, // 红冲原因代码 01-开票有误，02-销货退回 ， 03-服务中止，04-销售折让
&quot;qrjkp&quot;: &quot;Y&quot;, // 确认即开票 Y-是，N-否
&quot;qrrq&quot;: null, // 确认日期
&quot;kpr&quot;: &quot;**飞&quot;, // 开票人
&quot;hzFphm&quot;: &quot;************33969191&quot;, // 红字发票号码
&quot;hzFpdm&quot;: null, // 红字发票代码 数电时为空
&quot;hzKprq&quot;: &quot;2024-01-31 15:09:52&quot;, // 红字开票日期
&quot;hzkjBz&quot;: &quot;Y&quot;, // 红字开具标志 Y-已开票，N或空-未开票
&quot;hzHjje&quot;: -1.13 , // 红字合计金额
&quot;hzHjse&quot;: -0.07, // 红字合计税额
&quot;lzFphm&quot;: &quot;************23057583&quot;, // 蓝字发票号码
&quot;lzFpdm&quot;: null, // 蓝字发票代码 数电时为空
&quot;lzKprq&quot;: &quot;2024-01-22 19:56:27&quot;, // 蓝字开票日期
&quot;lzFplxdm&quot;: &quot;030&quot;, // 蓝字发票类型代码 30-普通发票，32-专票
&quot;lzHjje&quot;: 1.13, // 蓝字合计金额
&quot;lzHjse&quot;: 0.07, // 蓝字合计税额
&quot;ydkse&quot;: 0, // 已抵扣税额
&quot;rzzt&quot;: &quot;00&quot;, // 入账状态 00:未入账；01:已入帐
&quot;xfsYtZt&quot;: &quot;00&quot;,// 消费税用途状态 00-未勾选、01-已勾选
&quot;zzsYtzt&quot;: &quot;03&quot;, // 增值税用途状态 00-已勾选未确认、01-已确认、03-未勾选
&quot;lzTdyslxDm&quot;: null, // 蓝字发票特定要素类型代码
&quot;yjjdkncpse&quot;: 0, // 已加计抵扣农产品进项税额
&quot;bz&quot;: &quot;&quot; // 备注
}
]
}
}</code></pre>
<hr />
<h4>5.5 红字确认单详细信息</h4>
<ul>
<li>对数电发票红冲时，需先完成红字信息确认单申请，本接口可通过红字信息UUID查询对应的信息确认单处理（红冲）状态</li>
</ul>
<h5>5.5.1 请求地址</h5>
<p><code>https://api.jumdata.com/invoice/makeout/deficit/detail</code></p>
<h5>5.5.2 业务参数</h5>
<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>xsfNsrsbh</td>
<td>String</td>
<td>是</td>
<td>销方纳税人识别号</td>
</tr>
<tr>
<td>hzuuid</td>
<td>String</td>
<td>是</td>
<td>红字信息UUID</td>
</tr>
</tbody>
</table>
<h5>5.5.3 返回说明</h5>
<pre><code class="language-json">{
&quot;code&quot;: 200,
&quot;msg&quot;: &quot;成功&quot;,
&quot;taskNo&quot;: &quot;69564903663951243279&quot;,
&quot;data&quot;: {
&quot;hzuuid&quot;: &quot;********************c0223d26e97e&quot;, // 红字确认单UUID
&quot;hzqrdbh&quot;: &quot;31022924011005502771&quot;, // 红字确认单编号
&quot;gmfNsrsbh&quot;: &quot;************BDRR90&quot;, // 购买方纳税人识别号
&quot;gmfNsrmc&quot;: &quot;**********术有限公司&quot;, // 购买方纳税人名称
&quot;xsfNsrsbh&quot;: &quot;************PDDL2G&quot;, // 销售方纳税人识别号
&quot;xsfNsrmc&quot;: &quot;********信息有限公司&quot;, // 销售方纳税人名称
&quot;lrfsf&quot;: &quot;0&quot;, // 录入方身份 0：销方，1：购方
&quot;hzqrztDm&quot;: &quot;01&quot;, // 红字确认状态代码 01：无需确认（全电大多数情况是自动01） 02：销方录入待购方确认 03：购方录入待销方确认 04：购销双方已确认 05：作废（销方录入购方否认） 06：作废（购方录入销方否认） 07：作废（超 72 小时未确认） 08：发起方撤销 09：确认后撤销
&quot;hcyydm&quot;: &quot;01&quot;, // 红冲原因代码 01-开票有误，02-销货退回 ， 03-服务中止，04-销售折让
&quot;qrjkp&quot;: &quot;Y&quot;, // 确认即开票 Y-是，N-否
&quot;qrrq&quot;: null, // 确认日期
&quot;kpr&quot;: &quot;**飞&quot;, // 开票人
&quot;hzFphm&quot;: &quot;************33969191&quot;, // 红字发票号码
&quot;hzFpdm&quot;: null, // 红字发票代码 数电时为空
&quot;hzKprq&quot;: &quot;2024-01-31 15:09:52&quot;, // 红字开票日期
&quot;hzkjBz&quot;: &quot;Y&quot;, // 红字开具标志 Y-已开票，N或空-未开票
&quot;hzHjje&quot;: -1.13 , // 红字合计金额
&quot;hzHjse&quot;: -0.07, // 红字合计税额
&quot;lzFphm&quot;: &quot;************23057583&quot;, // 蓝字发票号码
&quot;lzFpdm&quot;: null, // 蓝字发票代码 数电时为空
&quot;lzKprq&quot;: &quot;2024-01-22 19:56:27&quot;, // 蓝字开票日期
&quot;lzFplxdm&quot;: &quot;030&quot;, // 蓝字发票类型代码 30-普通发票，32-专票
&quot;lzHjje&quot;: 1.13, // 蓝字合计金额
&quot;lzHjse&quot;: 0.07, // 蓝字合计税额
&quot;ydkse&quot;: 0, // 已抵扣税额
&quot;rzzt&quot;: &quot;00&quot;, // 入账状态 00:未入账；01:已入帐
&quot;xfsYtZt&quot;: &quot;00&quot;,// 消费税用途状态 00-未勾选、01-已勾选
&quot;zzsYtzt&quot;: &quot;03&quot;, // 增值税用途状态 00-已勾选未确认、01-已确认、03-未勾选
&quot;lzTdyslxDm&quot;: null, // 蓝字发票特定要素类型代码
&quot;yjjdkncpse&quot;: 0, // 已加计抵扣农产品进项税额
&quot;bz&quot;: &quot;&quot;, // 备注
&quot;xmmx&quot;: [
{
&quot;xh&quot;: 1, // 行序号
&quot;lzMxxh&quot;: 1, // 对应蓝字明细序
&quot;uuid&quot;: &quot;277fd1be295c4342a2af5716e438b22f&quot;, // 行UUID
&quot;spmc&quot;: &quot;研发和技术服务&quot;, // 商品税收名称
&quot;xmmc&quot;: &quot;技术服务费&quot;, // 项目名称 不带税收名称
&quot;xmmc2&quot;: &quot;*研发和技术服务*技术服务费&quot;, // 项目名称全称 带税收名称和星号
&quot;spbm&quot;: &quot;3040105000000000000&quot;, // 商品税收编码
&quot;ggxh&quot;: null, // 规格型号
&quot;spsl&quot;: &quot;&quot;, // 商品数量
&quot;dj&quot;: null, // 商品单价
&quot;dw&quot;: null, // 单位
&quot;sl&quot;: &quot;0.06&quot;, // 税率
&quot;se&quot;: -0.07, // 税额
&quot;je&quot;: -1.13, // 金额
}
]
}
}</code></pre>
<hr />
<h4>5.6 红字发票开具</h4>
<ul>
<li>红字申请单保存如果返回未开具，可调用此接口开具红字发票</li>
</ul>
<h5>5.6.1 请求地址</h5>
<p><code>https://api.jumdata.com/invoice/makeout/deficit/request</code></p>
<h5>5.6.2 业务参数</h5>
<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>xsfNsrsbh</td>
<td>String</td>
<td>是</td>
<td>销方纳税人识别号</td>
</tr>
<tr>
<td>hzuuid</td>
<td>String</td>
<td>是</td>
<td>红字信息UUID</td>
</tr>
</tbody>
</table>
<h5>5.6.3 返回说明</h5>
<pre><code class="language-json">{
&quot;code&quot;: 200,
&quot;msg&quot;: &quot;成功&quot;,
&quot;taskNo&quot;: &quot;69564903663951243279&quot;,
&quot;data&quot;: {
&quot;fphm&quot;: &quot;&quot;,//数电票号码
&quot;zzfphm&quot;: &quot;&quot;,//纸质发票号码
&quot;fpdm&quot;: &quot;&quot;,//票代码
&quot;kprq&quot;: &quot;&quot;,//开票日期
&quot;xsfNsrsbh&quot;: &quot;&quot;,//销售方纳税人识别号
&quot;gmfNsrsbh&quot;: &quot;&quot;,//购买方纳税人识别号
&quot;xsfmc&quot;: &quot;&quot;,//销售方名称
&quot;gmfmc&quot;: &quot;&quot;,//购买方名称
&quot;jshj&quot;: null,//价税合计
&quot;bzxx&quot;: &quot;&quot;,
&quot;hzqrdbh&quot;: &quot;&quot;,
&quot;tdyslxDm&quot;: &quot;&quot;,//特定业务类型代码
&quot;gmfzrrbz&quot;: &quot;&quot;
}
}</code></pre>