轻易云
注册体验

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

所属平台
领星ERP
类型
WebAPI
作用
EXECUTE
接口版本
1.0
适配器
\Adapter\LingXing\LXExecuteAdapter
授权方式
OTHER
描述
FBA / 发货单 · POST · 请求参数 113 个(必填 43) · 响应参数 7 个 · 限流令牌桶容量 1
更新日期
2026-11-21

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

POST/erp/sc/routing/storage/shipment/createReadySendOrder
加工厂
{
  "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"
          }
        ]
      }
    }
  }
}

接口请求参数

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

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0 成功
2message消息提示stringsuccess必填消息提示
3error_details错误信息string—必填错误信息
4request_id请求链路idstringC3D9F541-8083-E376-EB5C-606A872F5C89必填请求链路id
5response_time响应时间string2022-12-08 18:27:13必填响应时间
6data响应数据object—必填响应数据
6.1order_sn发货单号string&nbsp;必填发货单号

领星ERP的接口:生成待发货发货单(关联货件)(/erp/sc/routing/storage/shipment/createReadySendOrder),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。