跳到主要内容

人员创建

要为各自账户创建人员，必须保持 natural_person_account 和 legal_person_account 端点之间的隔离。

要为账户请求创建人员，只需将 Person 类型的对象发送到以下端点之一，遵循账户创建时的隔离：

个人账户​

  • 创建自然人

POST https://api.caas.qitech.app/account_monitoring/natural_person_account/{account_id}/natural_person

示例

{
    "id": "cc2f97ba-08c8-4a91-8d0d-49313a6c1245",
    "registration_date": "2024-11-04T13:37:00Z",
    "data": {
        "name": "John Doe",
        "document_number": "123.456.789-09",
        "birthdate": "2000-07-13"
    }
}

企业账户​

  • 创建自然人

POST https://api.caas.qitech.app/account_monitoring/legal_person_account/{account_id}/natural_person

示例

{
    "id": "cc2f97ba-08c8-4a91-8d0d-49313a6c1245",
    "registration_date": "2024-11-04T13:37:00Z",
    "data": {
        "name": "John Doe",
        "document_number": "123.456.789-09",
        "birthdate": "2000-07-13"
    }
}

birthdate 字段仅对拥有联邦税务局状态监控的账户为必填项，查询未满 18 岁的人员时需要此字段。

  • 创建法人

POST https://api.caas.qitech.app/account_monitoring/legal_person_account/{account_id}/legal_person

示例

{
    "id": "cc2f97ba-08c8-4a91-8d0d-49313a6c1245",
    "registration_date": "2024-11-04T13:37:00Z",
    "data": {
        "name": "Empresa das Tampas",
        "document_number": "12.482.243/0001-34"
    }
}

人员停用和重新激活​

要停用人员，操作与账户的操作类似，使用以下端点：

个人账户​

  • 创建自然人

PATCH https://api.caas.qitech.app/account_monitoring/natural_person_account/{account_id}/natural_person

示例

{
    "new_person_status" : "deactivated"
}

企业账户​

  • 创建自然人

PATCH https://api.caas.qitech.app/account_monitoring/legal_person_account/{account_id}/natural_person

示例

{
    "new_person_status" : "deactivated"
}
  • 创建法人

PATCH https://api.caas.qitech.app/account_monitoring/legal_person_account/{account_id}/legal_person

示例

{
    "new_person_status" : "deactivated"
}

要重新激活之前停用的人员，操作与停用人员相同，但 new_person_status 传入 'active'，使用以下端点：

个人账户​

  • 创建自然人

PATCH https://api.caas.qitech.app/account_monitoring/natural_person_account/{account_id}/natural_person

示例

{
    "new_person_status" : "active"
}

企业账户​

  • 创建自然人

PATCH https://api.caas.qitech.app/account_monitoring/legal_person_account/{account_id}/natural_person

示例

{
    "new_person_status" : "active"
}
  • 创建法人

PATCH https://api.caas.qitech.app/account_monitoring/legal_person_account/{account_id}/legal_person

示例

{
    "new_person_status" : "active"
}