Startseite Erkunden Hilfe
Registrieren Anmelden
gongmingwei
/
celestia-api-doc
2
1
Fork 1
Dateien Issues 0 Pull-Requests 0 Wiki

网络货运开放平台文档

Struktur: 0402f2eaf1
Branches Tags
celestia-api...
gmw 0402f2eaf1 up vor 4 Jahren
resources 0402f2eaf1 up vor 4 Jahren
.gitignore 771eef0b3b 创建对接文档 vor 4 Jahren
README.md 0402f2eaf1 up vor 4 Jahren

README.md

网络货运开放接口文档

接口简介：

本文档为网络货运开放接口文档，对接流程为：

  1. 注册并开通网络货运账号（正式环境账号联系我司实施或者商务获取）；
  2. 使用网络货运的账号密码获取接口访问令牌（accessToken）；
  3. 使用accessToken调用其他接口；

请使用主账号获取对应的token再调用其他接口!!!

相关说明(请仔细阅读!)：

  1. 什么是主账号：
    即贵公司在我们系统中创建的第一个账号，其后所有的贵公司系统中的账号都是子账号。如果不知道自己是否使用的主账号或者主账号具体是哪个请联系相关负责人。

  2. 接口统一URL地址：
    测试环境=https://openapi.wlhy.hw.56fanyun.com ，正式环境=https://openapi.wlhy.56fanyun.com

  3. 测试环境系统地址：
    https://wlhy.hw.56fanyun.com

  4. 测试环境账号：
    联系我司对接负责人获取。账号并不互通，测试账号对应的是测试环境的域名，正式环境无法使用！

  5. 调用接口方式：
    URL + ?access_token=生成的token，参数传递使用JSON格式。 Content-Type: application/json;charset=UTF-8。例： https://wlhy.hw.56fanyun.com/order/create_order?access_token=fe12047e-52b1-418c-848c-d08a885095a5 请勿将请求参数拼接在URL中传递！

  6. 调试接口：
    推荐使用Postman，或者访问接口URL，会跳转至调试界面

  7. 时间格式：
    如无特殊说明，接口中所有时间均使用时间戳，精确到秒

  8. 调用限制：
    为防止恶意攻击和滥用，接口都加上了调用限制，不同接口限制不同，请参考接口中调用限制的相关说明。例：60次/分钟，表示一分钟内最多请求60次，超过限制会拒绝请求，返回操作太频繁。

  9. 状态码：

状态码 说明
200 调用接口成功
401 授权失败，需要重新登陆获取access_token
404 接口不存在，请检查调用的接口地址，协议的格式是否正确
500 服务异常，具体错误原因会在返回结果中说明
  1. 返回字段：
名称 说明
code 状态码
data 返回数据，接口调用成功（状态码为 200）之后返回的数据
message 错误信息，当接口调用失败（状态码为 非200）时，返回的错误信息，调用成功时返回null

接口凭证

获取登陆凭证接口

简要描述： 获取登陆凭证，accessToken有效期72小时，refreshToken有效期100天，有效期内获取token返回的结果一样，accessToken到期后建议使用refreshToken进行刷新，而不是使用用户名密码重新获取

请求 URL： /user/generate_access_token

请求方式： POST

需要AccessToken： 否

调用限制： 60次/分钟

请求参数：

名称 说明 类型
userName
必填		 账号 string
password
必填		 密码 string

返回示例

  • 调用成功示例
{
    "code": 200,
    "message": null,
    "data": {
        "accessToken": "9d0dfe02-2349-421c-90ec-4b9ea174701b",
        "refreshToken": "9f8326bc-c29f-4a28-a512-26caa1a9850a"
    }
}
  • 调用失败示例
{
    "code": 500,
    "message": "账号或密码不正确"
}

更新登陆凭证接口

简要描述： 更新登陆凭证，会同时更新accessToken和refreshToken，更新后原accessToken和refreshToken将失效

请求 URL： /user/refresh_access_token

