cs.crm.customers.update.units.by-tag
按角色 Tag 独立保存/更新客户关联的往来单位列表(仅新建与修改)
- 请求路由:
cs.crm.customers.update.units.by-tag- 交互模型:
Request Response- 访问限制: 无
请求
RSocket.rr({
"route" : "cs.crm.customers.update.units.by-tag",
"data" : {
"replaceMe" : "关联往来单位更新请求"
}
});
请求参数
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
customerId | String | 否 | 客户 ID |
tag | String | 否 | 往来单位角色标签(如 shipper, consignee, notifier, importBuyer, exportBuyer, seller) |
units | Object[] | 否 | 需要新建/更新的往来单位列表 |
units.[].unitId | String | 否 | 往来单位唯一ID,主键 |
units.[].status | String | 否 | 状态 |
units.[].name | String | 否 | 名称(中文) |
units.[].nameEn | String | 否 | 名称(英文) |
units.[].abbreviation | String | 否 | 名称缩写 |
units.[].country | String | 否 | 国家 |
units.[].countryEn | String | 否 | 国家(英文) |
units.[].tags | String[] | 否 | 标签列表,用于分类或标记 |
units.[].address | String | 否 | 地址(中文) |
units.[].addressEn | String | 否 | 地址(英文) |
units.[].contactPersons | Object[] | 否 | 联系人信息列表,支持多个联系人 |
units.[].contactPersons.[].username | String | 否 | 用户标识 |
units.[].contactPersons.[].name | String | 否 | 用户名称 |
units.[].contactPersons.[].nameEn | String | 否 | 英文称呼,用于外部联系人的英文通知;缺失时不自动翻译姓名。 |
units.[].contactPersons.[].mobile | String | 否 | 用户手机号 |
units.[].contactPersons.[].email | String | 否 | 用户邮箱 |
units.[].contactPersons.[].position | String | 否 | 职位 |
units.[].contactPersons.[].contactRoles | String[] | 否 | 联系人承担的职责,支持多选;未指定时为空集合 |
units.[].bankAccounts | Object[] | 否 | 银行账户列表,支持多个账户 |
units.[].bankAccounts.[].accountName | String | 否 | 开户名称 |
units.[].bankAccounts.[].bankName | String | 否 | 银行名称 |
units.[].bankAccounts.[].bankCode | String | 否 | 联行号 |
units.[].bankAccounts.[].bankAccount | String | 否 | 银行账号 |
units.[].bankAccounts.[].currency | String | 否 | 币制 |
units.[].bankAccounts.[].swiftCode | String | 否 | SWIFT CODE |
units.[].bankAccounts.[].address | String | 否 | 地址 |
units.[].bankAccounts.[].isDefault | Boolean | 否 | 是否默认 |
units.[].invoiceInfo | Object | 否 | 开票信息 |
units.[].invoiceInfo.companyName | String | 否 | 公司名称 |
units.[].invoiceInfo.taxIdentificationNumber | String | 否 | 纳税识别号 |
units.[].invoiceInfo.companyAddress | String | 否 | 公司地址 |
units.[].invoiceInfo.phone | String | 否 | 电话 |
units.[].invoiceInfo.bankAccount | String | 否 | 银行账号 |
units.[].invoiceInfo.contact | String | 否 | 联系人 |
units.[].invoiceInfo.email | String | 否 | 邮箱 |
units.[].relatedCustomers | Object[] | 否 | 关联客户列表 |
units.[].relatedCustomers.[].tags | String[] | 否 | 该客户赋予当前往来单位的角色标签列表(如 shipper, consignee, importBuyer 等) |
units.[].relatedCustomers.[].extraProps | Object | 否 | 专属定制扩展属性 (Key 为 tag 比如 "shipper", Value 为特定定制的 Unit 实例) |
units.[].relatedCustomers.[].unitId | String | 否 | 往来单位唯一ID,主键 |
units.[].relatedCustomers.[].name | String | 否 | 名称(中文) |
units.[].relatedCustomers.[].nameEn | String | 否 | 名称(英文) |
units.[].sortWeight | Number | 否 | 排序权重 |
units.[].isPublic | Boolean | 否 | 是否公开 |
units.[].legalEntityId | String | 否 | 法人主体id |
units.[].customerId | String | 否 | 客户id |
units.[].extraProps | Object | 否 | 扩展属性 |
units.[].crBy | String | 否 | 创建者 |
units.[].upBy | String | 否 | 最后修改者 |
units.[].crDate | String | 否 | 创建时间 |
units.[].upDate | String | 否 | 最后修改时间 |
units.[].id | Varies | 否 | |
units.[].dockProps | Object | 否 | 获取 dock 扩展属性(港口专属信息) 当 tags 含 "dock" 时此字段才有意义 |
units.[].dockTimeZone | String | 否 | 获取港口所在时区(如 "Asia/Shanghai") 用于把第三方 API 返回的港口当地时间(无时区)转 UTC Instant |
返回
空 Mono 封装
{ }