跳到主要内容

cs.units.create

创建一个新的往来单位

  • 请求路由: cs.units.create
  • 交互模型: Request Response
  • 访问限制: 无

请求​

RSocket.rr({
"route" : "cs.units.create",
"data" : {
"replaceMe" : "要创建的对象"
}
});

请求参数​

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

    返回​

    创建成功后的对象

    { }

    返回属性​

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

    下载结果模型定义