3.25 发票/红冲申请接口
<p>[TOC]</p>
<p>请求模式：渠道方→保司</p>
<p>接口描述：发票申请</p>
<p>测试接口地址：<a href="https://hermesgyb.zhlic.net/avatar/invoice/invoiceApply">https://hermesgyb.zhlic.net/avatar/invoice/invoiceApply</a></p>
<p>生产接口地址：<a href="https://gyb.zhlic.net/avatar/invoice/invoiceApply">https://gyb.zhlic.net/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>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>发票请求id</td>
<td>reqInvoiceId</td>
<td>varchar</td>
<td>Y</td>
<td>申请id,幂等使用</td>
</tr>
<tr>
<td>开票清单</td>
<td>invoiceAppointLists</td>
<td>List<InvoiceAppoint></td>
<td>Y</td>
<td>最大清单列表500单</td>
</tr>
<tr>
<td>邮箱</td>
<td>email</td>
<td>varchar</td>
<td>Y</td>
<td></td>
</tr>
<tr>
<td>发票类型</td>
<td>invoiceType</td>
<td>varchar</td>
<td>Y</td>
<td>81-全电专票 82-全电普票</td>
</tr>
<tr>
<td>受票方类型</td>
<td>customerType</td>
<td>varchar</td>
<td>Y</td>
<td>1 自然人 2 企业对公 3 非企业对公</td>
</tr>
<tr>
<td>受票方名称</td>
<td>customerName</td>
<td>varchar</td>
<td>Y</td>
<td>投保人名称</td>
</tr>
<tr>
<td>受票方识别号</td>
<td>customerTaxNo</td>
<td>varchar</td>
<td>CY</td>
<td>当受票方为企业时必传 投保人证件号码</td>
</tr>
<tr>
<td>开票人员</td>
<td>invoiceStaff</td>
<td>varchar</td>
<td>Y</td>
<td>申请操作员姓名</td>
</tr>
<tr>
<td>开票申请类型</td>
<td>invoiceFlag</td>
<td>varchar</td>
<td>Y</td>
<td>0-发票红冲 1-发票开具</td>
</tr>
<tr>
<td>原发票号码</td>
<td>originInvoiceCode</td>
<td>varchar</td>
<td>CY</td>
<td>红冲时必传</td>
</tr>
<tr>
<td>开票/红冲总金额</td>
<td>sumInvoicePremium</td>
<td>BigDecimal</td>
<td>Y</td>
<td>全部保单总金额</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>
</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>invoicePremium</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>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>CY</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>