跳到主要内容

供应商登记

供应商是指为基金提供服务并收取费用款项的自然人或法人，例如审计、托管、顾问、分销等。在用于合同或费用之前，供应商必须通过 QI Tech 的登记审核。

本节介绍管理人和顾问通过 API 登记供应商所使用的调用。页面中提到“管理人”之处，对于顾问自己登记的供应商同样适用于顾问。在 API 字段中，管理人或顾问统称为主体（agent）。

审核通过的登记有效期为两年。如需续期，管理人针对同一供应商开启新的审核，并重新提交有变化的内容。

登记流程​

通过 API 登记供应商的各个步骤

图例：蓝色实线边框的方框是管理人通过 API 执行的步骤；灰色虚线方框是 QI Tech 审核的步骤；绿色方框是审核通过的供应商；红色方框是未通过即终止的审核。

在人工复核期间，QI Tech 可能会提出审核意见。在审核进入合规阶段之前，管理人可以将其撤出审核队列以修改登记。

1. 创建供应商​

根据 CPF 或 CNPJ 及名称创建供应商。创建时会同时开启第一次审核，状态为 pending_submission。响应返回的是审核：请保存 analysis_key 以及供应商的 key（位于 vendor.vendor_key）。

2. 填写登记信息​

提交名称、邮箱和地址。没有邮箱，审核就无法提交。

3. 申报关联方（法人）​

申报股东、管理人员、代理人和控股公司。法人供应商至少需要一个 is_representative: true 的关联方。自然人供应商跳过此步骤：它没有关联方。

4. 上传文件​

上传供应商及每个关联方的文件。主要的必需文件：

  • 法人：公司章程（contrato social 或 estatuto）；
  • 自然人及每位代表人：一份身份证件。

5. 登记银行账户和签署人组​

登记接收该供应商费用付款的账户，并申报在费用合同中代表供应商签署的人员。提交审核时两者都不是必需的。

6. 提交审核​

将登记提交给 QI Tech（status: sent_to_analysis）。此后，登记将被锁定，直到审核结束。

7. 跟踪审核​

如果文件和人员通过自动校验，QI Tech 会自动审核通过。否则由分析师复核（in_manual_analysis），必要时再由合规部门复核（in_compliance_analysis）。在人工复核期间，分析师可以提出审核意见，要求补充说明或文件。

审核状态​

状态说明由谁设置
pending_submission填写中。只有在审核处于此状态时才能修改信息、关联方和文件。初始状态。管理人将审核撤出队列时也会回到此状态。
sent_to_analysis已提交。文件和人员的自动校验进行中。管理人
in_manual_analysisQI Tech 分析师复核中。自动或 QI Tech
in_compliance_analysisQI Tech 合规部门复核中。自动或 QI Tech
approved已通过。供应商在两年内保持 active。自动或 QI Tech
reproved已拒绝。reproval_reason 说明原因。QI Tech
canceled已被管理人取消。管理人

管理人可执行的状态变更：

pending_submission     ──→ sent_to_analysis     （提交审核）
sent_to_analysis       ──→ pending_submission   （撤出队列以修改）
in_manual_analysis     ──→ pending_submission   （撤出队列以修改）
任一非终态             ──→ canceled             （取消）

在 in_compliance_analysis 状态下，管理人唯一可执行的操作是取消。approved、reproved 和 canceled 为终态。

拒绝原因​

reproval_reason来源影响
invalid_documents、missing_documents、incorrect_information、missing_information、additional_documents_requiredQI Tech 分析师供应商保持原状态。请开启新的审核，修改后重新提交。
compliance_reprovalQI Tech 合规部门最终结果：供应商变为 inactive，block_reason: compliance_reproval，且不再接受新的审核。

reproval_details 以自由文本形式提供详细说明。

供应商状态​

状态说明
pending_analysis从未通过审核。有一个审核正在进行，或已未通过而终止。
active已通过且在有效期内。可用于合同和费用。
expired两年有效期已过。请开启新的审核；通过后恢复为 active。
inactive被合规部门拒绝或被 QI Tech 冻结。

在新的审核期间，处于 active 或 expired 状态的供应商保持原状态。取消审核或登记类拒绝同样不会改变供应商的状态。

通用规则​

  • 归属。 供应商归创建它的管理人或顾问所有。对于其他任何主体，同一个 vendor_key 会返回 404。
  • 重复的 CPF 或 CNPJ。 不同主体可以登记同一个 CPF 或 CNPJ：各自拥有独立的供应商。只有当您已经可以看到使用该证件号的供应商时（包括通过顾问的合同看到的），创建才会返回 409（VRG000015）。
  • 合同中的顾问供应商。 当某个合同使用了顾问的供应商时，该基金的管理人可以在查询中看到该供应商，但不能修改：管理人的任何修改都会返回 403（VRG000046）。
  • 顾问的权限。 在 consultant-api 中只需有效集成即可：供应商登记不依赖按基金授予的权限。顾问需要已在供应商服务中登记；否则 API 返回 404（VRG000043）。
  • 登记锁定。 可修改的内容取决于审核状态：
    • pending_submission：唯一可以修改登记信息、关联方和审核文件的状态。只有在此状态下所做的修改才会被审核。
    • sent_to_analysis、in_manual_analysis 或 in_compliance_analysis：审核在 QI Tech 处理中，上述数据被锁定（409，VRG000104 或 VRG000072）。
    • approved、reproved 或 canceled：该审核的登记信息（409，VRG000010）和文件（409，VRG000072）不能再修改。如需修改，请开启新的审核。
    • 没有进行中的审核时，可以创建、启用或停用关联方，但只会在下一次审核中纳入评估（见关联方）。
  • 银行账户和签署人组不受此锁定限制：它们不依赖审核状态。
  • 同一时间只有一个审核。 每个供应商最多只有一个进行中的审核。只有在上一个审核处于 approved、reproved（登记类原因）或 canceled 时，才能开启新的审核。
  • 日期和时间。 *_datetime 和 last_updated 字段为 UTC 时间，格式为 YYYY-MM-DD HH:MM:SS.ffffff，不带时区。例外：在写操作的响应中，由该次调用写入的值带有 +00:00 后缀。日期的格式为 YYYY-MM-DD。
  • CPF 和 CNPJ。 可带或不带标点提交，返回时始终带标点（123.456.789-09、11.222.333/0001-81）。
  • 跟踪。 供应商登记不在门户可配置的 webhook 系统之列。请通过审核查询或状态历史跟踪。审核结果也会通过邮件发送给每个可访问该供应商的主体所登记的邮箱地址：创建者，以及通过顾问合同看到该供应商的一方。

错误​

针对供应商及其关联数据的调用中反复出现的错误：

状态code发生情形
403VRG000046您尝试修改一个您能看到但不属于您的供应商。管理人通过合同看到顾问的供应商时会出现这种情况。
404VRG000014vendor_key 不存在，或您看不到该供应商。对于您看不到的供应商的 analysis_key，同样返回此错误。

认证、权限和主机相关的错误：参见 API 错误。供应商登记的其他错误以 VRG 为前缀，列在各调用的页面中。