请求方式： POST

需要AccessToken： 否

调用限制： 60次/分钟

请求参数：

名称 说明 类型
userName
必填		 账号 string
refreshToken
必填		 刷新凭证 string

返回示例

  • 调用成功示例
{
    "code": 200,
    "message": null,
    "data": {
        "accessToken": "9d0dfe02-2349-421c-90ec-4b9ea174701b",
        "refreshToken": "9f8326bc-c29f-4a28-a512-26caa1a9850a"
    }
}
  • 调用失败示例
{
    "code": 500,
    "message": "账号或刷新凭证不正确"
}

运单类接口

创建运单接口

简要描述： 开单

请求 URL： /order/create_order

请求方式： POST

需要AccessToken： 是

调用限制： 3次/秒

请求参数：

名称 说明 类型
orders
必填		 运单列表，一次最多50单
长度 : 1 - 50		 < 运单 > array
organizationName
可选		 组织机构名称，会创建至对应组织机构下，默认创建到总部 string

返回示例

  • 调用成功示例
{
    "code": 200,
    "data": ["S2004221802969563"],
    "message": null    
}
  • 调用失败示例
{
    "code": 500,
    "message": "订单创建失败"
}

更新运单接口

简要描述： 更新运单

请求 URL： /order/update_order

请求方式： POST

需要AccessToken： 是

调用限制： 3次/秒

请求参数：

请参考：运单

返回示例

  • 调用成功示例
{
    "code": 200,
    "data": true,
    "message": null
}
  • 调用失败示例
{
    "code": 500,
    "message": "xxxxxxxx"
}

签收运单接口

简要描述： 签收运单

请求 URL： /order/signOff_order

请求方式： POST

需要AccessToken： 是

调用限制： 3次/秒

请求参数：

名称 说明 类型
orderNumbers
必填		 运单号列表，一次最多50单
长度 : 1 - 50		 < string > array
signer
可选		 签收人
长度 : 0 - 20		 string
signTime
可选		 签收时间，时间戳，精确到秒 integer (int32)

返回示例

  • 调用成功示例
{
    "code": 200,
    "data": true,
    "message": null
}
  • 调用失败示例
{
    "code": 500,
    "message": "xxxxxxxx"
}

查询运单接口

简要描述： 查询运单

请求 URL： /order/query_order

请求方式： POST

需要AccessToken： 是

调用限制： 5次/秒

请求参数：

名称 说明 类型
orderNumbers
可选		 运单号列表，一次最多50单
长度 : 1 - 50		 < string > array
timeType
可选		 时间类型
取值 : created(创建时间),opened(开单时间),signed(签收时间)		 string
beginDate
可选		 开始时间
格式 : yyyy-MM-dd HH:mm:ss		 string
endDate
可选		 结束时间
格式 : yyyy-MM-dd HH:mm:ss		 string
number
可选		 运单号，支持模糊搜索 string
originalOrderNumber
可选		 客户单号，支持模糊搜索 string
startAddress
可选		 起始地
长度 : 0 - 20		 string
endAddress
可选		 目的地
长度 : 0 - 20		 string
consignerName
可选		 发货方姓名
长度 : 0 - 45		 string
consignerPhone
可选		 发货方电话
长度 : 0 - 20		 string
consigneeName
可选		 收货方姓名
长度 : 0 - 45		 string
consigneePhone
可选		 收货方电话
长度 : 0 - 20		 string
remarks
可选		 备注
长度 : 0 - 256		 string
page
必填		 当前页
最小值 : 1
最大值 : 1000		 string
size
必填		 单页数量
最小值 : 1
最大值 : 50		 string

返回示例

  • 调用成功示例
{
    "code": 200,
    "data": true,
    "message": null
}
  • 调用失败示例
{
    "code": 500,
    "message": "xxxxxxxx"
}

撤销运单接口

简要描述： 撤销运单

请求 URL： /order/cancel_order

请求方式： POST

需要AccessToken： 是

