cs.real-space-inventories.flat.list

分页查询铺平现舱库存列表

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

请求

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

请求参数

名称	类型	必须	说明
search	Object	否	搜索参数
search.containerType	String	否	柜型代码。
search.etdFrom	String	否	预计开船时间下限。
search.etdTo	String	否	预计开船时间上限。
search.customsReleaseCutoffFrom	String	否	海关放行截止时间下限。
search.customsReleaseCutoffTo	String	否	海关放行截止时间上限。
search.week	String	否	业务周次。
search.polId	String	否	起运港 ID。
search.podId	String	否	目的港 ID。
search.carrierId	String	否	船公司 ID。
search.vessel	String	否	船名。
search.voyageNo	String	否	航次号。
search.status	String[]	否	状态列表。普通库存查询按 SO 原始状态过滤；分配列表按拆分后的实时状态过滤。 ACTIVE - 可正常使用。 CHANGING_VESSEL - 改船中，库存锁定。 PENDING - 待分配 ALLOCATED - 已分配 RESERVED - 已预占 INVALID - 已失效
search.selectJobIds	String[]	否	需要作为自身分配排除的工作单 ID 列表。
search.inventoryIds	String[]	否	指定库存 ID 列表。
search.itemType	String	否	目标分配来源类型。 FORECAST_INVENTORY - 来源于预报单的库存 INVENTORY - 库存 PEER - 同行舱位（仅保存于业务单据，不进入系统库存）
search.forecastIds	String[]	否	允许使用的预报单 ID 列表。
search.excludeForecastIds	String[]	否	需要排除的预报单 ID 列表。
search.tags	String[]	否	必须匹配的标签列表。
search.excludeTags	String[]	否	需要排除的标签列表。
search.hasTags	Boolean	否	是否仅查询包含标签的库存。
search.sourceId	String	否	库存来源id可以为订舱请求id
search.bookingNo	String	否	订舱参考号，同一租户内唯一。
search.contractNo	String	否	订舱合约号。
search.legalEntityIds	String[]	否	法人主体id
search.customerId	String	否	客户id
search.keyword	String	否	模糊匹配关键字
search.from	String	否	查询起始时间，时间样式为RFC3339格式，如：2019-04-18T00:13:39.649Z
search.to	String	否	查询终止时间，时间样式为RFC3339格式，如：2019-04-19T00:13:39.649Z
pg	Object	否	分页参数
pg.page	Number	否	页码，首页从0开始
pg.size	Number	否	每页记录，默认为10
pg.sort	String[]	否	排序字段清单，默认为升序，需要指定降序时在字段名后面添加desc并用分号隔开。 例如：["id", "crDate;desc"]

返回

现舱库存列表

[ ]

返回属性

