注册更新

管理人有责任根据公司的实际情况保持转让方数据的更新。这一责任极为重要，既是为了保持反洗钱（PLD）审查的时效性，也是为了更新签署人组——签署人组经常变化且会过期，届时需要进行新的审查。此外，每 2 年系统会自动生成一次新的审查，以确保信息定期更新。

提示

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

更新注册时，无论修改哪个字段，都会生成一次新的审查，并根据所做的修改要求提交新文件。审查按序号进行，在最终获得合规审批之前可能多次失败。只有在审查成功完成后，修改才会生效。如果关联方发生变化，还会有一个校验转让方签署人组的环节。需要特别注意的是，如果某个关联方或担保人未被发送，则视为将其删除。

信息

如果提交注册更新时有审查正在进行中，该审查会被自动取消（analysis_status: canceled，reproval_details 注明为注册更新），并生成新的审查。

法人转让方注册更新

适用范围

角色	主机	所需权限
管理人	`manager-api`	写入
顾问	`consultant-api`	Register 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,
  "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": "123.456.789-09",
      "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": "969.698.790-03",
      "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": "222.333.444-05",
      "person_type": "natural_person",
      "email": "email@avalista.com"
    },
    {
      "name": "Avalista PJ",
      "document_number": "22.333.444/0001-81",
      "person_type": "legal_person",
      "email": "email@avalista.com",
      "guarantor_representatives": [
        {
          "name": "Assinante do Avalista",
          "document_number": "111.444.777-35",
          "email": "emailrepresentante@avalista.com"
        }
      ]
    }
  ]
}

转让方定义

字段	类型	描述	字符数
`name`	string	转让方的名称/公司名称。	1 到 255
`annual_revenues`	integer	转让方申报的年营业收入，取整数。	最小值 1
`email`	string	转让方的邮箱地址。	1 到 255
`is_in_national_financial_system`	boolean	指示转让方是否属于巴西国家金融体系（SFN）成员。	-
`phone`	object	转让方电话信息对象。	见电话定义。
`address`	object	转让方地址信息对象。	见地址定义。
`related_parties`	array	公司关联方列表。	见关联方定义。
`minimum_required_signers`	integer	需要代表转让方签署的最少代表人数。	最小值 1
`guarantors`	array	转让方的担保人列表。	见担保人定义。

如不希望修改某个字段，只需不在请求中发送该字段。对于列表（例如 related_parties 和 guarantors），如果发送空列表，或此前列表中已有的某一方未出现在新列表中，将被视为删除。

Response

STATUS

200

Response Body
{
  "assignor_registry_key": "c4295375-4077-4092-a258-5bcdf8875907",
  "status": "registered",
  "name": "Cedente Exemplo LTDA",
  "document_number": "55.666.777/0001-81",
  "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": "969.698.790-03",
        "name": "Roberto Carlos",
        "documents": []
      },
      {
        "analysis_related_party_key": "d4c75c93-4aa9-4567-89c4-b49334927721",
        "document_number": "123.456.789-09",
        "name": "Natália Nascimento",
        "documents": []
      },
      {
        "analysis_related_party_key": "8a3e2f61-0c4b-4d7e-9f15-2b6c7d8e9a01",
        "passport_number": "C01X00T47",
        "name": "Maria Vitoria",
        "documents": []
      }
    ],
    "documents": [
      {
        "document_key": "994621ac-7d3f-4f6b-90c5-74a4d8c5d017",
        "document_type": "social_contract",
        "status": "valid"
      }
    ]
  }
}

字段	类型	描述	字符数
`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 成员；
关联方（新增和修改现有关联方）；
担保人（新增和修改现有担保人）；

错误

状态码	代码	触发条件
404	`ASR000004`	未找到所提供 `assignor_registry_key` 对应的转让方。请检查 `assignor_registry_key` 是否存在（对于管理人和顾问，还需检查该注册是否属于您的集成）。
400	`ASR000100`	所发送的字段不能在分支机构中更新：`name`、`related_parties` 和 `guarantors` 始终沿用总部的数据。如需修改，请更新总部的注册。
400	`ASR000128`	与该总部关联的某个分支机构的审查正在进行中。请等待分支机构的审查结束后，再重新提交总部的更新。
400	`ASR000056`	自然人不能是国家金融体系成员。对于自然人转让方，请发送 `is_in_national_financial_system=false` 或省略该字段。
400	`ASR000054`	法人转让方必须至少有 1 个关联方。请确保（更新后的）`related_parties` 中至少有一项。
400	`ASR000057`	法人转让方必须至少有 1 名签署代表。请确保至少有一个关联方的 `is_representative=true`。
400	`ASR000011`	关联方证件号重复。`related_parties` 中的每个 `document_number` 必须唯一。
400	`ASR000041`	代表必须提供邮箱。对于 `is_representative=true` 的关联方，请提供 `email`。
400	`ASR000058`	没有 CPF 的外国人不能作为签署人。没有 `document_number`（CPF）的外国人不能设置 `is_representative=true`。
400	`ASR000078`	担保人证件号重复。`guarantors` 中的每个担保人必须有唯一的 `document_number`。
400	`ASR000079`	自然人担保人不接受代表。对于 `person_type=natural_person`，仅接受配偶：`related_party_type: spouse`。
400	`ASR000080`	担保人代表的证件号重复。`guarantor_representatives` 中的每个代表必须有唯一的 `document_number`。
400	`ASR000091`	法人担保人必须至少有一名代表。对于 `person_type=legal_person`，请在 `guarantor_representatives` 中至少发送一项。

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

法人转让方注册更新​

Request​

转让方定义​

Response​

错误​

法人转让方注册更新

Request

转让方定义

Response

错误