[TOC]
简要描述
版本记录
变更日期 |
版本编号 |
修改说明 |
变更人 |
2022-11-2 |
v1.1 |
发车信息增加字段被覆盖订单号 |
兰兰 |
请求URL
- 测试环境
https://gaapi.dixingps.cn/web/gaib/api/delivery
请求方式
请求头
参数名 |
必选 |
说明 |
Authorization |
是 |
Bearer a7fe162f-2b74-4800-9516-ca8b4567a422 |
请求参数
参数名 |
必选 |
类型 |
说明 |
list |
是 |
array |
列表 |
list参数
参数名 |
必选 |
类型 |
说明 |
shopCode |
是 |
String |
店号 |
shopName |
否 |
String |
店名 |
financialId |
是 |
String |
金融机构 |
channelId |
是 |
String |
渠道 |
chassis |
是 |
String |
车架号 |
certificateNum |
否 |
String |
合格证编号 |
outDoorDate |
否 |
String |
出门日<br/>(yyyy-MM-dd) |
scheduledDate |
否 |
String |
预定到店日<br/>(yyyy-MM-dd) |
realWarehousedDT |
否 |
String |
实际收车日<br/>(yyyy-MM-dd) |
supplyPrice |
否 |
String |
供货价 |
draftNum |
否 |
String |
汇票号 |
orderNum |
否 |
String |
订单号 |
replacedChassis |
否 |
String |
被覆盖车架号,当发生车架号变更时必填 |
status |
是 |
String |
车辆状态 01.在途;02.在库;03.已出库; |
replacedOrderNum |
否 |
String |
被覆盖订单号,当发生订单号变更时必填 |
请求示例
{"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\"}]"}
{
"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"
}
]
}
数据处理逻辑
广爱系统只传需要新增或者修改(覆盖)的数据
所以蓝海方只需要判断新增或者修改就行了
该逻辑只是描述了广爱这边每个接口的数据处理逻辑,但是每个接口有个别逻辑是重复的
重复的逻辑,蓝海方了解了以后可自行处理
数据来源一、合格证管理页面导入
条件一、判断机构是否为广汽汇理 广汽汇理机构id静态常量值为6
1.订单号存在直接根据订单号覆盖 我们这边会额外传replacedChassis原车架号参数
2. 订单号不存在,但是车架号存在根据车架号覆盖(同条件二)
条件二、订单号不存在,但是车架号存在根据车架号覆盖
条件三、订单号、车架号都不存在直接新增
数据来源二、中行接口同步数据
条件一、车辆存在则修改、车辆不存在则新增
数据来源三 中信渠道证 中信机构id静态常量值为1
条件一、如果本来有汇票号不允许修改汇票号,修改(覆盖)的时候不允许修改汇票号
返回参数说明
参数名 |
类型 |
说明 |
success |
boolean |
是否成功 |
data |
string |
成功返回值 |
message |
string |
失败说明 |
code |
int |
状态码 |
成功返回示例
{
"success": true,
"data": "操作成功",
"message": null,
"code": 200,
"includes": null,
"excludes": null,
"onlyData": false,
"callback": null
}
失败返回示例
{
"success": false,
"data": null,
"message": "接口尚未开发",
"code": 500,
"includes": null,
"excludes": null,
"onlyData": false,
"callback": null
}
备注