POST /api/account/logon
说明
登录
request body
{
"userName": "用户名",
"password": "密码"
}
返回
登录成功
{
"code": 200,
"message": null,
"model": {
"id": 1,
"name": "总公司",
"account": "xxx",
"roleId": 1,
"orgId": 1,
"orgName": null,
"bizOrgId": 1,
"bizOrgName": null,
"org": {
"id": 1,
"name": "博特利华总公司",
"shortName": "博特利华总公司",
"type": 1,
"spelling": "btlh",
"shortSpelling": "btlh"
},
"bizOrg": {
"id": 1,
"name": "博特利华总公司",
"shortName": "博特利华总公司",
"type": 1,
"spelling": "btlh",
"shortSpelling": "btlh"
},
"endOrgList": [
{
"id": 33,
"name": "焦作网点",
"shortName": "焦作",
"type": 3,
"spelling": "jiaozuo",
"shortSpelling": "jz"
},
{
"id": 34,
"name": "开封网点",
"shortName": "开封",
"type": 3,
"spelling": "kaifeng",
"shortSpelling": "kf"
}
],
"nextOrgList": [
{
"id": 32,
"name": "太原物流公司",
"shortName": "太原分拨",
"type": 2,
"spelling": "taiyuanfenbo",
"shortSpelling": "tyfb"
}
]
}
}
登录失败
message字段会显示失败原因
{
"code": 300,
"model": null,
"message": "密码不正确"
}
修改密码 POST /api/account/change-password
说明
参数
{
"userName": "bbbb", // 用户名
"oldPassword": "xxxxx", // 旧密码
"newPassword": "33" // 新密码
}
返回
成功
{
"code": 200,
"message": null,
"model": true
}
失败
{
"code": 300,
"message": "登陆密码错误",
"model": false
}
获取车辆列表 GET /api/common/car
说明
参数
无
返回
{
"code": 200,
"message": null,
"model": [
{
"id": 1,
"plate": "豫AR3900",
"driverName": "小明",
"driverPhone": "18337198875",
"createTime": "2016-09-22T15:55:53",
"createUser": 1,
"carTypeId": 1,
"isValid": true,
"cubage": 168,
"weight": 40
}
]
}
获取常用选项 GET /api/common/option
说明
参数
无
返回
{
"code": 200,
"message": null,
"model": {
"pack": [
{
"key": "桶",
"value": "桶"
},
{
"key": "包",
"value": "包"
}
],
"balanceMethod": [
{
"key": "1",
"value": "到付"
},
{
"key": "2",
"value": "现付"
},
]
}
}
获取单个选项 GET /api/common/option/?id={:id}
说明
uri parameters
1. id 选项名称(Pack:包装方式,BalanceMethod: 结算方式等)
返回
{
"code": 200,
"message": null,
"model": [
{
"key": "桶",
"value": "桶"
},
{
"key": "包",
"value": "包"
}
]
}
获取系统配置 GET /api/common/cfg-option
说明
参数
无
返回
{
"code": 200,
"message": null,
"model": {
"premiumRatio": "0.003",
"singleBillMaxGoodsCount": "2"
}
}
获取会员 GET /api/common/member/?code={:code}
说明
参数
1. code 会员号
返回
{
"code": 200,
"message": null,
"model": {
"id": 52,
"no": "10034",
"name": "胡炳龙",
"telephone": "68726100",
"identityCard": "",
"birthday": "1980-01-01T00:00:00",
"address": "",
"isBankTransfer": true,
"bankType": "PCBC",
"bankCard": "2433139980104067408",
"enabled": true,
"createTime": "2016-12-06T10:15:51",
"createUser": 1,
"createOrg": 1,
"editTime": "2017-03-15T10:00:23",
"categoryId": 6,
"tradeId": 110,
"tradeName": "机械类"
}
}
获取发货人姓名 GET /api/common/shipper/?phone={:phone}
说明
根据手机号返回姓名
参数
1. phone 手机号
返回
{
"code": 200,
"message": null,
"model": "hello"
}
获取收货人姓名 GET /api/common/consignee/?phone={:phone}
说明
根据手机号返回姓名
参数
1. phone 手机号
返回
{
"code": 200,
"message": null,
"model": "hello"
}
获取票据信息 GET /api/common/bill/?id={:id}|hdbh={:hdbh}&orgId={:orgId}
说明
根据单号或者id查询票据详情
参数
id和hdbh任选一个, orgId必填
1. id 运单ID
2. hdbh 货单编号
3. orgId 部门ID
返回
{
{
"code": 200,
"message": null,
"model": {
"bill": {
"isReportLoss": false,
"reportLossPersonName": "",
"reportLossPersonIDCardNumber": "",
"cancelReportLossPersonName": "",
"cancelReportLossPersonIDCardNumber": "",
"takeMethod": "自提",
"billType": 1,
"parentId": 0,
"id": 13,
"billDate": "2017-02-06T00:00:00",
"hdbh": "017037000014",
"status": 1,
"isValid": true,
"notes": "",
"departmentId": 34,
"createUser": 4,
"createTime": "2017-02-06T17:43:38",
"isNeedDeliveryProof": false,
"displayStatus": "郑州物流公司已到货",
"billSource": "Web",
"clientType": 0,
"financeStatus": 0,
"storeStatus": 0,
"goodsInfo": "[{\"PremiumAmount\":0.0,\"Id\":0,\"BillId\":0,\"GoodsId\":\"017037000014-1-10\",\"GoodsName\":\"阿斯顿发\",\"Pack\":\"无\",\"Numbers\":10,\"Weight\":40.0,\"Length\":0.0,\"Width\":0.0,\"Height\":0.0,\"Cubage\":4.0},{\"PremiumAmount\":0.0,\"Id\":0,\"BillId\":0,\"GoodsId\":\"017037000014-2-5\",\"GoodsName\":\"爱的\",\"Pack\":\"无\",\"Numbers\":5,\"Weight\":30.0,\"Length\":0.0,\"Width\":0.0,\"Height\":0.0,\"Cubage\":3.0}]",
"quantity": 15,
"weight": 70,
"cubage": 7,
"deliveryProofCount": 0,
"virtualAccountFinanceStatus": 0,
"additionStatus": 1,
"extraRequirement": 0,
"transportCost": 0,
"goodsCost": 0
},
"contact": {
"billId": 13,
"shipper": "是打发",
"shipperPhone": "13133333333",
"consignee": "阿斯顿发",
"consigneePhone": "13233333333",
"memberId": 0,
"bankCode": "",
"bankCardNo": "",
"bankCardName": "",
"consigneeAddress": null
},
"goodsList": [
{
"premiumAmount": 0,
"id": 15,
"billId": 13,
"goodsId": "017037000014-1-10",
"goodsName": "阿斯顿发",
"pack": "无",
"numbers": 10,
"weight": 40,
"length": 0,
"width": 0,
"height": 0,
"cubage": 4
},
{
"premiumAmount": 0,
"id": 16,
"billId": 13,
"goodsId": "017037000014-2-5",
"goodsName": "爱的",
"pack": "无",
"numbers": 5,
"weight": 30,
"length": 0,
"width": 0,
"height": 0,
"cubage": 3
}
],
"cost": {
"rebateCost": 0,
"billId": 13,
"balanceMethod": 1,
"transportCost": 200,
"goodsCost": 0,
"transferCost": 0,
"deliveryCost": 0,
"deliveryCostBalanceMethod": 1,
"premiumAmount": 0,
"premiumCost": 0
},
"logList": [
{
"id": 225,
"billId": 13,
"operateUser": 2,
"department": 31,
"operateType": "到货",
"description": "郑州物流公司已到货",
"isTrack": true,
"createTime": "2017-02-08T15:08:33",
"clientType": 0,
"userHostAddress": "::1"
},
{
"id": 226,
"billId": 13,
"operateUser": 2,
"department": 31,
"operateType": "件数",
"description": "郑州物流公司实到数量10",
"isTrack": false,
"createTime": "2017-02-08T15:08:33",
"clientType": 0,
"userHostAddress": "::1"
},
{
"id": 50,
"billId": 13,
"operateUser": 4,
"department": 34,
"operateType": "发车",
"description": "开封网点已发车,下一站郑州物流公司",
"isTrack": true,
"createTime": "2017-02-06T17:48:14",
"clientType": 0,
"userHostAddress": "::1"
},
{
"id": 49,
"billId": 13,
"operateUser": 4,
"department": 34,
"operateType": "开票",
"description": "开封网点已收件",
"isTrack": true,
"createTime": "2017-02-06T17:43:38",
"clientType": 0,
"userHostAddress": "::1"
}
],
"transport": {
"currentDepartmentId": 31,
"nextDepartmentId": 35,
"billId": 13,
"startCity": 0,
"stockInTime": "1970-01-01T00:00:00",
"startDepartment": 34,
"endCity": 0,
"endDepartment": 35,
"transferAddress": null
},
"backtrack": {
"billId": 0,
"backtrackStatus": 0,
"updatedAt": "2017-03-28T09:25:32.9500596+08:00",
"updatedBy": 0,
"departmentId": 0,
"createUser": 0,
"createTime": "2017-03-28T09:25:32.9500596+08:00",
"applyReason": null,
"approveNote": null,
"createdByUser": null,
"createdByDepartment": null,
"updatedByUser": null
},
"startDepartName": "开封",
"endDepartName": "晋城",
"memberCode": "无",
"displayDeliveryCostBalanceMethod": "到付",
"displayBalanceMethod": "到付",
"otherRequirements": [],
"canReportLoss": false,
"canInvalid": false,
"isTransfer": false,
"transferDepartName": null,
"transferBillNo": null,
"transferPhone": null,
"transferTransportCost": 0,
"transferDeliveryCost": 0,
"transferGoodsCost": 0,
"transferTime": "0001-01-01T00:00:00",
"transferByDepartName": null,
"changeHistoryList": [
{
"bill": {
"isReportLoss": false,
"reportLossPersonName": "",
"reportLossPersonIDCardNumber": "",
"cancelReportLossPersonName": "",
"cancelReportLossPersonIDCardNumber": "",
"takeMethod": "自提",
"billType": 1,
"parentId": 0,
"id": 13,
"billDate": "2017-02-06T00:00:00",
"hdbh": "017037000014",
"status": 1,
"isValid": true,
"notes": "",
"departmentId": 34,
"createUser": 4,
"createTime": "2017-02-06T17:43:38",
"isNeedDeliveryProof": false,
"displayStatus": "郑州物流公司已到货",
"billSource": "Web",
"clientType": 0,
"financeStatus": 0,
"storeStatus": 0,
"goodsInfo": "[{\"PremiumAmount\":0.0,\"Id\":0,\"BillId\":0,\"GoodsId\":\"017037000014-1-10\",\"GoodsName\":\"阿斯顿发\",\"Pack\":\"无\",\"Numbers\":10,\"Weight\":40.0,\"Length\":0.0,\"Width\":0.0,\"Height\":0.0,\"Cubage\":4.0},{\"PremiumAmount\":0.0,\"Id\":0,\"BillId\":0,\"GoodsId\":\"017037000014-2-5\",\"GoodsName\":\"爱的\",\"Pack\":\"无\",\"Numbers\":5,\"Weight\":30.0,\"Length\":0.0,\"Width\":0.0,\"Height\":0.0,\"Cubage\":3.0}]",
"quantity": 15,
"weight": 70,
"cubage": 7,
"deliveryProofCount": 0,
"virtualAccountFinanceStatus": 0,
"additionStatus": 1,
"extraRequirement": 0,
"transportCost": 0,
"goodsCost": 0
},
"createdBy": {
"id": 2,
"account": "zhengzhou",
"password": "md5_e10adc3949ba59abbe56e057f20f883e",
"name": "郑州",
"orgId": 31,
"roleId": 1,
"enabled": true,
"createTime": "2017-02-06T13:52:38",
"createUser": 0,
"lastLoginTime": "2017-03-27T15:40:14",
"phone": " "
},
"department": {
"id": 31,
"cascadeId": "0.1.31.",
"name": "郑州物流公司",
"code": "",
"shorterName": "郑州分拨",
"shorterNameAllSpelling": "zhengzhoufenbo",
"shorterNameSpelling": "zzfb",
"parentId": 1,
"parentName": "博特利华总公司",
"businessParentId": 1,
"type": 2,
"region": 412,
"linkMan": "18703859320",
"linkTelephone": "18703859320",
"sortNo": 1,
"allowSend": false,
"allowTake": false,
"enabled": true,
"createTime": "2017-02-16T13:47:57",
"createUser": 0,
"reservedAmount": 0,
"alertAmount": 0,
"sendMessageStatus": 0
},
"id": 44,
"billId": 13,
"changeType": "到货件数",
"changeContent": "郑州物流公司实到数量10",
"oldValue": "",
"newValue": "",
"createUser": 2,
"createTime": "2017-02-08T15:08:33",
"departmentId": 31
}
],
"virtualAccountChanges": []
}
}
}
获取派送员 GET /api/common/deliverer?orgId={:orgId}
说明
参数
- orgId 部门ID
返回
{
"code": 200,
"message": null,
"model": [
{
"id": 9,
"account": "kaifengps",
"password": "md5_e10adc3949ba59abbe56e057f20f883e",
"name": "开封派送",
"orgId": 34,
"roleId": 2,
"enabled": true,
"createTime": "2017-02-06T13:56:35",
"createUser": 1,
"lastLoginTime": "1970-01-01T00:00:00",
"phone": " "
}
]
}
作废 POST /api/common/invalid
说明
参数
{
"userId": 4, // 用户ID [必选]
"id": 437 // 运单ID [必选]
}
返回
成功
{
"code": 200,
"message": "",
"model": 1
}
失败
{
"code": 300,
"message": "",
"model": 1
}
单号是否可用 GET /api/billnew/hdbh-available?hdbh={:hdbh}
说明
检测单号是否可用
参数
1. hdbh 货单编号
返回
成功
{
"code": 200,
"message": "",
"model": "1234"
}
失败
{
"code": 300,
"message": "重复",
"model": "1234"
}
开票 POST /api/billnew/create
说明
参数
{
"Hdbh": "", // 单号
"UserId": 4, // 用户ID
"DepartId": 34, // 起站ID
"EndDepartId": 33, // 到站ID
"TransferAddress": "", // 中转地可以为空
"MemberNo": "", // 会员卡号
"MemberId": 0, // 可以不传
"ShipperPhone": "18703859315", // 发货人手机号
"Shipper": "hello", // 发货人
"ConsigneePhone": "18703859316", // 收货人手机号
"Consignee": "xx", // 收货人
"ConsigneeAddress": "", // 收货人详情地址,可为空
"GoodsList": [
{
"GoodsName": "", // 货物名称
"Pack": "", // 包装
"Numbers": 1, // 件数
"Cubage": 10, // 体积
"Weight": 20, // 重量
"PremiumAmount": 0 // 保额
}
],
"TransportCost": 0, // 运费
"BalanceMethod": 1, // 结算方式
"GoodsCost": 0, // 货款
"TransferCost": 0, // 中转费
"DeliveryCost": 0, // 送货费
"TakeMethod": "自提", //服务方式
"DeliveryProofCount": 0, // 回单数量,没有传0
"Notes": "" //备注,可为空
}
返回
成功
{
"code": 200,
"message": "",
"model": "317156000654" // 运单号
}
失败
{
"code": 300,
"message": "起站或到站不存在",
"model": null
}
运单查询 GET /api/billsearch/query
说明
参数
1. startDate 开始日期 格式:2017-10-02 [必选]
2. endDate 结束日期 [必选]
3. userId 用户ID [必选]
4. hdbh 运单号 [可选]
返回
{
"code": 200,
"message": "",
"model": {
"items": [
{
"id": 345,
"billDate": "2017-03-23T00:00:00",
"hdbh": "117082000382",
"shipper": "hello",
"shipperPhone": "18703859315",
"consignee": "xx",
"consigneePhone": "18703859316",
"goodsName": "vv",
"numbers": "1",
"transportCost": 0,
"transferCost": 0,
"deliveryCost": 0,
"goodsCost": 0,
"balanceMethod": "到付",
"displayStatus": "开封网点已收件",
"canReportLoss": false,
"canInvalid": false,
"canEdit": true,
"createUser": 4,
"billStatus": 0,
"signedTime": "1970-01-01T00:00:00",
"additionStatus": 0,
"startOrgId": 34,
"startOrgName": "开封网点",
"endOrgId": 33,
"endOrgName": "焦作网点",
"transferAddress": "", // 中转地址
"consigneeAddress": "", //收货人地址
"memberCode": "10014", // 会员卡号
"memberId": 32,
"pack": "", // 包装
"weight": 0,//重量
"cubage": 0, // 体积
"takeMethod": "自提"
}
],
"total": 273,
"pageSize": 20,
"page": 1,
"summary": {
"billCount": 273,
"transportCost": 16087,
"quantity": 3222,
"goodsCost": 6283238,
"transportCostByShipper": 6169,
"transportCostByConsignee": 7281,
"transportCostByMonthly": 0,
"transportCostByDeliveryProof": 0,
"transportCostByUnpaid": 0,
"deliveryCost": 0
}
}
}
下载派送票据 GET /api/billsign/query
说明
参数
1. TakeMethod 提货方式(送货，自提)
2. Hdbh 货单编号
3. OrgId 部门ID [必填]
返回
{
"code": 200,
"message": "",
"model": {
"items": [
{
"id": 229,
"hdbh": "017048000225",
"billDate": "2017-02-17T00:00:00",
"goodsName": "hello",
"shipper": "hello",
"shipperPhone": "18703859315",
"consignee": "welcome",
"consigneePhone": "18703859317",
"pack": "桶",
"numbers": 10,
"balanceMethod": "现付",
"transportCost": 1,
"goodsCost": 0,
"displayStatus": "开封派送(开封网点)派送中",
"startDepartName": "焦作网点",
"sendDate": "0001-01-01T00:00:00",
"takeMethod": "送货",
"status": 5,
"transferAddress": null,
"isTransfer": false,
"deliveryCost": 1,
"billType": 1,
"parentId": 0,
"additionStatus": 0,
"isReportLoss": false,
"reportLossPersonName": "",
"reportLossPersonIDCardNumber": "",
"cancelReportLossPersonName": "",
"cancelReportLossPersonIDCardNumber": "",
"startOrgId": 33,
"startOrgName": "焦作网点",
"endOrgId": 34,
"endOrgName": "开封网点"
}
],
"total": 12,
"pageSize": 100,
"page": 1,
"summary": {
"billCount": 12,
"transportCost": 12,
"quantity": 120,
"goodsCost": 3,
"transportCostByShipper": 6,
"transportCostByConsignee": 6,
"transportCostByMonthly": 0,
"transportCostByDeliveryProof": 0,
"transportCostByUnpaid": 0,
"deliveryCost": 12
}
}
}
派送 POST /api/billsign/deliverymanyok
说明
参数
参数例子
- 要修改送货费(现付的不能修改送货费)
{
"deliveryUserId": 9,// 派送员ID [必填]
"note": "asdfs",// 备注 [选填]
"billList": [
{
"id": 229, // 运单ID
"deliveryCost": 1 // 派送费
}
],
"userId": 4,// 用户ID [必填]
"userHostAddress": "mac地址"
}
- 不修改送货费
{
"deliveryUserId": 9,
"note": "asdfs",
"billIdList": [
229
],
"userId": 4,
"userHostAddress": "mac地址"
}
返回
成功
{
"code": 200,
"message":null,
"model": {
"billIdList": null,
"billList": [
{
"id": 229,
"deliveryCost": 1
}
],
"personName": null,
"deliveryUserId": 9,
"note": "asdfs",
"userHostAddress": "",
"userId": 4
}
}
失败
{
"code": 300,
"message": "派送失败",
"model": {
"billIdList": null,
"billList": [
{
"id": 229,
"deliveryCost": 1
}
],
"personName": null,
"deliveryUserId": 9,
"note": "asdfs",
"userHostAddress": "",
"userId": 4
}
}
派送失败 POST /api/billsign/deliveryfail
说明
参数
{
"id": 33, // 运单ID
"note": "aaa", // 备注
"userId": 32, // 用户ID
"userHostAddress": "mac"
}
返回
{
"code": 200,
"message": null,
"model": 5
}
签收 POST /api/billsign/okone
说明
参数
{
"id": 33, // 运单ID
"SignIDCardNumber": "aaa",// 签收人身份证号
"SignName": "aa",// 签收人
"userId": 32,// 用户ID
"userHostAddress": "mac"
}
返回
{
"code": 200,
"message": null,
"model": {
"Id":1,
"SignName":"tom",
"SignIDCardNumber":"410",
"UserId":7,
"UserHostAddress":"127.0.0.1",
"SignTime":"2017-03-21T17:21:33"
}
}
下载发车票据 GET /api/billsend/query
说明
参数
1. nextId 下一站部门ID[必填]
2. userId 用户ID[必填]
3. hdbh 单号[可选]
返回
{
"code": 200,
"message": "",
"model": {
"items": [
{
"id": 352,
"hdbh": "117088000425",
"endDepartName": "焦作网点",
"endDepartId": 33,
"numbers": 283,
"transportCost": 447,
"weight": 87,
"cubage": 4,
"goodsName": "TFS",
"pack": "袋",
"startDepartName": "开封网点",
"startDepartId": 34,
"billDate": "2017-03-29T00:00:00",
"shouldQuantity": 0,
"priority":0 //优先级 0:normal 1:middle 2:high
}
],
"total": 42,
"pageSize": 100,
"page": 1,
"summary": {
"billCount": 42,
"numbers": 777,
"transportCostTotal": 2040,
"weightTotal": 1197,
"cubageTotal": 180
}
}
}
发车 POST /api/billsend/create
说明
参数
{
"bills": [
11, // 运单ID
22
],
"car": {
"Plate": "aaa", // 车牌
"driverName": "aa", // 司机姓名
"driverPhone": "bb" // 司机电话
},
"userId": 4, // 用户ID
"orgId": 34, // 部门ID
"nextId": 31, // 下一站ID
"note": "备注",
"userHostAddress": "MAC地址",
"carCostByShipper": 10, // 现付车费
"carCostByConsignee": 20, // 到付车费
"stevedoreCost": 0, // 装卸费
"scanHistories": [ // 扫描记录
{
"billId": 11, // 运单ID
"scanCount": 10, // 扫描件数
"childrenHdbh": [ // 子单号
"11-1",
"11-2"
]
}
]
}
返回
{
"code": 200,
"message": "发车成功",
"model": 147 // 批次ID
}
下一站 GET /api/common/next-org?orgId={:orgId}
说明
参数
1. orgId 当前部门ID
返回
{
"code": 200,
"message": null,
"model": [
{
"id": 32,
"cascadeId": "0.1.32.",
"name": "太原物流公司",
"code": "",
"shorterName": "太原分拨",
"shorterNameAllSpelling": "taiyuanfenbo",
"shorterNameSpelling": "tyfb",
"parentId": 1,
"parentName": "博特利华总公司",
"businessParentId": 1,
"type": 2,
"region": 6,
"linkMan": "太原",
"linkTelephone": "18703859321",
"sortNo": 1,
"allowSend": false,
"allowTake": false,
"enabled": true,
"createTime": "2017-02-16T13:48:41",
"createUser": 0,
"reservedAmount": 0,
"alertAmount": 0,
"sendMessageStatus": 0,
"canWithDrawAt": "1-31"
}
]
}
查询到货 GET /api/billconfirm/query-bill?userId={:userId}&hdbh={:hdbh}
说明
参数
1. userId 用户ID [必填]
2. hdbh 运单号 [选填]
返回
{
"code": 200,
"message": "",
"model": {
"items": [
{
"id": 760,
"hdbh": "017215000864",
"billDate": "2017-08-03T00:00:00",
"goodsName": "配件",
"shipper": "李白",
"shipperPhone": "18703859315",
"consignee": "收货人",
"consigneePhone": "18703859316",
"pack": "无",
"numbers": 10,
"balanceMethod": "到付",
"transportCost": 0,
"goodsCost": 0,
"deliveryCost": 0,
"weight": 0,
"cubage": 0,
"displayStatus": "从焦作网点发车到郑州物流公司",
"startDepartName": "焦作网点",
"startOrgId": 33,
"endOrgId": 34,
"endOrgName": "开封网点",
"endOrgCategoryName": "A", //线路名称
"sendDate": "2017-08-11T17:25:20", //发车时间
"batchBillId": 889 // 批次ID
}
],
"total": 1,
"pageSize": 200,
"page": 1,
"summary": {
"billCount": 1,
"numbers": 283,
"transportCostTotal": 447,
"goodsCostTotal": 5050,
"weightTotal": 87,
"cubageTotal": 4
}
}
}
到货 POST /api/billconfirm/confirm-bill
说明
参数
{
"userId": 2, // 用户ID
"userHostAddress": "MAC",
"billConfirmItemList": [
{
"id": 451, // 运单ID
"batchBillId": 385 // 订单批次详情ID
}
],
"scanHistories": [ // 扫描记录
{
"billId": 11, // 运单ID
"scanCount": 10, // 扫描件数
"childrenHdbh": [ // 子单号
"11-1",
"11-2"
]
}
]
}
返回
{
"code": 200,
"message": "到货确认成功",
"model": null
}
跟踪信息 GET /api/common/bill-track?hdbh={:hdbh}
说明
参数
1. hdbh 运单号 [必填]
返回
{
"code": 200,
"message": null,
"model": [
{
"id": 1,
"billId": 1,
"operateUser": 4,
"department": 34,
"operateType": "开票",
"description": "开封网点已收件",
"isTrack": true,
"createTime": "2017-02-06T14:37:37",
"clientType": 0,
"userHostAddress": "::1"
}
]
}
发车批次列表 GET /api/send-batch/search
说明
参数
1. startDate 开始日期 格式:2017-05-10 [必填]
2. endDate 结束日期 [必填]
3. userId 用户ID [必填]
4. sendBatchStatus 状态 (0:未交接,1:已交接,传空则是所有) [选填]
5. hdbh 运单号 [选填]
返回
{
"code": 200,
"message": null,
"model": [
{
"id": 143,
"batchNumber": "ZZFB0170503165149", // 批次号
"sendDate": "2017-05-03T00:00:00", // 发车日期
"sendTime": "2017-05-03T16:51:57", // 发车时间
"departName": "郑州物流公司", //发车部门
"nextDepartName": "焦作网点", //下一站部门
"nextId": 33, //下一站部门ID
"billCount": 1, //票数
"quantity": 0, //数量
"transportCost": 0.1, //运费
"goodsCost": 0, //货款
"weight": 0, //重量
"cubage": 0, //体积
"plate": "豫AR3900", //车牌
"driverName": "小明", //司机
"driverPhone": "18337198875", //司机电话
"batchStatus": 0, //交接状态
"carId": 0, //车辆ID
"stevedoreCost": 0, //装卸费
"carCost": 0, //大车费
"carCostByShipper": 0, //现付大车费
"carCostByConsignee": 0, //到付大车费
"note": null, //备注
"items": null,
"canEdit": false // 是否能编辑
}
]
}
获取批次详情 GET /api/send-batch/detail?id={:id}&userId={:userId}
说明
参数
1. id 批次ID [必填]
2. userId 用户ID [必填]
返回
{
"code": 200,
"message": null,
"model": {
"id": 162,
"batchNumber": "ZZFB0170517145809", // 批次号
"sendDate": "2017-05-17T00:00:00", //发车日期
"sendTime": "2017-05-17T14:58:10",
"departName": "郑州物流公司",
"nextDepartName": "开封网点",
"nextId": 34,
"billCount": 1,
"quantity": 2,
"transportCost": 1,
"goodsCost": 5,
"weight": 2,
"cubage": 2,
"plate": "gg",
"driverName": "gg",
"driverPhone": "55",
"batchStatus": 1,
"carId": 0,
"stevedoreCost": 0,
"carCost": 0,
"carCostByShipper": 0,
"carCostByConsignee": 0,
"note": "备注",
"items": [
{
"id": 410, // 批次运单ID
"hdbh": "117137000549", // 运单号
"endDepartName": "开封网点", //到站
"endDepartId": 34, // 到站ID
"numbers": 2, // 数量
"transportCost": 1, //运费
"goodsName": "看来", // 货名
"pack": "箱", // 包装
"startDepartName": "焦作网点", //起站
"startDepartId": 33, // 起站ID
"billDate": "2017-05-17T00:00:00", // 开票日期
"goodsCost": 5, // 货款
"shipper": "几天", // 发货人
"shipperPhone": "13938155582", //发货人电话
"consignee": "赵志芹", // 收货人
"consigneePhone": "68737880", //收货人电话
"balanceMethod": "现付", // 结算方式
"weight": 2, // 重量
"cubage": 2, //体积
"batchStatus": 1 // 交接状态
}
],
"canEdit": false
}
}
修改批次 POST /api/send-batch/edit
说明
参数
{
"sendDate": "2017-05-26", // 发车日期
"id": 187, // 批次ID
"note": "vv", // 备注
"deleting": [ // 删除的票
1, // 批次运单ID
2
],
"adding": [ // 新增的票
3, // 运单ID
4
],
"car": { //车辆
"id": 1, // 车辆ID
"plate": "a", // 车牌号
"driverName": "bb", // 司机姓名
"driverPhone": "abc" //司机电话
},
"stevedoreCost": 10, // 装卸费
"carCostByShipper": 10, // 现付大车费
"carCostByConsignee": 300, // 到付大车费
"userId":4 // 用户ID
}
返回
{
"code": 200,
"message": null,
"model": true
}
票据修改 POST /api/common/bill-edit
说明
参数
{
"id": 474, // 运单ID
"hdbh": "12", //货单编号
"endDepartmentId": 33, // 到站部门ID
"consignee": "a", // 收货人
"consigneePhone": "abc", // 收货人电话
"shipper": "a", // 发货人
"shipperPhone":"abc", //发货人电话
"memberNo":"",会员卡号
"transportCost": 10.1, // 运费
"goodsCost": 2.1, // 货款
"balanceMethod": 1, //结算方式
"deliveryCost": 0, // 送货费
"takeMethod": "自提", // 服务方式
"applyReason": "ab", // 修改原因
"goodsList":[
{
"goodsName": "a",
"pack": "b",
"id": 10,
"numbers": 20,
"cubage": 2.2,
"weight": 3.2,
"premiumAmount": 0
}
],
"userId":4 //用户ID
}
返回
{
"code": 200, // 操作是否成功
"message": null,
"model": true // true表示直接修改成功,false表示需要审批
}
检测版本 GET /api/check/version
说明
参数
返回
{
"code": 200,
"message": null,
"model": {
"version": "1.0",
"apkUrl": "/Version/jingke1.0.apk",
"baseUrl": "http://121.41.18.160:8083"
}
}
会员开票 POST /api/crm/bill/create
说明
参数
{
"Hdbh": "", // 单号
"UserId": 4, // 会员ID
"DepartId": 34, // 起站ID
"EndDepartId": 33, // 到站ID
"TransferAddress": "", // 中转地可以为空
"MemberNo": "", // 会员卡号
"MemberId": 0, // 可以不传
"ShipperPhone": "18703859315", // 发货人手机号
"Shipper": "hello", // 发货人
"ConsigneePhone": "18703859316", // 收货人手机号
"Consignee": "xx", // 收货人
"ConsigneeAddress": "", // 收货人详情地址,可为空
"GoodsList": [
{
"GoodsName": "", // 货物名称
"Pack": "", // 包装
"Numbers": 1, // 件数
"Cubage": 10, // 体积
"Weight": 20, // 重量
"PremiumAmount": 0 // 保额
}
],
"TransportCost": 0, // 运费
"BalanceMethod": 1, // 结算方式
"GoodsCost": 0, // 货款
"TransferCost": 0, // 中转费
"DeliveryCost": 0, // 送货费
"TakeMethod": "自提", //服务方式
"DeliveryProofCount": 0, // 回单数量,没有传0
"Notes": "" //备注,可为空
}
返回
成功
{
"code": 200,
"message": "",
"model": "317156000654" // 运单号
}
失败
{
"code": 300,
"message": "起站或到站不存在",
"model": null
}
会员登录 POST /api/crm/account/logon
说明
参数
{
"userName": "10014", // 会员卡号
"password": "123456" // 密码
}
返回
{
"code": 200,
"message": null,
"model": {
"id": 32,
"no": "10014",
"name": "赵志芹",
"telephone": "68737880",
"identityCard": "",
"birthday": "1980-01-01T00:00:00",
"address": "",
"isBankTransfer": true,
"bankType": "PCBC",
"bankCard": "2433139980104061278",
"enabled": true,
"createTime": "2016-12-06T10:15:51",
"createUser": 1,
"createOrg": 1,
"editTime": "2017-05-15T15:40:16",
"categoryId": 6,
"tradeId": 110,
"tradeName": "机械类",
"password": "md5_e10adc3949ba59abbe56e057f20f883e"
}
}
修改密码 POST /api/crm/account/change-password
说明
参数
{
"userName": "10014", // 用户名
"oldPassword": "123453", // 旧密码
"newPassword": "33" // 新密码
}
返回
成功
{
"code": 200,
"message": null,
"model": true
}
失败
{
"code": 300,
"message": "登陆密码错误",
"model": false
}
POST /common/geo-location
说明
上传位置
参数
{
"userId":10,
"carId":20,
"longitude":11.23,
"latitude":20.3,
"speed":20.3,
"radius":30,
"address":"hello"
}
返回
成功
{
"code": 200,
"message": null,
"model": true
}
Token登录 POST /oauth/token
说明
参数
1. client_id 用户名
2. client_secret 密码
3. grant_type 类型(目前都填写:client_credentials)
4. client_type (member:会员登录,user:用户登录)
返回
成功
{
"access_token": "Ynese8kQAgHA2NvFNM",
"token_type": "bearer",
"expires_in": 2591999
}
失败
{ "error": "invalid_grant", "error_description": "The user name or password is incorrect." }
获取信息 GET /account/info
说明
参数
无
头部
Authorization: token_type+" "+access_token
返回
成功
{
"code": 200,
"model": {
"id": 5,
"name": "太原",
"account": "taiyuan",
"roleId": 1,
"orgId": 32,
"orgName": "太原物流公司",
"bizOrgId": 32,
"bizOrgName": "太原物流公司"
},
"message": null
}
失败
{
"message": "已拒绝为此请求授权。"
}