调用限制： 3次/秒

请求参数：

名称 说明 类型
orderNumbers
必填		 运单号列表，一次最多50单
长度 : 1 - 50		 < string > array

返回示例

  • 调用成功示例
{
    "code": 200,
    "data": true,
    "message": null
}
  • 调用失败示例
{
    "code": 500,
    "message": "xxxxxxxx"
}

基础信息类接口

批量创建司机接口

简要描述： 批量创建司机

请求 URL： /driver/batch_create

请求方式： POST

需要AccessToken： 是

调用限制： 3次/秒

请求参数：

名称 说明 类型
drivers
必填		 司机列表，单次最多50个
长度 : 1 - 50		 < 司机 > array
  • 调用成功示例
{
    "code": 200,
    "data": true,
    "message": null
}
  • 调用失败示例
{
    "code": 500,
    "message": "xxxxxxxx"
}

修改司机信息接口

简要描述： 修改司机信息，根据唯一标识更新对应司机的信息，该接口为覆盖更新，故未变更的字段也需要传入，否则会置空

请求 URL： /driver/update

请求方式： POST

需要AccessToken： 是

调用限制： 3次/秒

请求参数：

请参考：司机

  • 调用成功示例
{
    "code": 200,
    "data": true,
    "message": null
}
  • 调用失败示例
{
    "code": 500,
    "message": "xxxxxxxx"
}

批量创建车辆接口

简要描述： 批量创建车辆

请求 URL： /vehicle/batch_create

请求方式： POST

需要AccessToken： 是

调用限制： 3次/秒

请求参数：

名称 说明 类型
vehicles
必填		 车辆列表，单次最多50个
长度 : 1 - 50		 < 车辆 > array
  • 调用成功示例
{
    "code": 200,
    "data": true,
    "message": null
}
  • 调用失败示例
{
    "code": 500,
    "message": "xxxxxxxx"
}

修改车辆信息接口

简要描述： 修改车辆信息，根据唯一标识更新对应车辆的信息，该接口为覆盖更新，故未变更的字段也需要传入，否则会置空

请求 URL： /vehicle/update

请求方式： POST

需要AccessToken： 是

调用限制： 3次/秒

请求参数：

请参考：车辆

  • 调用成功示例
{
    "code": 200,
    "data": true,
    "message": null
}
  • 调用失败示例
{
    "code": 500,
    "message": "xxxxxxxx"
}

批量创建收款人接口

简要描述： 批量创建收款人

请求 URL： /payee/batch_create

请求方式： POST

需要AccessToken： 是

调用限制： 3次/秒

请求参数：

名称 说明 类型
payees
必填		 收款人列表，单次最多50个
长度 : 1 - 50		 < 收款人 > array
  • 调用成功示例
{
    "code": 200,
    "data": true,
    "message": null
}
  • 调用失败示例
{
    "code": 500,
    "message": "xxxxxxxx"
}

修改收款人信息接口

简要描述： 修改收款人信息，根据唯一标识更新对应收款人的信息，该接口为覆盖更新，故未变更的字段也需要传入，否则会置空

请求 URL： /payee/update

请求方式： POST

需要AccessToken： 是

调用限制： 3次/秒

请求参数：

请参考：收款人

  • 调用成功示例
{
    "code": 200,
    "data": true,
    "message": null
}
  • 调用失败示例
{
    "code": 500,
    "message": "xxxxxxxx"
}

财务类接口

核销接口

简要描述： 核销

请求 URL： /writeoff/writeoff

请求方式： POST

需要AccessToken： 是

调用限制： 120次/分钟

请求参数：

