5.8 发票通知接口
<p>[TOC]</p>
<p>请求模式：华农阿凡达平台→渠道方</p>
<p>接口描述：发票通知接口，保司生成发票通知渠道方</p>
<p>测试接口地址：渠道方地址</p>
<p>生产接口地址：渠道方地址</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>invoiceNotice</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>invCode</td>
<td>varchar</td>
<td>CY</td>
<td>电子发票开具成功时必传</td>
</tr>
<tr>
<td>发票号码</td>
<td>invSerialNo</td>
<td>varchar</td>
<td>CY</td>
<td>电子发票开具成功时必传</td>
</tr>
<tr>
<td>发票金额</td>
<td>invPrice</td>
<td>BigDecimal</td>
<td>CY</td>
<td></td>
</tr>
<tr>
<td>电子发票PDF下载地址</td>
<td>downLoadUrl</td>
<td>varchar</td>
<td>CY</td>
<td>PDF下载地址</td>
</tr>
<tr>
<td>处理状态编码</td>
<td>dealCode</td>
<td>varchar</td>
<td>Y</td>
<td>1=开票成功<br/>0=开票失败<br/>4=红冲完成<br/>5=红冲失败<br/>7=作废完成<br/>8=作废失败<br/>11=主动撤回</td>
</tr>
<tr>
<td>处理说明</td>
<td>dealDesc</td>
<td>varchar</td>
<td>Y</td>
<td>处理结果描述</td>
</tr>
<tr>
<td>物流公司</td>
<td>logisticsCom</td>
<td>varchar</td>
<td>CY</td>
<td>专票成功时必传</td>
</tr>
<tr>
<td>物流单号</td>
<td>logisticsNo</td>
<td>varchar</td>
<td>CY</td>
<td>专票成功时必传</td>
</tr>
<tr>
<td>异常文件信息</td>
<td>errorFileURL</td>
<td>varchar</td>
<td>CY</td>
<td>sftp申请失败时比传</td>
</tr>
<tr>
<td>OFD版式文件地址</td>
<td>ofdUrl</td>
<td>varchar</td>
<td>CY</td>
<td>OFD版式文件地址，数电开票成功必传</td>
</tr>
<tr>
<td>XML版式文件地址</td>
<td>xmlUrl</td>
<td>varchar</td>
<td>CY</td>
<td>XML版式文件地址，数电开票成功必传</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>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>
<h3>报文示例</h3>
<h4>请求</h4>
<pre><code class="language-json">{
&quot;head&quot;: {
&quot;interfaceType&quot;: &quot;invoiceNotice&quot;,
&quot;policySource&quot;: &quot;HN_HT_QNW&quot;,
&quot;reqTime&quot;: 1671096412485,
&quot;uuid&quot;: &quot;73c5d04e-e6f3-47e1-9f0e-4c240934b3b2&quot;
},
&quot;invoiceNotice&quot;: {
&quot;dealCode&quot;: &quot;1&quot;,
&quot;dealDesc&quot;: &quot;成功&quot;,
&quot;downLoadUrl&quot;: &quot;https://avatar.chinahuanong.com.cn/einvoice/integration/e-invoices/file?invoiceNumber=*******&amp;invoiceCode=***********&amp;tax_num=******************&quot;,
&quot;invCode&quot;: &quot;011002200611&quot;,
&quot;invPrice&quot;: 50,
&quot;invSerialNo&quot;: &quot;37879499&quot;,
&quot;invoiceApplyNo&quot;: &quot;851350602257&quot;
}
}
</code></pre>
<h4>返回</h4>
<pre><code class="language-json">{
&quot;respBody&quot;: {
&quot;proposalOrders&quot;: null,
&quot;dealCode&quot;: &quot;1&quot;,
&quot;policyNo&quot;: null,
&quot;invoiceApplyNo&quot;: &quot;851350602257&quot;,
&quot;dealDesc&quot;: &quot;成功&quot;,
&quot;policyOrders&quot;: null
},
&quot;head&quot;: {
&quot;interfaceType&quot;: &quot;invoiceNotice&quot;,
&quot;orderNo&quot;: null,
&quot;policySource&quot;: &quot;HN_HT_QNW&quot;,
&quot;respTime&quot;: &quot;Thu Dec 15 17:26:52 CST 2022&quot;,
&quot;resultCode&quot;: null,
&quot;reqTime&quot;: &quot;1671096412485&quot;,
&quot;resultMessage&quot;: null,
&quot;uuid&quot;: &quot;73c5d04e-e6f3-47e1-9f0e-4c240934b3b2&quot;
}
}
</code></pre>