跳到主要内容

cs.crm.trucking.entrusts.list

分页查询委托单列表

  • 请求路由: cs.crm.trucking.entrusts.list
  • 交互模型: Request Stream
  • 访问限制: 无

请求​

RSocket.rs({
  "route" : "cs.crm.trucking.entrusts.list",
  "args" : {
    "search" : "搜索参数",
    "pg" : "分页参数"
  }
});

请求参数​

名称类型必须说明
searchObject否搜索参数
search.jobIdString否工作单号
search.soNoString否SO单号
search.statusString否委托状态
  • PENDING - 待确认
  • CONFIRMED - 已确认
  • IN_PROGRESS - 执行中
  • COMPLETED - 已完成
  • CANCELLED - 已取消
    • search.businessTypeString否业务类型
  • EXPORT - 出口
  • IMPORT - 进口
    • search.truckingCompanyIdString否拖车行ID
    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"]

    返回​

    委托单列表

    [ ]

    返回属性​

    名称类型说明
    entrustIdString委托单号
    jobIdString工作单号
    soNoStringSO单号
    businessTypeString业务类型
  • EXPORT - 出口
  • IMPORT - 进口
    • statusString委托状态
  • PENDING - 待确认
  • CONFIRMED - 已确认
  • IN_PROGRESS - 执行中
  • COMPLETED - 已完成
  • CANCELLED - 已取消
    • creatorObject创建者
    creator.usernameString用户标识
    creator.nameString用户名称
    creator.nameEnString英文称呼，用于外部联系人的英文通知；缺失时不自动翻译姓名。
    creator.mobileString用户手机号
    creator.emailString用户邮箱
    creator.positionString职位
    creator.contactRolesString[]联系人承担的职责，支持多选；未指定时为空集合
  • PRIMARY - 主联系人，承担往来单位的主要业务对接职责。
  • EMAIL_NOTIFICATION - 邮件通知人，作为业务邮件通知的联系对象。
  • BILLING - 账单联系人，承担账单接收和账务沟通职责。
    • truckingCompanyIdString拖车行（往来单位id）
    truckingCompanyObject拖车行（往来单位）
    truckingCompany.countryString国家
    truckingCompany.countryEnString国家(英文)
    truckingCompany.abbreviationString名称缩写
    truckingCompany.addressString地址（中文）
    truckingCompany.addressEnString地址（英文）
    truckingCompany.contactPersonsObject[]联系人信息列表，支持多个联系人
    truckingCompany.contactPersons.[].usernameString用户标识
    truckingCompany.contactPersons.[].nameString用户名称
    truckingCompany.contactPersons.[].nameEnString英文称呼，用于外部联系人的英文通知；缺失时不自动翻译姓名。
    truckingCompany.contactPersons.[].mobileString用户手机号
    truckingCompany.contactPersons.[].emailString用户邮箱
    truckingCompany.contactPersons.[].positionString职位
    truckingCompany.contactPersons.[].contactRolesString[]联系人承担的职责，支持多选；未指定时为空集合
  • PRIMARY - 主联系人，承担往来单位的主要业务对接职责。
  • EMAIL_NOTIFICATION - 邮件通知人，作为业务邮件通知的联系对象。
  • BILLING - 账单联系人，承担账单接收和账务沟通职责。
    • truckingCompany.bankAccountsObject[]银行账户列表，支持多个账户
    truckingCompany.bankAccounts.[].accountNameString开户名称
    truckingCompany.bankAccounts.[].bankNameString银行名称
    truckingCompany.bankAccounts.[].bankCodeString联行号
    truckingCompany.bankAccounts.[].bankAccountString银行账号
    truckingCompany.bankAccounts.[].currencyString币制
  • CNY - 人民币
  • USD - 美元
  • EUR - 欧元
  • HKD - 港币
  • JPY - 日元
  • GBP - 英镑
  • AUD - 澳大利亚元
  • CAD - 加拿大元
  • SGD - 新加坡元
  • KRW - 韩元
  • DKK - 丹麦克朗
  • NOK - 挪威克朗
  • SEK - 瑞典克朗
  • name - 获取币种名称
  • symbol - 获取币种符号
  • code - 返回币种代码
    • truckingCompany.bankAccounts.[].swiftCodeStringSWIFT CODE
    truckingCompany.bankAccounts.[].addressString地址
    truckingCompany.bankAccounts.[].isDefaultBoolean是否默认
    truckingCompany.invoiceInfoObject开票信息
    truckingCompany.invoiceInfo.companyNameString公司名称
    truckingCompany.invoiceInfo.taxIdentificationNumberString纳税识别号
    truckingCompany.invoiceInfo.companyAddressString公司地址
    truckingCompany.invoiceInfo.phoneString电话
    truckingCompany.invoiceInfo.bankAccountString银行账号
    truckingCompany.invoiceInfo.contactString联系人
    truckingCompany.invoiceInfo.emailString邮箱
    truckingCompany.extraPropsObject扩展信息
    truckingCompany.relatedCustomersObject[]关联客户列表
    truckingCompany.relatedCustomers.[].tagsString[]该客户赋予当前往来单位的角色标签列表（如 shipper, consignee, importBuyer 等）
    truckingCompany.relatedCustomers.[].extraPropsObject专属定制扩展属性 (Key 为 tag 比如 "shipper", Value 为特定定制的 Unit 实例)
    truckingCompany.relatedCustomers.[].unitIdString往来单位唯一ID，主键
    truckingCompany.relatedCustomers.[].nameString名称（中文）
    truckingCompany.relatedCustomers.[].nameEnString名称（英文）
    truckingCompany.unitIdString往来单位唯一ID，主键
    truckingCompany.nameString名称（中文）
    truckingCompany.nameEnString名称（英文）
    etdString开船时间
    closingTimeString截关时间
    freeStorageNumber免堆期
    freeDetentionNumber免箱期
    pickupPointString提柜点（往来单位id）
    pickupPointInfoObject提柜点信息
    pickupPointInfo.countryString国家
    pickupPointInfo.countryEnString国家(英文)
    pickupPointInfo.abbreviationString名称缩写
    pickupPointInfo.addressString地址（中文）
    pickupPointInfo.addressEnString地址（英文）
    pickupPointInfo.contactPersonsObject[]联系人信息列表，支持多个联系人
    pickupPointInfo.contactPersons.[].usernameString用户标识
    pickupPointInfo.contactPersons.[].nameString用户名称
    pickupPointInfo.contactPersons.[].nameEnString英文称呼，用于外部联系人的英文通知；缺失时不自动翻译姓名。
    pickupPointInfo.contactPersons.[].mobileString用户手机号
    pickupPointInfo.contactPersons.[].emailString用户邮箱
    pickupPointInfo.contactPersons.[].positionString职位
    pickupPointInfo.contactPersons.[].contactRolesString[]联系人承担的职责，支持多选；未指定时为空集合
  • PRIMARY - 主联系人，承担往来单位的主要业务对接职责。
  • EMAIL_NOTIFICATION - 邮件通知人，作为业务邮件通知的联系对象。
  • BILLING - 账单联系人，承担账单接收和账务沟通职责。
    • pickupPointInfo.bankAccountsObject[]银行账户列表，支持多个账户
    pickupPointInfo.bankAccounts.[].accountNameString开户名称
    pickupPointInfo.bankAccounts.[].bankNameString银行名称
    pickupPointInfo.bankAccounts.[].bankCodeString联行号
    pickupPointInfo.bankAccounts.[].bankAccountString银行账号
    pickupPointInfo.bankAccounts.[].currencyString币制
  • CNY - 人民币
  • USD - 美元
  • EUR - 欧元
  • HKD - 港币
  • JPY - 日元
  • GBP - 英镑
  • AUD - 澳大利亚元
  • CAD - 加拿大元
  • SGD - 新加坡元
  • KRW - 韩元
  • DKK - 丹麦克朗
  • NOK - 挪威克朗
  • SEK - 瑞典克朗
  • name - 获取币种名称
  • symbol - 获取币种符号
  • code - 返回币种代码
    • pickupPointInfo.bankAccounts.[].swiftCodeStringSWIFT CODE
    pickupPointInfo.bankAccounts.[].addressString地址
    pickupPointInfo.bankAccounts.[].isDefaultBoolean是否默认
    pickupPointInfo.invoiceInfoObject开票信息
    pickupPointInfo.invoiceInfo.companyNameString公司名称
    pickupPointInfo.invoiceInfo.taxIdentificationNumberString纳税识别号
    pickupPointInfo.invoiceInfo.companyAddressString公司地址
    pickupPointInfo.invoiceInfo.phoneString电话
    pickupPointInfo.invoiceInfo.bankAccountString银行账号
    pickupPointInfo.invoiceInfo.contactString联系人
    pickupPointInfo.invoiceInfo.emailString邮箱
    pickupPointInfo.extraPropsObject扩展信息
    pickupPointInfo.relatedCustomersObject[]关联客户列表
    pickupPointInfo.relatedCustomers.[].tagsString[]该客户赋予当前往来单位的角色标签列表（如 shipper, consignee, importBuyer 等）
    pickupPointInfo.relatedCustomers.[].extraPropsObject专属定制扩展属性 (Key 为 tag 比如 "shipper", Value 为特定定制的 Unit 实例)
    pickupPointInfo.relatedCustomers.[].unitIdString往来单位唯一ID，主键
    pickupPointInfo.relatedCustomers.[].nameString名称（中文）
    pickupPointInfo.relatedCustomers.[].nameEnString名称（英文）
    pickupPointInfo.unitIdString往来单位唯一ID，主键
    pickupPointInfo.nameString名称（中文）
    pickupPointInfo.nameEnString名称（英文）
    returnTerminalString还柜码头（往来单位id）
    returnTerminalInfoObject还柜码头信息
    returnTerminalInfo.countryString国家
    returnTerminalInfo.countryEnString国家(英文)
    returnTerminalInfo.abbreviationString名称缩写
    returnTerminalInfo.addressString地址（中文）
    returnTerminalInfo.addressEnString地址（英文）
    returnTerminalInfo.contactPersonsObject[]联系人信息列表，支持多个联系人
    returnTerminalInfo.contactPersons.[].usernameString用户标识
    returnTerminalInfo.contactPersons.[].nameString用户名称
    returnTerminalInfo.contactPersons.[].nameEnString英文称呼，用于外部联系人的英文通知；缺失时不自动翻译姓名。
    returnTerminalInfo.contactPersons.[].mobileString用户手机号
    returnTerminalInfo.contactPersons.[].emailString用户邮箱
    returnTerminalInfo.contactPersons.[].positionString职位
    returnTerminalInfo.contactPersons.[].contactRolesString[]联系人承担的职责，支持多选；未指定时为空集合
  • PRIMARY - 主联系人，承担往来单位的主要业务对接职责。
  • EMAIL_NOTIFICATION - 邮件通知人，作为业务邮件通知的联系对象。
  • BILLING - 账单联系人，承担账单接收和账务沟通职责。
    • returnTerminalInfo.bankAccountsObject[]银行账户列表，支持多个账户
    returnTerminalInfo.bankAccounts.[].accountNameString开户名称
    returnTerminalInfo.bankAccounts.[].bankNameString银行名称
    returnTerminalInfo.bankAccounts.[].bankCodeString联行号
    returnTerminalInfo.bankAccounts.[].bankAccountString银行账号
    returnTerminalInfo.bankAccounts.[].currencyString币制
  • CNY - 人民币
  • USD - 美元
  • EUR - 欧元
  • HKD - 港币
  • JPY - 日元
  • GBP - 英镑
  • AUD - 澳大利亚元
  • CAD - 加拿大元
  • SGD - 新加坡元
  • KRW - 韩元
  • DKK - 丹麦克朗
  • NOK - 挪威克朗
  • SEK - 瑞典克朗
  • name - 获取币种名称
  • symbol - 获取币种符号
  • code - 返回币种代码
    • returnTerminalInfo.bankAccounts.[].swiftCodeStringSWIFT CODE
    returnTerminalInfo.bankAccounts.[].addressString地址
    returnTerminalInfo.bankAccounts.[].isDefaultBoolean是否默认
    returnTerminalInfo.invoiceInfoObject开票信息
    returnTerminalInfo.invoiceInfo.companyNameString公司名称
    returnTerminalInfo.invoiceInfo.taxIdentificationNumberString纳税识别号
    returnTerminalInfo.invoiceInfo.companyAddressString公司地址
    returnTerminalInfo.invoiceInfo.phoneString电话
    returnTerminalInfo.invoiceInfo.bankAccountString银行账号
    returnTerminalInfo.invoiceInfo.contactString联系人
    returnTerminalInfo.invoiceInfo.emailString邮箱
    returnTerminalInfo.extraPropsObject扩展信息
    returnTerminalInfo.relatedCustomersObject[]关联客户列表
    returnTerminalInfo.relatedCustomers.[].tagsString[]该客户赋予当前往来单位的角色标签列表（如 shipper, consignee, importBuyer 等）
    returnTerminalInfo.relatedCustomers.[].extraPropsObject专属定制扩展属性 (Key 为 tag 比如 "shipper", Value 为特定定制的 Unit 实例)
    returnTerminalInfo.relatedCustomers.[].unitIdString往来单位唯一ID，主键
    returnTerminalInfo.relatedCustomers.[].nameString名称（中文）
    returnTerminalInfo.relatedCustomers.[].nameEnString名称（英文）
    returnTerminalInfo.unitIdString往来单位唯一ID，主键
    returnTerminalInfo.nameString名称（中文）
    returnTerminalInfo.nameEnString名称（英文）
    entrustContainersObject[]委托箱量（按柜型汇总）
    entrustContainers.[].typeString箱型类型
    entrustContainers.[].nameString箱型名称
    entrustContainers.[].nameEnString箱型英文名称
    entrustContainers.[].countNumber数量
    entrustContainers.[].containerNosString[]当前箱型明细包含的柜号；未指定具体集装箱的出口业务可不填写。
    specialRequirementsString特殊要求
    remarksString备注
    attachmentsObject[]SO相关附件列表
    attachments.[].titleString附件标题
    attachments.[].descriptionString附件说明
    attachments.[].binaryIdString[]附件id
    feesObject[]创建时补充的费用明细
    fees.[].feeIdStringCS 生成的稳定费用身份。
    fees.[].finEntryIdString账单确认后由服务端回写的 Fin 账目号；已入账费用不能通过普通编辑修改。
    fees.[].chargeCodeObject费用科目
    fees.[].chargeCode.codeString业务科目号（主键）
    fees.[].chargeCode.nameString科目中文名称
    fees.[].chargeCode.nameEnString科目英文文名称
    fees.[].billingUnitString计费单位(基础数据id)
    fees.[].billingUnitInfoObject计费单位信息
    fees.[].billingUnitInfo.itemIdString数据项唯一标识
    fees.[].billingUnitInfo.nameString数据项名称（中文）
    fees.[].billingUnitInfo.nameEnString数据项名称（英文）
    fees.[].billingUnitInfo.extendedPropertiesObject扩展属性
    用于存储一些额外的、非结构化的数据
    fees.[].containerTypeString柜型
    fees.[].currencyString币种
  • CNY - 人民币
  • USD - 美元
  • EUR - 欧元
  • HKD - 港币
  • JPY - 日元
  • GBP - 英镑
  • AUD - 澳大利亚元
  • CAD - 加拿大元
  • SGD - 新加坡元
  • KRW - 韩元
  • DKK - 丹麦克朗
  • NOK - 挪威克朗
  • SEK - 瑞典克朗
  • name - 获取币种名称
  • symbol - 获取币种符号
  • code - 返回币种代码
    • fees.[].unitPriceNumber成本单价
    fees.[].internalPriceNumber内部结算价
    fees.[].quantityNumber获取计费数量，兼容历史数据及请求中缺失或显式为空的数量。
    fees.[].amountNumber金额
    fees.[].occurAtString费用发生时间
    fees.[].defaultTaxRateNumber默认税率（如 0.06 / 0.09 / 0），录费时可带出
    fees.[].flowString费用流向
  • AR - 应收
  • AP - 应付
    • fees.[].stageString获取费用入账阶段，历史数据未指定阶段时按实际费用处理。
  • EST - 预估
  • ACTUAL - 实际
    • fees.[].settlementModeString结算方式
  • SPOT - 票结/见款放单（账期 0 天）
  • MONTHLY - 月结
  • CUSTOM - 自定义账期
    • fees.[].priceTypeString价格类型
  • TAX_INCLUSIVE - 含税：amount 为价税合计，税额从中拆出
  • TAX_EXCLUSIVE - 不含税：amount 为不含税净额，税额在其上，归一化后 amount 提升为含税合计
  • NON_TAXABLE - 不征税：免税 / 代收代付，无税额
    • fees.[].settlementObject结算对象
    fees.[].settlement.roleString角色
  • CUSTOMER - 客户（直客/收货人）
  • SUPPLIER - 供应商（船东/拖车行/报关行/仓库等）
  • AGENT - 海外代理
  • ORG - 内部组织（口岸/部门）
    • fees.[].settlement.unitString往来单位 id（客户/供应商/代理/组织 id）
    fees.[].settlement.unitInfoObject往来单位信息
    fees.[].settlement.unitInfo.countryString国家
    fees.[].settlement.unitInfo.countryEnString国家(英文)
    fees.[].settlement.unitInfo.abbreviationString名称缩写
    fees.[].settlement.unitInfo.addressString地址（中文）
    fees.[].settlement.unitInfo.addressEnString地址（英文）
    fees.[].settlement.unitInfo.contactPersonsObject[]联系人信息列表，支持多个联系人
    fees.[].settlement.unitInfo.contactPersons.[].usernameString用户标识
    fees.[].settlement.unitInfo.contactPersons.[].nameString用户名称
    fees.[].settlement.unitInfo.contactPersons.[].nameEnString英文称呼，用于外部联系人的英文通知；缺失时不自动翻译姓名。
    fees.[].settlement.unitInfo.contactPersons.[].mobileString用户手机号
    fees.[].settlement.unitInfo.contactPersons.[].emailString用户邮箱
    fees.[].settlement.unitInfo.contactPersons.[].positionString职位
    fees.[].settlement.unitInfo.contactPersons.[].contactRolesString[]联系人承担的职责，支持多选；未指定时为空集合
  • PRIMARY - 主联系人，承担往来单位的主要业务对接职责。
  • EMAIL_NOTIFICATION - 邮件通知人，作为业务邮件通知的联系对象。
  • BILLING - 账单联系人，承担账单接收和账务沟通职责。
    • fees.[].settlement.unitInfo.bankAccountsObject[]银行账户列表，支持多个账户
    fees.[].settlement.unitInfo.bankAccounts.[].accountNameString开户名称
    fees.[].settlement.unitInfo.bankAccounts.[].bankNameString银行名称
    fees.[].settlement.unitInfo.bankAccounts.[].bankCodeString联行号
    fees.[].settlement.unitInfo.bankAccounts.[].bankAccountString银行账号
    fees.[].settlement.unitInfo.bankAccounts.[].currencyString币制
  • CNY - 人民币
  • USD - 美元
  • EUR - 欧元
  • HKD - 港币
  • JPY - 日元
  • GBP - 英镑
  • AUD - 澳大利亚元
  • CAD - 加拿大元
  • SGD - 新加坡元
  • KRW - 韩元
  • DKK - 丹麦克朗
  • NOK - 挪威克朗
  • SEK - 瑞典克朗
  • name - 获取币种名称
  • symbol - 获取币种符号
  • code - 返回币种代码
    • fees.[].settlement.unitInfo.bankAccounts.[].swiftCodeStringSWIFT CODE
    fees.[].settlement.unitInfo.bankAccounts.[].addressString地址
    fees.[].settlement.unitInfo.bankAccounts.[].isDefaultBoolean是否默认
    fees.[].settlement.unitInfo.invoiceInfoObject开票信息
    fees.[].settlement.unitInfo.invoiceInfo.companyNameString公司名称
    fees.[].settlement.unitInfo.invoiceInfo.taxIdentificationNumberString纳税识别号
    fees.[].settlement.unitInfo.invoiceInfo.companyAddressString公司地址
    fees.[].settlement.unitInfo.invoiceInfo.phoneString电话
    fees.[].settlement.unitInfo.invoiceInfo.bankAccountString银行账号
    fees.[].settlement.unitInfo.invoiceInfo.contactString联系人
    fees.[].settlement.unitInfo.invoiceInfo.emailString邮箱
    fees.[].settlement.unitInfo.extraPropsObject扩展信息
    fees.[].settlement.unitInfo.relatedCustomersObject[]关联客户列表
    fees.[].settlement.unitInfo.relatedCustomers.[].tagsString[]该客户赋予当前往来单位的角色标签列表（如 shipper, consignee, importBuyer 等）
    fees.[].settlement.unitInfo.relatedCustomers.[].extraPropsObject专属定制扩展属性 (Key 为 tag 比如 "shipper", Value 为特定定制的 Unit 实例)
    fees.[].settlement.unitInfo.relatedCustomers.[].unitIdString往来单位唯一ID，主键
    fees.[].settlement.unitInfo.relatedCustomers.[].nameString名称（中文）
    fees.[].settlement.unitInfo.relatedCustomers.[].nameEnString名称（英文）
    fees.[].settlement.unitInfo.unitIdString往来单位唯一ID，主键
    fees.[].settlement.unitInfo.nameString名称（中文）
    fees.[].settlement.unitInfo.nameEnString名称（英文）
    fees.[].sourceObject费用来源
    fees.[].source.typeString来源类型（单据实体类名，如：JobOrder, TruckingEntrustOrder, BillLading, CustomsDeclarationOrder 等）
    fees.[].source.idString来源数据 ID (主键/数据库ID)
    fees.[].source.feeIdString来源费用 ID（仅 splitFromSource 使用：拆分来源母单费用的 feeId）
    fees.[].splitFromSourceObject拆分来源费用所属单据。

    仅拆单子 HBL 中与源 HBL 同费用科目的费用使用，由后端根据提单拆分关系自动维护；
    为空表示该费用不是从源 HBL 费用额度中拆分。

    fees.[].splitFromSource.typeString来源类型（单据实体类名，如：JobOrder, TruckingEntrustOrder, BillLading, CustomsDeclarationOrder 等）
    fees.[].splitFromSource.idString来源数据 ID (主键/数据库ID)
    fees.[].splitFromSource.feeIdString来源费用 ID（仅 splitFromSource 使用：拆分来源母单费用的 feeId）
    fees.[].auditPassedBoolean审核是否通过
    仅司机任务来源费用使用(DriverTask)
    fees.[].freightTermsString运费条款(基础数据id)
    fees.[].freightTermsInfoObject运费条款信息
    fees.[].freightTermsInfo.itemIdString数据项唯一标识
    fees.[].freightTermsInfo.nameString数据项名称（中文）
    fees.[].freightTermsInfo.nameEnString数据项名称（英文）
    fees.[].freightTermsInfo.extendedPropertiesObject扩展属性
    用于存储一些额外的、非结构化的数据
    fees.[].attachmentsObject[]附件列表
    fees.[].attachments.[].titleString附件标题
    fees.[].attachments.[].descriptionString附件说明
    fees.[].attachments.[].binaryIdString[]附件id
    fees.[].reviewRequiredBoolean是否需要审核
    legalEntityIdString法人主体id
    customerIdString客户id
    extraPropsObject扩展属性
    crByString创建者
    upByString最后修改者
    crDateString创建时间
    upDateString最后修改时间
    tenantIdString租户ID
    idVaries

    下载结果模型定义