跳到主要内容

提交注册

在转让方注册的第一步，需要提交其数据，具体定义见下文。 需要再次说明的是，仅提交数据并不会创建可运营的转让方，只有在其文件审查成功完成后，转让方才会被启用。

法人必须、自然人可选地注册关联方，即与转让方相关的最终受益人。

信息

最终受益人是指在公司或企业集团中具有重要影响力、拥有决策权或在股权结构中持有重大权益的个人或个人群体。在注册时，应考虑在公司或其所属企业集团中持股超过 15% 的任何股东；如没有如此重大的持股，则按持股比例从高到低取前三名。

如果相关受益人是另一家公司，则应列出该公司的最终受益人，并标记为间接受益人。此外，参与业务的任何受托人、经理和董事也被视为关联方，他们将作为转让方在业务中的签署代表。

签署代表是负责通过我们的系统跟进并签署发给转让方的文件的关联方；对于公司，需要通过股东结构、董事名单或授权书证明其关联关系。对于自然人转让方，不能注册受托人以外的关联方。此外，还需注明作为最终受益人的关联方与转让方是直接关联还是间接关联。

Sandbox

在 Sandbox 中，审查结果取决于转让方证件号（document_number）的第一位数字：以 1 开头，自动拒绝；以 8 开头，审查进入人工校验（pending_internal_validation）；其他情况自动审批通过。

转让方注册​

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

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

Request​

ENDPOINT
/assignor_registry/assignor_registry
MÉTODO
POST
Request Body
{
  "name": "Cedente Exemplo LTDA",
  "document_number": "55.666.777/0001-81",
  "person_type": "legal_person",
  "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",
      "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": "969.698.790-03",
      "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",
      "address": {
        "street": "Rua Maria Carolina",
        "number": "624",
        "neighborhood": "Jardim Paulistano",
        "city": "São Paulo",
        "postal_code": "01445-000",
        "uf": "SP",
        "country": "BRA"
      },
      "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",
          "address": {
            "street": "Rua Maria Carolina",
            "number": "624",
            "neighborhood": "Jardim Paulistano",
            "city": "São Paulo",
            "postal_code": "01445-000",
            "uf": "SP",
            "country": "BRA"
          }
        }
      ]
    }
  ]
}

转让方定义​

字段类型描述字符数
name *string转让方名称。1 到 255
document_number *string转让方的 CPF 或 CNPJ，带格式（000.000.000-00 或 00.000.000/0000-00）。14 到 18
annual_revenues *number转让方申报的年营业收入，整数。最小值 1
person_type *stringnatural_person（自然人）或 legal_person（法人）。-
email *string转让方的邮箱地址。1 到 255
is_in_national_financial_system *boolean指示转让方是否属于巴西国家金融体系（SFN）成员。-
phoneobject转让方电话信息对象。见 电话定义。
address *object转让方地址信息对象。见 地址定义。
related_parties **array公司关联方列表。见 关联方定义。
accountsarray转让方的放款账户列表。没有账户则无法提出转让合同。见 账户定义。
guarantorsarray转让方的担保人列表。见 担保人定义。
minimum_required_signersinteger需要代表转让方签署的最少代表人数。最小值 1

*必填字段。

**法人必填，且至少包含一名签署代表（is_representative: true）。

Response​

