5.9 发票查询接口
<p>[TOC]</p>
<p>请求模式：渠道方→华农阿凡达平台</p>
<p>接口描述：用于查询开票信息</p>
<p>测试接口地址： <a href="https://porsche-avatar.chinahuanong.com.cn/avatar/invoice/invoiceQuery">https://porsche-avatar.chinahuanong.com.cn/avatar/invoice/invoiceQuery</a></p>
<p>生产接口地址： <a href="https://avatar.chinahuanong.com.cn/avatar/invoice/invoiceQuery">https://avatar.chinahuanong.com.cn/avatar/invoice/invoiceQuery</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>格式为：yyyy-MM-dd HH:mm:ss。</td>
</tr>
<tr>
<td>唯一标识符</td>
<td>uuid</td>
<td>varchar</td>
<td>Y</td>
<td>单次请求唯一标识符，可用UUID生成</td>
</tr>
</tbody>
</table>
<h3>请求体</h3>
<p><code>invoiceQuery</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>invoiceApplyNo</td>
<td>varchar</td>
<td>CY</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>uuid</td>
<td>varchar</td>
<td>Y</td>
<td>单次请求唯一标识符，可用UUID生成</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>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>
<tr>
<td>详细信息</td>
<td>details</td>
<td>List\<Detail\></td>
<td>CY</td>
<td>无申请数据时不返回，目前只支持单一保单查询。</td>
</tr>
</tbody>
</table>
<p><code>details</code></p>
<table>
<thead>
<tr>
<th>字段名称</th>
<th>字段代码</th>
<th>类型</th>
<th>是否必传</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>核心申请号（子）</td>
<td>subApplyID</td>
<td>varchar</td>
<td>Y</td>
<td>保司系统的子申请号</td>
</tr>
<tr>
<td>财务处理状态码</td>
<td>dealCode</td>
<td>varchar</td>
<td>Y</td>
<td>0=处理中</br>1=开票成功</br>2=开票失败</br>3=红冲处理中</br>4=红冲完成</br>5=红冲失败</br>6=作废处理中</br>7=作废完成</br>8=作废失败</br>9=开票申请成功待审核</br>10=红冲/作废申请成功待审核</br>11=主动撤回</td>
</tr>
<tr>
<td>财务处理结果描述</td>
<td>dealDesc</td>
<td>varchar</td>
<td>Y</td>
<td>处理结果描述</td>
</tr>
<tr>
<td>票据ID</td>
<td>invId</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>invCode</td>
<td>varchar</td>
<td>CY</td>
<td>开票成功时必传</td>
</tr>
<tr>
<td>保费</td>
<td>sumPremium</td>
<td>varchar</td>
<td>CY</td>
<td>开票成功时必传</td>
</tr>
<tr>
<td>发票PDF下载链接</td>
<td>invPdfDownloadUrl</td>
<td>varchar</td>
<td>CY</td>
<td>开票成功时必传</td>
</tr>
<tr>
<td>发票打印链接</td>
<td>invPrintUrl</td>
<td>varchar</td>
<td>CY</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>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>
<h4>请求报文</h4>
<pre><code class="language-json">{
&quot;head&quot;:{
&quot;policySource&quot;:&quot;PHN_TC&quot;,
&quot;reqTime&quot;:&quot;2023-02-27 14:17:43&quot;,
&quot;uuid&quot;:&quot;3cfaad6d-59b1-46cc-8617-f1e4abe9a692&quot;
},
&quot;invoiceQuery&quot;:{
&quot;policyNo&quot;:&quot;X11000011000011000&quot;
}
}
</code></pre>
<h4>返回报文</h4>
<pre><code class="language-json">{
&quot;head&quot;:{
&quot;policySource&quot;:&quot;PHN_TC&quot;,
&quot;respTime&quot;:1677575612590,
&quot;uuid&quot;:&quot;3cfaad6d-59b1-46cc-8617-f1e4abe9a692&quot;
},
&quot;respBody&quot;:{
&quot;dealCode&quot;:&quot;1&quot;,
&quot;dealDesc&quot;:&quot;成功&quot;,
&quot;details&quot;:[
{
&quot;dealCode&quot;:&quot;1&quot;,
&quot;dealDesc&quot;:&quot;开票成功&quot;,
&quot;invCode&quot;:&quot;050003521104&quot;,
&quot;invID&quot;:&quot;Q440023022807221942&quot;,
&quot;invPdfDownLoadUrl&quot;:&quot;https://porsche-avatar.chinahuanong.com.cn/einvoice/integration/e-invoices/file?invoiceNumber=71222378&amp;invoiceCode=050003521104&amp;tax_num=500080000000019&quot;,
&quot;invSerialNo&quot;:&quot;71222378&quot;,
&quot;subApplyID&quot;:&quot;20230228155_1&quot;,
&quot;sumPremium&quot;:&quot;8&quot;
}
]
}
}
</code></pre>