供应商审核意见

在人工复核期间（in_manual_analysis 或 in_compliance_analysis），QI Tech 分析师可以提出审核意见：要求补充说明或提供文件。只要存在未关闭的审核意见，审核就不会通过。在此阶段，回复审核意见是附加文件的唯一方式。

审核意见状态

状态	说明
opened	由 QI Tech 提出，等待回复。
closed	已由管理人回复，或在审核结束时自动关闭。

如需了解是否有未关闭的审核意见，请使用 status=opened 列出该审核的审核意见。供应商列表的 annotation_status=opened 筛选只看最近一次审核中最新的审核意见：仍未关闭的较早审核意见不会出现在筛选结果中。

列出审核意见

适用范围

角色	主机	所需权限
管理人	manager-api	读取
顾问	consultant-api	有效集成

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

ENDPOINT

/vendor_registry/analysis/{analysis_key}/annotations

方法

GET

查询参数

参数	类型	必填	说明
status	string	否	opened 或 closed。可传入多个值，以逗号分隔。
limit	integer	否	每页条数，0 至 1000。默认值：10。
page	integer	否	页码，从 0 开始。默认值：0。

返回该审核的审核意见，按从新到旧排序。

响应

STATUS

200

Corpo da resposta

{
    "data": [
        {
            "annotation_key": "9a8b7c6d-5e4f-4a3b-2c1d-0e9f8a7b6c5d",
            "annotation_message": "Enviar comprovante de endereço atualizado.",
            "annotation_response": null,
            "annotation_datetime": "2026-11-03 10:00:00.527114",
            "analysis_key": "8c2a6f0e-1b3d-4f7a-9c1e-2a4b6d8f0c13",
            "status": "opened",
            "attached_document_key": null,
            "response_datetime": null
        }
    ],
    "limit": 10,
    "page": 0,
    "is_last_page": true
}

每条审核意见的属性

字段	类型	说明
annotation_key	string	审核意见的 key（UUID）。
annotation_message	string	分析师的要求，最多 200 个字符。
annotation_response	string	管理人的回复，或 null。
annotation_datetime	string	审核意见的提出时间。
analysis_key	string	审核意见所属的审核。
status	string	opened 或 closed。
attached_document_key	string	回复中附带的文件，或 null。
response_datetime	string	回复时间，或 null。

按 key 查询审核意见

ENDPOINT

/vendor_registry/analysis/{analysis_key}/annotation/{annotation_key}

方法

GET

权限：管理人（manager-api）：读取。顾问（consultant-api）：有效集成。返回一条审核意见，结构参见每条审核意见的属性。

回复审核意见

回复审核意见并将其关闭。仅在审核处于 in_manual_analysis 或 in_compliance_analysis 时接受回复；处于其他任何状态（包括审核已结束）时，返回 405（VRG000011）。

回复可以通过以下任一方式附带文件（不能同时使用两种方式）：

• 新文件，以 Base64 上传。新文件遵循文件中的类型和格式规则，并替换同类型的原有文件；
• 审核中已有文件的 key。

适用范围

角色	主机	所需权限
管理人	manager-api	写入
顾问	consultant-api	有效集成

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

ENDPOINT

/vendor_registry/analysis/{analysis_key}/annotation/{annotation_key}/respond

方法

PUT

Corpo da requisição — com documento novo

{
    "annotation_response": "Segue o comprovante de endereço atualizado.",
    "name": "comprovante_endereco.pdf",
    "document_type": "proof_of_residence",
    "document_b64": "JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoKPDwKL0xlbmd0aCAzIDAgUgo..."
}

Corpo da requisição — apontando documento existente

{
    "annotation_response": "O documento pedido já está na análise.",
    "attached_document_key": "d1e2f3a4-b5c6-4d7e-8f9a-0b1c2d3e4f5a"
}

请求体属性

字段	类型	必填	说明
annotation_response	string	是	回复内容，最多 1000 个字符。
document_b64	string	否	Base64 格式的新文件。需要同时提供 name 和 document_type。
name	string	条件必填	文件名，1 至 255 个字符。提供 document_b64 时必填。
document_type	string	条件必填	文件类型，须为可接受的类型之一。提供 document_b64 时必填。
related_party_key	string	否	将新文件附加到该关联方，而不是供应商。仅与 document_b64 一起使用。
attached_document_key	string	否	该审核中已上传文件（供应商或关联方的文件）的 key。不能与 document_b64 同时使用。

响应

STATUS

202

Corpo da resposta

{
    "annotation_key": "9a8b7c6d-5e4f-4a3b-2c1d-0e9f8a7b6c5d",
    "annotation_message": "Enviar comprovante de endereço atualizado.",
    "annotation_response": "Segue o comprovante de endereço atualizado.",
    "annotation_datetime": "2026-11-03 10:00:00.527114",
    "analysis_key": "8c2a6f0e-1b3d-4f7a-9c1e-2a4b6d8f0c13",
    "status": "closed",
    "attached_document_key": "f3a4b5c6-d7e8-4f9a-0b1c-2d3e4f5a6b7c",
    "response_datetime": "2026-11-03 11:20:07.381946+00:00"
}

错误

STATUS

405

审核意见已回复

您已经回复过此审核意见。

{
  "title": "Annotation Already Responded",
  "description": "Annotation with key 9a8b7c6d-5e4f-4a3b-2c1d-0e9f8a7b6c5d is already responded.",
  "translation": "Anotacao com chave 9a8b7c6d-5e4f-4a3b-2c1d-0e9f8a7b6c5d esta respondida.",
  "code": "VRG000013"
}

审核不在人工审核阶段

审核既不处于 in_manual_analysis，也不处于 in_compliance_analysis：例如审核已结束，或已被撤出队列。在审核结束时被自动关闭的审核意见也不再接受回复。

{
  "title": "Operation Status does not allow annotations",
  "description": "Operation with key 8c2a6f0e-1b3d-4f7a-9c1e-2a4b6d8f0c13 is on status approved, annotations can only be created or responded on in_manual_analysis or in_compliance_analysis.",
  "translation": "Operacao com chave 8c2a6f0e-1b3d-4f7a-9c1e-2a4b6d8f0c13 esta no status approved, apontamentos so podem ser criados ou respondidos nos status in_manual_analysis ou in_compliance_analysis.",
  "code": "VRG000011"
}

STATUS

404

code	发生情形
VRG000007	该 analysis_key 不存在。如果审核属于您看不到的供应商，错误码为 VRG000014。
VRG000012	该 annotation_key 不存在，或不属于此审核。
VRG000071	attached_document_key 不是此审核中的文件。
VRG000053	related_party_key 未与此审核关联，或处于 inactive。

STATUS

400

新文件的类型、大小和格式错误与文件中的相同（VRG000081、VRG000082、VRG000080、VRG000067、VRG000097）。将 document_b64 与 attached_document_key 同时提交，或在没有 document_b64 的情况下提交 name、document_type 或 related_party_key，会返回 QIT000001。

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