STATUS
201
Response Body
{
  "assignor_registry_key": "c4295375-4077-4092-a258-5bcdf8875907",
  "status": "pending_registry",
  "name": "Cedente Exemplo LTDA",
  "document_number": "55.666.777/0001-81",
  "related_parties": [
    {
      "related_party_key": "0b6f6a52-6c1e-4f4e-9d2a-1f3c5e7a9b10",
      "name": "Natália Nascimento",
      "document_number": "123.456.789-09",
      "direct_beneficiary": true,
      "is_representative": true,
      "related_party_type": "attorney"
    },
    {
      "related_party_key": "3e9d1c7b-2a4f-4b8e-8c6d-5f7a9b1c3d20",
      "name": "Maria Vitoria",
      "document_number": null,
      "direct_beneficiary": true,
      "is_representative": false,
      "related_party_type": "president",
      "passport_number": "C01X00T47"
    },
    {
      "related_party_key": "7a2c4e6f-8b0d-4f1a-9c3e-5d7f9a1b3c30",
      "name": "Roberto Carlos",
      "document_number": "969.698.790-03",
      "direct_beneficiary": false,
      "is_representative": false,
      "related_party_type": "director"
    }
  ],
  "last_analysis": {
    "analysis_key": "d7805a05-98a7-486b-a440-807f1d3d5691",
    "analysis_number": 1,
    "status": "pending_documents",
    "analysis_datetime": "2026-01-15T14:32:10Z",
    "analysis_related_parties": [
      {
        "analysis_related_party_key": "5cdcc13b-c67d-45f3-aa66-36cb4f178b59",
        "name": "Roberto Carlos",
        "document_number": "969.698.790-03",
        "analysis_roles": [{ "related_party_type": "director" }],
        "documents": []
      },
      {
        "analysis_related_party_key": "d4c75c93-4aa9-4567-89c4-b49334927721",
        "name": "Natália Nascimento",
        "document_number": "123.456.789-09",
        "analysis_roles": [{ "related_party_type": "attorney" }],
        "documents": []
      },
      {
        "analysis_related_party_key": "8a3e2f61-0c4b-4d7e-9f15-2b6c7d8e9a01",
        "name": "Maria Vitoria",
        "document_number": null,
        "analysis_roles": [{ "related_party_type": "president" }],
        "documents": [],
        "passport_number": "C01X00T47"
      },
      {
        "analysis_related_party_key": "1f4b6d8a-3c5e-4a7b-9d1f-2e4a6c8b0d40",
        "name": "Avalista PF",
        "document_number": "222.333.444-05",
        "analysis_roles": [{ "related_party_type": "guarantor" }],
        "documents": []
      },
      {
        "analysis_related_party_key": "9c1e3a5b-7d9f-4b2c-8e4a-6f8b0c2d4e50",
        "name": "Avalista PJ",
        "document_number": "22.333.444/0001-81",
        "analysis_roles": [{ "related_party_type": "guarantor" }],
        "documents": []
      },
      {
        "analysis_related_party_key": "4d6f8b0c-2e4a-4c6d-8f0b-1a3c5e7d9f60",
        "name": "Assinante do Avalista",
        "document_number": "111.444.777-35",
        "analysis_roles": [{ "related_party_type": "guarantor_representative" }],
        "documents": []
      }
    ],
    "documents": [],
    "annotations": [],
    "last_updated": "2026-01-15T14:32:10Z",
    "analysis_origin_type": "assignor_registry",
    "reproval_reason": null,
    "reproval_details": null
  }
}
字段类型描述字符数
assignor_registry_keystring注册的标识。36
statusstring注册状态。见 注册状态枚举值。
namestring转让方名称。1 到 255
document_numberstring转让方的证件号。14 到 18
related_partiesarray转让方的关联方，包含 related_party_key、name、document_number、direct_beneficiary、is_representative、related_party_type，外国人还包含 passport_number。-
last_analysisobject审查对象。见 审查定义。
信息

请务必保存 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
complementstring地址补充信息。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受益人与转让方是直接还是间接关联。1 到 255
is_representative *boolean指示该关联方是否为转让方的签署代表。1 到 255
company_registry_number ***string如未与转让方直接关联，其所关联的公司。1 到 255
company_country ***string连接受益人与转让方的中间公司的注册国家。3，遵循 ISO 3166-1 alpha-3
addressobject代表的地址信息对象。见 地址定义。
email ****string代表的邮箱地址。1 到 255
phoneobject代表的电话信息对象。建议签署代表提供。见 电话定义。
marital_statusstring关联方的婚姻状况。见 婚姻状况枚举值。
property_systemstring夫妻财产制度。见 夫妻财产制度枚举值。
professionstring关联方的职业。1 到 255。

