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" : "费用筛选条件"
}
});
请求参数
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
search | Object | 否 | 费用筛选条件 |
search.jobId | String | 否 | 工作单 ID |
search.sourceIds | String[] | 否 | 费用来源ID集合 |
search.sourceTypes | String[] | 否 | 费用来源类型集合(单据实体类名,如:JobOrder, TruckingEntrustOrder, BillLading, CustomsDeclarationOrder) |
search.chargeCodeId | String | 否 | 费用科目 ID(对应 fee.chargeCode.chargeCodeId) |
search.flow | String | 否 | 费用流向 |
search.settlementUnitId | String | 否 | 结算对象往来单位 ID(对应 fee.settlement.unit) |
search.auditPassed | Boolean | 否 | 审核是否通过。 传值时返回审核字段等于该值,或未带审核字段的历史费用。 |
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 |
返回
费用明细
[ ]
返回 属性
| 名称 | 类型 | 说明 |
|---|---|---|
feeId | String | CS 生成的稳定费用身份。 |
finEntryId | String | 账单确认后由服务端回写的 Fin 账目号;已入账费用不能通过普通编辑修改。 |
chargeCode | Object | 费用科目 |
chargeCode.code | String | 业务科目号(主键) |
chargeCode.name | String | 科目中文名称 |
chargeCode.nameEn | String | 科目英文文名称 |
billingUnit | String | 计费单位(基础数据id) |
billingUnitInfo | Object | 计费单位信息 |
billingUnitInfo.itemId | String | 数据项唯一标识 |
billingUnitInfo.name | String | 数据项名称(中文) |
billingUnitInfo.nameEn | String | 数据项名称(英文) |
billingUnitInfo.extendedProperties | Object | 扩展属性 用于存储一些额外的、非结构化的数据 |
containerType | String | 柜型 |
currency | String | 币种 |
unitPrice | Number | 成本单价 |
internalPrice | Number | 内部结算价 |
quantity | Number | 获取计费数量,兼容历史数据及请求中缺失或显式为空的数量。 |
amount | Number | 金额 |
occurAt | String | 费用发生时间 |
defaultTaxRate | Number | 默认税率(如 0.06 / 0.09 / 0),录费时可带出 |
flow | String | 费用流向 |
stage | String | 获取费用入账阶段,历史数据未指定阶段时按实际费用处理。 |
settlementMode | String | 结算方式 |
priceType | String | 价格类型 |
settlement | Object | 结算对象 |
settlement.role | String | 角色 |
settlement.unit | String | 往来单位 id(客户/供应商/代理/组织 id) |
settlement.unitInfo | Object | 往来单位信息 |
settlement.unitInfo.country | String | 国家 |
settlement.unitInfo.countryEn | String | 国家(英文) |
settlement.unitInfo.abbreviation | String | 名称缩写 |
settlement.unitInfo.address | String | 地址(中文) |
settlement.unitInfo.addressEn | String | 地址(英文) |
settlement.unitInfo.contactPersons | Object[] | 联系人信息列表,支持多个联系人 |
settlement.unitInfo.contactPersons.[].username | String | 用户标识 |
settlement.unitInfo.contactPersons.[].name | String | 用户名称 |
settlement.unitInfo.contactPersons.[].nameEn | String | 英文称呼,用于外部联系人的英文通知;缺失时不自动翻译姓名。 |
settlement.unitInfo.contactPersons.[].mobile | String | 用户手机号 |
settlement.unitInfo.contactPersons.[].email | String | 用户邮箱 |
settlement.unitInfo.contactPersons.[].position | String | 职位 |
settlement.unitInfo.contactPersons.[].contactRoles | String[] | 联系人承担的职责,支持多选;未指定时为空集合 |
settlement.unitInfo.bankAccounts | Object[] | 银行账户列表,支持多个账户 |
settlement.unitInfo.bankAccounts.[].accountName | String | 开户名称 |
settlement.unitInfo.bankAccounts.[].bankName | String | 银行名称 |
settlement.unitInfo.bankAccounts.[].bankCode | String | 联行号 |
settlement.unitInfo.bankAccounts.[].bankAccount | String | 银行账号 |
settlement.unitInfo.bankAccounts.[].currency | String | 币制 |
settlement.unitInfo.bankAccounts.[].swiftCode | String | SWIFT CODE |
settlement.unitInfo.bankAccounts.[].address | String | 地址 |
settlement.unitInfo.bankAccounts.[].isDefault | Boolean | 是否默认 |
settlement.unitInfo.invoiceInfo | Object | 开票信息 |
settlement.unitInfo.invoiceInfo.companyName | String | 公司名称 |
settlement.unitInfo.invoiceInfo.taxIdentificationNumber | String | 纳税识别号 |
settlement.unitInfo.invoiceInfo.companyAddress | String | 公司地址 |
settlement.unitInfo.invoiceInfo.phone | String | 电话 |
settlement.unitInfo.invoiceInfo.bankAccount | String | 银行账号 |
settlement.unitInfo.invoiceInfo.contact | String | 联系人 |
settlement.unitInfo.invoiceInfo.email | String | 邮箱 |
settlement.unitInfo.extraProps | Object | 扩展信息 |
settlement.unitInfo.relatedCustomers | Object[] | 关联客户列表 |
settlement.unitInfo.relatedCustomers.[].tags | String[] | 该客户赋予当前往来单位的角色标签列表(如 shipper, consignee, importBuyer 等) |
settlement.unitInfo.relatedCustomers.[].extraProps | Object | 专属定制扩展属性 (Key 为 tag 比如 "shipper", Value 为特定定制的 Unit 实例) |
settlement.unitInfo.relatedCustomers.[].unitId | String | 往来单位唯一ID,主键 |
settlement.unitInfo.relatedCustomers.[].name | String | 名称(中文) |
settlement.unitInfo.relatedCustomers.[].nameEn | String | 名称(英文) |
settlement.unitInfo.unitId | String | 往来单位唯一ID,主键 |
settlement.unitInfo.name | String | 名称(中文) |
settlement.unitInfo.nameEn | String | 名称(英文) |
source | Object | 费用来源 |
source.type | String | 来源类型(单据实体类名,如:JobOrder, TruckingEntrustOrder, BillLading, CustomsDeclarationOrder 等) |
source.id | String | 来源数据 ID (主键/数据库ID) |
source.feeId | String | 来源费用 ID(仅 splitFromSource 使用:拆分来源母单费用的 feeId) |
splitFromSource | Object | 拆分来源费用所属单据。 仅拆单子 HBL 中与源 HBL 同费用科目的费用使用,由后端根据提单拆分关系自动维护; |
splitFromSource.type | String | 来源类型(单据实体类名,如:JobOrder, TruckingEntrustOrder, BillLading, CustomsDeclarationOrder 等) |
splitFromSource.id | String | 来源数据 ID (主键/数据库ID) |
splitFromSource.feeId | String | 来源费用 ID(仅 splitFromSource 使用:拆分来源母单费用的 feeId) |
auditPassed | Boolean | 审核是否通过 仅司机任务来源费用使用(DriverTask) |
freightTerms | String | 运费条款(基础数据id) |
freightTermsInfo | Object | 运费条款信息 |
freightTermsInfo.itemId | String | 数据项唯一标识 |
freightTermsInfo.name | String | 数据项名称(中文) |
freightTermsInfo.nameEn | String | 数据项名称(英文) |
freightTermsInfo.extendedProperties | Object | 扩展属性 用于存储一些额外的、非结构化的数据 |
attachments | Object[] | 附件列表 |
attachments.[].title | String | 附件标题 |
attachments.[].description | String | 附件说明 |
attachments.[].binaryId | String[] | 附件id |
reviewRequired | Boolean | 是否需要审核 |