提交注册

在转让方注册的第一阶段，需要提交转让方的数据，如下所定义。需要注意的是，仅提交数据并不能创建可运营的转让方，只有在文件审查成功完成后，转让方才会被激活。

对于法人实体（强制）和自然人（可选），可以注册关联方，代表与转让方相关的最终受益人。

信息

最终受益人定义为在公司或集团中具有重大影响力、拥有决策权或在股权结构中持有重大参股的个人或个人组成的群体。就注册目的而言，应考虑在公司或其所属集团中持股超过 15% 的任何关联方，或在没有如此重大参股的情况下，按降序排列的前三大关联方。

如果相关受益人是另一家公司，则应指定其最终受益人，标记为间接受益人。此外，参与操作的代理人、管理人和董事也被视为关联方，他们将成为转让方的签署代表。

签署代表是负责跟踪和签署我们系统向转让方发送文件的关联方，需要提供关联关系的证明，对于公司而言，通过股权结构、董事或授权委托书证明。无法注册非代理人的关联方作为自然人转让方。此外，需要指明被视为最终受益人的关联方是否与转让方直接或间接关联。

信息

在验证环境中，审批规则如下：CPF/CNPJ 以 1 开头：自动拒绝；CPF/CNPJ 以 8 开头：待手动验证；其余自动批准。

转让方注册

Request

ENDPOINT

/assignor_registry/assignor_registry

MÉTODO

POST

Request Body
{
  "name": "QI Tech",
  "document_number": "32.402.502/0001-35",
  "person_type": "legal_person",
  "email": "qitech@qitech.com.br",
  "annual_revenues": 1000000,
  "is_in_national_financial_system": true,
  "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"
  },
  "related_parties": [
    {
      "name": "Natália Nascimento",
      "document_number": "883.512.866-80",
      "related_party_type": "attorney",
      "nationality": "BRA",
      "address": {
        "street": "Rua Maria Carolina",
        "number": "624",
        "neighborhood": "Jardim Paulistano",
        "city": "São Paulo",
        "postal_code": "01445-000",
        "uf": "SP",
        "country": "BRA"
      },
      "direct_beneficiary": true,
      "is_representative": true,
      "email": "natalia.nascimento@yopmail.com",
      "phone": {
        "international_dial_code": "+55",
        "area_code": "11",
        "number": "936360268"
      }
    },
    {
      "name": "Maria Vitoria",
      "related_party_type": "president",
      "nationality": "DEU",
      "passport_number": "C01X00T47",
      "direct_beneficiary": true,
      "is_representative": false
    },
    {
      "name": "Roberto Carlos",
      "document_number": "802.834.257-41",
      "related_party_type": "director",
      "nationality": "BRA",
      "direct_beneficiary": false,
      "company_country": "NZL",
      "company_registry_number": "4984037284610",
      "is_representative": false,
      "email": "roberto.carlos@yopmail.com",
      "phone": {
        "international_dial_code": "+64",
        "area_code": "11",
        "number": "936360268"
      }
    }
  ],
  "accounts": [
    {
      "account_branch": "0001",
      "account_number": "7912584",
      "account_digit": "1",
      "financial_institution_code": "329",
      "account_type": "checking_account",
      "default_account": true
    },
    {
      "account_branch": "0001",
      "account_number": "8758931",
      "account_digit": "5",
      "financial_institution_code": "329",
      "account_type": "escrow_account",
      "default_account": false
    }
  ],
  "guarantors": [
    {
      "name": "Avalista PF",
      "document_number": "172.775.419-01",
      "person_type": "natural_person",
      "email": "email@avalista.com"
    },
    {
      "name": "Avalista PJ",
      "document_number": "65.679.662/0001-85",
      "person_type": "legal_person",
      "email": "email@avalista.com",
      "guarantor_representatives": [
        {
          "name": "Assinante do Avalista",
          "document_number": "244.412.084-13",
          "email": "emailrepresentante@avalista.com"
        }
      ]
    }
  ]
}

转让方定义

字段	类型	描述	字符数
`name` *	string	转让方名称。	1 至 255
`document_number` *	string	转让方文件编号（CNPJ）。	14 至 18
`annual_revenues` *	number	转让方的年营收声明（整数）。	最小值为 1
`person_type` *	string	转让方的人员类型（自然人或法人）。	-
`email` *	string	转让方的电子邮件地址。	1 至 255
`is_in_national_financial_system` *	boolean	表示转让方是否为 SFN 成员。	-
`phone`	object	转让方电话信息对象。	请参见电话定义。
`address` *	object	转让方地址信息对象。	请参见地址定义。
`related_parties` *	array	公司关联方列表。	请参见关联方定义。
`accounts` *	array	转让方还款账户列表。	请参见账户定义。
`guarantors` *	array	转让方担保人列表。	请参见担保人定义。

*必填字段。

Response

STATUS

201

