跳到主要内容

查询待签署文件批次

简介​

本资源返回在提交注册分析后为投资者生成的文件批次（document_batches）。每个批次汇集待签署的文件（注册表、合格投资者/专业投资者声明等），并列出每份文件的状态和签署方式。

Input / Output​

无请求体。可选择通过 query param 按注册分析进行过滤。

作为输出，将返回该投资者的批次列表。

适用范围
角色主机
投资者investor-api

各主机的 Base URL：环境（主机）。

Request​

ENDPOINT
/investor_registry/investor/{investor_key}/document_batches
MÉTODO
GET
STATUS
200

Query params​

字段类型描述必填
investor_analysis_keystring过滤属于某一特定注册分析的批次否

Response​

响应体
[
  {
    "document_batch_key": "UUID",
    "status": "pending_signature",
    "investor_analysis_key": "UUID",
    "url": "https://docs.qitech.com.br/...",
    "documents": [
      {
        "investor_document_key": "UUID",
        "document_type": "legal_person_registry_form",
        "status": "generated",
        "signature_method": "certifiqi"
      },
      {
        "investor_document_key": "UUID",
        "document_type": "professional_investor_term",
        "status": "generated",
        "signature_method": "certifiqi"
      }
    ]
  }
]

Document Batch Status​

枚举值描述
creating_documents文件生成中
pending_signer_groups等待签署人组
send_to_signature已发送签署
pending_signature等待签署
signed已签署
签署详情

如需查看特定批次中每项签署的详情，请使用 GET /investor_registry/investor/{investor_key}/document_batch/{document_batch_key}/signature_details。

基金入会协议

如果投资者在注册过程中选择了基金（参见 选择基金），批次中还会为每个已批准的入会包含 document_type: "adhesion_term"，并在适用时包含 nonconformity_term——参见 入会状态。

错误​

状态代码发生情形
404IVR000008未找到投资者

认证、权限和主机相关错误：参见 API 错误。