5.7 发票申请接口
<p>[TOC]</p>
<p>请求模式：渠道方→华农阿凡达平台</p>
<p>接口描述：发票申请</p>
<p>测试接口地址：<a href="https://porsche-avatar.chinahuanong.com.cn/avatar/invoice/invoiceApply">https://porsche-avatar.chinahuanong.com.cn/avatar/invoice/invoiceApply</a></p>
<p>生产接口地址：<a href="https://avatar.chinahuanong.com.cn/avatar/invoice/invoiceApply">https://avatar.chinahuanong.com.cn/avatar/invoice/invoiceApply</a></p>
<h3>请求头</h3>
<p><code>head</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>渠道代码</td>
<td>policySource</td>
<td>varchar</td>
<td>Y</td>
<td>保险公司分配给 渠道方的渠道编码</td>
</tr>
<tr>
<td>请求时间</td>
<td>reqTime</td>
<td>DateTime</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>接口类型</td>
<td>interfaceType</td>
<td>varchar</td>
<td>Y</td>
<td>针对每个接口，使用接口的API信息</td>
</tr>
<tr>
<td>订单号</td>
<td>orderNo</td>
<td>varchar</td>
<td>Y</td>
<td>订单号</td>
</tr>
<tr>
<td>唯一标识符</td>
<td>uuid</td>
<td>varchar</td>
<td>Y</td>
<td>单次请求唯一标识符，任一次请求不允许相同</td>
</tr>
</tbody>
</table>
<h3>请求体</h3>
<p><code>invoiceApply</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>发票申请号</td>
<td>invoiceApplyNo</td>
<td>varchar</td>
<td>Y</td>
<td>每次申请用不同的申请号 issueType=2 时，使用该字段幂等</td>
</tr>
<tr>
<td>开具方式标识</td>
<td>issueType</td>
<td>varchar</td>
<td>Y</td>
<td>0-SFTP开具 1-报文开具 2-指定金额报文开具</td>
</tr>
<tr>
<td>Sftp地址</td>
<td>fileURL</td>
<td>varchar</td>
<td>CY</td>
<td>Sftp文件上传地址 <br/>/upload/invoiceupload/yyyy-mm-dd/</td>
</tr>
<tr>
<td>保单号</td>
<td>policyList</td>
<td>List<String></td>
<td>CY</td>
<td>issueType=1时必传，报文开具必传最多500单 （通过保单号幂等有效期10分钟，幂等返回提示：操作频繁，请10min后再重试；）</td>
</tr>
<tr>
<td>开票清单</td>
<td>invoiceAppointLists</td>
<td>List<InvoiceAppoint></td>
<td>CY</td>
<td>issueType=2时必传</td>
</tr>
<tr>
<td>保单类型</td>
<td>certiType</td>
<td>varchar</td>
<td>N</td>
<td>C:保单 V:凭证</td>
</tr>
<tr>
<td>发票类型</td>
<td>invoiceType</td>
<td>varchar</td>
<td>Y</td>
<td>0-增值税专用发票 1-增值税普通发票 2-电子发票 01-数电发票(增值税专用发票) 02-数电发票(增值税普通发票)</td>
</tr>
<tr>
<td>发票头类型</td>
<td>invoiceHeadType</td>
<td>varchar</td>
<td>Y</td>
<td>1-投保人 2-被保人</td>
</tr>
<tr>
<td>发票抬头</td>
<td>invoiceHead</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>证件类型</td>
<td>cardType</td>
<td>varchar</td>
<td>CY</td>
<td>01 身份证 02 户口薄 03 军官证 04 士兵证 05 港澳居民来往内地通行证 06 台湾居民来往大陆通行证 07 其他 （注:电子发票为必录）</td>
</tr>
<tr>
<td>证件号码</td>
<td>cardNo</td>
<td>varchar</td>
<td>CY</td>
<td>电子发票为必录</td>
</tr>
<tr>
<td>证件人名称</td>
<td>cardName</td>
<td>varchar</td>
<td>CY</td>
<td>电子发票为必录</td>
</tr>
<tr>
<td>邮箱</td>
<td>email</td>
<td>varchar</td>
<td>CY</td>
<td></td>
</tr>
<tr>
<td>手机号</td>
<td>mobile</td>
<td>varchar</td>
<td>CY</td>
<td>电子发票/数电发票 必录且必须为手机号 手机号、邮箱必录一项</td>
</tr>
<tr>
<td>纳税人类型</td>
<td>customerIdentities</td>
<td>varchar</td>
<td>Y</td>
<td>C-一般纳税人 S-小规模纳税人 Q-政府机构/事业单位 P-个人</td>
</tr>
<tr>
<td>客户纳税人识别号</td>
<td>customerTaxNo</td>
<td>varchar</td>
<td>CY</td>
<td>纳税人类型为：C，S时为必录</td>
</tr>
<tr>
<td>客户电话</td>
<td>customerPhone</td>
<td>varchar(50)</td>
<td>CY</td>
<td>中文占2个，英文占1个字符</td>
</tr>
<tr>
<td>客户开户行</td>
<td>customerBankAndAccount</td>
<td>varchar(100)</td>
<td>CY</td>
<td>中文占2个，英文占1个字符</td>
</tr>
<tr>
<td>客户开户行账号</td>
<td>customerAccount</td>
<td>varchar(50)</td>
<td>CY</td>
<td>中文占2个，英文占1个字符</td>
</tr>
<tr>
<td>客户地址</td>
<td>customerAddress</td>
<td>varchar(200)</td>
<td>CY</td>
<td>中文占2个，英文占1个字符</td>
</tr>
<tr>
<td>发票回调地址</td>
<td>callbackUrl</td>
<td>varchar</td>
<td>N</td>
<td>支持传入回调地址</td>
</tr>
<tr>
<td>备注</td>
<td>remake</td>
<td>varchar</td>
<td>N</td>
<td>最大长度中文68字，英文136字</td>
</tr>
<tr>
<td>开具流程</td>
<td>partFlag</td>
<td>varchar</td>
<td>N</td>
<td>0:部分开具 1:轧差开具 2:全额开具（飞鸟鱼渠道用，其他渠道不传）</td>
</tr>
<tr>
<td>开票方式</td>
<td>waySofBills</td>
<td>varchar</td>
<td>CY</td>
<td>1-线上2-线下 3-官网 4-小程序 5-文件开票 6-链接开票 7-商城 8-天捷 9-天翼（内部对接用，其他渠道不传）</td>
</tr>
</tbody>
</table>
<p><code>InvoiceAppoint</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>保单号</td>
<td>policyNo</td>
<td>varchar</td>
<td>Y</td>
<td>保单开票传保单号，批单开票传对应批单号</td>
</tr>
<tr>
<td>开具金额</td>
<td>sumPremium</td>
<td>BigDecimal</td>
<td>Y</td>
<td>开具金额</td>
</tr>
</tbody>
</table>
<h3>响应头</h3>
<p><code>head</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>渠道代码</td>
<td>policySource</td>
<td>varchar</td>
<td>Y</td>
<td>保险公司分配给 渠道方的渠道编码</td>
</tr>
<tr>
<td>响应时间</td>
<td>respTime</td>
<td>DateTime</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>接口类型</td>
<td>interfaceType</td>
<td>varchar</td>
<td>Y</td>
<td>针对每个接口，使用接口的API信息</td>
</tr>
<tr>
<td>订单号</td>
<td>orderNo</td>
<td>varchar</td>
<td>Y</td>
<td>贯穿保单始终的订单号， 要求必须唯一，会进行幂等检查</td>
</tr>
<tr>
<td>唯一标识符</td>
<td>uuid</td>
<td>varchar</td>
<td>Y</td>
<td>单次请求唯一标识符，任一次请求不允许相同</td>
</tr>
</tbody>
</table>
<h3>响应体</h3>
<p><code>respBody</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>字段描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>发票申请号</td>
<td>invoiceApplyNo</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>处理状态码</td>
<td>dealCode</td>
<td>varchar</td>
<td>Y</td>
<td>处理结果状态码</td>
</tr>
<tr>
<td>处理结果描述</td>
<td>dealDesc</td>
<td>varchar</td>
<td>Y</td>
<td>处理结果描述</td>
</tr>
</tbody>
</table>
<h3>报文示例</h3>
<h4>请求</h4>
<pre><code class="language-json">{
&quot;head&quot;: {
&quot;interfaceType&quot;: &quot;invoice&quot;,
&quot;orderNo&quot;: &quot;QS221213092908924R89D47&quot;,
&quot;policySource&quot;: &quot;HN_HT_QNW&quot;,
&quot;reqTime &quot;: &quot;2022-12-15 17: 26: 30&quot;,
&quot;uuid &quot;: &quot;a4b16e97-c8fc-467f-85b2-9e59b9278f24&quot;
},
&quot;invoiceApply&quot;: {
&quot;cardName&quot;: &quot;谢华国&quot;,
&quot;cardNo&quot;: &quot;身份证&quot;,
&quot;cardType&quot;: &quot;01&quot;,
&quot;customerIdentities&quot;: &quot;C&quot;,
&quot;customerTaxNo&quot;: &quot;91650106MA79L09MXF&quot;,
&quot;invoiceApplyNo&quot;: &quot;100782030676&quot;,
&quot;invoiceHead&quot;: &quot;新疆数农信息科技有限公司&quot;,
&quot;invoiceHeadType&quot;: &quot;1&quot;,
&quot;invoiceType&quot;: &quot;2 &quot;,
&quot;mobile&quot;: &quot;手机号 &quot;,
&quot;policyList&quot;: [
&quot;X11002749220000938375 &quot;
]
}
}
</code></pre>
<h4>返回</h4>
<pre><code class="language-json">{
&quot;head&quot;: {
&quot;interfaceType&quot;: &quot;invoice&quot;,
&quot;orderNo&quot;: &quot;QS221213092908924R89D47&quot;,
&quot;policySource&quot;: &quot;HN_HT_QNW&quot;,
&quot;respTime&quot;: 1671096390178,
&quot;uuid&quot;: &quot;a4b16e97-c8fc-467f-85b2-9e59b9278f24&quot;
},
&quot;respBody&quot;: {
&quot;dealCode&quot;: &quot;1&quot;,
&quot;dealDesc&quot;: &quot;成功&quot;,
&quot;invoiceApplyNo&quot;: &quot;100782030676&quot;
}
}
</code></pre>