跳到主要内容

转让方查询

按标识键查询转让方​

Request​

ENDPOINT
/assignor_registry/assignor_registry/ASSIGNOR_REGISTRY_KEY
MÉTODO
GET

Response​

STATUS
200
Response Body
{
  "assignor_registry_key": "c4295375-4077-4092-a258-5bcdf8875907",
  "status": "registred",
  "name": "QI CTVM",
  "document_number": "67.987.787/0001-06",
  "person_type": "legal_person",
  "email": "qidtvm@qitech.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": "883.512.866-80",
      "related_party_type": "attorney",
      "nationality": "BRA",
      "direct_beneficiary": true,
      "is_representative": true,
      "email": "natalia.nascimento@yopmail.com"
    }
  ],
  "last_analysis": {
    "analysis_key": "d7805a05-98a7-486b-a440-807f1d3d5691",
    "analysis_number": 1,
    "status": "pending_documents",
    "analysis_related_parties": [],
    "documents": [],
    "analysis_data": {}
  }
}

转让方对象​

字段类型描述字符数
assignor_registry_keystring注册标识符。36
name *string转让方名称。1 至 255
document_number *string转让方文件编号（CNPJ）。14 至 18
status枚举值注册状态。14 至 18
annual_revenues *number转让方的年营收声明（整数）。最小值为 1
person_type *string转让方的人员类型（自然人或法人）。-
email *string转让方的电子邮件地址。1 至 255
is_in_national_financial_system *boolean表示转让方是否为 SFN 成员。-
phoneobject转让方电话信息对象。请参见**电话定义**。
address *object转让方地址信息对象。请参见**地址定义**。
related_parties *array公司关联方列表。请参见**关联方定义**。
accounts *array转让方还款账户列表。请参见**账户定义**。
guarantors *array转让方担保人列表。请参见**担保人定义**。

分页查询转让方列表​

Request​

ENDPOINT
/assignor_registry/assignor_registries
MÉTODO
GET

Path params​

字段类型描述字符数
namestring转让方名称1-255
document_numberstring转让方文件编号1-18
assignor_registry_statusstring转让方状态1-255
analysis_statusstring最新审查状态1-255
limitinteger对象数量限制-
pageinteger请求页码-

Response​

STATUS
200
Response Body
{
  "data": [
    {
      "assignor_registry_key": "c4295375-4077-4092-a258-5bcdf8875907",
      "status": "registred",
      "name": "QI CTVM",
      "document_number": "67.987.787/0001-06",
      "person_type": "legal_person",
      "email": "qidtvm@qitech.com.br",
      "annual_revenues": 1000000,
      "is_in_national_financial_system": true,
      "last_analysis": {
        "analysis_key": "d7805a05-98a7-486b-a440-807f1d3d5691",
        "analysis_number": 1,
        "status": "pending_documents"
      }
    }
  ],
  "limit": 10,
  "page": 0,
  "is_last_page": true
}

查询转让方签署人​

Request​

ENDPOINT
/assignor_registry/assignor_registry/ASSIGNOR_REGISTRY_KEY/signers
MÉTODO
GET

Response​

Response Body
{
  "signer_groups": [
    {
      "signers": [
        {
          "name": "Natália Nascimento",
          "document_number": "883.512.866-80",
          "email": "natalia.nascimento@yopmail.com",
          "is_required_signer": true,
        },
        {
          "name": "Roberto Carlos",
          "document_number": "802.834.257-41",
          "email": "roberto.carlos@yopmail.com",
          "is_required_signer": true,
        }
      ],
      "minimum_required_signers": 2,
      "expiration": "2025-10-20"
    }
  ]
}

签署人组对象​

字段类型描述字符数
signersarray组内签署人标识。-
minimum_required_signersnumber将文件视为已签署所需的最少签署人数。-
expirationdate签署人组的到期日（可选）。10（格式：YYYY-MM-DD）

签署人组在内部根据提交文件的审查以及代表与转让方之间经证明的关联关系构建。