询价

客户对某一运单进行询价

POST	api/query/create

系统请求参数

参数名	中文参数名	类型	是否必填	描述
appKey	应用key	string	是	创建应用后生成
signStr	签名	string	是	appKey和appSecret加密生成
reqTimestamp	请求时间戳	long	是	单位:秒

业务请求参数

参数名	中文参数名	类型	是否必填	描述
thirdSn	客户的询价单号	string	是
customerName	请车员姓名	string	否
customerMobile	请车员联系方式	string	否
goodsName	货物名称	string	是
goodsWeight	货物重量【单位：千克(kg)】	integer	是
goodsCubage	货物体积【单位：立方米(m3)】	integer	是
carModelCode	车长车型id	integer	是	以福佑车长车型表的车长车型id为准,帮助中心-帮助文档下载查看
startProvinceName	装货地省名称	string	否
startProvinceCode	装货地省 id	string	是	以福佑区域信息表id 为准,帮助中心-帮助文档下载查看
startCityName	装货地市名称	string	否
startCityCode	装货地市 id	string	是	以福佑区域信息表id 为准,帮助中心-帮助文档下载查看
startDistrictName	装货地区名称	string	否
startDistrictCode	装货地区id	string	是	以福佑区域信息表id 为准,帮助中心-帮助文档下载查看
tags	个性标签编码(key)	string	否	详见个性标签表,帮助中心-帮助文档下载查看;多个用逗号隔开
startAddress	装货地址详细	string	是
endProvinceName	卸货地省名称	string	否
endProvinceCode	卸货地省id	string	是	以福佑区域信息表id 为准,帮助中心-帮助文档下载查看
endCityName	卸货地市名称	string	否
endCityCode	卸货地市id	string	是	以福佑区域信息表id 为准,帮助中心-帮助文档下载查看
endDistrictName	卸货地区名称	string	否
endDistrictCode	卸货地区id	string	是	以福佑区域信息表id 为准,帮助中心-帮助文档下载查看
endAddress	卸货地址详细地址	string	是
loadTime	装货时间时间戳	long	否	单位:秒
unloadTime	卸货时间时间戳	long	否	单位:秒
sendTime	发货时间戳	long	否	单位:秒
addedService	装卸货入仓服务	string	否	多个用逗号分隔，装货： 23;卸货： 24; 入仓：25;
needReceipt	是否需要回单	string	否	可选值 0：不需要;1：需要; 默认为 1 需要
needInsurance	是否需要购买保险	string	否	可选值 0：不需要;1：需要; 默认为 0 不需要
goodsValue	货物价值	string	否	单位:元;如果 needInsurance 为 1 则，该字段必须不能为空
goodsType	货物类型编码(key)	string	否	详见货物类型表,帮助中心-帮助文档下载查看; 如果needInsurance 为 1 则该字段必须不能为空
packageType	包装方式编码(key)	integer	否	详见包装方式表,帮助中心-帮助文档下载查看; 如果 needInsurance 为 1 则该字段必须不能为空
comments	备注	string	否
businessDeptName	营业部名称	string	否
stopPoints	经停点数据集合	array[object]	否

stopPoints类型说明

参数名	中文参数名	类型	是否必填	描述
provinceCode	经停点省id	string	是	以福佑区域表对应的省id 为准,帮助中心-帮助文档下载查看
provinceName	经停点省名称	string	否
cityCode	经停点市 id	string	是	以福佑区域表对应的市id 为准,帮助中心-帮助文档下载查看
cityName	经停点省京标编码	string	否
districtCode	经停点区id	string	是	以福佑区域表对应的区id 为准,帮助中心-帮助文档下载查看
districtName	经停点区名称	string	否
address	经停点详细地址	string	否
contactName	经停点联系人姓名	string	是
contactMobile	经停点联系人电话	string	是
planInTime	计划驶入经停点时间时间戳	long	否	单位:秒
planOutTime	计划驶出经停点时间时间戳	long	否	单位:秒

返回参数

参数名	中文参数名	类型	是否必填	描述
code	返回码	string	是	0 表示成功，非零表示询价失败详情见返回错误编码表
desc	描述	string	是
orderSn	福佑单号	string	是

请求示例

{
  "thirdSn": "12345678921",
  "customerName": "发货员",
  "customerMobile": "15944582222",
  "goodsName": "快递货",
  "goodsWeight": 10,
  "goodsCubage": 10,
  "carModelCode": 58,
  "startProvinceName": "北京市",
  "startProvinceCode": "2",
  "startCityName": "北京市",
  "startCityCode": "52",
  "startDistrictName": "海淀区",
  "startDistrictCode": "502",
  "startAddress": "知春里112号",
  "endProvinceName": "上海",
  "endProvinceCode": "25",
  "endCityName": "上海",
  "endCityCode": "321",
  "endDistrictName": "青浦区",
  "endDistrictCode": "2718",
  "endAddress": "XX转运场",
  "loadTime": 1562371200,
  "unloadTime": 1562457600,
  "sendTime": 1562374800,
  "tags": "20,21",
  "addedService": "23,24",
  "needReceipt": "0",
  "needInsurance": "0",
  "goodsValue": "23456",
  "goodsType": "",
  "packageType": 701,
  "comments": "",
  "businessDeptName": "",
  "stopPoints": [{
      "provinceCode": "2",
      "provinceName": "北京",
      "cityCode": "52",
      "cityName": "北京",
      "districtCode": "507",
      "districtName": "石景山区",
      "address": "北京市石景山区调度公园",
      "contactName": "张三",
      "contactMobile": "李四",
      "planInTime": 1562407200,
      "planOutTime": 1562414400
  }]
}

返回示例

{
  "status": {
      "desc": "操作成功",
      "code": 0
  },
  "property": {
      "orderSn": "118031539330"//福佑订单号，
  }
}

目录

接入规范

整车业务接口

财务

询价

系统请求参数

业务请求参数

stopPoints类型说明

返回参数

请求示例

返回示例