*必填字段。

**巴西人必须提供 document_number；外国人如有 CPF，可使用 document_number，否则至少需要发送 passport_number。

***当关联方不是与转让方直接关联的受益人时必填。否则不应发送。

****仅签署代表必须提供。

信息

marital_status 和 address 等非必填字段，如希望在后续步骤的转让主合同中有更完整的身份信息，可以一并发送。

审查定义​

字段类型描述字符数
analysis_key *string审查的标识。36
analysis_number *integer审查的序号。-
status *string审查状态。见 审查状态枚举值。
analysis_related_parties *array审查的关联方。见 审查关联方定义。
documents *array审查的文件。见 审查文件定义。
analysis_datetime *string审查创建的日期时间（ISO 8601，UTC）。-
annotations *array审查的审查意见。-
last_updated *string审查最后一次变更的日期时间（ISO 8601，UTC）。-
analysis_origin_type *string审查的来源。通过 API 提交的注册为 assignor_registry。-
analysis_dataobject产生该审查的 request body。仅在审查查询中返回，注册的返回结果中不包含。-
reproval_reasonstring审查被拒绝原因的枚举值。见 拒绝原因枚举值。
reproval_detailsstring审查被拒绝详情的自由文本字段。-

*必填字段。

审查关联方定义​

字段类型描述字符数
analysis_related_party_key *string关联方的标识。36
document_number *string关联方的证件号。14 到 18
name *string关联方名称。1 到 255
passport_numberstring护照号，仅适用于提供了护照的外国人。-
analysis_roles *array该人员在审查中的角色，每项含 related_party_type（例如 director、guarantor 或 guarantor_representative）。-
documents *array关联方审查的文件。见 审查文件定义。

*必填字段。

文件定义​

字段类型描述字符数
document_key *string文件的标识。36
document_type *string文件类型。见 文件类型枚举值。
statusstring文件状态。见 文件状态枚举值。
observationstring所发送的备注。-

*必填字段。

账户定义​

字段类型描述字符数
account_branch *string转让方账户所属分行。4
account_number *string转让方的账号。仅数字。3 - 20
account_digit *string转让方账户的校验位。1
financial_institution_code *string转让方账户所属银行的代码。3
account_type *string账户类型。见 账户类型枚举值。
default_account *boolean默认放款账户。-
descriptionstring账户的自由描述。最多 255

*必填字段。

转让方只能有一个默认账户；如未指定备用账户，转让款项将汇入该账户。如果发送了多个默认账户，将返回错误。

注意

填写账户数据时务必谨慎。如果账户无效，转让付款将无法完成，整个业务将被取消。

担保人定义​

字段类型描述字符数
name *string担保人姓名。3 - 255
document_number *string担保人的证件号。14 到 18
person_type *string人员类型（自然人或法人）。-
email *string担保人的邮箱地址。1 到 255
nationalitystring担保人的原籍国。3，遵循 ISO 3166-1 alpha-3
phoneobject担保人的电话信息对象。见 电话定义。
addressobject担保人的地址信息对象。见 地址定义。
guarantor_representativesarray法人担保人的代表，或自然人担保人的配偶。见 担保人代表定义。
marital_statusstring担保人的婚姻状况。见 婚姻状况枚举值。
property_systemstring夫妻财产制度。见 夫妻财产制度枚举值。
professionstring担保人的职业。1 到 255。

*必填字段。

guarantor_representatives 字段既可用于指定法人担保人的代表，也可在自然人担保人需要时用于指定配偶，以完成配偶同意（Outorga Uxória）。

注意

担保人及其代表也会被加入所生成的审查中，需要根据其人员类型提交标准文件。他们同样会经过合规流程，可能产生审查意见。

担保人代表定义​