名称	类型	说明
inventoryId	String	库存 ID
bookingOrderId	String	系统订舱单id
bookingNo	String	订舱参考号
soNo	String	SO单号
contractNo	String	合约号
pol	String	起运港（往来单位id）
polInfo	Object	起运港信息
polInfo.country	String	国家
polInfo.countryEn	String	国家(英文)
polInfo.abbreviation	String	名称缩写
polInfo.address	String	地址（中文）
polInfo.addressEn	String	地址（英文）
polInfo.contactPersons	Object[]	联系人信息列表，支持多个联系人
polInfo.contactPersons.[].username	String	用户标识
polInfo.contactPersons.[].name	String	用户名称
polInfo.contactPersons.[].nameEn	String	英文称呼，用于外部联系人的英文通知；缺失时不自动翻译姓名。
polInfo.contactPersons.[].mobile	String	用户手机号
polInfo.contactPersons.[].email	String	用户邮箱
polInfo.contactPersons.[].position	String	职位
polInfo.contactPersons.[].contactRoles	String[]	联系人承担的职责，支持多选；未指定时为空集合 PRIMARY - 主联系人，承担往来单位的主要业务对接职责。 EMAIL_NOTIFICATION - 邮件通知人，作为业务邮件通知的联系对象。 BILLING - 账单联系人，承担账单接收和账务沟通职责。
polInfo.bankAccounts	Object[]	银行账户列表，支持多个账户
polInfo.bankAccounts.[].accountName	String	开户名称
polInfo.bankAccounts.[].bankName	String	银行名称
polInfo.bankAccounts.[].bankCode	String	联行号
polInfo.bankAccounts.[].bankAccount	String	银行账号
polInfo.bankAccounts.[].currency	String	币制 CNY - 人民币 USD - 美元 EUR - 欧元 HKD - 港币 JPY - 日元 GBP - 英镑 AUD - 澳大利亚元 CAD - 加拿大元 SGD - 新加坡元 KRW - 韩元 DKK - 丹麦克朗 NOK - 挪威克朗 SEK - 瑞典克朗 name - 获取币种名称 symbol - 获取币种符号 code - 返回币种代码
polInfo.bankAccounts.[].swiftCode	String	SWIFT CODE
polInfo.bankAccounts.[].address	String	地址
polInfo.bankAccounts.[].isDefault	Boolean	是否默认
polInfo.invoiceInfo	Object	开票信息
polInfo.invoiceInfo.companyName	String	公司名称
polInfo.invoiceInfo.taxIdentificationNumber	String	纳税识别号
polInfo.invoiceInfo.companyAddress	String	公司地址
polInfo.invoiceInfo.phone	String	电话
polInfo.invoiceInfo.bankAccount	String	银行账号
polInfo.invoiceInfo.contact	String	联系人
polInfo.invoiceInfo.email	String	邮箱
polInfo.extraProps	Object	扩展信息
polInfo.relatedCustomers	Object[]	关联客户列表
polInfo.relatedCustomers.[].tags	String[]	该客户赋予当前往来单位的角色标签列表（如 shipper, consignee, importBuyer 等）
polInfo.relatedCustomers.[].extraProps	Object	专属定制扩展属性 (Key 为 tag 比如 "shipper", Value 为特定定制的 Unit 实例)
polInfo.relatedCustomers.[].unitId	String	往来单位唯一ID，主键
polInfo.relatedCustomers.[].name	String	名称（中文）
polInfo.relatedCustomers.[].nameEn	String	名称（英文）
polInfo.unitId	String	往来单位唯一ID，主键
polInfo.name	String	名称（中文）
polInfo.nameEn	String	名称（英文）
pod	String	目的港（往来单位id）
podInfo	Object	目的港信息
podInfo.country	String	国家
podInfo.countryEn	String	国家(英文)
podInfo.abbreviation	String	名称缩写
podInfo.address	String	地址（中文）
podInfo.addressEn	String	地址（英文）
podInfo.contactPersons	Object[]	联系人信息列表，支持多个联系人
podInfo.contactPersons.[].username	String	用户标识
podInfo.contactPersons.[].name	String	用户名称
podInfo.contactPersons.[].nameEn	String	英文称呼，用于外部联系人的英文通知；缺失时不自动翻译姓名。
podInfo.contactPersons.[].mobile	String	用户手机号
podInfo.contactPersons.[].email	String	用户邮箱
podInfo.contactPersons.[].position	String	职位
podInfo.contactPersons.[].contactRoles	String[]	联系人承担的职责，支持多选；未指定时为空集合 PRIMARY - 主联系人，承担往来单位的主要业务对接职责。 EMAIL_NOTIFICATION - 邮件通知人，作为业务邮件通知的联系对象。 BILLING - 账单联系人，承担账单接收和账务沟通职责。
podInfo.bankAccounts	Object[]	银行账户列表，支持多个账户
podInfo.bankAccounts.[].accountName	String	开户名称
podInfo.bankAccounts.[].bankName	String	银行名称
podInfo.bankAccounts.[].bankCode	String	联行号
podInfo.bankAccounts.[].bankAccount	String	银行账号
podInfo.bankAccounts.[].currency	String	币制 CNY - 人民币 USD - 美元 EUR - 欧元 HKD - 港币 JPY - 日元 GBP - 英镑 AUD - 澳大利亚元 CAD - 加拿大元 SGD - 新加坡元 KRW - 韩元 DKK - 丹麦克朗 NOK - 挪威克朗 SEK - 瑞典克朗 name - 获取币种名称 symbol - 获取币种符号 code - 返回币种代码
podInfo.bankAccounts.[].swiftCode	String	SWIFT CODE
podInfo.bankAccounts.[].address	String	地址
podInfo.bankAccounts.[].isDefault	Boolean	是否默认
podInfo.invoiceInfo	Object	开票信息
podInfo.invoiceInfo.companyName	String	公司名称
podInfo.invoiceInfo.taxIdentificationNumber	String	纳税识别号
podInfo.invoiceInfo.companyAddress	String	公司地址
podInfo.invoiceInfo.phone	String	电话
podInfo.invoiceInfo.bankAccount	String	银行账号
podInfo.invoiceInfo.contact	String	联系人
podInfo.invoiceInfo.email	String	邮箱
podInfo.extraProps	Object	扩展信息
podInfo.relatedCustomers	Object[]	关联客户列表
podInfo.relatedCustomers.[].tags	String[]	该客户赋予当前往来单位的角色标签列表（如 shipper, consignee, importBuyer 等）
podInfo.relatedCustomers.[].extraProps	Object	专属定制扩展属性 (Key 为 tag 比如 "shipper", Value 为特定定制的 Unit 实例)
podInfo.relatedCustomers.[].unitId	String	往来单位唯一ID，主键
podInfo.relatedCustomers.[].name	String	名称（中文）
podInfo.relatedCustomers.[].nameEn	String	名称（英文）
podInfo.unitId	String	往来单位唯一ID，主键
podInfo.name	String	名称（中文）
podInfo.nameEn	String	名称（英文）
carrier	String	船公司（往来单位id）
carrierInfo	Object	船公司信息
carrierInfo.country	String	国家
carrierInfo.countryEn	String	国家(英文)
carrierInfo.abbreviation	String	名称缩写
carrierInfo.address	String	地址（中文）
carrierInfo.addressEn	String	地址（英文）
carrierInfo.contactPersons	Object[]	联系人信息列表，支持多个联系人
carrierInfo.contactPersons.[].username	String	用户标识
carrierInfo.contactPersons.[].name	String	用户名称
carrierInfo.contactPersons.[].nameEn	String	英文称呼，用于外部联系人的英文通知；缺失时不自动翻译姓名。
carrierInfo.contactPersons.[].mobile	String	用户手机号
carrierInfo.contactPersons.[].email	String	用户邮箱
carrierInfo.contactPersons.[].position	String	职位
carrierInfo.contactPersons.[].contactRoles	String[]	联系人承担的职责，支持多选；未指定时为空集合 PRIMARY - 主联系人，承担往来单位的主要业务对接职责。 EMAIL_NOTIFICATION - 邮件通知人，作为业务邮件通知的联系对象。 BILLING - 账单联系人，承担账单接收和账务沟通职责。
carrierInfo.bankAccounts	Object[]	银行账户列表，支持多个账户
carrierInfo.bankAccounts.[].accountName	String	开户名称
carrierInfo.bankAccounts.[].bankName	String	银行名称
carrierInfo.bankAccounts.[].bankCode	String	联行号
carrierInfo.bankAccounts.[].bankAccount	String	银行账号
carrierInfo.bankAccounts.[].currency	String	币制 CNY - 人民币 USD - 美元 EUR - 欧元 HKD - 港币 JPY - 日元 GBP - 英镑 AUD - 澳大利亚元 CAD - 加拿大元 SGD - 新加坡元 KRW - 韩元 DKK - 丹麦克朗 NOK - 挪威克朗 SEK - 瑞典克朗 name - 获取币种名称 symbol - 获取币种符号 code - 返回币种代码
carrierInfo.bankAccounts.[].swiftCode	String	SWIFT CODE
carrierInfo.bankAccounts.[].address	String	地址
carrierInfo.bankAccounts.[].isDefault	Boolean	是否默认
carrierInfo.invoiceInfo	Object	开票信息
carrierInfo.invoiceInfo.companyName	String	公司名称
carrierInfo.invoiceInfo.taxIdentificationNumber	String	纳税识别号
carrierInfo.invoiceInfo.companyAddress	String	公司地址
carrierInfo.invoiceInfo.phone	String	电话
carrierInfo.invoiceInfo.bankAccount	String	银行账号
carrierInfo.invoiceInfo.contact	String	联系人
carrierInfo.invoiceInfo.email	String	邮箱
carrierInfo.extraProps	Object	扩展信息
carrierInfo.relatedCustomers	Object[]	关联客户列表
carrierInfo.relatedCustomers.[].tags	String[]	该客户赋予当前往来单位的角色标签列表（如 shipper, consignee, importBuyer 等）
carrierInfo.relatedCustomers.[].extraProps	Object	专属定制扩展属性 (Key 为 tag 比如 "shipper", Value 为特定定制的 Unit 实例)
carrierInfo.relatedCustomers.[].unitId	String	往来单位唯一ID，主键
carrierInfo.relatedCustomers.[].name	String	名称（中文）
carrierInfo.relatedCustomers.[].nameEn	String	名称（英文）
carrierInfo.unitId	String	往来单位唯一ID，主键
carrierInfo.name	String	名称（中文）
carrierInfo.nameEn	String	名称（英文）
week	String	业务周次（如 2026-WK10）
voyageId	String	航次id
voyageNo	String	航次号 (如: 045W)
vessel	String	船名（英文船名，物理船舶 itemId）
etd	String	开船日期(UTC)
eta	String	预计到港时间 (UTC)
cyCutoff	String	截港时间 (UTC)
siCutoff	String	SI截单时间(UTC)
cutoffTime	String	截单时间(UTC)
vgmCutoffTime	String	VGM 截单时间(UTC)
inventoryDetail	Object	箱型明细（按来源批次细分）
inventoryDetail.type	String	箱型类型
inventoryDetail.name	String	箱型名称
inventoryDetail.nameEn	String	箱型英文名称
inventoryDetail.remaining	Number	剩余数量
inventoryDetail.allocated	Number	已分配数量
inventoryDetail.remainingRealSpace	Number	剩余可用现舱数
inventoryDetail.allocatedRealSpace	Number	本单已确认分配的现舱数
inventoryDetail.itemType	String	分配类型 (FORECAST_INVENTORY / INVENTORY) FORECAST_INVENTORY - 来源于预报单的库存 INVENTORY - 库存 PEER - 同行舱位（仅保存于业务单据，不进入系统库存）
inventoryDetail.forecastId	String	预报单 ID
inventoryDetail.salesInfo	Object	销售信息
inventoryDetail.salesInfo.username	String	用户标识
inventoryDetail.salesInfo.name	String	用户名称
inventoryDetail.salesInfo.nameEn	String	英文称呼，用于外部联系人的英文通知；缺失时不自动翻译姓名。
inventoryDetail.salesInfo.mobile	String	用户手机号
inventoryDetail.salesInfo.email	String	用户邮箱
inventoryDetail.salesInfo.position	String	职位
inventoryDetail.salesInfo.contactRoles	String[]	联系人承担的职责，支持多选；未指定时为空集合 PRIMARY - 主联系人，承担往来单位的主要业务对接职责。 EMAIL_NOTIFICATION - 邮件通知人，作为业务邮件通知的联系对象。 BILLING - 账单联系人，承担账单接收和账务沟通职责。
inventoryDetail.quantity	Number	额度原始总库存数量

下载结果模型定义