跳到主要内容

cs.space-inventories.detail.list

分页查询按 SO 批次展开的库存明细。

  • 请求路由: cs.space-inventories.detail.list
  • 交互模型: Request Stream
  • 访问限制: 无

请求​

RSocket.rs({
"route" : "cs.space-inventories.detail.list",
"args" : {
"search" : "搜索参数",
"pg" : "分页参数"
}
});

请求参数​

名称类型必须说明
searchObject否搜索参数
search.inventoryIdsString[]否库存 ID 集合。
search.bookingNosString[]否订舱参考号集合。
search.contractNosString[]否合约号集合。
search.carrierIdString否船公司 ID。
search.tagsString[]否必须包含的标签集合。
search.excludeTagsString[]否必须排除的标签集合。
search.hasTagsBoolean否是否仅返回已设置标签的库存。
search.soNosString[]否SO 单号集合。
search.polIdsString[]否起运港 ID 集合。
search.podIdsString[]否目的港 ID 集合。
search.voyageIdsString[]否航次 ID 集合。
search.vesselString否船名或物理船舶 ID。
search.weekString否业务周次。
search.statusString[]否SO 批次状态集合。
  • ACTIVE - 可正常使用。
  • CHANGING_VESSEL - 改船中,库存锁定。
  • PENDING - 待分配
  • ALLOCATED - 已分配
  • RESERVED - 已预占
  • INVALID - 已失效
  • search.etdFromString否预计开船时间下限。
    search.etdToString否预计开船时间上限。
    search.customsReleaseCutoffFromString否海关放行截止时间下限。
    search.customsReleaseCutoffToString否海关放行截止时间上限。
    search.legalEntityIdsString[]否法人主体id
    search.customerIdString否客户id
    search.keywordString否模糊匹配关键字
    search.fromString否查询起始时间,时间样式为RFC3339格式,如:2019-04-18T00:13:39.649Z
    search.toString否查询终止时间,时间样式为RFC3339格式,如:2019-04-19T00:13:39.649Z
    pgObject否分页参数
    pg.pageNumber否页码,首页从0开始
    pg.sizeNumber否每页记录,默认为10
    pg.sortString[]否排序字段清单,默认为升序,需要指定降序时在字段名后面添加desc并用分号隔开。
    例如:["id", "crDate;desc"]

    返回​

    扁平化库存明细列表

    [ ]

    返回属性​

    名称类型说明
    inventoryIdString库存 ID。
    bookingOrderIdString系统订舱单 ID。
    bookingNoString订舱参考号。
    contractNoString订舱合约号。
    carrierString船公司 ID。
    tagsString[]库存标签列表。
    freeTimeDetNumber免堆期,单位为天。
    statusStringSO 批次状态。
  • ACTIVE - 可正常使用。
  • CHANGING_VESSEL - 改船中,库存锁定。
  • PENDING - 待分配
  • ALLOCATED - 已分配
  • RESERVED - 已预占
  • INVALID - 已失效
  • soNoString船东 SO 单号;为空表示虚批次。
    polString起运港 ID。
    podString目的港 ID。
    porString收货地 ID。
    fndString交货地 ID。
    voyageIdString航次 ID。
    voyageNoString航次号。
    vesselString船名或物理船舶 ID。
    weekString业务周次。
    etdString预计开船时间。
    etaString预计到港时间。
    atdString实际开船时间。
    ataString实际到港时间。
    gateOpenTimeString开舱时间。
    cutoffTimeString截单时间。
    vgmCutoffTimeStringVGM 截止时间。
    fullCutoffTimeString重柜截止时间。
    cyCutoffString截港时间。
    carrierCutoffTimeString船东关舱时间。
    customsReleaseCutoffString海关放行截止时间。
    releaseDateString放箱时间。
    siCutoffStringSI 截单时间。
    emptyPickupDepotString提柜堆场。
    returnTerminalString还柜码头。
    incotermIdString贸易条款基础数据 ID。
    remarksStringSO 批次备注。
    containerDetailsObject[]当前 SO 批次的柜型库存及工作单分配明细。
    containerDetails.[].spaceInventoryAllocationDetailsObject[]获取工作单分配记录。
    containerDetails.[].spaceInventoryAllocationDetails.[].jobOrderIdString占用库存的工作单 ID。
    containerDetails.[].spaceInventoryAllocationDetails.[].itemTypeString分配来源类型,用于区分现舱与预报占位库存。
  • FORECAST_INVENTORY - 来源于预报单的库存
  • INVENTORY - 库存
  • PEER - 同行舱位(仅保存于业务单据,不进入系统库存)
  • containerDetails.[].spaceInventoryAllocationDetails.[].forecastIdString预报单 ID
    containerDetails.[].spaceInventoryAllocationDetails.[].quantityNumber当前工作单在该 SO、柜型和来源下分配的柜量。
    containerDetails.[].spaceInventoryAllocationDetails.[].confirmedBoolean是否已通过工作单放舱确认。
    containerDetails.[].spaceInventoryAllocationDetails.[].allocatedAtString首次分配时间,用于无 SO 库存放舱时按稳定顺序拆分分配记录。
    containerDetails.[].typeString箱型类型
    containerDetails.[].nameString箱型名称
    containerDetails.[].nameEnString箱型英文名称
    containerDetails.[].countNumber数量
    containerDetails.[].containerNosString[]当前箱型明细包含的柜号;未指定具体集装箱的出口业务可不填写。

    下载结果模型定义