字段类型描述字符数
name *string代表姓名。3 - 255
document_number *string担保人代表的证件号——必须为自然人。14
email *string担保人代表的邮箱地址。1 到 255
nationalitystring担保人代表的原籍国。3，遵循 ISO 3166-1 alpha-3
addressobject担保人代表的地址信息对象。见 地址定义。
phoneobject担保人代表的电话信息对象。见 电话定义。
marital_statusstring担保人代表的婚姻状况。见 婚姻状况枚举值。
property_systemstring夫妻财产制度。见 夫妻财产制度枚举值。
professionstring担保人代表的职业。1 到 255。
related_party_typestring法人担保人的代表为 guarantor_representative（默认）；自然人担保人的配偶为 spouse（配偶同意）。-

枚举值​

Assignor Registry Status​

枚举值描述
created已创建（过渡状态）
pending_registry待注册
pending_manual_approval等待 QI DTVM 人工审批
registered已注册
rejected已拒绝
blocked已冻结

Analysis Status​

枚举值描述
created已创建（过渡状态）
pending_documents等待文件
sent_to_analysis已提交审查
pending_internal_validation文件校验中
in_manual_analysis合规人工审查中
in_risk_analysis风险审查中
approved已审批通过
reproved已拒绝
canceled已取消
枚举值描述
president总裁
partner合伙人
administrator管理者
director董事
manager经理
attorney受托人
spouse配偶
legal_representative法定代表人

Document Status​

枚举值描述
created已创建
valid有效
invalid无效
canceled已取消
accepted已接受，但未校验
inconclusive校验结果不确定

Document Type​

枚举值描述
cnhCNH。
rg_backRG 背面。
rg_frontRG 正面。
passport护照——仅限外国人。
national_migration_registry国家移民登记（Registro Nacional de Migração）。
national_registry_of_foreigners国家外国人登记（Registro Nacional de Estrangeiros）。
cin_digital国民身份证（电子版）。
social_contract公司章程/社团章程。
cnpj_cardCNPJ 卡。
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附加文件——自由类型。

Account Type​

枚举值描述
checking_account活期账户
saving_account储蓄账户
escrow_account监管账户（escrow）

Analysis Reproval Reason​

枚举值描述
assignor_update因后续的注册更新，审查被取消
insuficient_documents未提交证明权限所需的最低文件
compliance_reproval合规团队审查后拒绝该关联关系
unidentified_related_parties已提交关联方，但关联关系未得到证明
invalid_documents文件无效/已过期
missing_related_parties未提交必需的关联方
risk_analysis_reproval风险审查未通过

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法定分别财产制

错误​

状态码代码触发条件
409ASR000032该代理方已注册过此转让方。该 document_number 已有注册；请使用注册更新流程。
400ASR000054法人转让方必须至少有 1 个关联方。请在 related_parties 中至少包含一个关联方。
400ASR000056自然人不能是国家金融体系成员。对于 person_type=natural_person，请发送 is_in_national_financial_system=false。
400ASR000057法人转让方必须至少有 1 名签署代表。请确保至少有一个关联方的 is_representative=true。
400ASR000011关联方证件号重复。related_parties 中的每个 document_number 必须唯一。
400ASR000041is_representative=true 的关联方缺少 email。请提供代表的邮箱。
400ASR000058没有 CPF 的外国人不能作为签署人。没有 document_number（CPF）的外国人不能设置 is_representative=true。
404ASR000071未找到金融机构。请核实为账户提供的 financial_institution_code（银行代码）。
400ASR000087账户信息只能包含数字。account_branch、account_number 和 account_digit 只能填写数字。
400ASR000081发送了多个默认账户。只能有一个账户设置 default_account=true。
400ASR000078担保人证件号重复。guarantors 中的每个担保人必须有唯一的 document_number。
400ASR000079自然人担保人不接受代表。对于 person_type=natural_person，仅接受配偶：related_party_type: spouse。
400ASR000080担保人代表的证件号重复。guarantor_representatives 中的每个代表必须有唯一的 document_number。
400ASR000091法人担保人必须至少有一名代表。对于 person_type=legal_person，请在 guarantor_representatives 中至少发送一项。

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