创建组织部门 - 财资云开放平台（开发版）

请求参数

Body 参数application/json

name

string

组织名称

必需

注意：不可包含斜杠

<= 255 字符

i18n_name

object

国际化的组织名称

可选

注意：不可包含斜杠

zh_cn

string

中文名称

必需

en_us

string

英文名称

可选

parent_organization_id

string

父组织ID

必需

在根组织下创建新组织，该参数值为 “0”

organization_id

string

本组织的自定义组织ID

可选

organizationId用来标识租户内一个唯一的组织，支持在创建组织时自定义。若不自定义则由系统默认生成唯一的 organizationId。已经创建的组织，不允许修改 organizationId

<= 20 字符

category

enum<integer>

组织类别

可选

0-虚拟组织
1-公司（默认）
2-部门

枚举值:

012

默认值:

1

organization_code

string

组织编码

可选

一般用于数据展示或识别组织使用，需要保持唯一

<= 32 字符

abbreviation_name

string

组织简称

可选

当前值为空时，默认填充组织名称

i18n_abbreviation_name

object

组织简称

可选

zh_cn

string

中文组织简称

可选

en_us

string

可选

cost_center

string

成本中心

可选

profit_center

string

利润中心

可选

order

integer

组织的排序

可选

即组织在其同级组织的展示顺序

company_info

object

企业信息

可选

当组织类别为1（公司）时可填写相关企业信息，默认公司下属部门取公司信息使用

country_code

string

国家

可选

当前值为空时，默认填充CHN（中国）

<= 255 字符

默认值:

CHN

social_credit_code

string

社会信用代码

可选

<= 32 字符

institution_code

string

组织机构代码

可选

<= 32 字符

business_identifier_code

string

国际银行识别码

可选

国际银行业联合会(SWIFT)制定的一种国际标准,用于识别金融机构

functional_currency_code

string

本位币

可选

当前值为空时，默认填充CNY（人民币）

<= 5 字符

registered_currency

string

注册币种

必需

finance_person

string

财务负责人

可选

<= 32 字符

office_address

string

办公地址

可选

<= 255 字符

i18n_office_address

object

国际化的办公地址

可选

registered_address

string

注册地址

可选

<= 255 字符

i18n_registered_address

object

国际化的注册地址

可选

is_spv

integer

是否spv公司

可选

is_escrow

integer

是否集团代管

可选

business_info

object

经营信息

可选

debt_ratio

string

负债率

可选

finance_person

string

财务负责人

可选

establishment_date

string

成立日志

可选

operating_years_start

string

经营年限起

可选

operating_years_end

string

经营年限止

可选

is_general_taxpayer

integer

一般纳税人

可选

enterprise_size

string

规模

可选

legal_person

string

法人

可选

annual_output_value

string

年产值

可选

org_nature

string

企业性质

可选

registered_fund

string

注册资金

可选

contacts

object

联系信息

可选

email

string

邮箱

可选

mobile

string

移动电话

可选

fixed_phone

string

固定电话

可选

remark

string

备注

可选

<= 128 字符

示例

{
  "name": "优财云链科技有限公司",
  "i18n_name": {
    "zh_cn": "labore dolore proident",
    "en_us": "Duis"
  },
  "parent_organization_id": "98",
  "order": 10,
  "organization_code": "41",
  "profit_center": "in sint",
  "company_info": {
    "business_identifier_code": "70",
    "country_code": "71",
    "finance_person": "est",
    "office_address": "海南省朔州市城步苗族自治县",
    "i18n_registered_address": {
      "en_us": "杭州市滨江区",
      "zh_cn": "Binjiang District, Hangzhou City"
    },
    "i18n_office_address": {
      "en_us": "杭州市滨江区",
      "zh_cn": "Binjiang District, Hangzhou City"
    },
    "social_credit_code": "94",
    "registered_address": "杭州市滨江区",
    "institution_code": "16",
    "standard_currency": "CNY"
  },
  "short_name": "优财",
  "i18n_short_name": {
    "en_us": "优财",
    "zh_cn": "yocyl"
  },
  "category": 0,
  "remark": "Ut adipisicing eiusmod",
  "organization_id": "80"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/organization/v3/departments/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "优财云链科技有限公司",
        "i18n_name": {
        "zh_cn": "labore dolore proident",
        "en_us": "Duis"
    },
    "parent_organization_id": "98",
    "order": 10,
    "organization_code": "41",
    "profit_center": "in sint",
    "company_info": {
        "business_identifier_code": "70",
        "country_code": "71",
        "finance_person": "est",
        "office_address": "海南省朔州市城步苗族自治县",
        "i18n_registered_address": {
            "en_us": "杭州市滨江区",
            "zh_cn": "Binjiang District, Hangzhou City"
        },
        "i18n_office_address": {
            "en_us": "杭州市滨江区",
            "zh_cn": "Binjiang District, Hangzhou City"
        },
        "social_credit_code": "94",
        "registered_address": "杭州市滨江区",
        "institution_code": "16",
        "standard_currency": "CNY"
    },
    "short_name": "优财",
    "i18n_short_name": {
        "en_us": "优财",
        "zh_cn": "yocyl"
    },

    "category": 0,
    "remark": "Ut adipisicing eiusmod",
    "organization_id": "80"
}'

