百腾物流文档
    百腾物流文档
    • 订单创建接口
      POST
    • 订单取消接口
      POST
    • 订单修改接口
      POST
    • 获取物流轨迹
      POST
    • 查询签单附件
      POST

      订单创建接口

      POST

      请求参数

      Header 参数
      action
      string 
      固定值:order
      可选
      示例值:
      order
      code
      string 
      必需
      客户编码;由百腾提供;
      sign
      string 
      必需
      sign=MD5(body+key);key为固定值:由百腾提供, 32位MD5;
      Body 参数application/json
      WaybillID
      integer 
      必需
      单号, 未获取预约单号时填0
      CustomerOrderNo
      string 
      客户单号
      可选
      SName
      string 
      发货人姓名
      必需
      SPhone
      string 
      必需
      发货人手机号码(发货手机或座机必须填写一个)
      STel
      string 
      发货人座机号码
      必需
      SendAddress
      string 
      发货地址
      必需
      TName
      string 
      收货人姓名
      必需
      ReceiveCompany
      string 
      收货单位
      可选
      TPhone
      string 
      必需
      收货人手机号码-(收货手机或座机必须填写一个)
      TTel
      string 
      收货人座机号码
      必需
      ReceiveAddress
      string 
      收货地址
      必需
      GoodName
      string 
      商品名称
      可选
      Num
      integer 
      货物件数
      必需
      Volume
      number 
      必需
      货物总体积(单位:m³)
      Weight
      number 
      必需
      货物总重量(单位:kg)
      SettlementMode
      integer 
      必需
      付款方式(1月结2现付3到付)
      PackageTypeID
      integer 
      必需
      包装类型(1无2纸箱3纤袋4木箱5其它)
      GoodsValue
      number 
      必需
      (最多保留两位小数)-声明价值
      SignTypeID
      integer 
      必需
      签单类型(0无,1签单,3电子签单,2原单,4电子原单,6签单加原单,9原单加电子签单,10电子签单加电子原单,16原单加电商验收单,17电商验收单,18电子电商验收单,19电子电商验收单加电子原单)
      IsNotification
      boolean 
      是否等通知放货
      必需
      ElectronicBusinessType
      integer 
      必需
      电商类型(0:非电商 1:京东商城 2:菜鸟 3:唯品会 4:一号店 5:苏宁 6:国美 7:亚马逊 8:名创优品 9:大润发 10:淘宝 11:聚美优品仓 12:小米仓 13:零售通 14:阿里巴巴 15:小驴科技 16:顺电 17:米家电商 18:泡泡玛特 19:bilibili 20:抖音 21:美团)
      TransportType
      integer 
      必需
      运输方式: 1慢件, 2快件: 3航空
      ReceiveDeliveryTypeID
      integer 
      必需
      交货方式(1送货上门2送货上楼3到站自提)
      Model
      string 
      可选
      型号 可空
      Remark
      string 
      可选
      订单备注(最大长度200)
      示例
      {
              "WaybillID": 0,
              "CustomerOrderNo": "2021053100001",
              "SName": "发货人",
              "SPhone": "13800138000",
              "STel": "0755-87654321",
              "SendAddress": "广东省深圳市南山区南岗第二工业园8栋2楼",
              "TName": "收货人",
              "ReceiveCompany": "收货单位",
              "TPhone": "13900139000",
              "TTel": "010-65432100",
              "ReceiveAddress": "北京市海淀区北四环西路68号",
              "GoodName": "商品名称",
              "Num": 2,
              "Volume": 0.06,
              "Weight": 12.0,
              "SettlementMode": 1,
              "PackageTypeID": 2,
              "GoodsValue": 1.0,
              "SignTypeID": 3,
              "IsNotification": false,
              "ElectronicBusinessType": 0,
              "TransportType": 2,
              "ReceiveDeliveryTypeID": 2,
              "Model": "华为 手机 Nova2s颜色:灰色(1箱)",
              "Remark": "订单备注"
      }

      示例代码

      Shell
      JavaScript
      Java
      Swift
      Go
      PHP
      Python
      HTTP
      C
      C#
      Objective-C
      Ruby
      OCaml
      Dart
      R
      请求示例请求示例
      Shell
      JavaScript
      Java
      Swift
      curl --location --request POST '' \
      --header 'action: order' \
      --header 'code;' \
      --header 'sign;' \
      --header 'Content-Type: application/json' \
      --data-raw '{
              "WaybillID": 0,
              "CustomerOrderNo": "2021053100001",
              "SName": "发货人",
              "SPhone": "13800138000",
              "STel": "0755-87654321",
              "SendAddress": "广东省深圳市南山区南岗第二工业园8栋2楼",
              "TName": "收货人",
              "ReceiveCompany": "收货单位",
              "TPhone": "13900139000",
              "TTel": "010-65432100",
              "ReceiveAddress": "北京市海淀区北四环西路68号",
              "GoodName": "商品名称",
              "Num": 2,
              "Volume": 0.06,
              "Weight": 12.0,
              "SettlementMode": 1,
              "PackageTypeID": 2,
              "GoodsValue": 1.0,
              "SignTypeID": 3,
              "IsNotification": false,
              "ElectronicBusinessType": 0,
              "TransportType": 2,
              "ReceiveDeliveryTypeID": 2,
              "Model": "华为 手机 Nova2s颜色:灰色(1箱)",
              "Remark": "订单备注"
      }'

      返回响应

      🟢200成功
      application/json
      Body
      Status
      integer 
      可选
      200:成功 600:数据错误 700:签名无效 其他代码:Message携带错误信息
      Message
      string 
      可选
      请求失败时的错误信息, 请求成功时为空
      Data
      number 
      TMS单号
      可选
      示例
      {
          "Status": 0,
          "Message": "string",
          "Data": 0
      }
      修改于 2024-10-17 02:29:58
      下一页
      订单取消接口
      Built with