发车信息接口-广爱推送蓝海
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>发车信息接口-推送</li>
</ul>
<h5>版本记录</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">变更日期</th>
<th style="text-align: left;">版本编号</th>
<th style="text-align: left;">修改说明</th>
<th style="text-align: left;">变更人</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">2022-11-2</td>
<td style="text-align: left;">v1.1</td>
<td style="text-align: left;"><strong> 发车信息增加字段被覆盖订单号</strong></td>
<td style="text-align: left;">兰兰</td>
</tr>
</tbody>
</table>
<h5>请求URL</h5>
<ul>
<li>测试环境 <code>https://gaapi.dixingps.cn/web/gaib/api/delivery</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST</li>
</ul>
<h5>请求头</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">Authorization</td>
<td style="text-align: left;">是</td>
<td>Bearer a7fe162f-2b74-4800-9516-ca8b4567a422</td>
</tr>
</tbody>
</table>
<h5>请求参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">list</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">array</td>
<td>列表</td>
</tr>
</tbody>
</table>
<h5>list参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">shopCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>店号</td>
</tr>
<tr>
<td style="text-align: left;">shopName</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>店名</td>
</tr>
<tr>
<td style="text-align: left;">financialId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>金融机构</td>
</tr>
<tr>
<td style="text-align: left;">channelId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>渠道</td>
</tr>
<tr>
<td style="text-align: left;">chassis</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>车架号</td>
</tr>
<tr>
<td style="text-align: left;">certificateNum</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>合格证编号</td>
</tr>
<tr>
<td style="text-align: left;">outDoorDate</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>出门日<br/>(yyyy-MM-dd)</td>
</tr>
<tr>
<td style="text-align: left;">scheduledDate</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>预定到店日<br/>(yyyy-MM-dd)</td>
</tr>
<tr>
<td style="text-align: left;">realWarehousedDT</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>实际收车日<br/>(yyyy-MM-dd)</td>
</tr>
<tr>
<td style="text-align: left;">supplyPrice</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>供货价</td>
</tr>
<tr>
<td style="text-align: left;">draftNum</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>汇票号</td>
</tr>
<tr>
<td style="text-align: left;">orderNum</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>订单号</td>
</tr>
<tr>
<td style="text-align: left;">replacedChassis</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>被覆盖车架号,当发生车架号变更时必填</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>车辆状态 01.在途;02.在库;03.已出库;</td>
</tr>
<tr>
<td style="text-align: left;"><strong>replacedOrderNum</strong></td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td><strong>被覆盖订单号,当发生订单号变更时必填</strong></td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code class="language-json">{"list":"[{\"brandId\":\"1002\",\"carStyle\":\"AXVH71L-JEXGBC\",\"cebData\":false,\"certificateNum\":\"test2001661756188493\",\"chassis\":\"test1001661756188493\",\"createUser\":\"SYSTEM\",\"depositPrice\":\"16972.20\",\"draftNum\":\"山西锦华CFT2017183\",\"financialId\":\"14\",\"inStorageDate\":\"2022-08-29\",\"isAddressChange\":\"0\",\"leaveDate\":\"2022-08-29\",\"orderNum\":\"test3001661756188493\",\"outDoorDate\":\"2022-08-29\",\"shopId\":1161,\"status\":\"01\",\"supplyPrice\":\"84861.00\",\"type\":0},{\"brandId\":\"1002\",\"carStyle\":\"AXVH71L-JEXGBC\",\"cebData\":false,\"certificateNum\":\"test2001661756188493\",\"chassis\":\"test1001661756188493\",\"createUser\":\"SYSTEM\",\"depositPrice\":\"16972.20\",\"draftNum\":\"山西锦华CFT2017183\",\"financialId\":\"14\",\"id\":6254786,\"inStorageDate\":\"2022-08-29\",\"isAddressChange\":\"0\",\"leaveDate\":\"2022-08-29\",\"oldCertificateNum\":\"test2001661756188493\",\"orderNum\":\"test3001661756188493\",\"outDoorDate\":\"2022-08-29\",\"shopId\":1161,\"status\":\"01\",\"supplyPrice\":\"84861.00\",\"type\":0,\"updateUser\":\"SYSTEM\"},{\"brandId\":\"1002\",\"carStyle\":\"AXVH71L-JEXGBC\",\"cebData\":false,\"certificateNum\":\"test2001661756188493\",\"chassis\":\"test1001661756188493\",\"createUser\":\"SYSTEM\",\"depositPrice\":\"16972.20\",\"draftNum\":\"山西锦华CFT2017183\",\"financialId\":\"14\",\"id\":6254786,\"inStorageDate\":\"2022-08-29\",\"isAddressChange\":\"0\",\"leaveDate\":\"2022-08-29\",\"oldCertificateNum\":\"test2001661756188493\",\"orderNum\":\"test3001661756188493\",\"outDoorDate\":\"2022-08-29\",\"shopId\":1161,\"status\":\"01\",\"supplyPrice\":\"84861.00\",\"type\":0,\"updateUser\":\"SYSTEM\"},{\"brandId\":\"1002\",\"carStyle\":\"AXVH71L-JEXGBC\",\"cebData\":false,\"certificateNum\":\"test2001661756188493\",\"chassis\":\"test1001661756188493\",\"createUser\":\"SYSTEM\",\"depositPrice\":\"16972.20\",\"draftNum\":\"山西锦华CFT2017183\",\"financialId\":\"14\",\"id\":6254786,\"inStorageDate\":\"2022-08-29\",\"isAddressChange\":\"0\",\"leaveDate\":\"2022-08-29\",\"oldCertificateNum\":\"test2001661756188493\",\"orderNum\":\"test3001661756188493\",\"outDoorDate\":\"2022-08-29\",\"shopId\":1161,\"status\":\"01\",\"supplyPrice\":\"84861.00\",\"type\":0,\"updateUser\":\"SYSTEM\"},{\"brandId\":\"1002\",\"carStyle\":\"AXVH71L-JEXGBC\",\"cebData\":false,\"certificateNum\":\"test2001661756188493\",\"chassis\":\"test1001661756188493\",\"createUser\":\"SYSTEM\",\"depositPrice\":\"16972.20\",\"draftNum\":\"山西锦华CFT2017183\",\"financialId\":\"14\",\"id\":6254786,\"inStorageDate\":\"2022-08-29\",\"isAddressChange\":\"0\",\"leaveDate\":\"2022-08-29\",\"oldCertificateNum\":\"test2001661756188493\",\"orderNum\":\"test3001661756188493\",\"outDoorDate\":\"2022-08-29\",\"shopId\":1161,\"status\":\"01\",\"supplyPrice\":\"84861.00\",\"type\":0,\"updateUser\":\"SYSTEM\"},{\"brandId\":\"1002\",\"carStyle\":\"AXVH71L-JEXGBC\",\"cebData\":false,\"certificateNum\":\"test2001661756188493\",\"chassis\":\"test1001661756188493\",\"createUser\":\"SYSTEM\",\"depositPrice\":\"16972.20\",\"draftNum\":\"山西锦华CFT2017183\",\"financialId\":\"14\",\"id\":6254786,\"inStorageDate\":\"2022-08-29\",\"isAddressChange\":\"0\",\"leaveDate\":\"2022-08-29\",\"oldCertificateNum\":\"test2001661756188493\",\"orderNum\":\"test3001661756188493\",\"outDoorDate\":\"2022-08-29\",\"shopId\":1161,\"status\":\"01\",\"supplyPrice\":\"84861.00\",\"type\":0,\"updateUser\":\"SYSTEM\"},{\"brandId\":\"1002\",\"carStyle\":\"AXVH71L-JEXGBC\",\"cebData\":false,\"certificateNum\":\"test2001661756188493\",\"chassis\":\"test1001661756188493\",\"createUser\":\"SYSTEM\",\"depositPrice\":\"16972.20\",\"draftNum\":\"山西锦华CFT2017183\",\"financialId\":\"14\",\"id\":6254786,\"inStorageDate\":\"2022-08-29\",\"isAddressChange\":\"0\",\"leaveDate\":\"2022-08-29\",\"oldCertificateNum\":\"test2001661756188493\",\"orderNum\":\"test3001661756188493\",\"outDoorDate\":\"2022-08-29\",\"shopId\":1161,\"status\":\"01\",\"supplyPrice\":\"84861.00\",\"type\":0,\"updateUser\":\"SYSTEM\"},{\"brandId\":\"1002\",\"carStyle\":\"AXVH71L-JEXGBC\",\"cebData\":false,\"certificateNum\":\"test2001661756188493\",\"chassis\":\"test1001661756188493\",\"createUser\":\"SYSTEM\",\"depositPrice\":\"16972.20\",\"draftNum\":\"山西锦华CFT2017183\",\"financialId\":\"14\",\"id\":6254786,\"inStorageDate\":\"2022-08-29\",\"isAddressChange\":\"0\",\"leaveDate\":\"2022-08-29\",\"oldCertificateNum\":\"test2001661756188493\",\"orderNum\":\"test3001661756188493\",\"outDoorDate\":\"2022-08-29\",\"shopId\":1161,\"status\":\"01\",\"supplyPrice\":\"84861.00\",\"type\":0,\"updateUser\":\"SYSTEM\"},{\"brandId\":\"1002\",\"carStyle\":\"AXVH71L-JEXGBC\",\"cebData\":false,\"certificateNum\":\"test2001661756188493\",\"chassis\":\"test1001661756188493\",\"createUser\":\"SYSTEM\",\"depositPrice\":\"16972.20\",\"draftNum\":\"山西锦华CFT2017183\",\"financialId\":\"14\",\"id\":6254786,\"inStorageDate\":\"2022-08-29\",\"isAddressChange\":\"0\",\"leaveDate\":\"2022-08-29\",\"oldCertificateNum\":\"test2001661756188493\",\"orderNum\":\"test3001661756188493\",\"outDoorDate\":\"2022-08-29\",\"shopId\":1161,\"status\":\"01\",\"supplyPrice\":\"84861.00\",\"type\":0,\"updateUser\":\"SYSTEM\"},{\"brandId\":\"1002\",\"carStyle\":\"AXVH71L-JEXGBC\",\"cebData\":false,\"certificateNum\":\"test2001661756188493\",\"chassis\":\"test1001661756188493\",\"createUser\":\"SYSTEM\",\"depositPrice\":\"16972.20\",\"draftNum\":\"山西锦华CFT2017183\",\"financialId\":\"14\",\"id\":6254786,\"inStorageDate\":\"2022-08-29\",\"isAddressChange\":\"0\",\"leaveDate\":\"2022-08-29\",\"oldCertificateNum\":\"test2001661756188493\",\"orderNum\":\"test3001661756188493\",\"outDoorDate\":\"2022-08-29\",\"shopId\":1161,\"status\":\"01\",\"supplyPrice\":\"84861.00\",\"type\":0,\"updateUser\":\"SYSTEM\"}]"}
</code></pre>
<pre><code>{
"list":[
{
"shopCode": "34A10",
"shopName": "安徽中路佳宝",
"financialId": "1",
"channelId": "1002",
"chassis": "LMGJS1G80G1002765",
"certificateNum": "VDAEM84GB025972",
"outDoorDate": "2018-08-24",
"scheduledDate": "2018-08-29",
"realWarehousedDT": "2018-08-31",
"supplyPrice": "228501.00",
"draftNum": "B34A1020180823001GSF",
"status": "01"
},
{
"shopCode": "34A10",
"shopName": "安徽中路佳宝",
"financialId": "1",
"channelId": "1002",
"chassis": "LMGJS1G80G1002765",
"certificateNum": "VDAEM84GB025972",
"outDoorDate": "2018-08-24",
"scheduledDate": "2018-08-29",
"realWarehousedDT": "2018-08-31",
"supplyPrice": "228501.00",
"draftNum": "B34A1020180823001GSF",
"status": "01"
}
]
}</code></pre>
<h5>数据处理逻辑</h5>
<pre><code>广爱系统只传需要新增或者修改(覆盖)的数据
所以蓝海方只需要判断新增或者修改就行了
该逻辑只是描述了广爱这边每个接口的数据处理逻辑,但是每个接口有个别逻辑是重复的
重复的逻辑,蓝海方了解了以后可自行处理
数据来源一、合格证管理页面导入
条件一、判断机构是否为广汽汇理 广汽汇理机构id静态常量值为6
1.订单号存在直接根据订单号覆盖 我们这边会额外传replacedChassis原车架号参数
2. 订单号不存在,但是车架号存在根据车架号覆盖(同条件二)
条件二、订单号不存在,但是车架号存在根据车架号覆盖
条件三、订单号、车架号都不存在直接新增
数据来源二、中行接口同步数据
条件一、车辆存在则修改、车辆不存在则新增
数据来源三 中信渠道证 中信机构id静态常量值为1
条件一、如果本来有汇票号不允许修改汇票号,修改(覆盖)的时候不允许修改汇票号</code></pre>
<h5>返回参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">success</td>
<td style="text-align: left;">boolean</td>
<td>是否成功</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">string</td>
<td>成功返回值</td>
</tr>
<tr>
<td style="text-align: left;">message</td>
<td style="text-align: left;">string</td>
<td>失败说明</td>
</tr>
<tr>
<td style="text-align: left;">code</td>
<td style="text-align: left;">int</td>
<td>状态码</td>
</tr>
</tbody>
</table>
<h5>成功返回示例</h5>
<pre><code>{
"success": true,
"data": "操作成功",
"message": null,
"code": 200,
"includes": null,
"excludes": null,
"onlyData": false,
"callback": null
}</code></pre>
<h5>失败返回示例</h5>
<pre><code>{
"success": false,
"data": null,
"message": "接口尚未开发",
"code": 500,
"includes": null,
"excludes": null,
"onlyData": false,
"callback": null
}</code></pre>
<h5>备注</h5>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>