Lingxing
切换旧版

查询海外仓备货计划批次列表

POST/erp/sc/routing/owms/overseaStockPlan/getOverseaStockPlanList

按批次分页返回计划列表及汇总信息；未传分页参数时默认从第 0 条开始，每页 20 条。

接口信息

API Path请求协议请求方式令牌桶容量
/erp/sc/routing/owms/overseaStockPlan/getOverseaStockPlanListHTTPSPOST待确认

请求参数

offsetinteger
分页起始偏移量。
最小值：0
lengthinteger
每页返回的批次数量，必须为正整数。
最小值：1
ispg_idinteger
计划批次 ID。
statusstring
计划状态，0=待审核，5=待处理，10=已完成，-5=已驳回；支持整数、逗号分隔字符串或数组，空字符串表示不筛选。
widsarray<any>
发货仓库 ID 列表。
received_widsarray<any>
海外收货仓库 ID 列表，ID 必须大于 0；不筛选时传空数组或省略字段。
method_idstring
运输方式 ID，支持逗号分隔字符串或数组。
logistics_provider_idsarray<any>
物流商 ID 列表。
channel_idarray<any>
物流渠道 ID 列表。
search_fieldstring
搜索字段。
可选值：seq、order_sn、oversea_stocking_order_sn、local_name、sku、fnsku、purchase_plan_sn、purchase_order_sn、group_remark、plan_remark、packing_task_sn
search_valuestring
搜索关键词。
search_field_timestring
时间筛选字段，分别为计划创建时间、批次创建时间、预计发货时间。
可选值：gmt_create、group_gmt_create、estimated_delivery_time
start_datestring
时间筛选开始日期。
end_datestring
时间筛选结束日期。
lock_statusinteger
库存锁定状态，1=未锁定，2=已锁定，3=已使用；空字符串表示不筛选。
可选值：1、2、3
ship_modeinteger
发货方式，1=非工厂直发，2=工厂直发。
可选值：1、2
is_urgentinteger
是否加急，0=否，1=是。
可选值：0、1
sort_fieldstring
批次排序字段，空字符串使用默认排序。
可选值：seq、create_time、sum_cbm、sum_total_gw
sort_typestring
排序方向。
可选值：asc、desc

请求cURL示例

示例中的单号和 ID 为占位值，使用时请替换为实际值。

curl --location 'https://openapi.lingxing.com/erp/sc/routing/owms/overseaStockPlan/getOverseaStockPlanList?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "offset": 0,
    "length": 20
}'

返回结果

Json Object