名称 说明 类型
carNumber
必填		 车牌号码
长度 : 1 - 35		 string
customerOrderNumbers
必填		 结算受理单列表 < string > array
driverName
必填		 司机名称
长度 : 1 - 30		 string
driverPhone
必填		 司机电话
长度 : 1 - 18		 string
payFreight
必填		 支付金额
最小值 : 0
最大值 : 999999		 number (double)
payType
必填		 支付方式，1：油卡，2：现金，3：支付宝，4：微信，5：银行转账，6：其它 integer (int32)
payee
运单有关联收款人时可选		 收款人，默认用运单司机关联的收款人，如果受理单没有关联收款人，这里必填 收款人
tradeNo
必填		 资金流水号
长度 : 1 - 50		 string
note
可选		 付款备注
长度 : 0 - 256		 string
  • 调用成功示例
{
    "code": 200,
    "data": true,
    "message": null
}
  • 调用失败示例
{
    "code": 500,
    "message": "xxxxxxxx"
}

撤销核销接口

简要描述： 撤销核销

请求 URL： /writeoff/cancel

请求方式： POST

需要AccessToken： 是

调用限制： 120次/分钟

请求参数：

名称 说明 类型
customerOrderNumbers
必填		 结算受理单列表
样例 : [ "XXX", "XXX" ]		 < string > array
  • 调用成功示例
{
    "code": 200,
    "data": true,
    "message": null
}
  • 调用失败示例
{
    "code": 500,
    "message": "xxxxxxxx"
}

合同类接口

创建司机合同接口

简要描述： 创建司机合同

请求 URL： /contract/driver/create

请求方式： POST

需要AccessToken： 是

调用限制： 3次/秒

请求参数：

名称 说明 类型
number
必填		 合同编号 string
name
必填		 姓名 string
phone
必填		 电话 string
certNo
必填		 身份证号 string
contractDate
必填		 签约日期，格式yyyy-MM-dd
样例 : 2020-01-01		 string
startDate
必填		 合同开始日期，格式yyyy-MM-dd
样例 : 2020-01-01		 string
endDate
必填		 合同截止日期，格式yyyy-MM-dd
样例 : 2020-01-01		 string
fileUrl
必填		 合同文件地址
样例 : https://www.a.com/z.pdf		 string
organizationName
可选		 组织机构名称，会创建至对应组织机构下，默认创建到总部 string
  • 调用成功示例
{
    "code": 200,
    "data": true,
    "message": null
}
  • 调用失败示例
{
    "code": 500,
    "message": "xxxxxxxx"
}

位置信息类接口

上传设备状态位置数据接口

简要描述： 上传单个位置信息接口，如果一次性需要传多个位置信息，则推荐使用批量上传接口

请求 URL： /gps/push_gps_data

请求方式： POST

需要AccessToken： 是

调用限制： 3次/秒

请求参数：

请参考：位置信息

  • 调用成功示例
{
    "code": 200,
    "data": true,
    "message": null
}
  • 调用失败示例
{
    "code": 500,
    "message": "xxxxxxxx"
}

批量上传设备状态位置数据接口

简要描述： 批量上传设备状态位置数据接口

请求 URL： /gps/batch_push_gps_data

请求方式： POST

需要AccessToken： 是

调用限制： 60次/分钟

请求参数：

请参考： |名称|说明|类型| |---|---|---| |gpsDataList
必填|位置信息列表，单次最多1000个点、50台不同的设备|< 位置信息 > array|

  • 调用成功示例
{
    "code": 200,
    "data": true,
    "message": null
}
  • 调用失败示例
{
    "code": 500,
    "message": "xxxxxxxx"
}

实名认证类接口

实名认证接口

简要描述： 使用自有业务系统APP的场景需要接入实名认证和嵌入网络货运SDK

请求 URL： /ocr/face_match

请求方式： POST

需要AccessToken： 是

调用限制： 1000次/天

请求参数：

名称 说明 类型
name
必填		 姓名 string
certNo
必填		 身份证号 string
certImg
必填		 身份证图片
格式 : Base64		 string
headImg
必填		 人脸图片
格式 : Base64		 string
  • 调用成功示例
{
    "code": 200,
    "data": true,
    "message": null
}
  • 调用失败示例
{
    "code": 500,
    "message": "xxxxxxxx"
}

