← 返回客户中心
盛高国际物流 · 开放接口文档
本文档列出盛高国际（达因系统）对外开放的全部接口，供客户系统对接使用。
所有接口均需先调用登录接口获取令牌，之后在请求头中携带 Authorization: Bearer <token>。
POST https://business.logistic.mobi/api/{接口路径} branchId = 319（深圳盛高国际物流有限公司）
1. 登录认证
获取访问令牌，后续所有接口调用均需携带。
| 接口 | 方法 | 说明 |
|---|
/Client/PostLoginAsync?branchId=319 | POST | 账号密码登录，返回 token |
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|
| userCode | string | 是 | 客户账号 |
| userPwd | string | 是 | 客户密码 |
| branchId | int | 是 | 分公司 ID，固定 319 |
| loginType | int | 是 | 登录类型：1=密码登录，3=客户端登录 |
返回
| 字段 | 类型 | 说明 |
|---|
| code | int | 200 成功，-200 失败 |
| data.token | string | 访问令牌，后续请求头使用 |
请求示例：
curl -X POST "https://business.logistic.mobi/api/Client/PostLoginAsync?branchId=319" -H "Content-Type: application/json" -d '{"userCode":"账号","userPwd":"密码","branchId":319,"loginType":3}'
2. 客户信息
| 接口 | 方法 | 说明 |
|---|
/Client/GetLoginInfoAsync | POST | 获取当前登录客户信息、余额与菜单权限 |
/Client/GetClientAccountInfoAsync | POST | 获取账户余额、未核销金额、预计结余 |
/Client/GetSysInfoByDomainPrefixAsync | POST | 获取分公司信息（公司名称、Logo 等） |
/Client/ChangePassAsync | POST | 修改密码 |
修改密码请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|
| OldPass | string | 是 | 原密码 |
| NewPass | string | 是 | 新密码 |
| ConfirmNewPass | string | 是 | 确认新密码，须与 NewPass 一致 |
新密码须包含数字、字母、符号中的至少两种，长度至少 6 位，且连续或重复字符不超过 3 个。
3. 订单管理
| 接口 | 方法 | 说明 |
|---|
/PreWayBill/GetListAsync | POST | 查询订单列表（支持多种筛选） |
/PreWayBill/GetSimpleRecStateSumAsync | POST | 按状态统计订单数量 |
/PreWayBill/GetPreWayBillByBillCodeAsync | POST | 按单号查询订单详情 |
/PreWayBill/InsertAsync | POST | 创建订单 |
/PreWayBill/GetPreWaybillLogListAsync | POST | 查询订单操作日志 |
/PreWayBill/BatchImportAsync | POST | 批量导入订单 |
/PreWayBill/ExportExcelAsync | POST | 导出订单 |
/PreWayBill/submitSeizureAsync | POST | 提交扣件 |
/PreWayBill/SubmitReturnAsync | POST | 提交退件 |
订单列表请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|
| skipCount | int | 否 | 跳过的记录数，用于分页 |
| maxResultCount | int | 否 | 每页条数 |
| codes | string | 否 | 单号，多个用逗号分隔（订单号/运单号/转单号） |
| countryId | int | 否 | 目的地国家 ID，传父级 ID 即包含该国全部子区域 |
| carrierRouteId | int | 否 | 承运路线 ID |
| labelPrintStatus | int | 否 | 标签打印状态：0=全部，1=未打印，2=已打印 |
| holdType | int[] | 否 | 扣退件类型：1=客户提交扣件，2=财务扣件，3=问题扣件，4=客户提交退件 |
| beginTime / endTime | string | 否 | 创建时间范围，如 2026-01-01 或 2026-01-01 00:00:00 |
| preWayBillStateType | int | 否 | 订单状态：0=全部，1=已预录，2=已入仓/运输中/已签收，3=已退件，4=已作废 |
| wayBillStatus | int[] | 否 | 运单状态：1=已下单，2=已入仓，3=已出库，4=在途，5=派送中，6=已妥投 |
| consigneeName / senderSign | string | 否 | 收件人姓名 / 寄件人签名 |
状态筛选组合：已预录 = preWayBillStateType 1；已入仓 = 2 + [1,2]；运输中 = 2 + [3,4,5]；已签收 = 2 + [6]；已退件 = 3；已作废 = 4。
注意：无匹配数据时接口返回的 total 为 null 而非 0，请做好兼容。
返回字段（data 数组元素）
| 字段 | 说明 | 字段 | 说明 |
|---|
| preBillCode | 订单号 | waybillCode | 运单号 |
| tranBillCode | 转单号 | recState | 订单状态 |
| wayBillStatus | 运单状态 | goodsType | 货物类型 |
| goodsNum | 件数 | preWeight | 预录重量 |
| rChargeWeight | 到货重量 | carrierRouteName | 承运路线 |
| countryId | 目的地国家 ID | latestTrack | 最新轨迹 |
| latestTrackTime | 最新轨迹时间 | signTime | 签收时间 |
| transportTime | 上网时间 | buildDate | 到货时间 |
| createMethod | 创建方式 | currency | 申报币种 |
| isPrint / printResultTranId | 是否已打印标签 | isRemoteArea | 是否偏远地区 |
4. 轨迹查询
| 接口 | 方法 | 鉴权 | 说明 |
|---|
/PublicApp/GetTrackAsync | POST | 需 token | 查询单号轨迹，body 为单号字符串 |
/WayBillTrackInfo/GetTracksNoAuthAsync?branchId=319 | POST | 免登录 | 查询单号轨迹，body 为单号数组 |
/WayBill/GetTracksDynamicsAsync | POST | 需 token | 订单动态，timeRangeType：1=今天 2=近7天 3=近一个月 |
5. 账单与账户
| 接口 | 方法 | 说明 |
|---|
/ClientExpendBill/GetWebClientBillExpendListAsync | POST | 账单明细列表 |
/ClientAccount/GetClientAccountListAsync | POST | 账户流水 |
/CompanyBrankAccount/GetWebBrankAccountList | POST | 收款银行账号（userType=3） |
/ClientRecharge/GetClientRechargeListAsync | POST | 充值记录 |
账单接口仅支持按创建时间范围过滤（beginTime / endTime），单号与寄件人等条件需在返回结果中自行筛选。
6. 运费试算
| 接口 | 方法 | 说明 |
|---|
https://calcquery.logistic.mobi/api/Calculate/GetClientPricesResultOfServer | POST | 提交运费试算请求 |
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|
| requestKey | string | 是 | 本次请求唯一标识（建议用 UUID），每次请求须不同 |
| body.countryId | int | 是 | 目的地国家 ID |
| body.goodsType | int | 是 | 货物类型：1=包裹 2=袋子 3=文件 |
| body.likeWeight | decimal | 是 | 预估重量（KG） |
| body.typeAndServices | array | 否 | 附加服务 |
| body.boxWeightSizes | array | 否 | 箱规重量尺寸 |
异步回调：接口立即返回 code=200，实际报价通过服务端推送返回，客户端需按 requestKey 关联结果。
7. 基础字典
| 接口 | 方法 | 说明 |
|---|
/Country/GetSelectAsync | POST | 国家/地区列表（含父级与子区域，pid 为父级 ID） |
/CarrierRoute/GetCurrentClientUsableSelectAsync | POST | 当前客户可用承运路线 |
/CarrierRoute/GetOrderFormConfigAsync | POST | 创建订单表单字段配置 |
/Server/GetGoodsType | POST | 货物类型 |
/Server/GetCurrencyType | POST | 申报币种 |
/Server/GetUnitCodeType | POST | 计量单位 |
/Server/GetCarrierList | POST | 承运商列表 |
/ExtraService/GetExtraServiceSelectAsync | POST | 附加服务列表 |
/Tool/SearchRemotebook | POST | 查询地址是否偏远（isRemoteArea：0=非偏远 1=偏远 2=未知） |
/Tool/SearchAddressbookDHL | POST | 地址联想 |
8. 公告与消息
| 接口 | 方法 | 说明 |
|---|
/Notify/GetClientWebListAsync | POST | 公告列表 |
/Notify/GetClientWebUnreadListAsync | POST | 未读公告 |
https://message.logistic.mobi/api/DyMessage/GetTotalMessageCount | POST | 站内消息总数 |
通用说明
响应结构：code 为 200 表示成功，-200 表示失败；message 为提示信息。
认证方式：请求头携带 Authorization: Bearer <token>；令牌失效返回 401/403，请重新登录。
跨域：所有接口均已开放 Access-Control-Allow-Origin: *，浏览器可直连。
字符编码：请求与响应统一使用 UTF-8。