Response Body
{
  "assignor_registry_key": "c4295375-4077-4092-a258-5bcdf8875907",
  "status": "pending_registry",
  "name": "QI Tech",
  "document_number": "32.402.502/0001-35",
  "last_analysis": {
    "analysis_key": "d7805a05-98a7-486b-a440-807f1d3d5691",
    "analysis_number": 1,
    "status": "pending_documents",
    "analysis_related_parties": [
      {
        "analysis_related_party_key": "5cdcc13b-c67d-45f3-aa66-36cb4f178b59",
        "document_number": "802.834.257-41",
        "name": "Roberto Carlos",
        "documents": []
      }
    ],
    "documents": [],
    "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。

信息

在审查结构中，担保人或担保人的代表也通过 analysis_related_party 表示。值得注意的是，每个 document_number 只有一个，因此，如果同一个人既是担保人又是转让方的关联方，只会生成一个 analysis_related_party，具有一个 analysis_related_party_key，同时适用于关联方和担保人。

信息

自然人的代表仅限于可代其签署的代理人。

定义

地址定义

字段	类型	描述	字符数
`street` *	string	街道名称。	1 至 255
`number` *	string	门牌号。	1 至 4
`neighborhood` *	string	社区/街区。	1 至 255
`city` *	string	城市。	1 至 255
`uf` *	string	州缩写。	2
`complement`	string	地址补充信息。	1 至 255
`postal_code` *	string	邮政编码。	9（格式：XXXXX-XXX）
`country` *	string	国家（缩写）。	3，按 ISO 3166-1 alpha-3

*必填字段。

电话定义

字段	类型	描述	字符数
`international_dial_code` *	string	国际拨号代码。	1 至 3
`area_code` *	string	区号。	2
`number` *	string	电话号码。	8 至 9

*必填字段。

关联方定义

字段	类型	描述	字符数
`name` *	string	关联方名称。	1 至 255
`document_number` **	string	受益人文件编号（CPF）。	14 至 18
`passport_number` **	string	外国受益人文件编号。	8 至 9
`related_party_type` *	string	关联方的关联类型。	请参见关联方类型枚举。
`nationality` *	string	受益人的来源国。	3，按 ISO 3166-1 alpha-3
`direct_beneficiary` *	boolean	与转让方直接或间接关联的受益人。	-
`is_representative` *	boolean	表示关联方是否为转让方的签署代表。	-
`company_registry_number` ***	string	若非直接与转让方关联，关联的公司。	1 至 255
`company_country` ***	string	受益人与转让方之间中介公司所在国。	3，按 ISO 3166-1 alpha-3
`address`	object	代表地址信息对象。	请参见地址定义。
`email` ****	string	代表的电子邮件地址。	1 至 255
`phone`	object	代表电话信息对象。	请参见电话定义。
`marital_status`	string	关联方婚姻状况。	请参见婚姻状况枚举。
`property_system`	string	财产分离制度。	请参见财产制度枚举。
`profession`	string	关联方职业。	1 至 255。

*必填字段。 **巴西人需要 document_number，外国人需要 passport_number。 ***若关联方与转让方非直接关联，则为必填。 ****仅签署代表必填。

担保人定义

字段	类型	描述	字符数
`name` *	string	担保人名称。	3 - 255
`document_number` *	string	担保人文件编号。	14 至 18
`person_type` *	string	担保人的人员类型（自然人或法人）。	-
`email` *	string	担保人的电子邮件地址。	1 至 255
`nationality`	string	担保人的来源国。	3，按 ISO 3166-1 alpha-3
`phone`	object	担保人电话信息对象。	请参见电话定义。
`address`	object	担保人地址信息对象。	请参见地址定义。
`guarantor_representatives`	array	担保人的签署代表 - 仅适用于法人担保人。	请参见担保人代表定义。
`marital_status`	string	担保人婚姻状况。	请参见婚姻状况枚举。
`property_system`	string	财产分离制度。	请参见财产制度枚举。
`profession`	string	担保人职业。	1 至 255。

*必填字段。

枚举值

Assignor Registry Status

枚举值	描述
pending_registry	待注册
registered	已注册

Analysis Status

枚举值	描述
pending_documents	待提交文件
sent_to_analysis	已发送审查
pending_internal_validation	文件验证中
in_manual_analysis	合规手动审查中
approved	已批准
reproved	已拒绝

枚举值	描述
president	总裁
partner	合伙人
administrator	管理人
director	董事
manager	经理
attorney	代理人

Marital Status

枚举值	描述
single	单身
married	已婚
widower	丧偶
divorced	离婚
separated	分居
stable_union	稳定伴侣关系

Property System

枚举值	描述
total_communion_of_goods	完全财产共有
partial_communion_of_goods	部分财产共有
total_separation_of_goods	完全财产分离
final_participation_of_acquisitions	婚后财产最终参与
compulsory_separation_of_goods	强制财产分离

转让方注册​

Request​

转让方定义​

Response​

定义​

地址定义​

电话定义​

关联方定义​

担保人定义​

枚举值

Assignor Registry Status​

Analysis Status​

Related Party Type​

Marital Status​

Property System​

转让方注册

Request

转让方定义

Response

定义

地址定义

电话定义

关联方定义

担保人定义

Assignor Registry Status

Analysis Status

Related Party Type

Marital Status

Property System