全部产品
Search
文档中心

阿里云交易和账单管理API:AddAccountRelation - 创建财务关联

更新时间:Sep 27, 2024

创建一个财务关联关系。

接口说明

1、具体财务关联业务规则参见财务托管协议。 2、如果邀约主、子账号实名认证一致,则不需要子账号通过 OpenAPI 再次确认,否则需要调用 ConfirmRelation 确认。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
RelationTypestring

关系类型,目前仅支持 enterprise_group

enterprise_group
ParentUserIdlong

主账号的阿里云 UID

1738376485192612
ChildNickstring

显示名称,用于页面显示,便于明确账号使用场景

xxx项目
ChildUserIdlong

子账号的阿里云账号 UID

1512996702208737
RequestIdstring

请求唯一标识,用于标记一次请求,便于定位问题

32324242444
PermissionCodesarray

授予子账号的权限数据,权限点如下:

  • 允许同步信控身份给关联账号:SYNCHRONIZE_FINANCE_IDENTITY
  • 允许同步优惠给关联账号:SYNCHRONIZE_FINANCE_DISCOUNT_POLICY_TO_TARGET
  • 禁止关联账户余额提现:FORBID_WITHDRAW_CASH
  • 禁止关联账户管理发票:FORBID_MANAGE_INVOICE
  • 请求查看财务关联信息:CHECK_FINANCE_INFO
  • 允许管理目标发票:MANAGE_TARGET_INVOICE
  • 允许查看关联账户消费信息:CHECK_TARGET_CONSUMPTION
string

权限点。

SYNCHRONIZE_FINANCE_IDENTITY
RoleCodesarray

授予子账号角色,目前仅支持财务托管角色(trusteeship)

string

财务托管角色。

trusteeship

返回参数

名称类型描述示例值
object
Codestring

状态码

200
Messagestring

返回信息

返回信息
RequestIdstring

请求标识

请求标识
Successboolean

是否成功

true
Dataobject

数据

HostIdstring

请求来源 ip

HostId
RelationIdlong

关联关系 id

RelationId

示例

正常返回示例

JSON格式

{
  "Code": "200",
  "Message": "返回信息",
  "RequestId": "请求标识",
  "Success": true,
  "Data": {
    "HostId": "HostId",
    "RelationId": 0
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2021-12-14OpenAPI 返回结构发生变更查看变更详情