[toc]

则一订单对接API

则一提供了不同规范的API，调用则一订单服务端API前，需了解开发前须知及调用流程。本文提供了调用则一订单服务端API示例，供开发者参考。

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">白名单

则一服务端API接口访问有IP白名单限制，需要接口调用方提供调用API的服务器IP地址。

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">数据加签

采用md5(32位小写)算法生成签名 appKey(则一提供) + appSecret(则一提供) + timestamp(当前时间戳毫秒) + nonce(6位随机码大小写字母数子组合) + data(请求数据)

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">请求流程

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">接口信息

1.1 下单

则一调用该接口下单给承运商

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">调用方式

则一 ----> 百腾

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">请求方式：

• POST
• Content-Type: application/json

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">请求地址：

百腾提供

示例:

• 生产：https://example.com/order/add
• 测试：https://test.example.com/order/add

Headers参数

Body参数(application/json)

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">返回值

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">请求示例

{
  "expressCode": "hxtest20231226001",
  "actualTotalCapacity": 10,
  "actualTotalQuantity": 1,
  "actualTotalWeight": 1,
  "cargoDesc": "西蒙面板 蓝色",
  "customerNumber": "hxtest20231226001",
  "deliverType": 10,
  "expressDeliveryType":"EN0215",
  "entityWarehouseCode": "N01",
  "entityWarehouseName": "北京",
  "orderDate": "2023-04-01 00:00:00",
  "productList": [
    {
      "customerProductCode": "7813800017",
      "customerProductDescription": "西蒙面板 蓝色",
      "quantity": 10,
      "sourceLineId": "b629f33b-b205-458e-a388-12712b488445"
    }
  ],
  "productType": 160,
  "remark": null,
  "returnMailno": null,
  "returnRoute": 1,
  "returnOrder": 1,
  "returnTrackingRemark": "签名",
  "returnTrackingRemarkEnum": "",
  "subMailno": null,
  "verificationCode": "SHOW_ED",
  "senderInfo": {
    "countryName": "中国",
    "cityName": "北京市",
    "company": null,
    "countyName": "顺义区",
    "detailAddress": "空港物流园八街七号（中心仓）",
    "mobile": "13910568648",
    "name": "刘浩",
    "provinceName": "北京",
    "tel": "13910568648"
  },
  "extendPropertites": {
    "addedService": [
      {
        "name": "20",
        "value": "20",
        "value1": "20",
        "value2": "20"
      }
    ],
    "identification": null,
    "identificationType": null,
    "regionAnalysis": null,
    "singBackInfo": {
      "remRfCode": null,
      "remRfMsg": null
    },
    "valinsPay": null
  },
  "receiverInfo": {
    "countryName": "中国",
    "cityName": "北京市",
    "company": null,
    "countyName": "东城区",
    "detailAddress": "北京北京市东城区123",
    "mobile": "07115112227",
    "name": "杨",
    "provinceName": "北京",
    "tel": "07115112227"
  }
}

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">返回示例

{
  "flag": true,
  "code": 200,
  "value": {
    "mailno": "ZY1160307865367",
    "returnMailno": "ZY1200030442093",
    "orderDetails": [
      {
        "forwardMailNo": "ZY1160307865367",
        "isReturnFlag": "0"
      }
    ]
  },
  "message": "成功"
}

1.2 取消订单

则一调用该接口取消已下发给承运商的订单

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">调用方式

则一 ----> 百腾

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">请求方式：

• POST
• Content-Type: application/json

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">请求地址：

百腾提供

示例:

• 生产：https://example.com/order/cancel
• 测试：https://test.example.com/order/cancel

Headers参数

Body参数(application/json)

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">返回值

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">请求示例

{
  "mailno": "Z20251226001",
  "customerNumber": "test20251226001",
  "reason": "任务取消,不发运了",
  "optionDate": "2025-12-01 00:00:00",
  "vin": "ZOBS89000921C",
  "jdCode": "string",
  "divisionCodeJd": "string",
  "shopCode": "string"
}

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">返回示例

{
  "flag": true,
  "code": 200,
  "message": "成功"
}

1.3 路由回传

承运商调用该接口传输运输路由节点信息, 其中必传的节点: 80-启运，81-在途，001: 签收 / 002: 签收异常

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">调用方式

百腾 ----> 则一

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">请求方式：

• POST
• Content-Type: application/json

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">请求地址：

• 生产：https://gw.shjiuze.cn/oms-service-api/baiTengOrder/routePush
• 测试：https://test.shjiuze.cn/oms-service-api/baiTengOrder/routePush

Headers参数

Body参数(application/json)

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">返回值

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">请求示例

 {
  "mailno": "Z20251226001",
  "scanTypeCode": "80",
  "operator": "张三",
  "time": "2025-12-01 00:00:00",
  "plannedDeliveryDate": "2025-12-02 00:00:00",
  "transferAddress": "上海市青浦区纪鹤公路1988号",
  "memo": "快件在【XXX营业点】已装车,准备发往 【XXX集散中心】",
  "vinCode": "ZOBS89000921C",
  "longitude": "113.465168",
  "dimension": "31.664137"
}

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">返回示例

{
  "code": 200,
  "message": "响应成功",
  "flag": true
}

1.4 签收图片回传

承运商调用该接口回传签收图片

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">调用方式

百腾 ----> 则一

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">请求方式：

• POST
• Content-Type: application/json

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">请求地址：

• 生产：https://gw.shjiuze.cn/oms-service-api/baiTengOrder/sign
• 测试：https://test.shjiuze.cn/oms-service-api/baiTengOrder/sign

Headers参数

Body参数(application/json)

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">返回值

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">请求示例

 {
  "mailno": "Z20251226001",
  "imageType": "imageUrl",
  "imageInfos": [
    {
      "imageName": "回单照片",
      "extendName": "jpg",
      "imageContent": "https://shjiuze.cn/xxx/xxx.jpg"
    }
  ]
}

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">返回示例

{
  "code": 200,
  "message": "响应成功",
  "flag": true
}

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">附录一

25fd5c476e407376d6bf46220a7475f9c07249ea/order/ld/baiteng/order.md#">路由节点类型

001: 签收

100: 到达

80：汽运-启运

81：汽运-在途

82：汽运-派送

83：空运-航班信息

84：空运-起飞时间

85：空运-降落时间

86：空运-提货时间

87：空运-派送时间

101：入站

102：分配派送员

103：妥投

104：滞留

105：拒收

89: 到达目的城市

90: 空运-入目的库

91: 空运-出目的库

92：汽运-中转库入库

93：汽运-中转库出库

94：汽运-入目的库

95：汽运-出目的库

96：汽运-装车

97：汽运-发运

98：汽运-中转装车

99：汽运-中转发运

002: 签收异常

Java-sdk下载

zy-java-sdk

2025-12-01更新日志

新增