资方接口v1.0 - maihaoche/BRZ GitHub Wiki
1、获取accessToken
请求:
url:v1/corp/token?id=CORP_ID&key=CORP_KEY
method:GET
响应:
header:
{
"X-Nonce":"随机字符串，必填"
"X-Signature":"签名值"
}
body:
{
"token":"token值，文本",
"expire":"有效期，单位秒，数字,7200"
}
2、获取订单信息
请求:
url:v1/orders
method:GET
header:
{
X-Access-Token:"token，必填"
X-Nonce:"随机字符串，必填"
X-Signature:"签名值"
}
入参:
["订单id"]
响应:
header:
{
X-Nonce:"随机字符串，必填"
X-Signature:"签名值"
}
body:
[
{
"orderId": "订单id，G20180104106309",
"kind": "产品类型,0 订单宝 ，1 接车宝 2库融宝",
"applierName": "申请人姓名，李清月",
"applierMobile": "申请人手机号，17682309427",
"bailAmount": "定金金额，单位元，1000",
"contractAmount": "合同金额，单位元，10000",
"totalLoanAmount": "核价金额，单位元，10000",
"totalMatAmount": "实际垫资金额，单位元，7200",
"totalEarnestAmount": "保证金金额，单位元，1800",
"borrower": {
"creditLine": "剩余授信金额，单位元，1000000",
"id": "申请企业id，10190",
"kind": "企业类型，1 经销商 2 供应商，1",
"name": "公司名，大月的大公司",
"address": "公司注册地址，大月路",
"foundingTime": "成立时间，2010-01-01",
"expirationTime": "到期时间，2100-01-01",
"registeredCapital": "注册资本，不一定有，默认空字符串",
"socialCreditCode": "统一社会信用代码，91330106MA27YQ011A",
"businessLicense": "营业执照，https://dn-mhc.qbox.me/59E4329B-9EC6-4B3C-A535-41408F037B5A.jpg",
"legalPerson": {
"name": "法人名称，李清月",
"idNumber": "身份证号，342201198810020001",
"idAddress": "浙江省，身份证地址",
"effectiveTime": "2010-10-10，生效时间",
"expirationTime": "2030-10-10，过期时间",
"idPhotos": [
"身份证照片，正反面，https://dn-mhc.qbox.me/59E4329B-9EC6-4B3C-A535-41408F037B5A.jpg",
"https://dn-mhc.qbox.me/59E4329B-9EC6-4B3C-A535-41408F037B5A.jpg"
]
},
"account": [
{
"bank": "开户行，北京银行",
"number": "银行卡号，125666668856655555",
"name": "开户名，大月"
},
{
"bank": "中国光大银行",
"number": "288228386969850558",
"name": "李清月"
}
]
},
"provider": {
"id": "12",
"kind": "2",
"name": "杭州ABC汽车销售公司",
"address": "安徽省铜陵市铜都大道中段4551号A201-A207室",
"foundingTime": "",
"expirationTime": "",
"registeredCapital": "",
"socialCreditCode": "1234678",
"businessLicense": "",
"legalPerson": {
"id": "",
"name": "",
"idNumber": "",
"idAddress": "",
"mobile": "159942923801",
"effectiveTime": "",
"expirationTime": ""
},
"account": [
{
"bank": "中国银行",
"number": "1231251234125",
"name": "杨绛"
}
]
},
"account": {
"bank": "中国银行",
"number": "1231251234125",
"name": "杨绛"
},
"contract": [
{
"id": "合同id,154912340470149120",
"type": "合同类型，1采购合同，2代购合同， 1",
"mime":"数据类型，img为线下合同照片，pdf为线上合同，img"
},
{
"id": "154913893524451328",
"type": "2",
"mime":"pdf"
}
],
"earnest": [
{
"id": "订单id，G20180104144394",
"amount": "保证金金额，1800",
"remittanceMode": "打款方式，1 网银，2 线下转账，2",
"account": {//打款账户，当打款方式为 1的时候，这里一定有值
"bank": "",
"number": "",
"name": ""
},
"remittanceTime": "2018-01-04",
"voucher": [//打款凭证，当打款方式为2的时候，这里一定有值
"http://secure.maihaoche.com/CD99C131-01CB-45DA-B27B-49948FFC9839.jpg?e=1515117642&token=BzDkpyEeUNKVhvJn5spXnnwzQXYBnS034DXkbP3U:TzpMrsuTMSb0KU87hsWQ574iCsA="
]
}
],
"cars": [
{
"id": "车辆id，100571421",
"vin": "车架号",
"brand": "品牌，保时捷",
"model": "车型，卡宴 17款 3.0T SE 混动 白金",
"series": "车系，卡宴",
"interior": "内饰颜色，咖色",
"exterior": "外观颜色，红色",
"mileage": "里程数，不一定有，默认空字符串",
"engineDisplacement": "排量，不一定有，默认空字符串",
"dateOfManufacture": "生产日期，不一定有，默认空字符串",
"loanAmount": "核价金额，单位元，10000",
"earnestAmount": "保证金金额，1800",
"matAmount": "实际垫资金额，7200",
"marketPrice": "市场价，不一定有，默认空字符串",
"guarantee": ["手续承诺函照片"],
"formalities": ["手续照片"],
"logistics": {//库融宝审核的时候，没有物流照片
"front": "物流验车照片，前45度，//img.maihaoche.com/tms/contracts/[email protected]",
"behind": "物流验车照片，后45度，//img.maihaoche.com/tms/contracts/[email protected]",
"inner": "物流验车照片，内饰，//img.maihaoche.com/tms/contracts/[email protected]",
"odometer": "物流验车照片，里程表//img.maihaoche.com/tms/contracts/[email protected]",
"nameplate": "物流验车照片，铭牌//img.maihaoche.com/tms/contracts/[email protected]"
}
},
"warehouse":{//订单宝审核的时候，没有仓库验车照片，因为车还在供应商手里没起运
"front": "仓库验车照片，前45度，//img.maihaoche.com/tms/contracts/[email protected]",
"behind": "仓库验车照片，后45度，//img.maihaoche.com/tms/contracts/[email protected]",
"inner": "仓库验车照片，内饰，//img.maihaoche.com/tms/contracts/[email protected]",
"odometer": "仓库验车照片，里程表//img.maihaoche.com/tms/contracts/[email protected]",
"nameplate": "仓库验车照片，铭牌//img.maihaoche.com/tms/contracts/[email protected]"
}
}
]
}
]
3、获取车辆运单信息
请求:
url:v1/car/waybill
method:GET
header:
{
X-Access-Token:"token，必填"
X-Nonce:"随机字符串，必填"
X-Signature:"签名值"
}
入参:
["车辆id"]
响应:
header:
{
X-Nonce:"随机字符串，必填"
X-Signature:"签名值"
}
body:
[
{
"logisticsCompany": "承运商公司名，大头娃娃运输有限公司1",
"destination": "目的地，杭州市上城区",
"kind": "运输车辆类型，卖好车大板车",
"status": "物流装填，待发车",
"shippingTime": "起运时间 yyyy-MM-dd",
"predictArrivalTime": "预计到达时间 yyyy-MM-dd",
"arrivalTime": "实际到达时间,yyyy-MM-dd",
"carId": "100571421,车辆id",
"photos": {//物流验车照片，同订单
"behind": "//img.maihaoche.com/tms/contracts/[email protected]",
"odometer": "//img.maihaoche.com/tms/contracts/[email protected]",
"front": "//img.maihaoche.com/tms/contracts/[email protected]",
"nameplate": "//img.maihaoche.com/tms/contracts/[email protected]",
"inner": "//img.maihaoche.com/tms/contracts/[email protected]"
}
}
]
4、获取车辆停放仓库信息
请求:
url:v1/car/warehouse
method:GET
header:
{
X-Access-Token:"token，必填"
X-Nonce:"随机字符串，必填"
X-Signature:"签名值"
}
入参:
["车辆id"]
响应:
header:
{
X-Nonce:"随机字符串，必填"
X-Signature:"签名值"
}
body:
[
{
"name": "仓库名称",
"address": "仓库地址",
"carId": "100571421,车辆id",
"entryTime": "入库时间",
"deliveryTime": "出库时间"
"keeper":{
"name":"库管姓名",
"mobile":"库管手机号"
}
"photos": {//仓库验车照片，同订单
"behind": "//img.maihaoche.com/tms/contracts/[email protected]",
"odometer": "//img.maihaoche.com/tms/contracts/[email protected]",
"front": "//img.maihaoche.com/tms/contracts/[email protected]",
"nameplate": "//img.maihaoche.com/tms/contracts/[email protected]",
"inner": "//img.maihaoche.com/tms/contracts/[email protected]"
}
}
]
5、审批通过
请求:
url:v1/agree
method:PUT
header:
{
X-Access-Token:"token，必填"
X-Nonce:"随机字符串，必填"
X-Signature:"签名值"
}
入参:
{"orderId":"订单id"}
响应:
header:
{
X-Nonce:"随机字符串，必填"
X-Signature:"签名值"
}
6、审批拒绝
请求:
url:v1/reject
method:PUT
header:
{
X-Access-Token:"token，必填"
X-Nonce:"随机字符串，必填"
X-Signature:"签名值"
}
入参:
{"orderId":"订单id"}
响应:
header:
{
X-Nonce:"随机字符串，必填"
X-Signature:"签名值"
}
7、获取签章验证码
请求:
url:v1/captcha
method:GET
header:
{
X-Access-Token:"token，必填"
}
响应:
header:
{
X-Nonce:"随机字符串，必填"
X-Signature:"签名值"
}
8、修改签章人
请求:
url:v1/signer
method:POST
header:
{
X-Access-Token:"token，必填"
X-Nonce:"随机字符串，必填"
X-Signature:"签名值"
}
入参:
{
"name": "签章人姓名",
"mobile": "手机号"
}
响应:
header:
{
X-Nonce:"随机字符串，必填"
X-Signature:"签名值"
}
9、签合同
请求:
url:v1/sign
method:POST
header:
{
X-Access-Token:"token，必填"
X-Nonce:"随机字符串，必填"
X-Signature:"签名值"
}
入参:
{
"captcha": "验证码",
"contractId": "合同id"
}
响应:
header:
{
X-Nonce:"随机字符串，必填"
X-Signature:"签名值"
}
10、查询合同地址
请求:
url:v1/contract/uri
method:GET
header:
{
X-Access-Token:"token，必填"
X-Nonce:"随机字符串，必填"
X-Signature:"签名值"
}
入参:
{
"contractId": "订单号",
"mime": "pdf | img"
}
响应:
header:
{
X-Nonce:"随机字符串，必填"
X-Signature:"签名值"
}
出参:
{
"uri": "合同私有地址，一小时有效"
}
11、通知卖好车
请求:
url:v1//message
method:POST
header:
{
X-Access-Token:"token，必填"
X-Nonce:"随机字符串，必填"
X-Signature:"签名值"
}
入参:
响应:
header:
{
X-Nonce:"随机字符串，必填"
X-Signature:"签名值"
}
出参: