Qarma 支持基于文件的数据导出,便于在 Qarma 之外进行进一步分析。这对于以下场景非常有用:

  • 商业智能应用(例如展示仪表板,深度分析验货数据和供应商评分卡)
  • 在 ERP 系统中批量更新订单状态(也可以通过事件驱动的 API 实现)
  • 更新订单预定系统中的验货状态和日期
  • 更新主数据系统中的供应商和生产单位信息

当然,还有许多其他应用场景。总的来说,API 支持定义数据导出任务,这些任务将在预定时间间隔内运行,生成可以通过包含 API 密钥的 URL 下载的文件。

获取访问权限

您可以手动或通过编程方式访问数据。若手动提取数据,请访问数据导出页面,您将能够进行一次性的数据提取。

若要获取 API 密钥和用于持续集成数据的 URL,请联系 Qarma 支持团队,并注明您希望基于哪些参数进行数据导出。

参数说明

以下是数据导出的参数:

名称描述
Date start 和 Date end开始日期可以是具体日期或相对日期(例如 -30 天表示从当前日期起,往前推 30 天的所有数据,-3 个月表示从今天起,往前推三个月的数据)。
日期过滤将基于状态对应的日期:
计划中:将根据以下日期进行过滤,按设置顺序选择:
1. 计划日期(验货/验厂的预定日期)
2. 预定日期
3. ETD(预计出发日期)
对于验厂,只有计划日期适用。
进行中:将根据开始日期进行过滤。
报告:将根据结束日期进行过滤。
请注意,由于 Qarma 支持离线操作,因此实际结束日期和数据在 Qarma 服务器上可用的时间之间可能存在延迟。这意味着,如果您过滤每天的数据提取,它需要包括几天前的数据,以确保所有数据都被包含。
Type选择数据类型:验货验厂供应商
Extra data基本数据始终会导出,这包括验货、验厂或供应商的列表,具体取决于选择的类型。此外,还可以包括以下数据:
检查点:对于“进行中”和“报告”状态的验货和验厂,可以包括所有检查点的列表。
疵点(仅限验货):对于“进行中”和“报告”状态,可以包括所有疵点的列表。
改正措施(仅限验厂):对于“进行中”和“报告”状态,可以包括所有与验厂相关的改正措施列表。
只有在使用了检查点、疵点或改正措施时才包含它们,因为它们会显著增加导出文件的大小。
Status选择一个或多个状态:
计划中
已下载(仅限验厂)
进行中
报告
Interval定义导出任务的运行频率。例如:每天 20:00,或每周一 06:00 等等。
Data format数据可以以 Excel 或一组 CSV 文件的形式提供,内容相同。Excel 文件会包含一个或多个工作表,具体取决于上面定义的Extra data参数。对于每个工作表,都有对应的 CSV 文件。
由于 Excel 文件的行数限制,建议大规模文件集成时使用 CSV 文件而非 Excel 文件。如果 Qarma 导出的数据行数超过一百万行,将不会生成 Excel 文件,只有 CSV 文件可用。

详细导出格式说明

  1. 验货和疵点
  2. 验厂和改正措施
  3. 供应商和生产单位

如有任何问题或需要帮助,请联系 Qarma 支持团队。供应商与生产单位导出 API