【顺丰快递管家】通用接口文档


6.订单图片审核接口

<h3>功能描述</h3> <ul> <li>订单图片审核接口</li> <li>注意:相关字段需配合订单详情接口使用</li> <li>建议配合订单详情接口使用单条订单,单张图片审核的请求形式</li> </ul> <h3>接口定义</h3> <table> <thead> <tr> <th style="text-align: center;">服务名称</th> <th style="text-align: center;">批量交易</th> <th style="text-align: center;">接口类型</th> <th style="text-align: center;">接口uri</th> </tr> </thead> <tbody> <tr> <td style="text-align: center;">订单图片审核</td> <td style="text-align: center;">不支持</td> <td style="text-align: center;">接入/POST</td> <td style="text-align: center;">/public/vpOrder/abnormalOrderReview</td> </tr> </tbody> </table> <h3>元素&lt;请求&gt;</h3> <table> <thead> <tr> <th style="text-align: center;">#</th> <th style="text-align: center;">字段名</th> <th style="text-align: center;">类型(约束)</th> <th style="text-align: center;">必填</th> <th style="text-align: center;">描述</th> </tr> </thead> <tbody> <tr> <td style="text-align: center;">1</td> <td style="text-align: center;">companyId</td> <td style="text-align: center;">String(64)</td> <td style="text-align: center;">是</td> <td style="text-align: center;">分配appId</td> </tr> <tr> <td style="text-align: center;">2</td> <td style="text-align: center;">merchantOrderNo</td> <td style="text-align: center;">String</td> <td style="text-align: center;">是</td> <td style="text-align: center;">订单号</td> </tr> <tr> <td style="text-align: center;">3</td> <td style="text-align: center;">authName</td> <td style="text-align: center;">String</td> <td style="text-align: center;">是</td> <td style="text-align: center;">订单创建人</td> </tr> <tr> <td style="text-align: center;">4</td> <td style="text-align: center;">results</td> <td style="text-align: center;">List</td> <td style="text-align: center;">否</td> <td style="text-align: center;">取证项审核列表(不传此字段则默认审核此订单所有图片))</td> </tr> <tr> <td style="text-align: center;">5</td> <td style="text-align: center;">-fieldCode</td> <td style="text-align: center;">String(128)</td> <td style="text-align: center;">是</td> <td style="text-align: center;">取证项字段编码(订单详情接口获取)</td> </tr> <tr> <td style="text-align: center;">6</td> <td style="text-align: center;">-itemConclusion</td> <td style="text-align: center;">String(14)</td> <td style="text-align: center;">是</td> <td style="text-align: center;">审核结论:PASS/ REJECT</td> </tr> <tr> <td style="text-align: center;">7</td> <td style="text-align: center;">-opinion</td> <td style="text-align: center;">String(255)</td> <td style="text-align: center;">是</td> <td style="text-align: center;">不合格原因</td> </tr> <tr> <td style="text-align: center;">8</td> <td style="text-align: center;">-sn</td> <td style="text-align: center;">String(14)</td> <td style="text-align: center;">是</td> <td style="text-align: center;">同一个取证项字段编码图片序列号(订单详情接口获取)</td> </tr> <tr> <td style="text-align: center;">9</td> <td style="text-align: center;">-url</td> <td style="text-align: center;">String(14)</td> <td style="text-align: center;">是</td> <td style="text-align: center;">图片url(订单详情接口获取)</td> </tr> <tr> <td style="text-align: center;">10</td> <td style="text-align: center;">itemConclusion</td> <td style="text-align: center;">String(14)</td> <td style="text-align: center;">是</td> <td style="text-align: center;">审核结论:PASS/ REJECT(不传results字段,此字段单独传入,审核所有图片)</td> </tr> <tr> <td style="text-align: center;">11</td> <td style="text-align: center;">opinion</td> <td style="text-align: center;">String(255)</td> <td style="text-align: center;">是</td> <td style="text-align: center;">不合格原因(不传results字段,此字段单独传入,审核所有图片)</td> </tr> </tbody> </table> <h3>元素&lt;响应&gt;</h3> <table> <thead> <tr> <th style="text-align: center;">#</th> <th style="text-align: center;">字段名</th> <th style="text-align: center;">类型(约束)</th> <th style="text-align: center;">必填</th> <th style="text-align: center;">描述</th> </tr> </thead> <tbody> <tr> <td style="text-align: center;">1</td> <td style="text-align: center;">msg</td> <td style="text-align: center;">String (200)</td> <td style="text-align: center;">否</td> <td style="text-align: center;">提示信息</td> </tr> <tr> <td style="text-align: center;">2</td> <td style="text-align: center;">succ</td> <td style="text-align: center;">String (10)</td> <td style="text-align: center;">是</td> <td style="text-align: center;">状态码,返回成功或失败信息(ok/fail)</td> </tr> <tr> <td style="text-align: center;">3</td> <td style="text-align: center;">result</td> <td style="text-align: center;">List</td> <td style="text-align: center;">是</td> <td style="text-align: center;">数据</td> </tr> </tbody> </table> <h3>报文范例</h3> <ul> <li><strong>单条订单批量审核图片请求报文</strong> <pre><code>{     &amp;quot;companyId&amp;quot;:&amp;quot;xxxxx&amp;quot;,     //订单号     &amp;quot;merchantOrderNo&amp;quot;:&amp;quot;xxxxx&amp;quot;,     //客户用户名     &amp;quot;authName&amp;quot;:&amp;quot;xxxxx&amp;quot;,     ////审核结论:PASS/ REJECT     &amp;quot;itemConclusion&amp;quot;:&amp;quot;REJECT&amp;quot;,     //不合格原因     &amp;quot;opinion&amp;quot;:&amp;quot;不合格&amp;quot; }</code></pre></li> <li> <p><strong>单条订单审核单张图片请求报文</strong></p> <pre><code>{     &amp;quot;companyId&amp;quot;:&amp;quot;xxxxx&amp;quot;,     //微派订单号     &amp;quot;merchantOrderNo&amp;quot;:&amp;quot;xxxxx&amp;quot;,     //客户用户名     &amp;quot;authName&amp;quot;:&amp;quot;xxxxx&amp;quot;,     //取证项审核列表     &amp;quot;results&amp;quot;:[         {         //取证项字段编码(订单详情接口获取)         &amp;quot;fieldCode&amp;quot;:&amp;quot;&amp;quot;,         //审核结论:PASS/ REJECT         &amp;quot;itemConclusion&amp;quot;:&amp;quot;REJECT&amp;quot;,         //不合格原因         &amp;quot;opinion&amp;quot;:&amp;quot;不合格&amp;quot;,         //同一个取证项字段编码图片序列号(订单详情接口获取)         &amp;quot;sn&amp;quot;:&amp;quot;xxxxx&amp;quot;,         //图片地址(订单详情接口获取)         &amp;quot;url&amp;quot;:&amp;quot;xxxxx&amp;quot;         }     ] }</code></pre> </li> <li><strong>响应报文</strong> <ul> <li>成功报文 <pre><code>{     &amp;quot;result&amp;quot;: null     &amp;quot;succ&amp;quot;: &amp;quot;ok&amp;quot;,     &amp;quot;msg&amp;quot;: &amp;quot;审核成功&amp;quot; }</code></pre></li> <li>失败报文-范例1 <pre><code>{ &amp;quot;msg&amp;quot;:&amp;quot;订单不存在&amp;quot;, &amp;quot;result&amp;quot;: null, &amp;quot;succ&amp;quot;: &amp;quot;fail&amp;quot; }</code></pre></li> <li>失败报文-范例2 <pre><code>{ &amp;quot;msg&amp;quot;:&amp;quot;该订单不能审核,请稍后重试&amp;quot;, &amp;quot;result&amp;quot;: null, &amp;quot;succ&amp;quot;: &amp;quot;fail&amp;quot; }</code></pre></li> </ul></li> </ul>

页面列表

ITEM_HTML