库存/库存地点
您的 V5 集成指南！
V5 Traceability 和客户 ERP 系统之间库存/库存位置的集成允许 商品 库存详细信息，例如批号、现有数量和位置，将发送至 V5 Traceability。 这些详细信息将允许此类商品用于生产/订购等。
根据我们的 ERP 设置，我们可以通过几种不同的方式来处理库存/库存：
- ERP 作为库存主数据： 在这里，ERP 将库存数据输入 V5，然后 V5 将返回调整/消耗/生产/等。 （最常见）（存入、注销）。 这可以通过两种方式完成； 日志中更新的库存值（批次 2 现在为 123LB）； 或者您可以查看日志中的调整值（Lot50 -123LBS）。 第一个选项使事情更加同步，但更有可能错过交易。
- V5作为库存大师： V5 将库存数据提供给 ERP。 然后，ERP 会定期反馈更新的库存水平。 （缺货、入库）
- ERP 作为库存主数据： ERP 提供 V5 库存，然后 V5 定期返回库存水平，ERP 更新其计数。 这是有益的，因为 ERP 和 V5 将始终同步。 然而，由于同步的时间和频率，这可能会出现问题，特别是如果可以在 ERP 本身中扣除库存，则这些调整后的水平可能会在下一次 V5 同步时被覆盖。 如果 ERP/MRP 不直接调整库存，而只是保存财务数据，则此方法非常有用。 （入库、出库）
如果您不确定特定 ERP 设置的最佳途径，SG Systems 可以安排咨询会议，以最好地评估适合您系统的最佳方法。
目录
1. 控制中心布局
就如何将库存/库存位置详细信息与我们在控制中心看到的内容相关联而言，我们将主要使用此端点来填充左下面板，以导入和导出现有商品的库存水平/位置。
使用 V5 网关，我们可以使用两个端点轻松填充此处的数据， ‘Stock’ 以及 ‘StockLocation’.
2.API链接
3. 集成模板
库存位置集成模板可下载 点击此处。
4. StockLocation 字段指南
4.1. 主键
4.2. 必填字段
SG 在 V5 控制中心中填充有效商品行所需的其他字段包括：
stock.expiry – 特定批次的到期日期。
qty – 该批次中商品的数量。
4.3. 首选字段
首选字段用于添加针对相关商品的更多信息，虽然不是必需的，但在 V5 Traceability 中添加功能时非常有用。
stock.supplier.code – 提供商品批次的供应商代码。
stock.cost – 商品的成本（每计量单位）。
stock.dateReceived – 批次登记入库的日期。
stock.supplierLotNo – 供应商指定的批号。
4.4. 附加字段
还可以包含其他字段，例如：
stock.commodity.description – 商品的描述。
stock.commodity.units.code – 商品的默认计量单位。
stock.commodity.recordStock – 该商品的使用是否将通过 V5 Traceability 进行跟踪。
请注意，这些附加字段可用于在 V5 Traceability 中创建商品条目，并根据它们分配库存地点和数量。 当使用 CSV方法 为了进行数据交换，我们必须确保在控制中心的“网关”中选择“创建子实体”。 但现有商品无法更新 V5-API 使用此端点，我们必须直接使用 ' 来解决这些问题商品' 端点代替。
5。 方法论
根据 API 集成的目的，我们可以利用 ‘StockLocation’ or ‘Stock’ JSON 和 CSV 导入和导出的端点。 我们现在可以看看下面的内容。
5.1. JSON – 导入
StockLocation:
我们可以利用 ‘StockLocation’ 将商品（现有或不存在）的库存记录插入到 V5 Traceability 中的端点，其中包含与接收/到期日期、批次/供应商批号以及库存位置相关的信息。
‘StockLocation’ 导入端点/URI –
http://host:port/V5-API/api/integrate/import/stock_location
对于此示例导入，使用 ‘StockLocation’ 端点，我们可以为单个批次构建基本导入文件，如下所示：
可以下载此示例 JSON 文件 开始.
使用API手册我们可以看到我们只使用 ‘qty’ 价值来自 ‘StockLocation’ 类，所有其他值都嵌套在 ‘stock’ or ‘location’ 班级。 我们还可以看到 ‘code’ 以及 ‘units’ 数据点进一步嵌套在 ‘commodity’ 类。
我们可以在下面看到这个数据流过程的摘要：
如果我们运行上面的 JSON 文件，我们将看到我们的商品批次 ‘I015’ (Jalepenos) 现在已将此批次导入到控制中心。
然而，我们不能做什么 ‘StockLocation’ 端点是更改值，例如供应商批号和现有库存的到期日期。 为此，我们需要使用 ‘Stock’ 端点。
库存：
如上所述， ‘StockLocation’ 端点可用于插入库存记录及其关联位置。 但是，如果我们想要更新这些属于以下批次的详细信息 ‘Stock’ 标头，我们必须使用 ‘Stock’ 端点。 其中包括供应商批号、有效期和收到的重量等详细信息。
‘Stock’ 导入端点/URI –
http://host:port/V5-API/api/integrate/import/stock
对于一个非常基本的 ‘Stock’ 导入文件将更新我们上面创建的批次的到期日期和供应商批号，我们可以使用以下内容：
导致批次信息在 V5 内更新：
5.2. JSON – 导出
在从 V5 API 接收与库存位置相关的文件方面，如果我们检查下面的方法摘要 IntegrationExport 类，我们可能会认为 ‘StockLocations’ (export/locations/stock) 将是我们正在寻找的。 但情况并非如此，因为此端点将导出系统中存在的库存位置（相对于生产位置）的列表。
要接收我们商品的位置和库存水平信息，我们可以使用：
个别商品+批量库存：
导出端点/URI –
http://host:port/V5-API/api/integrate/export/stock/{commodityCode}/{lotNumber}
该端点将导出一个 JSON 文件，其中包含单一商品指定批次的所有相关信息。 如果我们使用刚刚导入的批次信息运行此请求，我们将得到一个如下所示的文件：
可以下载此类型的示例 JSON 文件 开始.
所有库存：
导出端点/URI –
http://host:port/V5-API/api/integrate/export/stock/{all}
该端点将导出一个 JSON 文件，其中包含系统中每种商品的所有批次的所有相关信息的列表，具体取决于 {all} 字段的值。 如果这是 ‘true’ 那么我们将提取所有库存批次，而如果 ‘false’ 那么我们将只获得新库存商品的退货（即许多未标记为已出口的商品）。
如果我们运行这个请求 ‘true’ （所以 http://host:port/V5-API/api/integrate/export/stock/true) ，我们将得到一个如下所示的文件：
可以下载此类型的示例 JSON 文件 开始.
上述端点仅提供当前库存水平。 但是，如果我们想在生产过程中跟踪库存水平该怎么办？ 这里我们有一些不同的选项，具体取决于我们如何使用 API 以及与 ERP 系统集成。
我们还可以利用各种 事务和日志端点 检索有关库存水平变化的更多相关信息。
对于 系统日志 端点，这些是：
对于 交易/通用 端点，这些是：
5.3. CSV – 导入
标题/列定义文件名： “stockLocation.csvh”
完成的头文件应放置在： “<installdir>\SG Control Center\gateway\import\column_defs”
导入 CSV 文件名： “stockLocation-datetime.csv”
用于导入的 CSV 应放置在： “<installdir>\SG Control Center\gateway\import”
头文件：
头文件通常会在 CSV 集成之前由 SG Systems 编译，但我们可以看到一个可用于库存/库存的基本示例，使用之前定义的 类定义，下面：
有关我们如何构建这些文件的更多信息，请参阅 主集成页面。 可以下载此示例头文件 开始.
CSV 导入文件：
然后，我们可以使用标头中定义的数据点顺序来构建导入文件。 SG Systems 可以为此提供一个模板文件，列出每列的数据点，以便在填充列表时使事情变得更加清晰。 请注意，控制中心可以忽略第一行，因此在提交导入时可以将其保留在文件中。
示例 csv 导入文件可能如下所示：
在这里我们可以看到我们正在从 3 个不同的供应商进口 2 个新批次。 可以下载此示例导入文件 开始.
导入完成后，我们可以看到这些额外批次的墨西哥胡椒已添加到控制中心。 请注意这里的区别 ‘Qty’ （手头上）和 ‘Stock_WeightReceived’ 在我们的导入 csv 中。
5.4. CSV – 导出
与 JSON 导出一样，我们这里有几个不同的选项：
StockLocation:
当使用这种方法出口商品时，我们可以使用相同的端点 类定义 就像我们对进口所做的那样。
标题/列定义文件名： “stockLocation.csvh”
完成的头文件应放置在： “<installdir>\SG Control Center\gateway\export\order”
导出 CSV 文件名： “StockLocation-datetime.csv”
用于导出的 CSV 将在以下位置生成： “<installdir>\SG Control Center\gateway\export”
还需要在控制中心的网关部分启用此导出。 我们可以在这里选择导出 ‘Stock’ .
头文件：
从这里开始，构建我们的导出头文件以适应我们想要从系统返回的信息将是一个简单的情况。
我们可以采用与构建导入标头非常相似的方式来构建它：
可以下载此示例头文件 开始.
CSV 导出文件：
这将为我们最近的导入提供一个返回 csv，类似于下面的示例。 我们可以在这里看到，我们已经检索了所有以前未导出的库存系列，包括添加了当天早些时候生产的一些产品。
可以下载此示例导出文件 开始.
但是，与上面的 JSON 导出一样，这不会返回任何事务数据，因此我们可以再次利用 ‘SystemLog’ 端点而不是检索交易和库存调整方面的更多相关数据。
SystemLog:
该端点可用于通过遍历从此处链接的可用数据点来提取各种数据。 我们可以看到我们可以使用的定义 开始.
标题/列定义文件名： “SystemLog.csvh”
完成的头文件应放置在： “<installdir>\SG Control Center\gateway\export\order”
导出 CSV 文件名： “SystemLog-datetime.csv”
用于导出的 CSV 将在以下位置生成： “<installdir>\SG Control Center\gateway\export”
如上所述，需要在控制中心的网关部分启用此功能：
头文件：
从这里，我们可以根据我们想要接收回 ERP 的交易数据来构建标头。 出于我们的目的，这可能如下所示：
可以下载此示例头文件 开始.
CSV 导出文件：
因此，我们可以在这里看到，我们将收到专门针对我们的需求而定制的数据，包括商品、批号、原始数量、任何调整和执行操作的用户等数据，以及任何原因和相关工作/批次信息。
如果我们使用上述标头运行系统日志，我们将得到如下所示的导出：
可以下载此示例导出文件 开始.
