验厂
验厂通常使用 Qarma 平台进行，但如果需要从其他来源导入验厂数据，以下是所需的整体数据结构。此导入 API 仅支持创建状态为“报告”的验厂，不能用于规划验厂。
验厂数据字段
| 字段 | 描述 | 数据类型 |
|---|---|---|
| start_time | 验厂开始的日期和时间 | 日期（UTC） |
| end_time | 验厂结束的日期和时间 | 日期（UTC） |
| supplier_name | 供应商名称（可选） | 字符串 |
| supplier_number | 供应商编号（可选） | 字符串 |
| auditor_name | 执行验厂的人员姓名 | 字符串 |
| auditor_email | 执行验厂的人员电子邮件 | 字符串 |
| production_unit_name | 被验厂的生产单位名称 | 字符串 |
| production_unit_number | 生产单位编号，需要与 Qarma 中使用的编号匹配 | 字符串 |
| production_unit_address | 生产单位地址 | 字符串 |
| latitude | 验厂地点的 GPS 定位 | 浮点数 |
| longitude | 验厂地点的 GPS 定位 | 浮点数 |
| accuracy | GPS 定位的精度 | 整数 |
| auditor_comment | 验厂员提供的最终总结 | 字符串 |
| checklist_name | 使用的验厂模板名称 | 字符串 |
| audit_type | 必须与 Qarma 中定义的验厂类型匹配 | 字符串 |
| attachments | 附件的 URL 列表，链接到验厂 | URL 列表 |
| audit_conclusion | 验厂结果（例如：不合格、合格、低于预期等） | 字符串 |
| checkpoint_headers | 验厂的各个部分列表，例如基本信息、员工、加班、安全等 | 字符串列表 |
| checkpoints | 每个部分下的检查点列表，每个检查点有若干字段 | 字符串 |
创建和更新生命周期
只有当不存在与以下四个条件完全匹配的验厂记录时，才会创建新记录：
- 供应商编号（如果没有提供编号，则使用供应商名称）
- 生产单位编号（如果没有提供编号，则使用生产单位名称。如果没有提供生产单位，则仅按供应商编号/名称匹配）
- 验厂结束日期（仅为日期，不包括具体时间）
- 验厂类型
如果找到现有的验厂记录，则会用提供的信息更新该记录。请注意，验厂的附加评论和结论将不会被清除， 即使验厂内容发生了变化，它们也会保留下来。
改进措施计划 (CAP)
改进措施计划是验厂后续的一部分，用来描述生产单位应该改进的不合规项。
CAP 数据字段
CAP 是改进措施（CA）的列表；每个改进措施包含以下信息：
| 字段 | 描述 | 数据类型 |
|---|---|---|
| status | 改进措施的状态，可以是以下之一：开启，审核中，已关闭 | 字符串 |
| created_date | 改进措施创建的日期 | 日期（UTC） |
| due_date | 改进措施解决的截止日期 | 日期（UTC） |
| resolution_date | 改进措施解决的日期 | 日期（UTC） |
| finding | 识别出的不合规项 | 字符串 |
| description | 不合规项的详细描述，包括解决该问题所需采取的措施信息 | 字符串 |
| resolution | 改进措施解决方式的文本描述 | 字符串 |
| creator | 创建改进措施的人员的电子邮件地址 | 字符串 |
| responsible | 负责采取行动的人员的电子邮件地址 (需要与Qarma中的用户电子邮件地址匹配) | 字符串 |
| approver | 审批改进措施已解决的人员的电子邮件地址 (需要与Qarma中的用户电子邮件地址匹配) | 字符串 |
| resolution_images | 作为证明改进措施已解决的图片的URL列表 | URL列表 |
| resolution_attachments | 作为证明改进措施已解决的文件的URL列表 | URL列表 |
| supplier | 供应商名称（可选）或供应商编号（可选），需与Qarma中的供应商编号匹配 | 字符串 |
| production_unit | 生产单位名称，生产单位编号，需与Qarma中的生产单位编号匹配 | 字符串 |
location
| 分别为纬度、经度、准确度和时间戳的GPS信息 | 浮点数 浮点数 整数 日期时间 |
| audit_id | 与CAP相关联的验厂内部ID。如果CAP包含在验厂数据中进行创建，则此部分可以省略。 如果没有提供audit_id，则CAP不会与验厂相关联 | 字符串 |
| audit_end_time | 用于识别验厂，如果没有提供audit_id，则此字段与验厂结束时间匹配，精确到毫秒 | 日期时间 |
| audit_type | 用于识别验厂，如果没有提供audit_id | 字符串 |
| groups | 匹配Qarma中组的列表（用于控制访问权限） | 字符串列表 |
创建和更新生命周期
只有当不存在与以下四个条件完全匹配的改进措施记录时，才会创建新记录：
- 供应商编号（如果没有提供编号，则使用供应商名称）
- 生产单位编号（如果没有提供编号，则使用生产单位名称。如果没有提供生产单位，则仅按供应商编号/名称匹配）
- 改进措施创建日期（仅为日期，不包括具体时间）
- 不合规项文本（完全匹配）
如果找到现有的改进措施记录，则会用提供的信息更新该记录。
供应商
本部分描述了供应商和生产单位。
供应商数据字段
| 字段 | 描述 | 数据类型 |
|---|---|---|
| supplier_name | 供应商名称 | 字符串 |
| supplier_number | 供应商编号 | 字符串 |
| groups | 匹配Qarma中组的列表（用于控制访问权限） | 字符串列表 |
| production_units | 该供应商的生产单位列表。该列表需要包括所有与供应商关联的生产单位（最终完整状态）。在更新现有供应商时，任何不包含在导入数据中的关联生产单位将被取消关联。
| |
创建和更新生命周期
只有当不存在与以下条件完全匹配的供应商或生产单位时，才会创建新记录：
- 如果提供了供应商编号，则按供应商编号匹配。
- 如果没有提供供应商编号，则按供应商名称匹配——请注意，匹配名称时会使用模糊匹配。模糊匹配会去除所有空格、逗号和句号，并将字母转为小写。所以例如“Shanghai Factory, China”和“shanghaifactorychina”会匹配到同一个供应商。
如果找到现有的供应商记录，则会用提供的信息更新该记录。
生产单位
本部分描述了生产单位。虽然在更新或创建供应商时可以创建生产单位，但更新生产单位的唯一方法是通过以下字段。
注意：只有当组织具有单位生产单位编号时，才能更新生产单位。
供应商数据字段
| 字段 | 描述 | 数据类型 |
|---|---|---|
| production_unit_name | 生产单位名称 | 字符串 |
| production_unit_number | 生产单位编号 | 字符串 |
| production_unit_address | 生产单位地址 | 字符串 |
| location | 生产单位的GPS位置
| 地图 浮点数 |
| custom fields | 每个组织在Qarma中定义的自定义字段 | 视自定义字段类型而定 （日期、数字、文本、列表） |
| status | 生产单位状态 | 字符串 |
| upstream_production_units | 上游生产单位列表。该列表需要包含所有上游生产单元（完整的最终状态）。在更新现有生产单元时，任何未包含在导入数据中的链接生产单元将被解除链接。
| |
通用说明
如果省略某个字段，则表示在匹配现有实体时不会更新该字段。如果需要清除字段内容，必须提供一个空值，而不是省略该字段。