codeinteger必填
业务结果码，与 HTTP 状态码不同；常见值为 1=成功、102=参数错误、1000=业务处理失败、500=系统错误。
msgstring必填
响应消息。
dataobject
隐藏子属性
totalinteger
符合筛选条件的计划批次总数。
is_audit_enableinteger
是否启用审批流，0=否，1=是。
listarray<object>
按批次分页的海外仓备货计划列表。
隐藏子属性
ispg_idinteger
计划批次 ID。
seqstring
计划批次号。
remarkstring
批次备注。
create_timestring
批次创建时间。
shipment_plan_quantityinteger
批次计划发货总量。
box_numinteger
批次箱数。
total_nwnumber
批次总净重。
total_gwnumber
批次总毛重。
cbmnumber
批次总体积。
volume_weightnumber
批次总体积重。
packing_task_snstring
关联装箱任务单号。
packingstring
关联装箱任务信息。
custom_fieldsarray<any>
批次自定义字段。
plan_listarray<object>
当前批次下的海外仓备货计划明细。
隐藏子属性
isp_idinteger
计划 ID。
ispg_idinteger
计划批次 ID。
sidstring
店铺 ID。
snamestring
店铺名称。
seller_idstring
卖家 ID。
seller_namestring
卖家名称。
nationstring
国家或站点。
order_snstring
计划单号。
seqstring
计划批次号。
receive_warehouse_typestring
收货仓库类型。
receive_warehouse_type_textstring
收货仓库类型名称。
widinteger
发货仓库 ID。
wnamestring
发货仓库名称。
target_widinteger
收货仓库 ID。
target_wnamestring
收货仓库名称。
statusinteger
计划状态，0=待审核，5=待处理，10=已完成，-5=已驳回。
status_namestring
计划状态名称。
lock_statusinteger
库存锁定状态，1=未锁定，2=已锁定，3=已使用；空字符串表示不筛选。
可选值：1、2、3
lock_status_namestring
库存锁定状态名称。
create_timestring
创建时间。
create_datetimestring
创建时间。
create_uidstring
创建人 ID。
create_userstring
创建人名称。
shipment_timestring
计划发货日期。
shipment_datetimestring
计划发货日期。
expected_arrival_datestring
预计到货日期。
valid_periodstring
物流预计时效。
logistics_typeinteger
物流类型。
method_idstring
运输方式 ID。
method_namestring
运输方式名称。
logistics_provider_idstring
物流商 ID。
logistics_provider_namestring
物流商名称。
logistics_channel_idstring
物流渠道 ID。
logistics_namestring
物流渠道名称。
remarkstring
计划备注。
is_urgentinteger
是否加急，0=否，1=是。
is_combointeger
是否组合品。
is_combo_auto_processinteger
是否自动创建组合品加工单。
is_auto_adjustinteger
库存不足时是否自动换标。
pic_urlstring
商品图片地址。
product_namestring
商品名称。
product_idinteger
商品 ID。
skustring
商品 SKU。
fnskustring
商品 FNSKU。
third_party_product_namestring
第三方仓商品名称。
third_party_product_codestring
第三方仓商品编码。
match_numinteger
SKU 配对数量。
stock_numinteger
海外仓备货数量。
shipment_plan_quantityinteger
计划发货数量。
packed_numinteger
已装箱数量。
overseas_relatearray<any>
关联备货单明细。
overseas_relation_numinteger
已关联备货数量。
overseas_diff_numinteger
未关联备货数量。
storage_listarray<any>
仓储库存信息。
product_valid_numstring
商品可用量。
product_qc_numstring
待检待上架数量。
quantity_receivestring
待到货数量。
lock_bin_listarray<any>
已锁定仓位明细。
is_manual_select_whb_codeinteger
是否手动指定锁库仓位。
whb_codearray<any>
锁库仓位编码列表。
pps_idstring
箱规 ID。
spec_titlestring
箱规名称。
spec_pack_listarray<any>
商品箱规列表。
quantity_in_caseinteger
单箱数量。
box_numinteger
箱数。
cg_package_lengthnumber
单品包装长。
cg_package_widthnumber
单品包装宽。
cg_package_heightnumber
单品包装高。
cg_box_lengthnumber
箱规长。
cg_box_widthnumber
箱规宽。
cg_box_heightnumber
箱规高。
cbmnumber
体积。
volume_weightnumber
体积重。
nwnumber
单品净重。
gwnumber
单品毛重。
total_nwnumber
总净重。
total_gwnumber
总毛重。
cg_box_weightnumber
单箱重量。
cg_box_net_weightnumber
单箱净重。
cg_box_gross_weightnumber
单箱毛重。
cg_box_total_gross_weightnumber
箱子总毛重。
ship_modeinteger
发货方式，1=非工厂直发，2=工厂直发。
awd_order_idstring
关联 AWD 入库单 ID。
local_awd_idstring
本地 AWD 单据 ID。
awd_shipment_idstring
AWD 货件 ID。
list_relate_purchasearray<any>
关联采购计划及采购单列表。
purchase_deliverable_balanceinteger
采购可发余量。
shipment_pending_purchase_balanceinteger
发货待采余量。
audit_usersarray<any>
审批人信息。
target_wid_is_awdboolean
收货仓库是否 AWD 仓。
mws_relatearray<any>
兼容字段，货件单关联信息。
summaryobject
当前筛选条件下的数量、箱数、体积和重量汇总。
require_idstring
请求追踪 ID；错误响应的 msg 还会附加请求码，便于排查。

附加说明

  • total 是符合全部筛选条件的批次总数；每批 plan_list 仅包含符合相同筛选条件的计划。非法枚举值返回字段错误。