组织创建

开发中

POST

当应用订阅该事件后，如果组织内有组织被创建，则会触发该事件。

事件触发范围

企业开发者调用新增组织接口

资金系统内新增组织

请求参数

Body 参数application/json

headers

object (事件中心 webhook v1 公共请求格式)

事件头

必需

schema

string

版本

必需

header

object

事件头

必需

event

object

事件类型

必需

event

object

必需

name

string

组织名称

可选

注意：不可包含斜杠

<= 255 字符

remark

string

备注

可选

<= 128 字符

category

enum<integer>

组织类别

可选

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

枚举值:

012

默认值:

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（公司）时可填写相关企业信息，默认公司下属部门取公司信息使用

short_name

string

组织简称

可选

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

i18n_short_name

object

组织简称

可选

cost_center

string

成本中心

可选

profit_center

string

利润中心

可选

schema

string

必需

示例

{
    "headers": {
        "schema": "string",
        "header": {
            "event_id": "string",
            "event_type": "string",
            "create_time": "string",
            "token": "string"
        },
        "event": {}
    },
    "event": {
        "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",
            "standard_currency": "strin",
            "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"
            }
        },
        "short_name": "string",
        "i18n_short_name": {
            "zh_cn": "string",
            "en_us": "string"
        },
        "cost_center": "string",
        "profit_center": "string"
    },
    "schema": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '' \
--header 'Content-Type: application/json' \
--data-raw '{
    "headers": {
        "schema": "string",
        "header": {
            "event_id": "string",
            "event_type": "string",
            "create_time": "string",
            "token": "string"
        },
        "event": {}
    },
    "event": {
        "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",
            "standard_currency": "strin",
            "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"
            }
        },
        "short_name": "string",
        "i18n_short_name": {
            "zh_cn": "string",
            "en_us": "string"
        },
        "cost_center": "string",
        "profit_center": "string"
    },
    "schema": "string"
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{}

组织创建

组织变更