跳到主要内容

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" : "关联往来单位更新请求"
}
});

请求参数​

名称类型必须说明
customerIdString否客户 ID
tagString否往来单位角色标签(如 shipper, consignee, notifier, importBuyer, exportBuyer, seller)
unitsObject[]否需要新建/更新的往来单位列表
units.[].unitIdString否往来单位唯一ID,主键
units.[].statusString否状态
  • NORMAL - 正常
  • DISABLED - 禁用
  • units.[].nameString否名称(中文)
    units.[].nameEnString否名称(英文)
    units.[].abbreviationString否名称缩写
    units.[].countryString否国家
    units.[].countryEnString否国家(英文)
    units.[].tagsString[]否标签列表,用于分类或标记
    units.[].addressString否地址(中文)
    units.[].addressEnString否地址(英文)
    units.[].contactPersonsObject[]否联系人信息列表,支持多个联系人
    units.[].contactPersons.[].usernameString否用户标识
    units.[].contactPersons.[].nameString否用户名称
    units.[].contactPersons.[].nameEnString否英文称呼,用于外部联系人的英文通知;缺失时不自动翻译姓名。
    units.[].contactPersons.[].mobileString否用户手机号
    units.[].contactPersons.[].emailString否用户邮箱
    units.[].contactPersons.[].positionString否职位
    units.[].contactPersons.[].contactRolesString[]否联系人承担的职责,支持多选;未指定时为空集合
  • PRIMARY - 主联系人,承担往来单位的主要业务对接职责。
  • EMAIL_NOTIFICATION - 邮件通知人,作为业务邮件通知的联系对象。
  • BILLING - 账单联系人,承担账单接收和账务沟通职责。
  • units.[].bankAccountsObject[]否银行账户列表,支持多个账户
    units.[].bankAccounts.[].accountNameString否开户名称
    units.[].bankAccounts.[].bankNameString否银行名称
    units.[].bankAccounts.[].bankCodeString否联行号
    units.[].bankAccounts.[].bankAccountString否银行账号
    units.[].bankAccounts.[].currencyString否币制
  • CNY - 人民币
  • USD - 美元
  • EUR - 欧元
  • HKD - 港币
  • JPY - 日元
  • GBP - 英镑
  • AUD - 澳大利亚元
  • CAD - 加拿大元
  • SGD - 新加坡元
  • KRW - 韩元
  • DKK - 丹麦克朗
  • NOK - 挪威克朗
  • SEK - 瑞典克朗
  • name - 获取币种名称
  • symbol - 获取币种符号
  • code - 返回币种代码
  • units.[].bankAccounts.[].swiftCodeString否SWIFT CODE
    units.[].bankAccounts.[].addressString否地址
    units.[].bankAccounts.[].isDefaultBoolean否是否默认
    units.[].invoiceInfoObject否开票信息
    units.[].invoiceInfo.companyNameString否公司名称
    units.[].invoiceInfo.taxIdentificationNumberString否纳税识别号
    units.[].invoiceInfo.companyAddressString否公司地址
    units.[].invoiceInfo.phoneString否电话
    units.[].invoiceInfo.bankAccountString否银行账号
    units.[].invoiceInfo.contactString否联系人
    units.[].invoiceInfo.emailString否邮箱
    units.[].relatedCustomersObject[]否关联客户列表
    units.[].relatedCustomers.[].tagsString[]否该客户赋予当前往来单位的角色标签列表(如 shipper, consignee, importBuyer 等)
    units.[].relatedCustomers.[].extraPropsObject否专属定制扩展属性 (Key 为 tag 比如 "shipper", Value 为特定定制的 Unit 实例)
    units.[].relatedCustomers.[].unitIdString否往来单位唯一ID,主键
    units.[].relatedCustomers.[].nameString否名称(中文)
    units.[].relatedCustomers.[].nameEnString否名称(英文)
    units.[].sortWeightNumber否排序权重
    units.[].isPublicBoolean否是否公开
    units.[].legalEntityIdString否法人主体id
    units.[].customerIdString否客户id
    units.[].extraPropsObject否扩展属性
    units.[].crByString否创建者
    units.[].upByString否最后修改者
    units.[].crDateString否创建时间
    units.[].upDateString否最后修改时间
    units.[].idVaries否
    units.[].dockPropsObject否获取 dock 扩展属性(港口专属信息)
    当 tags 含 "dock" 时此字段才有意义
    units.[].dockTimeZoneString否获取港口所在时区(如 "Asia/Shanghai")
    用于把第三方 API 返回的港口当地时间(无时区)转 UTC Instant

    返回​

    空 Mono 封装

    { }