事务和日志端点

介绍

除了我们在 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 文件，其中列出了除“CONSUMED”或“PRODUCED”描述符之外的所有系统日志。

对...有用：

• 库存管理

端点/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 文件，其中包含与采购订单相关的接收数据，包括“RECEIVED”等系统描述符。

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

您可以点击此处下载此类文件的示例。

对...有用：

• 库存管理
• 订单

导出端点/URI –

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

端点描述

从此接口导出的销售交易数据将提供一个简化的 JSON 文件，其中包含与销售订单相关的分配/拣货/发货数据。使用此接口将返回所有通过销售订单售出的商品的数据，以及“已拣货”和“已发货”等描述符。

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

您可以点击此处下载此类文件的示例。

对...有用：

• 库存管理
• 销售订单