跳到主要内容

分支机构注册

开通分支机构有两种可选的操作流程：

  1. 完整流程（从零开始）： 对分支机构进行完整注册，涵盖从地址和营业收入数据到法定代表人和担保人信息的全部内容。在该流程中，开通遵循本文档前面介绍的标准流程，需经过文件审批和权限校验。该流程需要签订新的转让合同，才能使转让方在基金中正式开通。
  2. 简化流程（关联注册）： 即本页介绍的流程，将分支机构的注册视为与已注册总部的关联。在该流程中，只需发送基础数据，系统会创建一个新的 assignor_registry_key，而代表和担保人等数据必须沿用总部审查中的数据。
信息

如果分支机构已作为转让方注册，也可以将其关联到总部。此时，其原有的文件、代表和担保人信息将被丢弃，转而继承总部的数据。

简化流程的优势​

分支机构简化开通流程主要有两个优势：

  • 付款选项： 与分支机构进行转让业务时，总部的账户也可作为付款选项。
  • 配置复制： 分支机构一经审批通过，总部的所有转让配置都会自动复制到分支机构，无需再进行合同签署步骤。如需获取新的 key，建议使用转让配置列表，以总部签订的合同为参照，使用 assignment_contract_key、asset_type 和 assignor_document_number 等参数。
注意

使用分支机构简化流程，要求与总部签订的主合同中包含以下条款：

CONSIDERANDO que o CEDENTE declara e garante que, caso aplicável, é a matriz e detém plenos poderes para representar juridicamente todas as suas filiais perante a CESSIONÁRIA, inclusive para a prática de todos os atos necessários à formalização e à execução de cessões. O CEDENTE reconhece e assume responsabilidade solidária e ilimitada por todas as obrigações assumidas por suas filiais em decorrência de cessões realizadas junto à CESSIONÁRIA, renunciando, para todos os fins, a qualquer alegação de ausência de poderes ou de autonomia.

创建新的分支机构​

尽管总部的反洗钱（PLD）审查已经完成，分支机构的第一次审查（关联审查）始终会经过外部数据查询和校验环节，需要等待所生成审查的审批通过或拒绝 webhook，该 webhook 会自动发送。

适用范围
角色主机所需权限
管理人manager-api写入
顾问consultant-apiRegister Assignor

各主机的 Base URL：环境（主机）。

Request​

ENDPOINT
/assignor_registry/assignor_registry/ASSIGNOR_REGISTRY_KEY/branch
MÉTODO
POST
信息

请求中发送的 assignor_registry_key 必须属于转让方的总部，且总部必须已开通。

Request Body
{
    "document_number": "55.666.777/0002-62",
    "email": "filial@cedente-exemplo.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
phoneobject转让方电话信息对象。见 电话定义。
address *object转让方地址信息对象。见 地址定义。
accounts *array转让方的放款账户列表。见 账户定义。

*必填字段。

Response​

STATUS
201
Response Body
{
  "assignor_registry_key": "9c130814-1aa5-4dcb-b6af-c4abdfca2947",
  "status": "pending_registry",
  "name": "Cedente Exemplo LTDA",
  "document_number": "55.666.777/0002-62",
  "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": "969.698.790-03",
        "name": "Roberto Carlos",
        "documents": []
      },
      {
        "analysis_related_party_key": "f2bc3473-1686-4d15-9a06-b51d25e20cb4",
        "document_number": "123.456.789-09",
        "name": "Natália Nascimento",
        "documents": []
      },
      {
        "analysis_related_party_key": "272cc251-a56d-4b89-82a1-d815a319b9fb",
        "passport_number": "C01X00T47",
        "name": "Maria Vitoria",
        "documents": []
      }
    ],
    "documents": [
      {
        "document_key": "5530af20-f52e-4a2e-b0f3-732e8121f4b3",
        "document_type": "social_contract",
        "status": "valid"
      }
    ]
  }
}
字段类型描述字符数
assignor_registry_keystring注册的标识。36
statusstring注册状态。见 注册状态枚举值。
namestring转让方名称。1 到 255
document_numberstring转让方的证件号。14 到 18
last_analysisobject审查对象。见 审查定义。
信息

所有代表、担保人和文件信息都会自动从总部的注册中复制。但所发送的账户必须由分支机构持有，否则后续转账将会失败。

信息

请务必保存 assignor_registry_key，它将在许多其他流程中使用；同样需要保存 analysis_key 和各个 analysis_related_party_key。

错误​

状态码代码触发条件
404ASR000004未找到所提供 assignor_registry_key 对应的总部转让方。请确保 URL 中的 assignor_registry_key 对应总部的注册。
400ASR000099自然人转让方不能有分支机构。只有法人总部（person_type=legal_person）可以有分支机构。
400ASR000096总部的状态不允许开通分支机构。总部必须处于 status=registered 才能创建分支机构。
400ASR000097所指注册不是总部。URL 中的 assignor_registry_key 必须属于 organization_level=headquarters 的注册。
400ASR000098分支机构的 CNPJ 根号与总部不一致。分支机构 document_number 的根号（前 8 位数字）必须与总部相同。
409ASR000032该代理方已注册过使用该 document_number 的转让方。该分支机构已有与此代理方关联的注册；请使用关联已有分支机构流程。
404ASR000071未找到分支机构账户的金融机构。请核实 accounts 中提供的 financial_institution_code。
400ASR000087账户信息只能包含数字。account_branch、account_number 和 account_digit 只能填写数字。
400ASR000081发送了多个默认账户。只能有一个账户设置 default_account=true。

认证、权限和主机相关错误：参见 API 错误。

将已有分支机构关联到总部​

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

