Legal Person 对象
在您的平台完成企业注册后，需要对该公司进行反欺诈和 KYC 评估，这应通过 Legal Person 端点完成。提交的数据必须是最终数据，不得以任何方式更改，即在此流程之后，不应存在修改基本注册数据（如 CNPJ、公司名称、成立日期等）的可能性。这对于保证以下两点至关重要：
- 反欺诈数据库中数据的一致性
- 真实的风险评估，避免后续操作中的欺诈行为
Legal Person 对象定义
Request Body
{
"id": "12345678",
"registration_id": "12345678",
"registration_date": "2019-12-11T11:37:15.12-03:00",
"client_category" : "Premium Account",
"legal_name": "John's Company",
"trading_name": "John's Barbershop",
"document_number": "11.111.111/0001-11",
"foundation_date": "1992-09-15",
"website": "www.johnsbarbershop.com.br",
"activity": "Barber Shops",
"activity_code": "96.02-5-01",
"merchant_category_code": "0742",
"tier" : "epp",
"annual_revenues": 72000000,
"emails":[
{
"email": "johnsample@test.com",
"validation_type":"zaig_api",
"validation_key": "ccc4b4b4-f91c-4475-8290-07152550aefc"
}
],
"documents": {
"ie": {
"number": "388.108.598.269",
"issuer": "JUCESP",
"issuer_state": "SP",
"issuance_date":"2002-01-12",
"validation_type": "zaig_api",
"ocr_key": "c64627db-1ba4-48b6-979d-06222a25d5e9"
},
"company_statute": {
"ocr_key": "60ed79c4-5aba-4cc7-aebb-5de5f92b7d0d"
}
},
"address": {
"street": "Rua do Teste",
"number": "111",
"neighborhood": "Bairro do Exemplo",
"city": "Aparecida de Goiânia",
"uf": "GO",
"complement": "Térreo",
"postal_code": "00000-000",
"country": "BRA",
"validation_type": "visit",
"ocr_key": "265b1b74-4b93-41dc-ac78-e1c37467225d"
},
"phones": [
{
"international_dial_code": "1",
"area_code": "11",
"number": "999999999",
"type": "mobile",
"validation_type": "zaig_sms",
"validation_key": "82473dec-8e14-4570-997a-59652818c908"
}
],
"source": {
"channel": "app",
"platform": "android",
"ip":"201.6.142.66",
"session_id": "c90ad2df-7307-4f82-8938-1da81dff2be6"
},
"legal_representatives": [
{
"name": "Frederic Attorney",
"document_number": "111.111.111-11",
"birthdate": "1987-06-12",
"gender": "male",
"nationality": "BRA",
"mother_name": "Jackie Attorney Mother",
"occupation": "Accountant",
"emails":[
{
"email": "frederic@attorney.com",
"validation_type":"zaig_api",
"validation_key": "d174d522-6003-4b05-adb2-e92e92632c67"
}
],
"documents": {
"letter_of_attorney": {
"ocr_key": "6972894d-d2ef-4b5f-b54f-10f178bf3e5d"
},
"cnh": {
"register_number": "05163811694",
"issuer_state": "PR",
"first_issuance_date":"2011-03-21",
"issuance_date":"2016-06-29",
"expiration_date":"2021-06-25",
"category": "AB",
"validation_type":"zaig_sdk",
"ocr_key":"a5cf9c8f-2f66-4490-a7db-8a5bc70c1b76"
}
},
"address": {
"street": "Avenida de Exemplo",
"number": "99",
"neighborhood": "Vila do Exemplo",
"city": "Jundiaí",
"uf": "SP",
"complement": "Ap 82",
"postal_code": "00000-000",
"country": "BRA",
"validation_type":"visit",
"ocr_key": "265b1b74-4b93-41dc-ac78-e1c37467225d"
},
"phones": [
{
"international_dial_code": "55",
"area_code": "11",
"number": "999998877",
"type": "mobile",
"validation_type": "zaig_sms",
"validation_key": "e390d2b3-cb71-4991-9d94-1b7f8b43a04e"
}
],
"source": {
"channel": "app",
"platform": "ios",
"ip":"175.92.122.2",
"session_id": "93c68588-7a41-472f-95b3-835ea6ee1ede"
},
"face":
{
"type":"zaig_sdk",
"registration_key":"d2677a8c-d575-44e1-a54d-ec00f9310f34"
}
}
],
"partners": [
{
"name": "John Partner",
"document_number": "111.111.111-11",
"birthdate": "1992-09-15",
"gender": "male",
"nationality": "BRA",
"mother_name": "Maria Partner's Mother",
"occupation": "Teacher",
"emails":[
{
"email": "johnsample@test.com",
"validation_type":"zaig_api",
"validation_key": "1fac6f8c-1a16-4a12-9afc-9a2d9ae0a31e"
}
],
"documents": {
"rg": {
"number": "4.366.477-8",
"issuer": "II",
"issuer_state": "PR",
"issuance_date":"2002-01-12",
"validation_type":"zaig_sdk",
"ocr_front_key":"a5cf9c8f-2f66-4490-a7db-8a5bc70c1b76",
"ocr_back_key":"a5cf9c8f-2f66-4490-a7db-8a5bc70c1b76"
},
"cnh": {
"register_number": "05163811694",
"issuer_state": "PR",
"first_issuance_date":"2011-03-21",
"issuance_date":"2016-06-29",
"expiration_date":"2021-06-25",
"category": "AB",
"validation_type":"zaig_sdk",
"ocr_key":"a5cf9c8f-2f66-4490-a7db-8a5bc70c1b76"
}
},
"address": {
"street": "Rua do Teste",
"number": "111",
"neighborhood": "Bairro do Exemplo",
"city": "Aparecida de Goiânia",
"uf": "GO",
"complement": "Térreo",
"postal_code": "00000-000",
"country": "BRA",
"validation_type":"visit",
"ocr_key": "265b1b74-4b93-41dc-ac78-e1c37467225d"
},
"phones": [
{
"international_dial_code": "1",
"area_code": "11",
"number": "999999999",
"type": "mobile",
"validation_type": "zaig_sms",
"validation_key": "d1713959-4ae4-4180-befc-6931c658e908"
}
],
"source": {
"channel": "app",
"platform": "android",
"ip":"255.201.26.1",
"session_id": "79d5e442-2cb7-4a9e-82c5-7fa3717d7ada"
},
"face":
{
"type":"zaig_sdk",
"registration_key":"a2b6ae92-1394-4f9b-b8ee-5be188f93609"
}
}
]
}
所有注册的信息交换均使用以下对象定义。在某些情况下，为了简化实现并减少各方之间的数据流量，部分信息可以省略。
| 名称 | 类型 | 限制条件 | 描述 |
|---|---|---|---|
| id | string | 1–50 个字符 | 分析的标识符。 该编号对于每次请求必须唯一 (必填) |
| registration_id | string | 1–50 个字符 | 客户系统中注册的标识符。如需对同一注册进行多次分析，只需在不同分析中使用相同的 registration_id。未发送时将与 id 取相同值。 |
| registration_date | datetime | ISO 8601 含时区 | 注册的日期和时间。格式：YYYY-MM-DDTHH:MM:SS[.ffffff]±HH:MM 或 ...Z。示例：2019-12-11T11:37:15.12-03:00 (必填) |
| client_category | string | 1–100 个字符 | 根据您的平台分类或忠诚度计划划分的客户类别 |
| legal_name | string | 1–1000 个字 符 | 被注册公司的法定名称 |
| trading_name | string | 1–1000 个字符 | 被注册公司的商业名称 |
| document_number | string | 格式 XX.XXX.XXX/XXXX-XX | 公司的 CNPJ。必须恰好为 18 个字符，含点、斜杠和连字符 (必填) |
| foundation_date | date | 格式 YYYY-MM-DD | 公司的成立日期 |
| website | string | 最多 10,000 个字符 | 被注册公司的网站 |
| activity | string | 1–1000 个字符 | 被注册公司的经营范围 |
| activity_code | string | 格式 XX.XX-X-XX | 公司经营活动的 CNAE 代码，含分隔符共 10 个字符。示例：96.02-5-01 |
| merchant_category_code | string | 枚举值（见列表） | 根据卡片品牌标准划分的 MCC（Merchant Category Code）代码 |
| tier | string | 1–10 个字符 | 公司规模（如：mei、epp、me、medio、grande） |
| annual_revenues | integer | 0 至 10,000,000,000,000 | 被注册公司的年度毛收入，以分为单位（雷亚尔） |
| monthly_revenues | integer | 0 至 10,000,000,000,000 | 被注册公司的月度毛收入，以分为单位（雷亚尔） |
| emails | Email 列表 | — | Email 类型对象列表，描述公司的电子邮件地址 |
| documents | Document | — | 文件类型对象（州注册号 - ie，公司章程 - company_statute） |
| address | Address | — | Address 类型对象，描述公司的注册地址 |
| phones | Phone 列表 | — | Phone 类型对象列表，描述公司的电话号码 |
| source | Source | — | Source 类型对象，描述用于提交注册的应用程序特征 |
| partners | Partner 列表 | — | Partner 类型对象列表，描述公司各股东的信息 |
| legal_representatives | 法定代表人列表 | — | LegalRepresentative 类型对象列表，描述公司各法定代表人的信息 |
字段格式说明
registration_date
必须遵循 ISO 8601 格式，且必须包含时区。有效值示例：
2019-12-11T11:37:15-03:00 （无秒级小数，带时区偏移）
2019-12-11T11:37:15.123456-03:00 （带秒级小数，最多 6 位）
2019-12-11T14:37:15Z （UTC 时间）
该字段不接受不含时区的日期（例如
2019-12-11T11:37:15为无效值）。
document_number — CNPJ
CNPJ 必须带标点发送，格式为 XX.XXX.XXX/XXXX-XX，其中每个 X 为数字。字段长度恰好为 18 个字符。
有效示例：11.222.333/0001-81
foundation_date
日期格式为 YYYY-MM-DD（年-月-日），符合 ISO 8601 标准。
有效示例：1992-09-15
activity_code — CNAE
CNAE 代码必须以 XX.XX-X-XX 格式发送，含分隔符共恰好 10 个字符。
有效示例：96.02-5-01
annual_revenues 与 monthly_revenues
两个字段均为整数，表示以**分（雷亚尔）**为单位的货币金额。将雷亚尔转换为所需格式时，乘以 100 即可。
示例：BRL 720,000.00 → 72000000
提交 Legal Person
Request Body
{
"id": "12345",
...
}
Response Body
{
"id": "12345",
"analysis_status": "automatically_approved",
"reason": "rule_decision_enum"
}
要对注册进行评估，只需将 Legal Person 类型的对象发送到以下端点，并相应设置参数标志：
POST https://api.caas.qitech.app/onboarding/legal_person?analyze=true
参数 analyze 用于标识所提交的注册是否应由 QI Tech 的算法进行分析。如果提交注册时该参数值为 false，则不会对其进行分析或计费，但其数据将被 QI Tech 的算法用于未来的分析。该参数的默认值为 true，因此只有明确以 false 标志提交的注册才不会被分析。