# QI Tech — Banking-as-a-Service › 用户管理

Documentação da QI Tech em texto corrido, para colar em um LLM.
Fonte: https://docs.qitech.com.br
9 página(s).

Índice:
- 修改人员联系方式 (/zh-Hans/documentation/gestao_de_usuarios/alteracao_de_contato_de_pessoa)
- 修改关联联系方式 (/zh-Hans/documentation/gestao_de_usuarios/alteracao_de_contato_de_vinculo)
- 修改个人数据 (/zh-Hans/documentation/gestao_de_usuarios/alteracao_de_dados_pessoais)
- 修改地址 (/zh-Hans/documentation/gestao_de_usuarios/alteracao_de_endereco)
- 查询关联方 (/zh-Hans/documentation/gestao_de_usuarios/consulta_partes_relacionadas)
- 创建人员 (/zh-Hans/documentation/gestao_de_usuarios/criacao_de_pessoa)
- 删除关联 (/zh-Hans/documentation/gestao_de_usuarios/exclusao_de_vinculo)
- 添加关联 (/zh-Hans/documentation/gestao_de_usuarios/inclusao_de_vinculo)
- 双因素授权（TFA）简介 (/zh-Hans/documentation/gestao_de_usuarios/tfa_introducao)

---

# 修改人员联系方式

URL: /zh-Hans/documentation/gestao_de_usuarios/alteracao_de_contato_de_pessoa

## 1. 请求令牌

ENDPOINT /person/token_request
方法 POST

### Body Params

| 字段 | 类型 | 描述 |
|---|---|---|
| `contact_type` | string | 联系方式类型：`sms` 或 `email` |
| `person_contact_update` | object | 包含联系方式更新数据的对象 |

### person_contact_update 对象

| 字段 | 类型 | 描述 |
|---|---|---|
| `person_key` | string | 人员的唯一标识符 |
| `phone_number` | string | 新电话号码 |
| `email` | string | 新电子邮件地址 |

---

## 2. 令牌验证

ENDPOINT /person/token_validation
方法 POST

### Body Params

| 字段 | 类型 | 描述 |
|---|---|---|
| `token` | string | 收到的验证令牌 |
| `agent_document_number` | string | 操作员的 CPF |
| `person_contact_update` | object | 包含联系方式更新数据的对象（与请求令牌中相同）|

---

# 修改关联联系方式

URL: /zh-Hans/documentation/gestao_de_usuarios/alteracao_de_contato_de_vinculo

## 1. 请求令牌

ENDPOINT /professional_data/token_request
方法 POST

### Body Params

| 字段 | 类型 | 描述 |
|---|---|---|
| `contact_type` | string | 联系方式类型：`sms` 或 `email` |
| `professional_data_contact_update` | object | 包含联系方式更新数据的对象 |

### professional_data_contact_update 对象

| 字段 | 类型 | 描述 |
|---|---|---|
| `natural_person` | string | 自然人的唯一标识符 |
| `professional_data_key` | string | 职业数据的唯一标识符 |
| `email` | string | 新电子邮件地址 |
| `phone_number` | string | 新电话号码 |

---

## 2. 令牌验证

ENDPOINT /professional_data/token_validation
方法 POST

### Body Params

| 字段 | 类型 | 描述 |
|---|---|---|
| `token` | string | 收到的验证令牌 |
| `professional_data_contact_update` | object | 包含联系方式更新数据的对象（与请求令牌中相同）|

---

# 修改个人数据

URL: /zh-Hans/documentation/gestao_de_usuarios/alteracao_de_dados_pessoais

ENDPOINT /person/PERSON_KEY/personal_data
方法 PATCH

## Body Params

| 字段 | 类型 | 描述 |
|---|---|---|
| `name` | string | 人员姓名 |
| `date_of_birth` | string | 出生日期（格式 "YYYY-MM-DD"）|
| `profession` | string | 职业 |
| `mother_name` | string | 母亲姓名 |
| `father_name` | string | 父亲姓名 |
| `birth_place` | string | 出生地 |
| `spouse_name` | string | 配偶姓名 |
| `is_pep` | boolean | 是否为政治公众人物（PEP）|
| `revenue_amount` | float | 月收入 |
| `onboarding_key` | string | Onboarding 的唯一标识符 |

---

# 修改地址

URL: /zh-Hans/documentation/gestao_de_usuarios/alteracao_de_endereco