接口参数说明

运单

名称 说明 类型
orderNumber
更新运单时必填		 运单号，更新运单时必填，创建运单时不需要填写 string
originalOrderNumber
必填		 客户单号
长度 : 1 - 50		 string
businessType
必填		 业务类型 enum (干线普货运输, 城市配送, 农村配送, 集装箱运输, 其他)
consignerName
必填		 发货人姓名
长度 : 1 - 45		 string
consignerPhone
必填		 发货人电话
长度 : 1 - 20		 string
consignerAddress
必填		 发货人地址 地址
consignerIdCard
必填		 发货人证件号
长度 : 1 - 35		 string
consigneeName
必填		 收货人姓名
长度 : 1 - 45		 string
consigneePhone
必填		 收货人电话
长度 : 1 - 20		 string
freightIn
必填		 运单运费信息 运单运费
consigneeAddress
必填		 收货人地址 地址
cargoList
必填		 货物列表 < 货物 > array
carrier
可选		 承运人 承运人
payee
可选		 收款人 收款人
consigneeIdCard
可选		 收货人证件号
长度 : 0 - 35		 string
appointArriveTime
可选		 预约送达时间。时间戳 integer (int32)
openTime
可选		 开单时间。时间戳 integer (int32)
deliveryTime
可选		 提货时间。时间戳 integer (int32)
deliveryType
可选		 提送类型。1：自提；2：送货 integer (int32)
endAddress
可选		 目的地
长度 : 0 - 20		 string
note1
可选		 自定义备注1 string
note2
可选		 自定义备注2 string
note3
可选		 自定义备注3 string
note4
可选		 自定义备注4 string
note5
可选		 自定义备注5 string
note6
可选		 自定义备注6 string
note7
可选		 自定义备注7 string
note8
可选		 自定义备注8 string
note9
可选		 自定义备注9 string
note10
可选		 自定义备注10 string
note11
可选		 自定义备注11 string
note12
可选		 自定义备注12 string
paymentCollect
可选		 代收货款
最小值 : 0
最大值 : 999999		 number (double)
receiptCount
可选		 回单数
最小值 : 0
最大值 : 999		 integer (int32)
remarks
可选		 备注
长度 : 1 - 250		 string
salesman
可选		 业务员
长度 : 0 - 20		 string
salesmanPhone
可选		 业务员电话
长度 : 0 - 12		 string
settlementName
可选		 结算方名称
长度 : 0 - 50		 string
settlementPhone
可选		 结算方电话
长度 : 0 - 20		 string
shipperPay
可选		 上游运费
最小值 : 0
最大值 : 9999999		 number (double)
shipperPayType
可选		 上游运费支付方式. 1：现付；2：到付；3：回付；4：周结；5：月结；6：货款扣；7：季度结；8：在线支付；9：到付月结 integer (int32)
startAddress
可选		 起始地
长度 : 0 - 20		 string

货物

名称 说明 类型
name
必填		 货物名称
长度 : 1 - 150		 string
type
必填		 货物类型名称 可选值请参考《部网络货运信息交互系统代码集》
weight
必填		 重量(千克或吨，由系统设置的重量单位决定)
最小值 : 0
最大值 : 99999999		 number (double)
quantity
可选		 件数
最小值 : 0
最大值 : 999999		 number (double)
value
可选		 货值
最小值 : 0
最大值 : 9999999		 number (double)
volume
可选		 体积
最小值 : 0
最大值 : 9999		 number (double)
productModel
可选		 货物备注
长度 : 0 - 100		 string
note1
可选		 自定义备注1 string
note2
可选		 自定义备注2 string
note3
可选		 自定义备注3 string
note4
可选		 自定义备注4 string
note5
可选		 自定义备注5 string
note6
可选		 自定义备注6 string

承运人

