跳到主要内容

cs.import-job-orders.list-fees

查询外层费用及指定拖车来源费用。

  • 请求路由: cs.import-job-orders.list-fees
  • 交互模型: Request Stream
  • 访问限制: 无

请求​

RSocket.rs({
"route" : "cs.import-job-orders.list-fees",
"args" : {
"search" : "费用筛选条件"
}
});

请求参数​

名称类型必须说明
searchObject否费用筛选条件
search.jobIdString否工作单 ID
search.sourceIdsString[]否费用来源ID集合
search.sourceTypesString[]否费用来源类型集合(单据实体类名,如:JobOrder, TruckingEntrustOrder, BillLading, CustomsDeclarationOrder)
search.chargeCodeIdString否费用科目 ID(对应 fee.chargeCode.chargeCodeId)
search.flowString否费用流向
  • AR - 应收
  • AP - 应付
  • search.settlementUnitIdString否结算对象往来单位 ID(对应 fee.settlement.unit)
    search.auditPassedBoolean否审核是否通过。

    传值时返回审核字段等于该值,或未带审核字段的历史费用。

    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

    返回​

    费用明细

    [ ]

    返回属性​

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

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

    splitFromSource.typeString来源类型(单据实体类名,如:JobOrder, TruckingEntrustOrder, BillLading, CustomsDeclarationOrder 等)
    splitFromSource.idString来源数据 ID (主键/数据库ID)
    splitFromSource.feeIdString来源费用 ID(仅 splitFromSource 使用:拆分来源母单费用的 feeId)
    auditPassedBoolean审核是否通过
    仅司机任务来源费用使用(DriverTask)
    freightTermsString运费条款(基础数据id)
    freightTermsInfoObject运费条款信息
    freightTermsInfo.itemIdString数据项唯一标识
    freightTermsInfo.nameString数据项名称(中文)
    freightTermsInfo.nameEnString数据项名称(英文)
    freightTermsInfo.extendedPropertiesObject扩展属性
    用于存储一些额外的、非结构化的数据
    attachmentsObject[]附件列表
    attachments.[].titleString附件标题
    attachments.[].descriptionString附件说明
    attachments.[].binaryIdString[]附件id
    reviewRequiredBoolean是否需要审核

    下载结果模型定义