Qeasy Cloud
Get Started

领星ERP 创建待发货/待收货/已完成的备货单 API

Platform
领星ERP
Type
WebAPI
Effect
EXECUTE
API Version
1.0
Adapter
\Adapter\LingXing\LXExecuteAdapter
Auth Mode
OTHER
Description
仓库 / 海外仓 · POST · 请求参数 75 个(必填 38) · 响应参数 8 个 · 限流令牌桶容量 1
Updated At
2026-11-21

创建待发货/待收货/已完成的备货单

POST/erp/sc/routing/owms/inbound/createInbound
Factory
{
  "operation": {
    "method": "POST",
    "path": "/erp/sc/routing/owms/inbound/createInbound"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": {
    "inbound_order_no": "20221116161351",
    "s_wid": "1",
    "r_wid": "3835",
    "status": 60,
    "estimated_time": "2022-05-11",
    "arrival_time": "2022-05-13",
    "share_id": "0",
    "remark": "备注33",
    "file_id": "",
    "logistics_id": "35",
    "method_id": "241261034153378816",
    "logistics_list": [
      {
        "logistics_order_no": "YT21316212661013364",
        "logistics_money": "10",
        "logistics_money_unit": "TRY",
        "other_money": "9.6",
        "other_money_unit": "CNY",
        "track_order_no": "H1018660368132401072",
        "other_money_remark": "预估备注",
        "real_logistics_money": "4",
        "real_logistics_money_unit": "CNY",
        "real_other_money": "4",
        "real_other_money_unit": "CNY",
        "real_other_money_remark": "实际备注"
      }
    ],
    "product_list": [
      {
        "product_id": "33664",
        "fnsku": "",
        "oversea_product_code": "LINGXING-YF",
        "tariffs": 1,
        "tariffs_currency_unit": "CNY",
        "stock_num": "2",
        "receive_num": "1",
        "cg_product_gross_weight": 1,
        "cg_package_length": 1,
        "cg_package_width": 2,
        "cg_package_height": 4
      }
    ],
    "logistics_list_type": 0,
    "head_logistics_list": {
      "tax_fee_type": 1,
      "tracking_list": [
        {
          "tracking_no": "cxdhxxxxxx123",
          "transport_type": "1",
          "order_type_code": "5",
          "shippers": "coscoxxx",
          "remark": "备注"
        }
      ],
      "estimate_expenses_list": {
        "chargeable_weight": "111.00",
        "price": "1.00",
        "price_currency": "CNY",
        "logistics_fee": "1.00",
        "logistics_fee_currency": "CNY",
        "remark": "预估费用备注",
        "other_fee_arr": [
          {
            "fee_type_id": "241192037543649792",
            "other_amount": "1.00",
            "other_currency": "CNY"
          }
        ]
      },
      "actual_expenses_list": {
        "tax_fee": "1",
        "tax_fee_currency": "CNY",
        "chargeable_weight": "111.00",
        "price": "111.00",
        "price_currency": "CNY",
        "logistics_fee": "111.00",
        "logistics_fee_currency": "CNY",
        "remark": "实际费用备注",
        "other_fee_arr": [
          {
            "fee_type_id": "241192037543649792",
            "other_amount": "111.00",
            "other_currency": "CNY"
          }
        ]
      }
    }
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1inbound_order_no客户参考号(唯一单号)string—Required客户参考号(唯一单号)
2custom_s_wid自定义仓库idstring—Optional自定义仓库id,custom_s_wid和s_wid其中一项必填,都填则优先custom_s_wid
3s_wid发货仓库integer—Required发货仓库,仅限本地仓
4r_wid收货仓库integer—Required收货仓库,仅限海外仓
5logistics_id物流方式idinteger—Required物流方式id,查询头程物流渠道列表接口对应字段【id】 (按计费重分摊时,需有传对应物流方式,以获取材积参数用于计算)
6status订单状态integer—Optional订单状态:【默认60】 40 待发货 50 待收货 60 已完成 注:收货仓支持三方海外仓的备货单状态只会到待发货
7estimated_time预计到货时间string—Optional预计到货时间
8arrival_time实际到货时间string—Optional实际到货时间
9share_id头程费分摊方式integer—Optional头程费分摊方式:【默认0】 0 按计费重 1 按实重 2 按体积重 3 按SKU数量 4 自定义 5 按箱子体积 注意:生成待发货状态备货单时,需要通过接口上传备货单装箱信息上传箱子信息; 待收货和已完成的订单不支持【上传备货单装箱信息】,无法按箱子体积分摊
10remark备注string—Optional备注
11file_id附件idstring—Optional附件id
12overseas_type下单至第三方【默认2】integer—Optional下单至第三方【默认2】: 1 否,2 是 注:当收货仓为API海外仓时可填,不填默认为是
13real_delivery_time实际发货时间string—Optional实际发货时间
14logistics_list物流信息array<object>—Optional物流信息
14.1logistics_order_no物流单号string—Optional物流单号
14.2logistics_money预估物流费用string—Optional预估物流费用
14.3logistics_money_unit预估物流费用币种string—Optional预估物流费用币种
14.4other_money预估其他费用string—Optional预估其他费用
14.5other_money_unit预估其他费用币种string—Optional预估其他费用币种
14.6track_order_no追踪号string—Optional追踪号
14.7other_money_remark预估费用备注string—Optional预估费用备注
14.8real_logistics_money实际物流费用number—Optional实际物流费用
14.9real_logistics_money_unit实际物流费用币种string—Optional实际物流费用币种
14.10real_other_money实际其他费用number—Optional实际其他费用
14.11real_other_money_unit实际其他费用币种string—Optional实际其他费用币种
14.12real_other_money_remark实际其他费用备注string—Optional实际其他费用备注
14.13wool_id物流记录idinteger—Optional物流记录id
15product_list产品信息array<object>—Required产品信息
15.1product_id本地商品idinteger—Required本地商品id
15.2fnskufnskustring—Optionalfnsku
15.3tariffs报关费用number—Optional报关费用
15.4tariffs_currency_unit报关费用币种string—Optional报关费用币种
15.5cg_product_gross_weight单品净重(G)number—Optional单品净重(G)
15.6cg_package_length包装规格-长(CM)number—Optional包装规格-长(CM)
15.7cg_package_width包装规格-宽(CM)number—Optional包装规格-宽(CM)
15.8cg_package_height包装规格-高(CM)number—Optional包装规格-高(CM)
15.9stock_num备货数量integer—Required备货数量,整箱配对需要乘以配对数量
15.10receive_num收货数量(收货数量可以为0)integer—Required收货数量(收货数量可以为0)
15.11oversea_product_code三方sku编码string—Optional三方sku编码,查询系统产品与第三方海外仓产品映射列表接口对应字段【oversea_product_code】 【当仓库是有api海外仓必填】
15.12sid店铺idstring—Optional店铺id,有fnsku填 ,对应查询亚马逊店铺列表接口对应字段【sid】
16logistics_list_type物流信息版本integer—Required物流信息版本:0或者不传:默认旧版物流信息 1:新版物流信息
17head_logistics_listhead_logistics_listobject—Required新版头程物流信息(当logistics_list_type 为1时才有意义)
17.1tax_fee_type税费分摊方式integer—Required税费分摊方式: 0:产品-计费重 1:产品-实重 2:产品-体积重 3:产品-数量 4:自定义 5:箱子-体积)
17.2tracking_list轨迹信息array<object>—Required轨迹信息
17.2.1tracking_no查询单号string—Required查询单号
17.2.2transport_type运输类型integer—Required运输类型: 1:快递 2:海运 3:空运 4:其他
17.2.3order_type_code单号类型integer—Required单号类型:【注意:与运输类型联动关系】 1:订舱号 2:提单号 3:箱号 4:其他 5:跟踪单号 6:航班号 当transport_type=1时只能传5 当transport_type=2时只能传1、2、3、4 当transport_type=3时只能传2、6
17.2.4shippers承运商【运输类型为海运时才有意义】string—Required承运商【运输类型为海运时才有意义】
17.2.5remark备注string—Required备注
17.3estimate_expenses_list费用明细-预估费用object—Required费用明细-预估费用
17.3.1chargeable_weight计费重(单位KG)string—Optional计费重(单位KG)
17.3.2price单价string—Required单价
17.3.3price_currency单价币种string—Required单价币种
17.3.4logistics_fee物流费用string—Required物流费用
17.3.5logistics_fee_currency物流费用币种string—Required物流费用币种
17.3.6remark备注string—Optional备注
17.3.7other_fee_arr预估费用-其他费array<object>—Required预估费用-其他费: 获取发货单头程物流-其他费类型接口获取
17.3.7.1fee_type_id其他费id(20位)string—Required其他费id(20位)
17.3.7.2other_amount其他费金额string—Required其他费金额
17.3.7.3other_currency其他费币种string—Required其他费币种
17.4actual_expenses_list费用明细-实际费用object—Required费用明细-实际费用
17.4.1tax_fee税费string—Required税费
17.4.2tax_fee_currency税费币种string—Required税费币种
17.4.3chargeable_weight计费重string—Required计费重
17.4.4price单价string—Required单价
17.4.5price_currency单价币种string—Required单价币种
17.4.6logistics_fee物流费用string—Required物流费用
17.4.7logistics_fee_currency物流费用币种string—Required物流费用币种
17.4.8remark备注string—Optional备注
17.4.9other_fee_arr实际费用-其他费array<object>—Required实际费用-其他费: 获取发货单头程物流-其他费类型接口获取
17.4.9.1fee_type_id其他费id(20位)string—Required其他费id(20位)
17.4.9.2other_amount其他费金额string—Required其他费金额
17.4.9.3other_currency其他费币种string—Required其他费币种
18method_idmethod_idstring—Optional运输方式 查询运输方式列表接口对应字段【method_id】
19custom_fields自定义字段object—Optional自定义字段

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0 成功
2message信息提示stringsuccessRequired信息提示
3error_details错误信息array<any>—Required错误信息
4request_id请求链路idstringD17B0688-C52D-1BA9-1BCC-50AA00058A3FRequired请求链路id
5response_time响应时间string2022-08-23 16:56:31Required响应时间
6data响应数据object—Required响应数据
6.1overseas_order_no系统备货单号string—Required系统备货单号
7total数据总量integer&nbsp;Required数据总量

The 创建待发货/待收货/已完成的备货单 API (/erp/sc/routing/owms/inbound/createInbound) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.