适用范围
角色主机所需权限
管理人manager-api写入
顾问consultant-apiRegister Assignor

各主机的 Base URL：环境（主机）。

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": "Cedente Exemplo LTDA",
  "document_number": "55.666.777/0002-62",
  "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": "969.698.790-03",
        "name": "Roberto Carlos",
        "documents": []
      },
      {
        "analysis_related_party_key": "f2bc3473-1686-4d15-9a06-b51d25e20cb4",
        "document_number": "123.456.789-09",
        "name": "Natália Nascimento",
        "documents": []
      },
      {
        "analysis_related_party_key": "272cc251-a56d-4b89-82a1-d815a319b9fb",
        "passport_number": "C01X00T47",
        "name": "Maria Vitoria",
        "documents": []
      }
    ],
    "documents": [
      {
        "document_key": "5530af20-f52e-4a2e-b0f3-732e8121f4b3",
        "document_type": "social_contract",
        "status": "valid"
      }
    ]
  }
}
字段类型描述字符数
assignor_registry_keystring注册的标识。36
statusstring注册状态。见 注册状态枚举值。
namestring转让方名称。1 到 255
document_numberstring转让方的证件号。14 到 18
last_analysisobject审查对象。见 审查定义。

错误​

状态码代码触发条件
404ASR000004未找到总部或分支机构转让方。请确保 URL 中的 assignor_registry_key 属于总部，且 body 中的 branch_assignor_registry_key 属于同一代理方的已有注册。
400ASR000099自然人转让方不能有分支机构。只有法人总部可以关联分支机构。
400ASR000096总部的状态不允许关联分支机构。总部必须处于 status=registered。
400ASR000097所指注册不是总部。URL 中的 assignor_registry_key 必须属于 organization_level=headquarters 的注册。
400ASR000098分支机构的 CNPJ 根号与总部不一致。分支机构 document_number 的根号（前 8 位数字）必须与总部相同。

认证、权限和主机相关错误：参见 API 错误。

更新分支机构数据​

尽管是关联注册，分支机构的信息仍可更新，但有一些限制：

email、phone、address 和 annual_revenues 等信息可以使用与修改总部数据相同的端点进行更新（见下文）。但 name、related_parties、guarantors 以及文件本身必须始终在总部更新。总部的修改审批通过后，所有关联的分支机构会自动同步这些数据。

适用范围
角色主机所需权限
管理人manager-api写入
顾问consultant-apiRegister Assignor
转让方assignor-api写入

各主机的 Base URL：环境（主机）。

Request​

ENDPOINT
/assignor_registry/assignor_registry/ASSIGNOR_REGISTRY_KEY
MÉTODO
PUT
Request Body
{
  "email": "financeiro@cedente-exemplo.com.br",
  "annual_revenues": 1000000,
  "address": {
    "street": "Rua Maria Carolina",
    "number": "624",
    "neighborhood": "Jardim Paulistano",
    "city": "São Paulo",
    "postal_code": "01445-000",
    "uf": "SP",
    "country": "BRA"
  },
  "phone": {
    "international_dial_code": "+55",
    "area_code": "11",
    "number": "936360268"
  }
}
字段类型描述字符数
annual_revenuesnumber转让方申报的年营业收入。-
emailstring转让方的邮箱地址。1 到 255
phoneobject转让方电话信息对象。见 电话定义。
addressobject转让方地址信息对象。见 地址定义。

如不希望修改某个字段，只需不在请求中发送该字段。

Response​

STATUS
200
Response Body
{
  "assignor_registry_key": "9c130814-1aa5-4dcb-b6af-c4abdfca2947",
  "status": "registered",
  "name": "Cedente Exemplo LTDA",
  "document_number": "55.666.777/0002-62",
  "last_analysis": {
    "analysis_key": "f51a49e1-842c-471f-a0e1-32ee9f12625d",
    "analysis_number": 2,
    "status": "approved",
    "analysis_related_parties": [
      {
        "analysis_related_party_key": "f361763a-91f5-4688-8e28-cc3f3fbccf9a",
        "document_number": "969.698.790-03",
        "name": "Roberto Carlos",
        "documents": []
      },
      {
        "analysis_related_party_key": "7ea3193b-8e53-40b7-94cf-2d3cc62942e0",
        "document_number": "123.456.789-09",
        "name": "Natália Nascimento",
        "documents": []
      },
      {
        "analysis_related_party_key": "f321f063-5f9a-4964-a24a-52deba128160",
        "passport_number": "C01X00T47",
        "name": "Maria Vitoria",
        "documents": []
      }
    ],
    "documents": [
      {
        "document_key": "994621ac-7d3f-4f6b-90c5-74a4d8c5d017",
        "document_type": "social_contract",
        "status": "valid"
      }
    ]
  }
}
字段类型描述字符数
assignor_registry_keystring注册的标识。36
statusstring注册状态。见 注册状态枚举值。
namestring转让方名称。1 到 255
document_numberstring转让方的证件号。14 到 18
last_analysisobject审查对象。见 审查定义。
信息

与总部注册不同，由于修改不涉及代表和反洗钱数据，分支机构的修改始终自动审批通过。

信息

账户维护的逻辑与总部相同：参见转让方账户。

错误​

状态码代码触发条件
404ASR000004未找到所提供 assignor_registry_key 对应的分支机构转让方。请检查 URL 中的 assignor_registry_key 是否对应分支机构的注册。
400ASR000100所发送的字段不能在分支机构中更新：name、related_parties 和 guarantors 始终沿用总部的数据。如需修改，请更新总部的注册（参见注册更新）。

认证、权限和主机相关错误：参见 API 错误。