返回响应

🟢200成功

application/json

Body

code

string

响应码

必需

响应code (6位自定义错误码)

>= 6 字符<= 6 字符

默认值:

000000

示例值:

000000

msg

string

响应信息

必需

响应信息

data

object

响应数据

可选

响应数据

name

string

组织名称

可选

注意：不可包含斜杠

<= 255 字符

remark

string

备注

可选

<= 128 字符

category

enum<integer>

组织类别

可选

0-虚拟组织
1-公司（默认）
2-部门

枚举值:

012

默认值:

1

order

integer

组织的排序

可选

即组织在其同级组织的展示顺序

i18n_name

object

国际化的组织名称

可选

注意：不可包含斜杠

parent_organization_id

string

父组织ID

可选

在根组织下创建新组织，该参数值为 “0”

organization_id

string

本组织的自定义组织ID

可选

organizationId用来标识租户内一个唯一的组织，支持在创建组织时自定义。若不自定义则由系统默认生成唯一的 organizationId。已经创建的组织，不允许修改 organizationId

<= 20 字符

organization_code

string

组织编码

可选

一般用于数据展示或识别组织使用，需要保持唯一

<= 32 字符

company_info

object

企业信息

可选

当组织类别为1（公司）时可填写相关企业信息，默认公司下属部门取公司信息使用

cost_center

string

成本中心

可选

profit_center

string

利润中心

可选

abbreviation_name

string

组织简称

可选

当前值为空时，默认填充组织名称

i18n_abbreviation_name

object

组织简称

可选

business_info

object

经营信息

可选

contacts

object

联系信息

可选

示例

{
  "code": "000000",
  "msg": "string",
  "data": {
    "name": "string",
    "remark": "string",
    "category": 1,
    "order": 0,
    "i18n_name": {
      "zh_cn": "string",
      "en_us": "string"
    },
    "parent_organization_id": "string",
    "organization_id": "string",
    "organization_code": "string",
    "company_info": {
      "country_code": "CHN",
      "social_credit_code": "string",
      "institution_code": "string",
      "business_identifier_code": "string",
      "functional_currency_code": "strin",
      "registered_currency": "string",
      "finance_person": "string",
      "office_address": "string",
      "i18n_office_address": {
        "en_us": "string",
        "zh_cn": "string"
      },
      "registered_address": "string",
      "i18n_registered_address": {
        "en_us": "string",
        "zh_cn": "string"
      },
      "is_spv": 0,
      "is_escrow": 0
    },
    "cost_center": "string",
    "profit_center": "string",
    "abbreviation_name": "string",
    "i18n_abbreviation_name": {
      "zh_cn": "string",
      "en_us": "string"
    },
    "business_info": {
      "debt_ratio": "string",
      "finance_person": "string",
      "establishment_date": "string",
      "operating_years_start": "string",
      "operating_years_end": "string",
      "is_general_taxpayer": 0,
      "enterprise_size": "string",
      "legal_person": "string",
      "annual_output_value": "string",
      "org_nature": "string",
      "registered_fund": "string"
    },
    "contacts": {
      "email": "string",
      "mobile": "string",
      "fixed_phone": "string"
    }
  }
}