事务和日志端点

引言

除了迄今为止在我们的 V5 集成指南中看到的导出端点之外，V5 API 还具有多个可用于返回的事务端点 系统事件描述符/记录到外部 ERP。

1. 系统日志端点
   1. 系统日志
   2. 系统日志
   3. 调整系统日志
   4. 消耗/产生的系统日志
   5. 非消耗/产生的系统日志
   6. 使用日志
   7. 使用日志（过滤日期）
   8. 作业日志
2. 事务/通用端点
   1. 调整交易
   2. 批量消费交易
   3. 批量消费交易（筛选自）
   4. 采购订单交易
   5. 销售订单交易

通用端点可用于返回各种 描述符 横跨多个 不同的模块.

这些端点将返回比事务/通用端点更复杂的数据，并且通常包含与描述符事件相关的多组嵌套数据。虽然这在返回正确数据的意义上很有用，但通常需要过滤这些端点以最好地利用返回的数据。

我们可以在下面看到 V5 API 的这些内容：

端点/URI –

http://host:port/V5-API/api/integrate/export/system_logs

端点描述

该端点将提供一个 JSON 返回文件，其中包含 所有 系统事件 描述符 以及与它们相关的数据。 如果我们到达这个端点，我们将得到如下所示的返回：

因此，我们可以在这里看到，虽然我们在该图像的底部接收到用于批处理的某些 Saffron 线程的“CONSUMED”描述符，但我们还接收到许多额外的嵌套数据，例如我们可以在这里看到供应商和地点。

可以在 ERP 中设置过滤器，以有选择地选择您想要查看的数据。

该示例文件可以下载 开始.

对...有用：

• 库存管理

端点/URI –

http://host:port/V5-API/api/integrate/export/system_log/{id}

端点描述

此端点将提供一个 JSON 返回文件，其结构与上面的“系统日志”导出类似，但在这里我们可以指定一个单独的日志 ID 号来返回相关信息。 如果我们想关注特定事件或 描述符.

可以下载此文件类型的示例 开始.

对...有用：

• 库存管理

端点/URI –

http://host:port/V5-API/api/integrate/export/adjustment_logs

端点描述

此端点将返回一个 JSON 文件，其中包含带有“ADJUSTMENT”的系统日志事件列表 描述符，将我们上面看到的“系统日志”的返回范围缩小到仅包含此描述符的条目。 这有助于为 ERP 根据您的需求提供更多相关数据进行处理。

可以下载此文件类型的示例 开始.

对...有用：

• • 库存管理

端点/URI –

http://host:port/V5-API/api/integrate/export/system_logs_cp 

端点描述

此端点将返回一个 JSON 文件，其中包含系统日志事件列表，其中包含“CONSUMED”或“PRODUCED” 描述符，将我们上面看到的“系统日志”的返回范围缩小到包含这些描述符的条目。 这些日志与主要配料过程有关，特别是库存的减少和生产。 这有助于为 ERP 根据您的需求提供更多相关数据进行处理。

可以下载此文件类型的示例 开始.

对...有用：

• 库存管理
• 工作/生产订单

端点/URI –

http://host:port/V5-API/api/integrate/export/system_logs_noncp 

端点描述

此端点实际上充当上面“消耗/生产的系统日志”端点的反面，并将返回一个 JSON 文件，其中列出了除“消耗”或“生产”之外的任何内容的系统日志 描述符.

对...有用：

• 库存管理

端点/URI –

http://host:port/V5-API/api/integrate/export/batch_system_logs

端点描述

此端点将返回一个 JSON 文件，其中包含与批处理相关的系统日志事件列表，将返回范围从我们上面看到的“系统日志”缩小到包含以下内容的条目： 描述符 例如“已整理”、“批量暂停”等（以及“已消耗”和“已生产”）。 这有助于为 ERP 根据您的需求提供更多相关数据进行处理。

可以下载此文件类型的示例 开始.

对...有用：

• 库存管理
• 工作/生产订单

端点/URI –

http://host:port/V5-API/api/integrate/export/batch_system_logs/filterFrom/{filterDate}

端点描述

此端点返回与上面“使用日志”相同的信息，但如果需要，允许使用日期（纪元时间戳）过滤器来缩小结果范围。

对...有用：

• 库存管理
• 工作/生产订单

端点/URI –

http://host:port/V5-API/api/integrate/export/job_logs

端点描述

该端点将提供一个 JSON 返回文件，其中包含系统 描述符 与就业生产有关。

可下载此类型的示例文件 开始.

对...有用：

• 库存管理
• 工作/生产订单

事务端点用于返回信息简化信息 描述符 更具体地涉及各个模块如何管理库存水平的事件。与我们上面看到的提供各种嵌套数据的通用端点不同，这些端点提供没有嵌套数据的简化信息。

我们可以在下面的示例中看到它的样子：

端点/URI –

http://host:port/V5-API/api/integrate/export/transactions/adjustments

端点描述

该端点可用于提供系统中已发生的调整交易的列表。 使用此端点，每当使用控制中心或 WMS 更改（或调整）批次数量时，我们都会返回一个条目。 这可能是由于需要从系统中删除的损坏或过期商品造成的。

这种类型的导出示例如下所示：

正如我们在这里看到的，这是“调整”的单个条目 描述符 事件，并且不包含我们在通用端点中看到的任何潜在多余的嵌套数据。

可以下载这种类型的示例文件 开始.

对...有用：

• 库存管理

端点/URI –

http://host:port/V5-API/api/integrate/export/transactions/batching/{completedBatches}

端点描述

批量消费交易导出将提供一个简化的 JSON 文件，提供消费和生产 描述符 与系统已处理的特定、已完成批次相关的数据。

使用此端点，我们将获得一个返回结果，显示批次中已消耗的所有商品，以及随后生产的批次本身的数量。

可以下载此文件类型的示例 开始.

对...有用：

• 库存管理
• 工作/生产订单

端点/URI –

http://host:port/V5-API/api/integrate/export/transactions/batching/filterfrom/{filterDate}

端点描述

此端点返回与上面“批量消耗”相同的信息，但如果需要，允许使用日期（纪元时间戳）过滤器来缩小结果范围。

对...有用：

• 库存管理
• 工作/生产订单

导出端点/URI –

http://host:port/V5-API/api/integrate/export/transactions/purchase

端点描述 

从此端点导出的采购交易将提供一个简化的 JSON 文件，该文件提供与采购订单相关的接收数据，包括 系统描述符 例如“已收到”。

端点仅为尚未标记为导出的已完成订单提供此数据。

可以下载此文件类型的示例 开始.

对...有用：

• 库存管理
• 订单

导出端点/URI –

http://host:port/V5-API/api/integrate/export/transactions/sales/{true/false}

端点描述

从该端点导出的销售交易将提供一个简化的 JSON 文件，该文件提供与销售订单相关的分配/提货/运输数据。 使用此端点将返回与通过销售订单销售的所有商品相关的数据 描述符 例如“已挑选”和“已发货”。

端点可以为已完成的订单 (true) 或所有订单 (false) 提供此数据，前提是这些订单尚未标记为已导出。

可以下载此文件类型的示例 开始.

对...有用：

• 库存管理
• 销售订单