分支机构注册

要启用分支机构，可以遵循两种操作流程：

完整流程（从零开始）： 完整注册分支机构，涵盖地址和营收数据直至法定代表人和担保人信息。在此流程中，启用过程遵循文档中之前介绍的标准流程，经过文件审批和授权验证。此流程需要新的转让合同才能有效启用转让方在基金中的操作。
简化流程（关联注册）： 本页介绍的此流程将分支机构注册视为与预先注册的总公司的关联。在此流程中，仅提交基本数据并创建新的 assignor_registry_key，但代表和担保人等数据必须从总公司的审查中复用。

信息

如果分支机构已作为转让方注册，也可以将其关联到总公司。在这种情况下，之前的文件、代表和担保人信息将被废弃，分支机构将继承总公司的数据。

简化激活流程的优势

分支机构简化激活流程有两大主要优势：

付款选项： 与分支机构进行转让操作时，总公司的账户也将成为付款选项。
配置复制： 总公司的所有转让配置将在审批后自动复制到分支机构，无需合同签署步骤。要获取新密钥，建议使用分页的转让配置 GET 请求（主题 5.3.1.2.），以 assignment_contract_key、asset_type 和 assignor_document_number 等参数，以总公司签订的合同为参考。

注意

简化的分支机构流程要求总公司签订的主合同中包含以下条款才能使用：

鉴于转让方声明并保证，如适用，其作为总公司对所有分支机构拥有完全法律代表权，包括为与受让方签订和执行所有转让所需的所有行为。转让方认可并承担其分支机构因与受让方进行转让而产生的所有义务的连带和无限责任，放弃就授权不足或自主性的任何主张。

创建新分支机构

尽管总公司的反洗钱审查已完成，分支机构的首次审查（关联审查）始终会经历外部数据查询和验证阶段，需要等待自动发送的审查批准或拒绝的 Webhook 通知。

Request

ENDPOINT

/assignor_registry/assignor_registry/ASSIGNOR_REGISTRY_KEY/branch

MÉTODO

POST

信息

请求中发送的 assignor_registry_key 必须属于转让方的总公司，且总公司必须已启用。

Request Body
{
    "document_number": "32.402.502/0002-16",
    "email": "qitechfilial@qitech.com.br",
    "phone": {
        "international_dial_code": "+55",
        "area_code": "11",
        "number": "936360269"
    },
    "address": {
        "street": "Rua Maria Carolina dois",
        "number": "624",
        "neighborhood": "Jardim Paulistano",
        "city": "Campinas",
        "postal_code": "01445-000",
        "uf": "SP",
        "country": "BRA"
    },
    "annual_revenues": 20000,
    "accounts": [
        {
            "account_branch": "0001",
            "account_number": "0423223",
            "account_digit": "6",
            "financial_institution_code": "329",
            "account_type": "checking_account",
            "default_account": true
        }
    ]
}

字段	类型	描述	字符数
`document_number` *	string	转让方文件编号（CNPJ）。	14 至 18
`annual_revenues` *	number	转让方的年营收声明（整数）。	最小值为 1
`email` *	string	转让方的电子邮件地址。	1 至 255
`phone`	object	转让方电话信息对象。	请参见电话定义。
`address` *	object	转让方地址信息对象。	请参见地址定义。
`accounts` *	array	转让方还款账户列表。	请参见账户定义。

*必填字段。

Response

STATUS

201

Response Body
{
  "assignor_registry_key": "9c130814-1aa5-4dcb-b6af-c4abdfca2947",
  "status": "pending_registry",
  "name": "QI Tech",
  "document_number": "32.402.502/0002-16",
  "last_analysis": {
    "analysis_key": "49bcaaca-6029-4f6f-97a0-d71f7cefb7ae",
    "analysis_number": 1,
	  "status": "sent_to_analysis",
    "analysis_related_parties": [
      {
        "analysis_related_party_key": "65a74b18-0da8-4460-844b-524c9941e615",
        "document_number": "802.834.257-41",
        "name": "Roberto Carlos",
        "documents": []
      }
    ],
    "documents": [
      {
        "document_key": "5530af20-f52e-4a2e-b0f3-732e8121f4b3",
        "document_type": "social_contract",
        "status": "valid",
      }
    ],
    "analysis_data": {}
  }
}

字段	类型	描述	字符数
`assignor_registry_key`	string	注册标识符。	36
`status`	string	注册状态。	请参见注册状态枚举。
`name`	string	转让方名称。	1 至 255
`document_number`	string	转让方文件。	14 至 18
`last_analysis`	object	审查对象。	请参见审查定义。

信息

所有代表、担保人和文件信息将自动从总公司的注册中复制。但是，发送的账户必须属于分支机构所有，否则未来的转账将失败。

信息

重要的是存储 assignor_registry_key，因为它将用于其他多个流程，以及 analysis_key 和 analysis_related_party_key。

将现有分支机构关联到总公司

如果分支机构和总公司已以不同注册存在，可以强制将两者关联。在此流程中，分支机构中不在创建请求体中的所有信息将被总公司的信息替换。

Request

ENDPOINT

/assignor_registry/assignor_registry/ASSIGNOR_REGISTRY_KEY/branch

MÉTODO

PUT

信息

请求中发送的 assignor_registry_key 必须属于转让方的总公司，且总公司必须已启用。

Request Body
{
    "branch_assignor_registry_key": "9c130814-1aa5-4dcb-b6af-c4abdfca2947",
}

字段	类型	描述	字符数
`branch_assignor_registry_key` *	string	注册标识符。	36

*必填字段。

Response

STATUS

200

Response Body
{
  "assignor_registry_key": "9c130814-1aa5-4dcb-b6af-c4abdfca2947",
  "status": "pending_registry",
  "name": "QI Tech",
  "document_number": "32.402.502/0002-16",
  "last_analysis": {
    "analysis_key": "49bcaaca-6029-4f6f-97a0-d71f7cefb7ae",
    "analysis_number": 1,
    "status": "sent_to_analysis"
  }
}

简化激活流程的优势​

创建新分支机构​

Request​

Response​

将现有分支机构关联到总公司​

Request​

Response​

简化激活流程的优势

创建新分支机构

Request

Response

将现有分支机构关联到总公司

Request

Response