注册更新

基金经理有责任根据公司的实际情况保持转让方数据的更新。这一承诺极为重要，既能保持反洗钱分析的最新状态，也能更新签署人组，签署人组会不断变化并会过期，因此需要进行新的分析。此外，每 2 年会自动生成一次新的分析，以确保定期更新。

注意

基金经理有责任保持转让方数据的更新，并反映公司的实际情况。

更新注册时，无论更改了哪个字段，都将生成新的分析，该分析将根据所做的更改要求新的文件。分析有顺序编号，可能会多次失败，直到最终获得合规团队的批准。更改只有在分析成功完成后才会生效。如果关联方发生更改，将进行转让方签署人组的验证阶段。需要注意的是，如果关联方或担保人未被发送，将被视为已删除。

信息

如果分析正在进行中，且发送了注册更新，最后一次未完成的分析将自动关闭并被拒绝，原因为"assignor_update"。

法人转让方注册更新

Request

ENDPOINT

/assignor_registry/assignor_registry/ASSIGNOR_REGISTRY_KEY

MÉTODO

PUT

Request Body
{
  "email": "qidtvm@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",
      "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": true,
      "email": "roberto.carlos@yopmail.com",
      "phone": {
        "international_dial_code": "+64",
        "area_code": "11",
        "number": "936360268"
      }
    }
  ],
  "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"
        }
      ]
    }
  ]
}

转让方定义

字段	类型	描述	字符数
`annual_revenues`	number	转让方的年营收声明。	-
`email`	string	转让方的电子邮件地址。	1 至 255
`is_in_national_financial_system`	boolean	表示转让方是否为 SFN 成员。	-
`phone`	object	转让方电话信息对象。	请参见电话定义。
`address`	object	转让方地址信息对象。	请参见地址定义。
`related_parties`	array	公司关联方列表。	请参见关联方定义。
`guarantors`	array	转让方担保人列表。	请参见担保人定义。

如果不想更改某个字段，只需在请求中不发送该字段。对于列表，如 related_parties 和 guarantors，如果发送了空列表，或之前列表中存在但新列表中未包含的某方，将被视为删除处理。

Response

STATUS

200

Response Body
{
  "assignor_registry_key": "c4295375-4077-4092-a258-5bcdf8875907",
  "status": "registred",
  "name": "QI Tech",
  "document_number": "32.402.502/0001-35",
  "last_analysis": {
    "analysis_key": "d7805a05-98a7-486b-a440-807f1d3d5691",
    "analysis_number": 2,
    "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	审查对象。	请参见审查定义。

信息

重要的是存储 analysis_key 和 analysis_related_party_key，它们将用于提交转让方和关联方的文件。

注意！

更新转让方注册时，将生成新的注册分析，产生新的 analysis_key 和新的 analysis_related_party_key。注册只有在此新分析获得批准后才会正式更新。

重要！

无法更新转让方的基本数据，如文件编号和人员类型。可更改的注册数据包括：

名称/公司名称；
电子邮件；
地址；
电话；
营收；
SFN 参与状态；
关联方（现有关联方的添加和更改）；
担保人（现有担保人的添加和更改）；

定义

地址定义

字段	类型	描述	字符数
`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

*必填字段。

电话定义

字段	类型	描述	字符数
`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	与转让方直接或间接关联的受益人。	1 至 255
`is_representative` *	boolean	表示关联方是否为转让方的签署代表。	1 至 255
`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。 ***若关联方与转让方非直接关联，则为必填。 ****仅签署代表必填。

审查定义

字段	类型	描述	字符数
`analysis_key` *	string	审查标识符。	36
`analysis_number` *	integer	审查的顺序编号。	-
`status` *	string	审查状态。	请参见审查状态枚举。
`analysis_related_parties` *	array	审查的关联方。	请参见审查关联方定义。
`documents` *	array	审查的文件。	请参见文件定义。
`analysis_data` *	object	生成该审查的请求负载。	-
`analysis_datetime` *	string	审查创建的日期时间对象。	-
`reproval_reason`	string	审查拒绝原因的枚举值。	请参见拒绝原因枚举。
`reproval_details`	string	审查拒绝详情的自由字段。	-

*必填字段。

担保人定义

字段	类型	描述	字符数
`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。

*必填字段。

担保人代表仅应为法人担保人发送。

注意

担保人及其代表也将被添加到生成的分析中，需要根据其人员类型发送标准文件。他们也将经过合规流程，可能会产生问题点。

担保人代表定义

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

文件定义

字段	类型	描述	字符数
`document_key` *	string	文件标识符。	36
`document_type` *	string	文件类型。	请参见文件类型枚举。
`status`	string	文件状态。	请参见文件状态枚举。
`observation`	string	发送的备注。	-

*必填字段。

审查关联方定义

字段	类型	描述	字符数
`analysis_representative_key` *	string	代表标识符。	36
`document_number` *	string	代表文件编号。	14 至 18
`name`	string	受益人名称。	1 至 255
`documents` *	枚举值	代表审查的文件。	请参见文件定义。

*必填字段。

枚举值

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	代理人

Document Status

枚举值	描述
created	已创建
valid	有效
invalid	无效
canceled	已取消
accepted	已接受，但未验证

Document Type

枚举值	描述
cnh	驾驶执照。
rg_back	身份证背面。
rg_front	身份证正面。
passport	护照 - 仅限外国人。
national_migration_registry	国家移民登记。
cin_digital	国家数字身份证。
social_contract	社会合同/公司章程。
cnpj_card	CNPJ 卡。
commercial_board_certificate	商业局简化证书。
board_election_record	现任董事会选举记录。
power_of_attorney	授权委托书 - 若代表为代理人则为必填。
marital_power_of_attorney	婚姻授权委托书 - 仅适用于配偶。
compliance_statement	合规意见书。
financial_statement	财务报表。
credit_report	信贷记录/意见书。
manager_statement	基金经理意见书/表格。
visit_report	访问报告。
proof_of_residence	居住证明。
credit_agency_consulation	信用保护机构查询。
annual_revenues_declaration	年营收声明。
financial_institutions_declaration	银行关系声明。
additional_document	附加文件 - 自由格式。

Analysis Reproval Reason

枚举值	描述
assignor_update	因后续注册更新而取消的分析
insuficient_documents	未提交证明授权所需的最少文件
compliance_reproval	合规团队分析拒绝关联
unidentified_related_parties	已提交关联方，但关联关系未得到证明
invalid_documents	文件无效/过期
missing_related_parties	未提交必要的关联方

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​

Document Status​

Document Type​

Analysis Reproval Reason​

Marital Status​

Property System​

法人转让方注册更新

Request

转让方定义

Response

定义

地址定义

电话定义

关联方定义

审查定义

担保人定义

担保人代表定义

文件定义

审查关联方定义

Assignor Registry Status

Analysis Status

Related Party Type

Document Status

Document Type

Analysis Reproval Reason

Marital Status

Property System