ENDPOINT /person/PERSON_KEY/address
方法 PUT

## Body Params

| 字段 | 类型 | 描述 |
|---|---|---|
| `street` | string | 街道名称 |
| `complement` | string | 地址补充信息 |
| `state` | string | 州（两位大写字母）|
| `number` | string | 门牌号 |
| `neighborhood` | string | 社区/街区 |
| `postal_code` | string | 邮政编码（仅数字）|
| `city` | string | 城市 |

---

# 查询关联方

URL: /zh-Hans/documentation/gestao_de_usuarios/consulta_partes_relacionadas

ENDPOINT /account/ACCOUNT_KEY/related_parties
方法 GET

此端点用于查询法人（PJ）账户的关联方。

## 响应字段

| 字段 | 类型 | 描述 |
|---|---|---|
| `allowed_users` | array | 授权用户列表 |
| `legal_person_key` | string | 法人实体的唯一标识符 |
| `owner_document_number` | string | 账户所有人的 CNPJ 或 CPF |
| `owner_name` | string | 账户所有人名称 |

### allowed_users 对象

| 字段 | 类型 | 描述 |
|---|---|---|
| `natural_person_document_number` | string | 自然人的 CPF |
| `natural_person_key` | string | 自然人的唯一标识符 |
| `natural_person_name` | string | 自然人姓名 |
| `professional_data_key` | string | 职业数据的唯一标识符 |

---

# 创建人员

URL: /zh-Hans/documentation/gestao_de_usuarios/criacao_de_pessoa

## 1. 请求令牌

ENDPOINT /person/token_request
方法 POST

## 2. 令牌验证

ENDPOINT /person/token_validation
方法 POST

### person_creation 对象

| 字段 | 类型 | 描述 |
|---|---|---|
| `address` | object | 人员地址 |
| `date_of_birth` | string | 出生日期（格式 "YYYY-MM-DD"）|
| `document_identification_number` | string | 身份证件号码 |
| `email` | string | 电子邮件地址 |
| `document_number` | string | CPF（仅数字）|
| `is_pep` | boolean | 是否为政治公众人物（PEP）|
| `mother_name` | string | 母亲姓名 |
| `name` | string | 人员姓名 |
| `nationality` | string | 国籍 |
| `birth_place` | string | 出生地 |
| `person_type` | string | 人员类型（自然人或法人）|
| `phone_number` | string | 电话号码 |

---

# 删除关联

URL: /zh-Hans/documentation/gestao_de_usuarios/exclusao_de_vinculo

## 1. 请求令牌

ENDPOINT /professional_data/token_request
方法 POST

## 2. 令牌验证

ENDPOINT /professional_data/token_validation
方法 POST

此流程用于删除自然人与法人之间的职业数据关联。

### Body Params

| 字段 | 类型 | 描述 |
|---|---|---|
| `natural_person` | string | 自然人的唯一标识符 |
| `legal_person` | string | 法人实体的唯一标识符 |

---

# 添加关联

URL: /zh-Hans/documentation/gestao_de_usuarios/inclusao_de_vinculo

## 1. 请求令牌

ENDPOINT /professional_data/token_request
方法 POST

## 2. 令牌验证

ENDPOINT /professional_data/token_validation
方法 POST

此流程用于在自然人与法人之间创建职业数据关联，包括角色和产品权限。

### Body Params

| 字段 | 类型 | 描述 |
|---|---|---|
| `natural_person` | string | 自然人的唯一标识符 |
| `legal_person` | string | 法人实体的唯一标识符 |
| `natural_person_roles` | array | 角色列表 |
| `post_type` | string | 职位类型 |

### natural_person_roles 对象

| 字段 | 类型 | 描述 |
|---|---|---|
| `product_type` | string | 产品类型 |
| `role_type` | string | 角色类型 |

---

# 双因素授权（TFA）简介

URL: /zh-Hans/documentation/gestao_de_usuarios/tfa_introducao

双因素授权（TFA）系统用于验证敏感操作。该流程分为两个步骤：

## 流程

1. **令牌请求（token_request）**：系统向用户发送验证令牌（通过 SMS 或 email）。
2. **令牌验证（token_validation）**：用户提交收到的令牌以确认操作。

:::info Sandbox 环境

在 Sandbox 环境中，验证令牌始终为 **`329329`**。

:::