CreateFinancialRelation - 建立财务关系--费用中心-火山引擎

文档中心

立即注册

导航

CreateFinancialRelation - 建立财务关系

最近更新时间：2024.04.11 17:06:38首次发布时间：2024.04.11 17:06:38

创建一个财务关联关系

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

参数	类型	是否必填	示例值	描述
Action	String	是	CreateFinancialRelation	要执行的操作，取值：CreateFinancialRelation
Version	String	是	2022-01-01	API的版本，取值：2022-01-01
SubAccountID	Integer	是	2000000000	子账号的火山引擎账号 UID
Relation	Integer	是	2000000000	关系类型，目前仅支持企业财务 1 财务托管 4 财务管理
AccountAlias	String	否	xxx项目	显示名称，用于页面显示，便于明确账号使用场景
AuthListStr	String	否	1,3,5	授权列表，以逗号隔开，权限点如下： 1 授权子账号共享主账号的合同优惠 2 授权主账号查看子账号下的资金余额 3 授权主账号对子账号进行授信额度的划拨和回收 4 授权主账号查看子账号下的账单信息 5 授权主账号协助子账号进行开票管理

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构

参数	类型	示例值	描述
IsSuccess	Boolean	true	是否成功

请求示例

{
    "SubAccountID":"2000000000",
    "Relation":"4",
    "AccountAlias":"xx项目",
    "AuthListStr":"1,3,5"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230327113355546653D988035BA94DB1",
        "Action": "CreateFinancialRelation",
        "Version": "2022-01-01",
        "Result": {
            "IsSuccess": true
            "BaseResp": {
                "StatusMessage": "",
                "StatusCode": 0
            }
        }
    }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	OperationDenied.OrderExist	Account %v has outstanding orders and cannot be linked with trusteeship!	账号%v存在未完成的订单，不能被托管！
400	OperationDenied.FinanceManagementSubExcludeCorpFinance	The associated account %v already has other financial relationships and cannot be linked!	被关联的账号%v已存在其他的财务关联关系，不能被关联！
400	OperationDenied.FinanceManagementMajorExcludePartnership	Account %v already has other agency/dropshipping relationships and cannot become the main financial management account!	账号%v已存在其他的代售/代销关系，不能成为财务管理主账号！
400	OperationDenied.TrusteeshipSubExcludePartnership	Account %v already has other reseller/commission seller relationships and cannot be linked with trusteeship!	账号%v已存在其他的代售/代销关系，不能被托管！
400	OperationDenied.TrusteeshipSubExcludeTrusteeship	Account %v already has a linked trusteeship and cannot be linked with another trusteeship!	账号%v已存在托管关系，不能被托管！
400	OperationDenied.TrusteeshipMajorExcludePartnership	Account %v already has other reseller/commission seller relationships and cannot be the trusted master account!	账号%v已存在其他的代售/代销关系，不能成为托管主账号！
400	OperationDenied.TrusteeshipSubExcludeFinanceManagement	Account %v already has a financial management relationship and cannot be hosted!	账号%v已存在财务管理关系，不能被托管！
400	OperationDenied.FinanceManagementMajorExcludeFinanceManagementSub	Account %v is a financial management sub-account of other accounts and cannot become the main financial management account!	账号%v为其他账号的财务管理子账号，不能成为财务管理主账号！
400	OperationDenied.UnCompleteCorpAuthentication	The associated account %v has not completed the enterprise real-name authentication and cannot be associated!	被关联的账号%v未完成企业实名认证，无法关联！
400	OperationDenied.FinanceManagementSubjectNonExist	The associated account does not have a valid business relationship with the current account and cannot be associated with "financial management". For details, please consult the sales & sales operation responsible for your business.	关联账号同当前账号不存在有效的业务关系，不能进行“财务管理“关联。详情可咨询负责您业务的销售&销售运营。
400	OperationDenied.AccountRelationExist	The relationship between the invited associated account and the operation account already exists!	邀请的关联账号与操作账号关系已存在！
400	OperationDenied.UpdateFinancialRelationSameAccount	The account cannot have a business (financial + ecological) relationship with itself	账号不能与自己产生业务（财务+生态）关系
400	OperationDenied.FinanceManagementSubExcludePartnership	The associated account %v already has other affiliate/dropshipping relationships and cannot be associated!	被关联的账号%v已存在其他的代售/代销关系，不能被关联！
400	OperationDenied.FinanceManagementMajorExcludeTrusteeship	Account %v already has a hosting relationship and cannot become the main financial management account!	账号%v已存在托管关系，不能成为财务管理主账号！
400	OperationDenied.TrusteeshipSubArrears	Account %v is in arrears and cannot be linked with trusteeship!	账号%v存在欠费，不能被托管！
400	OperationDenied.AuthenticateInconsistent	The associated account of the invitation is inconsistent with the real-name authentication of the operation account, so the associated invitation cannot be carried out!	邀请的关联账号与操作账号实名认证信息不一致，无法进行关联邀请！
400	OperationDenied.TrusteeshipMajorExcludeTrusteeshipSub	Account %v is a linked sub-account of another account and cannot become the trusted master account!	账号%v为其他账号的托管子账号，不能成为托管主账号！
400	MissingParameter	The required parameter %s is missing.	客户端参数缺失
400	OperationDenied.FinanceRelationExcludePartnership	Account %v already has other agency/dropshipping relationships and cannot become the main financial account!	账号%v已存在其他的代售/代销关系，不能成为财务主账号！
400	OperationDenied.AccountAliasExist	The account alias associated with the main account already exists, please re-enter!	主账号下关联的账号别名已存在，请重新输入！
400	OperationDenied.TrusteeshipMajorExcludeFinanceManagement	Account %v already has a financial management relationship and cannot become the main hosting account!	账号%v已存在财务管理关系，不能成为托管主账号！
400	OperationDenied.DebtInvoice	Account %v owes invoice and cannot be linked with trusteeship!	账号%v存在欠票，不能被托管！
400	OperationDenied.FinanceManagementAuthTypeInValid	The financial management authorization is unreasonable, please re-select	财务管理授权不合理，请重新选择
400	ParamInvalid	The specified parameter %s is invalid.	客户端参数错误
500	InternalServerError	The request has failed due to an unknown error.	系统错误，多次出现时请联系管理员