Qeasy Cloud
Get Started

领星ERP 生成待发货发货单(关联货件) API

Platform
领星ERP
Type
WebAPI
Effect
EXECUTE
API Version
1.0
Adapter
\Adapter\LingXing\LXExecuteAdapter
Auth Mode
OTHER
Description
FBA / 发货单 · POST · 请求参数 113 个(必填 43) · 响应参数 7 个 · 限流令牌桶容量 1
Updated At
2026-11-21

生成待发货发货单(关联货件)

POST/erp/sc/routing/storage/shipment/createReadySendOrder
Factory
{
  "operation": {
    "method": "POST",
    "path": "/erp/sc/routing/storage/shipment/createReadySendOrder"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": {
    "sys_wid": 1,
    "expected_arrival_date": "",
    "etd_date": "",
    "eta_date": "",
    "delivery_date": "",
    "actual_shipment_time": "",
    "head_fee_type": 0,
    "tax_fee_type": 0,
    "is_points_behind": 0,
    "points_behind_coeffient": 0,
    "logistics_channel_id": 0,
    "remark": "",
    "is_related": "",
    "vat_code": "",
    "is_pick": 0,
    "logistics_list": [
      {
        "tracking_number": "",
        "replace_tracking_number": "",
        "transportation_cost": 0,
        "transportation_currency": "",
        "other_cost": 0,
        "other_currency": "",
        "other_cost_remark": "",
        "predicted_transportation_cost": 0,
        "predicted_transportation_currency": "",
        "predicted_other_cost": 0,
        "predicted_other_currency": ""
      }
    ],
    "list": [
      {
        "seller_id": "",
        "warehouse_seller_id": 0,
        "marketplace_id": "",
        "shipment_id": "",
        "fulfillment_network_sku": "",
        "fnsku": "",
        "num": 0,
        "box_num": 0,
        "sku": "",
        "tax_currency": "",
        "tax_amount": "",
        "cg_product_gross_weight": "",
        "cg_product_net_weight": "",
        "cg_package_length": "",
        "cg_package_width": "",
        "cg_package_height": "",
        "cg_box_weight": "",
        "transport_cost": "",
        "cg_box_length": "",
        "cg_box_width": "",
        "cg_box_height": "",
        "quantity_in_case": 0,
        "remark": ""
      }
    ],
    "box_type": "",
    "box_remark": "",
    "box_list": [
      {
        "box_num": "3",
        "cg_box_length": 20,
        "cg_box_width": 30,
        "cg_box_height": 40,
        "cg_box_weight": 1.33,
        "box_skus": [
          {
            "seller_id": "A1MQMW3JWPNCBX",
            "marketplace_id": "xxxxxxxxxxxxxxxx",
            "shipment_id": "FBA16XNMN3N4",
            "fulfillment_network_sku": "B09MT3989Q",
            "quantity_in_case": 32,
            "sku": "0530-1"
          }
        ]
      }
    ],
    "logistics_list_type": 0,
    "head_logistics_list": {
      "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",
        "weight": "111.00",
        "volume": "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
1wid自定义仓库 IDinteger—Optional自定义仓库 ID。wid 和 sys_wid 至少传一个,若都传则优先用 wid。
2sys_wid系统仓库 IDinteger—Optional系统仓库 ID。wid 和 sys_wid 至少传一个,若都传则优先用 wid。多仓库发货时传 -1。
3expected_arrival_date预计到达时间string—Optional预计到达时间,格式:Y-m-d
4etd_date开船时间string—Optional开船时间,格式:Y-m-d
5eta_date预计到港时间string—Optional预计到港时间,格式:Y-m-d
6delivery_date实际妥投时间string—Optional实际妥投时间,格式:Y-m-d
7actual_shipment_time实际发货时间string—Optional实际发货时间,格式:Y-m-d
8head_fee_type头程费分配方式integer—Optional头程费分配方式:【默认0】 0 按计费重 1 按实重 2 按体积重 3 按SKU数量 4 自定义 5 按箱子体积
9tax_fee_type实际税费分配方式integer—Optional实际税费分配方式:【默认0】 0 产品-计费重 1 产品-实重 2 产品-体积重 3 产品-数量 4 自定义 5 箱子-体积
10is_points_behind是否分抛计算integer—Optional是否分抛计算:0 否,1 是;头程分摊方式为按计费重时用
11points_behind_coeffient分抛系数integer—Optional分抛系数:0~100,分抛计算选是时必填
12logistics_channel_id物流渠道idinteger—Optional物流渠道id:按计费重分摊时必填,以获取材积参数用于计算 查询头程物流渠道列表接口对应字段【id】
13is_related是否关联普通商品integer—Optional是否关联普通商品: 0 否 1 是【会拆分组合商品】
14vat_code店铺VAT税号string—Optional店铺VAT税号
15is_pick是否拣货integer—Optional是否拣货:【默认0】 0 否 1 是
16remark备注string—Optional备注
17principal_uids负责人UIDarray<any>—Optional负责人UID,来源:查询ERP用户信息列表返回的 data>>uid
18ship_mode发货方式integer—Optional发货方式:1-默认,2-工厂直发
19hand_pick_purchase工厂直发时手动选择出库批次integer—Optional工厂直发时手动选择出库批次:1-否,2-是
20listlistarray<object>—Required
20.1seller_id亚马逊店铺idstring—Required亚马逊店铺id
20.2warehouse_seller_id仓库店铺idinteger—Optional仓库店铺id
20.3marketplace_id亚马逊市场idstring—Required亚马逊市场id,对应查询亚马逊店铺列表接口的marketplace_id字段
20.4shipment_id货件单号string—Required货件单号
20.5fulfillment_network_sku货件fnskustring—Required货件fnsku
20.6fnsku本地发货的fnskustring—Optional本地发货的fnsku,默认空
20.7num发货数量integer—Required发货数量
20.8box_num箱数integer—Optional箱数
20.9skuskustring—Requiredsku
20.10tax_currency报关税费币种string—Optional报关税费币种
20.11tax_amount税费值string—Optional税费值
20.12cg_product_gross_weight采购string—Optional采购:单品毛重(G);不传值则自动取【商品管理】模块维护的SKU“单品毛重”;按计费重分摊时需用到该字段
20.13cg_product_net_weight采购string—Optional采购:单品净重(G);不传值则自动取【商品管理】模块维护的SKU“单品净重”;
20.14cg_package_length采购string—Optional采购:包装规格-长(CM);不传值则自动取【商品管理】模块维护的SKU“包装规格-长”;按计费重分摊时需用到该字段
20.15cg_package_width采购string—Optional采购:包装规格-宽(CM);不传值则自动取【商品管理】模块维护的SKU“包装规格-宽”;按计费重分摊时需用到该字段
20.16cg_package_height采购string—Optional采购:包装规格-高(CM);不传值则自动取【商品管理】模块维护的SKU“包装规格-高”;按计费重分摊时需用到该字段
20.17cg_box_weight采购string—Optional采购:单箱重量(KG);不传值则自动取【商品管理】模块维护的SKU“单箱重量”;按计费重分摊时需用到该字段
20.18transport_cost自定义头程费string—Optional自定义头程费,head_fee_type为4才生效
20.19cg_box_length箱规-长(CM)string—Optional箱规-长(CM)
20.20cg_box_width箱规-宽(CM)string—Optional箱规-宽(CM)
20.21cg_box_height箱规-高(CM)string—Optional箱规-高(CM)
20.22quantity_in_case单箱数量(PCS)integer—Optional单箱数量(PCS)
20.23remark备注string—Optional备注
20.24purchase_items工厂直发手动选择出库批次array<object>—Optional工厂直发手动选择出库批次
20.24.1relation_num关联量integer—Required关联量
20.24.2purchase_sn系统采购单号string—Optional系统采购单号
20.24.3custom_purchase_sn自定义采购单号(无系统采购单号时必填)string—Optional自定义采购单号(无系统采购单号时必填)
20.25warehouse_items多仓发货商品array<object>—Optional多仓发货商品
20.25.1sys_wid多仓系统仓库idinteger—Optional多仓系统仓库id
20.25.2warehouse_seller_id多仓发货仓库店铺idinteger—Optional多仓发货仓库店铺id
20.25.3warehouse_fnsku多仓发货仓库fnskustring—Optional多仓发货仓库fnsku
20.25.4out_num调出量integer—Optional调出量
21box_type装箱类型string—Optional装箱类型:SINGLE-每箱只允许一款SKU,MULTIPLE-每箱允许多款SKU
22box_remark装箱备注string—Optional装箱备注
23box_list箱规列表array<object>—Required箱规列表,每个子项代表一个箱规,在装箱类型为MULTIPLE时必填
23.1box_num箱子数string—Required箱子数
23.2cg_box_length箱子长(CM)number—Required箱子长(CM)
23.3cg_box_width箱子宽(CM)number—Required箱子宽(CM)
23.4cg_box_height箱子高(CM)number—Required箱子高(CM)
23.5cg_box_weight箱子重(KG)number—Required箱子重(KG)
23.6box_skus箱子内包含的SKU信息array<object>—Required箱子内包含的SKU信息,需与list里的数据保持一致
23.6.1seller_id亚马逊店铺idstring—Required亚马逊店铺id ,对应查询亚马逊店铺列表接口对应字段【seller_id】
23.6.2marketplace_id亚马逊市场idstring—Required亚马逊市场id
23.6.3shipment_id货件单号string—Required货件单号
23.6.4fulfillment_network_sku货件fnskustring—Required货件fnsku
23.6.5quantity_in_case单箱数量number—Required单箱数量
23.6.6skuskustring—RequiredSKU
24logistics_list_type物流信息版本integer—Optional物流信息版本: 0 旧版 1 新版
25head_logistics_list新版头程物流信息object—Required新版头程物流信息
25.1tracking_list轨迹信息数组array<object>—Optional轨迹信息数组
25.1.1tracking_no查询单号string—Optional查询单号
25.1.2transport_type运输类型string—Optional运输类型: 1 快递 2 海运 3 空运 4 其他
25.1.3order_type_code单号类型integer—Optional单号类型:【注意:与运输类型联动关系】 1 订舱号 2 提单号 3 箱号 4 其他 5 跟踪单号 6航班号 当transport_type=1时只能传5 当transport_type=2时只能传1、2、3、4 当transport_type=3时只能传2、6 当transport_type=4只能传空
25.1.4shippers承运商string—Optional承运商,运输类型为海运时才有意义: 获取发货单头程物流-承运商信息接口获取
25.1.5remark备注string—Optional备注
25.2estimate_expenses_list费用明细-预估费用object—Optional费用明细-预估费用
25.2.1chargeable_weight计费重(单位KG)string—Optional计费重(单位KG)
25.2.2price单价string—Required单价
25.2.3price_currency单价币种string—Required单价币种
25.2.4logistics_fee物流费用string—Required物流费用
25.2.5logistics_fee_currency物流费用币种string—Required物流费用币种
25.2.6remark备注string—Optional备注
25.2.7other_fee_arr预估费用-其他费array<object>—Required预估费用-其他费: 获取发货单头程物流-其他费类型接口获取
25.2.7.1fee_type_id其他费idstring—Required其他费id
25.2.7.2other_amount其他费金额string—Required其他费金额
25.2.7.3other_currency其他费币种string—Required其他费币种
25.3actual_expenses_list费用明细-实际费用object—Optional费用明细-实际费用
25.3.1tax_fee税费string—Required税费
25.3.2tax_fee_currency税费币种string—Required税费币种
25.3.3chargeable_weight计费重【废弃字段】string—Required计费重【废弃字段】
25.3.4weight实重(单位string—Required实重(单位:KG)
25.3.5volume体积(单位string—Required体积(单位:m³)
25.3.6price单价string—Required单价
25.3.7price_currency单价币种string—Required单价币种
25.3.8logistics_fee物流费用string—Required物流费用
25.3.9logistics_fee_currency物流费用币种string—Required物流费用币种
25.3.10remark备注string—Optional备注
25.3.11other_fee_arr实际费用-其他费array<object>—Required实际费用-其他费: 获取发货单头程物流-其他费类型接口获取
25.3.11.1fee_type_id其他费idstring—Required其他费id
25.3.11.2other_amount其他费金额string—Required其他费金额
25.3.11.3other_currency其他费币种string—Required其他费币种
26logistics_list旧版物流信息array<object>—Optional旧版物流信息,即将下线
26.1tracking_number物流商单号string—Optional物流商单号
26.2replace_tracking_number跟踪号string—Optional跟踪号
26.3transportation_cost实际物流费用number—Optional实际物流费用
26.4transportation_currency实际物流费用币种string—Optional实际物流费用币种
26.5other_cost实际其他费用number—Optional实际其他费用
26.6other_currency实际其他费用币种string—Optional实际其他费用币种
26.7other_cost_remark其他费用备注string—Optional其他费用备注
26.8predicted_transportation_cost预估物流费用number—Optional预估物流费用
26.9predicted_transportation_currency预估物流费用币种string—Optional预估物流费用币种
26.10predicted_other_cost预估其他费用number—Optional预估其他费用
26.11predicted_other_currency预估其他费用币种string—Optional预估其他费用币种

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0 成功
2message消息提示stringsuccessRequired消息提示
3error_details错误信息string—Required错误信息
4request_id请求链路idstringC3D9F541-8083-E376-EB5C-606A872F5C89Required请求链路id
5response_time响应时间string2022-12-08 18:27:13Required响应时间
6data响应数据object—Required响应数据
6.1order_sn发货单号string&nbsp;Required发货单号

The 生成待发货发货单(关联货件) API (/erp/sc/routing/storage/shipment/createReadySendOrder) 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.