投资者分页查询

---

Request

ENDPOINT

/quota_distributor/investors

MÉTODO

GET

STATUS

200

Query Params

参数	描述
document_number	投资者证件号

注意

在集成过程中，将要求对发送的哈希值进行身份验证。

情况01：返回仅一个投资者

{
    "data": [
      {
         "investor_key":"UUID",
         "name":"SAMPLE INVESTOR NAME",
         "document_number":"00.000.000/0000-00",
         "person_type":"natural_person / legal_person",
         "status":"approved / pending_update",
         "associations":[
            {
               "manager":{
                  "manager_key":"UUID",
                  "name":"SAMPLE MANAGER NAME",
                  "document_number":"00.000.000/0000-00"
               }
            }
         ],
         "distributor":{
            "distributor_key":"UUID",
            "document_number":"00.000.000/0000-00",
            "name":"SAMPLE DISTRIBUTOR NAME",
            "account_data":{
               "owner":{
                  "name":"SAMPLE OWNER NAME",
                  "document_number":"00.000.000/0000-00"
               },
                "account_digit": "0",
                "account_branch": "0000",
                "account_number": "00000",
                "financial_institution_code": "000",
                "financial_institution_ispb": "00000000"
            }
         },
         "account_data": {
              "account_digit": "0",
              "account_branch": "0000",
              "account_number": "00000",
              "financial_institution_code": "000",
              "financial_institution_ispb": "00000000"
          },
         "investor_sub_type": "person / financial_institution / fund class"
      }
    ],
    "limit": 50,
    "page": 0,
    "is_last_page": true
}

Investor

字段	类型	描述
investor_key	string	投资者唯一标识键
name	string	投资者姓名
document_number	string	投资者 CPF 或 CNPJ
person_type	string	投资者类型（natural person 表示自然人，legal person 表示法人）
status	string	投资者状态（approved 表示已批准，pending update 表示待更新）
associations	array	与投资者相关的 Association 对象列表
distributor	JSON	代表投资者分销商的 Distributor 对象
account_data	JSON	包含投资者银行信息的 Account Data 对象
investor_sub_type	string	投资者子类型（person、financial institution 或 fund class）

Association

注：只能与一位经理、一位分销商或两者同时关联

字段	类型	描述
manager	JSON	代表关联经理的 Manager 对象
distributor	JSON	代表关联分销商的 Distributor 对象

Manager

字段	类型	描述
manager_key	string	经理唯一标识键
name	string	经理姓名
document_number	string	经理 CNPJ

Distributor

字段	类型	描述
distributor_key	string	分销商唯一标识键
document_number	string	分销商 CNPJ
name	string	分销商名称
account_data	JSON	包含分销商银行信息的 Account Data 对象

Account Data

字段	类型	描述
account_digit	string	账户校验位
account_branch	string	支行编号
account_number	string	账户号码
financial_institution_code	string	金融机构代码
financial_institution_ispb	string	金融机构 ISPB

Owner

字段	类型	描述
name	string	账户持有人姓名
document_number	string	账户持有人 CPF 或 CNPJ