提交和取消审核
在登记信息、关联方和文件准备就绪后，将审核提交给 QI Tech。提交后，登记将被锁定：如需修改，请将审核撤出队列；如需放弃，请取消审核。
提交的前提条件
API 按以下顺序进行检查，并在第一个缺失项上返回 400：
| 检查项 | code |
|---|---|
已提供供应商邮箱（analysis_data.email）。 | VRG000103 |
| 法人：至少有一个非停用状态的关联方。 | VRG000058 |
法人：至少有一个 is_representative: true 的关联方。 | VRG000051 |
供应商的必需文件：法人为 social_contract 或 company_statute；自然人为 cnh、rg、rg_front + rg_back 或 identification_document。 | VRG000064 |
每位代表人都有自己的身份证件（cnh、rg、rg_front + rg_back、identification_document 或 passport）。 | VRG000066 |
每个 attorney 类型的关联方都有自己的 power_of_attorney。 | VRG000083 |
处于 valid、in_manual_analysis、inconclusive 或 invalid 的文件计入检查；canceled 的文件不计入。提交时不要求银行账户和签署人组。
提交审核
| 角色 | 主机 | 所需权限 |
|---|---|---|
| 管理人 | manager-api | 写入 |
| 顾问 | consultant-api | 有效集成 |
各主机的 Base URL：环境（主机）。
路径参数
| 参数 | 类型 | 说明 |
|---|---|---|
analysis_key | string | 审核的 key（UUID）。 |
{
"status": "sent_to_analysis"
}
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
status | string | 是 | sent_to_analysis 或 pending_submission。不接受其他任何值。 |
sent_to_analysis提交审核。仅可从pending_submission提交。pending_submission将审核撤出队列。仅可从sent_to_analysis或in_manual_analysis撤出。审核已处于pending_submission时，调用会被接受且不做任何改变：只会在历史中记录一个新事件。
响应
返回审核，结构与创建供应商相同，status: sent_to_analysis。
提交后，QI Tech 会校验文件和人员，审核将自动进入 approved、in_manual_analysis 或 in_compliance_analysis。请通过审核查询跟踪。
撤出审核队列
使用与提交相同的调用，传入 status: pending_submission。仅在审核处于 sent_to_analysis 或 in_manual_analysis 时有效；处于 in_compliance_analysis 时只能取消。
{
"status": "pending_submission"
}
审核回到 pending_submission，登记可以再次编辑并重新提交。已完成的校验会被丢弃：pending 的签署人组变为 invalid，自动校验的待处理事项（ai_pending_reasons）会被清除。
取消审核
在未通过的情况下终止审核。适用于任何非终态（pending_submission、sent_to_analysis、in_manual_analysis、in_compliance_analysis）。供应商的状态不变；active 的供应商仍为 active。
| 角色 | 主机 | 所需权限 |
|---|---|---|
| 管理人 | manager-api | 写入 |
| 顾问 | consultant-api | 有效集成 |
各主机的 Base URL：环境（主机）。
此调用不带请求体。
响应
返回审核，status: canceled、reproval_reason: null 且 reproval_details: null。此外：
- 未关闭的审核意见会被关闭；
- 可访问该供应商的主体会在其登记的邮箱地址收到结束通知。
如需重新登记供应商，请开启新的审核。
错误
未满足提交的前提条件
前提条件表中的某一项未满足。缺少邮箱的示例：
{
"title": "Analysis Submission Must Have Email",
"description": "The analysis 8c2a6f0e-1b3d-4f7a-9c1e-2a4b6d8f0c13 has no vendor email and cannot be submitted.",
"translation": "Informe o e-mail do fornecedor antes de enviar o cadastro para analise.",
"code": "VRG000103"
}
缺少必需文件的示例：
{
"title": "Analysis Submission Must Have Required Documents",
"description": "The analysis 8c2a6f0e-1b3d-4f7a-9c1e-2a4b6d8f0c13 does not have every document required for a legal_person vendor.",
"translation": "A analise 8c2a6f0e-1b3d-4f7a-9c1e-2a4b6d8f0c13 nao possui todos os documentos obrigatorios para um fornecedor legal_person.",
"code": "VRG000064"
}
不允许的状态变更
当前状态不允许所请求的变更：例如从 in_manual_analysis 变为 sent_to_analysis、从 in_compliance_analysis 变为 pending_submission，或对 canceled 的审核执行任何操作。
{
"title": "Analysis Status Transition Denied",
"description": "Analysis with key 8c2a6f0e-1b3d-4f7a-9c1e-2a4b6d8f0c13 is not allowed to switch status from in_compliance_analysis to pending_submission.",
"translation": "Analise com chave 8c2a6f0e-1b3d-4f7a-9c1e-2a4b6d8f0c13 nao pode trocar de status de in_compliance_analysis para pending_submission.",
"code": "VRG000008"
}
审核已通过
审核已处于 approved。如需修改登记，请开启新的审核。
{
"title": "Completed Analysis",
"description": "Analysis with key 8c2a6f0e-1b3d-4f7a-9c1e-2a4b6d8f0c13 is already completed, it can't be updated.",
"translation": "Analise com chave 8c2a6f0e-1b3d-4f7a-9c1e-2a4b6d8f0c13 esta finalizada, nao pode ser atualizada.",
"code": "VRG000010"
}
审核已被拒绝
审核已处于 reproved。如果是登记类原因，请开启新的审核。
{
"title": "Reproved Analysis",
"description": "The analysis 8c2a6f0e-1b3d-4f7a-9c1e-2a4b6d8f0c13 was already reproved and cannot change status.",
"translation": "A analise 8c2a6f0e-1b3d-4f7a-9c1e-2a4b6d8f0c13 ja foi reprovada e nao pode mudar de status.",
"code": "VRG000065"
}
未找到审核
该 analysis_key 不存在。如果审核属于您看不到的供应商，错误码为 VRG000014（参见通用错误）。
{
"title": "Analysis not found",
"description": "Analysis with the key 8c2a6f0e-1b3d-4f7a-9c1e-2a4b6d8f0c13 was not found.",
"translation": "A analise com a chave 8c2a6f0e-1b3d-4f7a-9c1e-2a4b6d8f0c13 nao foi encontrada.",
"code": "VRG000007"
}
认证、权限和主机相关的错误：参见 API 错误。