名称 说明 类型
carNumber
必填		 车牌号码
长度 : 1 - 20		 string
driverFreight
必填		 司机运费
最小值 : 0
最大值 : 999999		 number (double)
driverName
必填		 司机名称
长度 : 1 - 20		 string
driverPhone
必填		 司机电话
长度 : 1 - 20		 string
insuranceCompany
可选		 保险公司
长度 : 0 - 30		 string
insuranceNumber
可选		 保险单号
长度 : 0 - 30		 string

受理单收款人

名称 说明 类型
name
必填		 银行开户名
长度 : 1 - 20		 string
bankCardNumber
必填		 银行卡号 number (double)
bankName
必填		 开户银行，支持的银行请参考《部网络货运信息交互系统代码集》 string
idCard
必填		 身份证
长度 : 18		 string
phoneNumber
可选		 手机号
长度 : 11		 string

地址

省市区可选值参考：http://go.56ctms.com/s/BuxJEn09

名称 说明 类型
address
必填		 地址
长度 : 1 - 100		 string
province
必填		 省。xx省 string
city
必填		 市。xx市 string
district
必填		 区/县。xx区/县 string
lat
可选		 纬度 number (double)
lng
可选		 经度 number (double)

运单运费

名称 说明 类型
amount
必填		 运费金额，如无运费，填0即可 number (double)
payType
可选		 支付方式，1：现付， 2：到付， 3：回付， 4：周结， 5：月结， 6：货款扣， 7：季度结， 8：在线支付， 9：到付月结 integer (int32)

司机

名称 说明 类型
idCard
必填		 身份证，该字段为司机的唯一标识 string
name
必填		 姓名
长度 : 1 - 20		 string
phoneNumber
必填		 手机号
长度 : 11		 string
idCardAddress
必填		 身份证地址
长度 : 1 - 80		 string
driverLicenseIssuingAuthority
必填		 驾驶证发证机关
长度 : 1 - 50		 string
driverLicenseNumber
必填		 驾驶证编号
长度 : 1 - 18		 string
driverLicenseEndTime
必填		 驾驶证有效期结束时间，时间戳，精确到秒 integer (int64)
driverLicenseStartTime
必填		 驾驶证有效期开始时间，时间戳，精确到秒 integer (int64)
qualificationCertificateNumber
必填		 从业资格证号
长度 : 1 - 19		 string
quasiDrivingModel
必填		 准驾车型
长度 : 1 - 20		 string
organizationName
可选		 组织机构名称，会创建至对应组织机构下，默认创建到总部 string
idCardBackUrl
可选		 身份证背面图片地址 string
idCardFrontUrl
可选		 身份证正面图片地址 string
driverLicenseUrl
可选		 驾驶证图片地址 string
qualificationCertificateUrlList
可选		 从业资格证图片地址，最多传输4张 < string > array
verifyStatus
可选		 审核状态，0：审核通过，1：审核不通过，默认：0 integer (int32)
note
可选		 备注
长度 : 0 - 250		 string

车辆

