开放平台接口文档
  • 基础

    • 调用方法
    • 关于鉴权
    • 业务建议
    • 文字符号
    • 返回信息代码含义
  • 物流接口

    • 预报订单
    • 获取面单
    • 费用查询
    • 取消订单
    • 批量取消订单
    • 订单轨迹
    • 预上网推送
    • 获取订单列表
    • 获取用户信息
    • 获取物流服务列表
  • 仓库接口

    • 出库业务流程
    • 创建出库订单
      • 请求参数
        • 物流服务代码 service_code 参数说明
        • 出库产品列表 products 参数说明
        • 收件人 recipient 参数说明
      • 返回信息
        • data 对象说明
    • 获取出库订单
    • 获取仓库列表
    • 拦截出库订单
    • 获取入库订单
    • 获取库存信息
  • 基础
  • 仓库接口
Admin
2024-09-10
目录

创建出库订单

POST /wms/createOrder

# 请求参数

请求参数列表:

参数名称 必须 描述 类型
warehouseId 是 仓库ID Number
reference_no 是 参考号 String
service_code 是 物流服务代码 String
remark 否 备注 String
products 是 产品列表 Array
recipient 是 收件人信息 Object
shipping_type 否 物流方式,默认0,传 1 为自有物流,下面参数必填 Number
shipping_label 否 物流面单地址,只接收pdf url string
order_carrier 否 物流服务商,可选[USPS,UPS,DHL,FEDEX] String
tracking_number 否 物流单号 Number

# 物流服务代码 service_code 参数说明

service_code 可以参考 物流接口-获取物流服务列表 接口获取 或者在客户后台,在右上角点击 【API接口】 获取

# 出库产品列表 products 参数说明

参数名称 必须 描述 类型
sku 是 SKU String
quantity 是 出库数量 Number

# 收件人 recipient 参数说明

参数名称 必须 描述 类型
name 是 收件人姓名 String
company 否 公司名称 String
country 是 国家 String
address1 是 地址1 String
address2 否 地址2 String
city 是 城市 String
state 是 州/省 String
zip 是 邮编 String
mobile 是 手机号 String

请求示例:

{
    "warehouseId": 1,
    "reference_no": "REF123456",
    "service_code": "124_LCS_USPS_GA_T5",
    "remark": "备注",
    "products": [
        {
            "sku": "phone2",
            "quantity": 1
        }
    ],
    "recipient": {
        "name": "John Doe",
        "company": "ACME Inc.",
        "country": "US",
        "address1": "123 Main St",
        "address2": "Apt 4B",
        "city": "Anytown",
        "state": "CA",
        "zip": "12345",
        "mobile": "1234567890"
    }
}

# 返回信息

接口返回创建出库单的结果

响应参数列表:

参数名称 描述
code 状态码
msg 返回信息
data 返回数据对象

# data 对象说明

参数名称 描述
outbound_id 出库单ID
platform_no 平台单号

完整响应数据示例:

{
    "code": 200,
    "msg": "出库单创建成功",
    "data": {
        "outbound_id": "1508",
        "platform_no": "O240910-DB8E"
    }
}

错误响应数据示例:

{
    "code": 100,
    "msg": "sku_1 数量超出可用库存",
    "data": []
}
出库业务流程
获取出库订单

← 出库业务流程 获取出库订单→

  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式