cs.job-orders.update-fee
修改费用明细
- 请求路由:
cs.job-orders.update-fee- 交互模型:
Request Response- 访问限制: 无
支持全量覆盖修改,或通过指定 sourceId / sourceType 进行局部按来源修改
请求
RSocket.rr({
"route" : "cs.job-orders.update-fee",
"data" : {
"replaceMe" : "修改工作单费用请求信息"
}
});
请求参数
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
jobId | String | 否 | 工作单 ID (必填) |
sourceId | String | 否 | 目标费用来源 ID (可选。若指定,则仅更新/替换该 sourceId 对应的费用明细;若为空且 sourceType 亦为空,则全量覆盖更新) |
sourceType | String | 否 | 目标费用来源类型 (可选。如:JobOrder, TruckingEntrustOrder, BillLading, CustomsDeclarationOrder。若指定,则仅更新/替换该 sourceType 对应的费用明细) |
fees | Object[] | 否 | 更新后的费用列表 (必填) -未指定来源时表示工作单最终全量费用; -指定来源时表示该来源范围更新后的完整费用列表, -空列表表示删除该来源范围全部费用。 |
fees.[].feeId | String | 否 | CS 生成的稳定费用身份。 |
fees.[].finEntryId | String | 否 | 账单确认后由服务端回写的 Fin 账目号;已入账费用不能通过普通编辑修改。 |
fees.[].chargeCode | Object | 否 | 费用科目 |
fees.[].chargeCode.code | String | 否 | 业务科目号(主键 ) |
fees.[].chargeCode.name | String | 否 | 科目中文名称 |
fees.[].chargeCode.nameEn | String | 否 | 科目英文文名称 |
fees.[].billingUnit | String | 否 | 计费单位(基础数据id) |
fees.[].containerType | String | 否 | 柜型 |
fees.[].currency | String | 否 | 币种 |
fees.[].unitPrice | Number | 否 | 成本单价 |
fees.[].internalPrice | Number | 否 | 内部结算价 |
fees.[].quantity | Number | 否 | 获取计费数量,兼容历史数据及请求中缺失或显式为空的数量。 |
fees.[].amount | Number | 否 | 金额 |
fees.[].occurAt | String | 否 | 费用发生时间 |
fees.[].defaultTaxRate | Number | 否 | 默认税率(如 0.06 / 0.09 / 0),录费时可带出 |
fees.[].flow | String | 否 | 费用流向 |
fees.[].stage | String | 否 | 获取费用入账阶段,历史数据未指定阶段时按实际费用处理。 |
fees.[].settlementMode | String | 否 | 结算方式 |
fees.[].priceType | String | 否 | 价格类型 |
fees.[].settlement | Object | 否 | 结算对象 |
fees.[].settlement.role | String | 否 | 角色 |
fees.[].settlement.unit | String | 否 | 往来单位 id(客户/供应商/代理/组织 id) |
fees.[].source | Object | 否 | 费用来源 |
fees.[].source.type | String | 否 | 来源类型(单据实体类名,如:JobOrder, TruckingEntrustOrder, BillLading, CustomsDeclarationOrder 等) |
fees.[].source.id | String | 否 | 来源数据 ID (主键/数据库ID) |
fees.[].source.feeId | String | 否 | 来源费用 ID(仅 splitFromSource 使用:拆分来源母单费用的 feeId) |
fees.[].splitFromSource | Object | 否 | 拆分来源费用所属单据。 仅拆单子 HBL 中与源 HBL 同费用科目的费用使用,由后端根据提单拆分关系自动维护; |
fees.[].splitFromSource.type | String | 否 | 来源类型(单据实体类名,如:JobOrder, TruckingEntrustOrder, BillLading, CustomsDeclarationOrder 等) |
fees.[].splitFromSource.id | String | 否 | 来源数据 ID (主键/数据库ID) |
fees.[].splitFromSource.feeId | String | 否 | 来源费用 ID(仅 splitFromSource 使用:拆分来源母单费用的 feeId) |
fees.[].auditPassed | Boolean | 否 | 审核是否通过 仅司机任务来源费用使用(DriverTask) |
fees.[].freightTerms | String | 否 | 运费条款(基础数据id) |
fees.[].attachments | Object[] | 否 | 附件列表 |
fees.[].attachments.[].title | String | 否 | 附件标题 |
fees.[].attachments.[].description | String | 否 | 附件说明 |
fees.[].attachments.[].binaryId | String[] | 否 | 附件id |
fees.[].reviewRequired | Boolean | 否 | 是否需要审核 |
返回
更新后的工作单对象
{ }
返回属性
| 名称 | 类型 | 说明 |
|---|---|---|
jobId | String | 工作单 ID |
finJobId | String | Fin 资金档 ID,由首次账单确认回写 |
shipmentType | String | 业务类型 (整箱/拼箱) |
approvers | Object[] | 商务审核候选列表及最后一次认领标记,由流程维护。 |
approvers.[].user | Object | 候选商务的账号及展示资料。 |
approvers.[].user.username | String | 用户标识 |
approvers.[].user.name | String | 用户名称 |
approvers.[].user.nameEn | String | 英文称呼,用于外部联系人的英文通知;缺失时不自动翻译姓名。 |
approvers.[].user.mobile | String | 用户手机号 |
approvers.[].user.email | String | 用户邮箱 |
approvers.[].user.position | String | 职位 |
approvers.[].user.contactRoles | String[] | 联系人承担的职责,支持多选;未指定时为空集合 |
approvers.[].claimed | Boolean | 是否为该审核节点最后一次实际认领人。 |
destinationAgentId | String | 海外代理Id |
destinationAgent | Object | 海外代理(往来单位) |
destinationAgent.country | String | 国家 |
destinationAgent.countryEn | String | 国家(英文) |
destinationAgent.abbreviation | String | 名称缩写 |
destinationAgent.address | String | 地址(中文) |
destinationAgent.addressEn | String | 地址(英文) |
destinationAgent.contactPersons | Object[] | 联系人信息列表,支持多个联系人 |
destinationAgent.contactPersons.[].username | String | 用户标识 |
destinationAgent.contactPersons.[].name | String | 用户名称 |
destinationAgent.contactPersons.[].nameEn | String | 英文称呼,用于外部联系人的英文通知;缺失时不自动翻译姓名。 |
destinationAgent.contactPersons.[].mobile | String | 用户手机号 |
destinationAgent.contactPersons.[].email | String | 用户邮箱 |
destinationAgent.contactPersons.[].position | String | 职位 |
destinationAgent.contactPersons.[].contactRoles | String[] | 联系人承担的职责,支持多选;未指定时为空集合 |
destinationAgent.bankAccounts | Object[] | 银行账户列表,支持多个账户 |
destinationAgent.bankAccounts.[].accountName | String | 开户名称 |
destinationAgent.bankAccounts.[].bankName | String | 银行名称 |
destinationAgent.bankAccounts.[].bankCode | String | 联行号 |
destinationAgent.bankAccounts.[].bankAccount | String | 银行账号 |
destinationAgent.bankAccounts.[].currency | String | 币制 |
destinationAgent.bankAccounts.[].swiftCode | String | SWIFT CODE |
destinationAgent.bankAccounts.[].address | String | 地址 |
destinationAgent.bankAccounts.[].isDefault | Boolean | 是否默认 |
destinationAgent.invoiceInfo | Object | 开票信息 |
destinationAgent.invoiceInfo.companyName | String | 公司名称 |
destinationAgent.invoiceInfo.taxIdentificationNumber | String | 纳税识别号 |
destinationAgent.invoiceInfo.companyAddress | String | 公司地址 |
destinationAgent.invoiceInfo.phone | String | 电话 |
destinationAgent.invoiceInfo.bankAccount | String | 银行账号 |
destinationAgent.invoiceInfo.contact | String | 联系人 |
destinationAgent.invoiceInfo.email | String | 邮箱 |
destinationAgent.extraProps | Object | 扩展信息 |
destinationAgent.relatedCustomers | Object[] | 关联客户列表 |
destinationAgent.relatedCustomers.[].tags | String[] | 该客户赋予当前往来单位的角色标签列表(如 shipper, consignee, importBuyer 等) |
destinationAgent.relatedCustomers.[].extraProps | Object | 专属定制扩展属性 (Key 为 tag 比如 "shipper", Value 为特定定制的 Unit 实例) |
destinationAgent.relatedCustomers.[].unitId | String | 往来单位唯一ID,主键 |
destinationAgent.relatedCustomers.[].name | String | 名称(中文) |
destinationAgent.relatedCustomers.[].nameEn | String | 名称(英文) |
destinationAgent.unitId | String | 往来单位唯一ID,主键 |
destinationAgent.name | String | 名称(中文) |
destinationAgent.nameEn | String | 名称(英文) |
destinationExchangeAgent | String | 海外换单代理 |
destinationExchangeAgentInfo | Object | 海外换单代理 |
destinationExchangeAgentInfo.country | String | 国家 |
destinationExchangeAgentInfo.countryEn | String | 国家(英文) |
destinationExchangeAgentInfo.abbreviation | String | 名称缩写 |
destinationExchangeAgentInfo.address | String | 地址(中文) |
destinationExchangeAgentInfo.addressEn | String | 地址(英文) |
destinationExchangeAgentInfo.contactPersons | Object[] | 联系人信息列表,支持多个联系人 |
destinationExchangeAgentInfo.contactPersons.[].username | String | 用户标识 |
destinationExchangeAgentInfo.contactPersons.[].name | String | 用户名称 |
destinationExchangeAgentInfo.contactPersons.[].nameEn | String | 英文称呼,用于外部联系人的英文通知;缺失时不自动翻译姓名。 |
destinationExchangeAgentInfo.contactPersons.[].mobile | String | 用户手机号 |
destinationExchangeAgentInfo.contactPersons.[].email | String | 用户邮箱 |
destinationExchangeAgentInfo.contactPersons.[].position | String | 职位 |
destinationExchangeAgentInfo.contactPersons.[].contactRoles | String[] | 联系人承担的职责,支持多选;未指定时为空集合 |
destinationExchangeAgentInfo.bankAccounts | Object[] | 银行账户列表,支持多个账户 |
destinationExchangeAgentInfo.bankAccounts.[].accountName | String | 开户名称 |
destinationExchangeAgentInfo.bankAccounts.[].bankName | String | 银行名称 |
destinationExchangeAgentInfo.bankAccounts.[].bankCode | String | 联行号 |
destinationExchangeAgentInfo.bankAccounts.[].bankAccount | String | 银行账号 |
destinationExchangeAgentInfo.bankAccounts.[].currency | String | 币制 |
destinationExchangeAgentInfo.bankAccounts.[].swiftCode | String | SWIFT CODE |
destinationExchangeAgentInfo.bankAccounts.[].address | String | 地址 |
destinationExchangeAgentInfo.bankAccounts.[].isDefault | Boolean | 是否默认 |
destinationExchangeAgentInfo.invoiceInfo | Object | 开票信息 |
destinationExchangeAgentInfo.invoiceInfo.companyName | String | 公司名称 |
destinationExchangeAgentInfo.invoiceInfo.taxIdentificationNumber | String | 纳税识别号 |
destinationExchangeAgentInfo.invoiceInfo.companyAddress | String | 公司地址 |
destinationExchangeAgentInfo.invoiceInfo.phone | String | 电话 |
destinationExchangeAgentInfo.invoiceInfo.bankAccount | String | 银行账号 |
destinationExchangeAgentInfo.invoiceInfo.contact | String | 联系人 |
destinationExchangeAgentInfo.invoiceInfo.email | String | 邮箱 |
destinationExchangeAgentInfo.extraProps | Object | 扩展信息 |
destinationExchangeAgentInfo.relatedCustomers | Object[] | 关联客户列表 |
destinationExchangeAgentInfo.relatedCustomers.[].tags | String[] | 该客户赋予当前往来单位的角色标签列表(如 shipper, consignee, importBuyer 等) |
destinationExchangeAgentInfo.relatedCustomers.[].extraProps | Object | 专属定制扩展属性 (Key 为 tag 比如 "shipper", Value 为特定定制的 Unit 实例) |
destinationExchangeAgentInfo.relatedCustomers.[].unitId | String | 往来单位唯一ID,主键 |
destinationExchangeAgentInfo.relatedCustomers.[].name | String | 名称(中文) |
destinationExchangeAgentInfo.relatedCustomers.[].nameEn | String | 名称(英文) |
destinationExchangeAgentInfo.unitId | String | 往来单位唯一ID,主键 |
destinationExchangeAgentInfo.name | String | 名称(中文) |
destinationExchangeAgentInfo.nameEn | String | 名称(英文) |
blMode | String | 提单操作模式 |
isAMS | Boolean | 是否为反恐舱单 |
isPreAlloc | Boolean | 是否预配舱 单 |
soNos | String[] | SO单号 |
spaceForecastId | String | 预报单id |
status | String | 状态 |
clientId | String | 客户Id |
client | Object | 客户信息(往来单位) |
client.country | String | 国家 |
client.countryEn | String | 国家(英文) |
client.abbreviation | String | 名称缩写 |
client.address | String | 地址(中文) |
client.addressEn | String | 地址(英文) |
client.contactPersons | Object[] | 联系人信息列表,支持多个联系人 |
client.contactPersons.[].username | String | 用户标识 |
client.contactPersons.[].name | String | 用户名称 |
client.contactPersons.[].nameEn | String | 英文称呼,用于外部联系人的英文通知;缺失时不自动翻译姓名。 |
client.contactPersons.[].mobile | String | 用户手机号 |
client.contactPersons.[].email | String | 用户邮箱 |
client.contactPersons.[].position | String | 职位 |
client.contactPersons.[].contactRoles | String[] | 联系人承担的职责,支持多选;未指定时为空集合 |
client.bankAccounts | Object[] | 银行账户列表,支持多个账户 |
client.bankAccounts.[].accountName | String | 开户名称 |
client.bankAccounts.[].bankName | String | 银行名称 |
client.bankAccounts.[].bankCode | String | 联行号 |
client.bankAccounts.[].bankAccount | String | 银行账号 |
client.bankAccounts.[].currency | String | 币制 |
client.bankAccounts.[].swiftCode | String | SWIFT CODE |
client.bankAccounts.[].address | String | 地址 |
client.bankAccounts.[].isDefault | Boolean | 是否默认 |
client.invoiceInfo | Object | 开票信息 |
client.invoiceInfo.companyName | String | 公司名称 |
client.invoiceInfo.taxIdentificationNumber | String | 纳税识别号 |
client.invoiceInfo.companyAddress | String | 公司地址 |
client.invoiceInfo.phone | String | 电话 |
client.invoiceInfo.bankAccount | String | 银行账号 |
client.invoiceInfo.contact | String | 联系人 |
client.invoiceInfo.email | String | 邮箱 |
client.extraProps | Object | 扩展信息 |
client.relatedCustomers | Object[] | 关联客户列表 |
client.relatedCustomers.[].tags | String[] | 该客户赋予当前往来单位的角色标签列表(如 shipper, consignee, importBuyer 等) |
client.relatedCustomers.[].extraProps | Object | 专属定制扩展属性 (Key 为 tag 比如 "shipper", Value 为特定定制的 Unit 实例) |
client.relatedCustomers.[].unitId | String | 往来单位唯一ID,主键 |
client.relatedCustomers.[].name | String | 名称(中文) |
client.relatedCustomers.[].nameEn | String | 名称(英文) |
client.unitId | String | 往来单位唯一ID,主键 |
client.name | String | 名称(中文) |
client.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[] | 联系人承担的职责,支持多选;未指定时为空集合 |
carrierInfo.bankAccounts | Object[] | 银行账户列表,支持多个账户 |
carrierInfo.bankAccounts.[].accountName | String | 开户名称 |
carrierInfo.bankAccounts.[].bankName | String | 银行名称 |
carrierInfo.bankAccounts.[].bankCode | String | 联行号 |
carrierInfo.bankAccounts.[].bankAccount | String | 银行账号 |
carrierInfo.bankAccounts.[].currency | String | 币制 |
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 |