名称 说明 类型
licensePlateNumber
必填		 车牌号，该字段为车辆的唯一标识
长度 : 1 - 10		 string
vehicleOwner
必填		 车辆所有人
长度 : 1 - 50		 string
issuingAuthority
必填		 发证机关
长度 : 1 - 50		 string
merchantName
必填		 业户名称 string
natureOfUse
必填		 使用性质
长度 : 1 - 20		 string
licensePlateColor
与licensePlateColorCode二选一必填		 车牌颜色，和车牌颜色代码对应，两个中必填一个，优先使用本字段的值，代码集请参考《部网络货运信息交互系统代码集》 string
licensePlateColorCode
与licensePlateColor二选一必填		 车牌颜色代码，和车牌颜色对应 string
vehicleType
与vehicleTypeCode二选一必填		 车辆类型，和车辆类型代码对应，两个中必填一个，优先使用本字段的值，代码集请参考《部网络货运信息交互系统代码集》 string
vehicleTypeCode
与vehicleType二选一必填		 车辆类型代码，和车辆类型对应 string
vehicleEnergyType
与vehicleEnergyTypeCode二选一必填		 车辆能源类型，和车辆能源类型代码对应，两个中必填一个，优先使用本字段的值，代码集请参考《部网络货运信息交互系统代码集》 string
vehicleEnergyTypeCode
与vehicleEnergyType二选一必填		 车辆能源类型代码，和车辆能源类型对应 string
issueDate
必填		 发证日期，时间戳，精确到秒 integer (int64)
registrationDate
必填		 注册日期，时间戳，精确到秒 integer (int64)
roadTransportCertificate
必填		 道路运输证号
长度 : 1 - 12		 string
roadTransportLicenseNumber
必填		 道路运输经营许可证号 string
totalWeight
必填		 总质量，单位：千克
最小值 : 1		 integer (int32)
approvedLoadWeight
必填		 核定载质量，单位：千克
最小值 : 1		 integer (int32)
vehicleIDCode
必填		 车辆识别代码
长度 : 1 - 20		 string
organizationName
可选		 组织机构名称，会创建至对应组织机构下，默认创建到总部 string
fileNumber
可选		 档案编号
长度 : 0 - 20		 string
note
可选		 备注
长度 : 0 - 250		 string
outlineHeight
可选		 外廓高，单位：毫米
最小值 : 1		 integer (int32)
outlineLength
可选		 外廓长，单位：毫米
最小值 : 1		 integer (int32)
outlineWidth
可选		 外廓宽，单位：毫米
最小值 : 1		 integer (int32)
drivingLicenseUrlList
可选		 行驶证照片，最多传输4张 < string > array
roadTransportPermitUrlList
可选		 道路运输证照片，最多传输4张 < string > array
trailerLicenseNumber
可选		 挂车牌照号
长度 : 0 - 10		 string
verifyStatus
可选		 审核状态，0：审核通过，1：审核不通过，默认：0 integer (int32)

收款人

名称 说明 类型
bankCardNumber
必填		 银行卡号，该字段为收款人的唯一标识 string
name
必填		 银行开户名
长度 : 1 - 20		 string
bankName
必填		 开户银行，支持的银行请参考《部网络货运信息交互系统代码集》 string
idCard
必填		 身份证 string
organizationName
可选		 组织机构名称，会创建至对应组织机构下，默认创建到总部 string
phoneNumber
可选		 手机号
长度 : 11		 string
note
可选		 备注
长度 : 1 - 200		 string

位置信息

名称 说明 类型
device
必填		 设备号，如果没有设备号也可以按车牌号上报位置，此时运单绑定的设备号需要为车牌号 string
longitude
必填		 经度 number (double)
latitude
必填		 纬度 number (double)
locateTime
必填		 定位时间（时间戳，精确到秒） integer (int32)
locateType
必填		 定位类型：(0：未知，1：GPS，2：基站定位，4：北斗定位，5：GPS 和北斗定位） integer (int32)
runStatus
必填		 设备运行状态（1:行驶，2:停止，3:离线） integer (int32)
addr
可选		 设备完整定位地址，包含省市区
例 : 浙江省杭州市西湖区计量大厦		 string
province
可选		 定位省份 string
city
可选		 定位城市 string
roadName
可选		 定位街道 string
speed
可选		 设备速度（单位：km／h） number (double)
direction
可选		 设备运动方向（单位：角度） number (double)
temperature
可选		 设备温度（单位：度） number (double)
humidity
可选		 设备湿度（单位：度） number (double)
powerRate
可选		 设备电量（单位：%） integer (int32)
note1
可选		 自定义备注1 string
note2
可选		 自定义备注2 string
note3
可选		 自定义备注3 string
note4
可选		 自定义备注4 string
note5
可选		 自定义备注5 string
note6
可选		 自定义备注6 string
note7
可选		 自定义备注7 string
note8
可选		 自定义备注8 string
note9
可选		 自定义备注9 string
note10
可选		 自定义备注10 string
note11
可选		 自定义备注11 string
note12
可选		 自定义备注12 string