转让
您的 V5 集成指南！
V5 Traceability 和客户 ERP 系统之间的传输集成允许将传输详细信息、传输行项目和计划信息发送到 V5 Traceability。然后可以通过 V5 WMS 软件发送和接收这些传输，之后发送和接收哪些批次、发送了多少、位于哪个托盘等信息可以发送回 ERP。
在这种情况下，V5 还可以充当数据主站，并将系统内创建的传输发送到 ERP。
有关 V5 Traceability 中的传输模块如何工作的更多信息，请参阅我们的模块指南 开始.
目录
1. 控制中心布局
就我们如何联系而言 ‘Transfers’ 以及 ‘Transfer Lines’ 从我们在控制中心看到的内容，我们可以看到这里的顶部面板是用于传输的，到/从站点的位置、外部参考号等都可以导入。
然后，我们可以在左下面板添加传输线，保存与传输所需的商品和数量相关的数据。
使用 V5 网关，我们可以轻松地单独或一起填充两个面板。
右下面板包含与“发件人”位置中的转运中的物品拾取位置以及“目的地”位置中的接收位置相关的数据。该数据将构成我们可以从 V5 网关接收回来的导出的一部分。
2.API链接
3. 集成模板
可以下载转账集成模板 开始.
4. 转学现场指南
4.1. 主键
主键是 V5 API 中每个表的唯一标识符。 为了 Transfers， 这是：
reference – 转账的唯一参考号。本质上是转移订单号。
对于 TransferLines，主键是 或:
reference + commodity.code – 转让参考/编号以及要转让的商品。
or
lineID – 对于高级用途，同一商品可能出现在多行中，您可以指定行 ID 作为唯一标识符，而不是转移参考和商品代码。如果有超过 1 行的同一商品正在传输，则需要这样做。
4.2. 必填字段
SG 在控制中心填充有效条目所需的其他字段包括：
对于 TransferLines:
quantityOrdered – 所订购商品的数量。
对于 Transfers:
fromLocation.code – 转账的发送位置。
toLocation.code – 转账将发送到的位置。
4.3. 首选字段
首选字段用于向传输添加更多数据，虽然不是必需的，但在 V5 Traceability 中的功能方面非常有用。这些都是：
lineID – 如果上面没有用作主键，则应包含该字段。
commodity.code – 如果上面未用作主键，则应包含此字段。待转让商品的代码。
transfer.reference – 如果上面没有用作主键，则应包含该字段。
上述内容适用于‘transferLines’。我们可以将相同的字段应用于‘transfers' 通过增加 ‘transferLine’ 到前 2 个条目，并删除 ‘transfer’ 从最后一张开始。
4.4. 附加字段
还可以包括其他字段，例如，for ‘transfer’:
comment – 对于转让的任何其他意见。
fromAddress – 转账的发送地址。这些人口居住在 ‘Site Addresses‘.
toAddress – 接收转账的地址。
directTransfer – 此转移是否应该是 直接转移 或没有。
与上面类似，如果创建一个‘transferLine' 文件中，我们可以通过添加简单地遍历到传输类 ‘transfer’ 到上述参数的开头。
5。 方法论
鉴于其性质 ‘Transfer’ 以及 ‘TransferLine’，我们可以选择2种方式导入数据：
- 我们可以使用 ‘Transfer’ 端点导入传输，然后，正如我们将在下面看到的，遍历到 ‘TransferLine’ 类，然后将组件行项目全部包含在一个文件中。这是导入整个传输的最合乎逻辑的方式，因为它只需要一组标题信息，然后是后续行项目。请注意，这也是我们可以用来修改传输标头信息的唯一端点。
- 我们可以使用 ‘TransferLine’ 创建传输后，端点可以修改或添加传输线路。这仍然可以用于导入整个传输，但效率较低，因为每个传输行项目都需要包含对传输标头的嵌套引用（例如引用）。如上所述，该端点不能用于更改传输标头信息（参考/来自位置等）。
我们将使用哪些端点很大程度上取决于我们是使用 JSON 还是 CSV 导入。 我们现在可以看看下面这些。
5.1. JSON – 导入
传递：
‘Transfer’ 导入端点/URI –
http://host:port/V5-API/api/integrate/import/transfer
对于此示例导入，我们将使用 ‘Transfer’ 端点，并用 2 行构建传输的基本导入文件，这可能看起来像这样：
可以下载此示例 JSON 文件 开始.
我们可以明白为什么我们要使用 ‘Transfer’ 这种格式的端点，考虑到 JSON 文件保存嵌套数据的能力，允许我们包含缩进 ‘TransferLines’ 列出，随后 ‘Commodity’ 导入中的数据点，可以通过使用 SG API 手册来确定。 例如， ‘commodity code’ 可以使用API手册中的以下路径找到数据点：
我们可以使用类似的寻路方法来构建其余所需的数据点。
使用上面的文件，我们可以看到我们的新传输已在控制中心中创建。
换乘线路：
‘TransferLine’ 导入端点/URI –
http://host:port/V5-API/api/integrate/import/transfer_line
如上所述，我们可以使用 ‘TransferLine’ 用于添加或编辑现有传输线路的端点。我们还可以使用此端点添加传输，但重要的是要记住，我们只能使用 ‘Transfer’ 上面的 URI。另请注意，每个传输行的传输信息必须嵌套在此处。
我们可以看到一个例子 ‘TransferLine’ 下面的 JSON 文件，我们将在其中添加另一行来传输 ‘TR-1882’ 我们在上面创建的：
可以下载此示例 JSON 文件 开始.
发布此请求后，我们可以返回控制中心并看到第三行已添加到此传输中。
5.2. JSON – 导出
在接收与从V5 API转回相关的文件方面，如果我们检查下面的方法摘要 ‘IntegrationExport‘ 类，那么我们这里有一些不同的选择：
转会：
导出端点/URI –
http://host:port/V5-API/api/integrate/export/transfers
此端点将使用传输数据库类导出完整的传输 JSON 文件，并将包括尚未被系统标记为导出或自首次导出以来已更改的每个传输。这不会包括任何库存移动数据，而是为数据中的每个数据点提供一个返回值。 ‘Transfer’ 类。
可以下载此类 JSON 文件的示例 开始.
传递：
导出端点/URI –
http://host:port/V5-API/api/integrate/export/transfer/{referenceNumber}
此端点将使用传输数据库类导出完整传输 JSON 文件，但仅限于指定的传输，并且仅当该传输尚未被系统标记为导出时。如上所述，这不会包括任何库存移动数据，而是为数据中的每个数据点提供一个返回值。 ‘Transfer’ 类。
可以下载此类 JSON 文件的示例 开始.
我们还可以利用 事务和日志端点 检索有关采购订单中收到的商品的更多相关信息。
对于转账，我们有 1 系统日志 我们可以使用的端点：
系统日志：
导出端点/URI –
http://host:port/V5-API/api/integrate/export/system_logs
使用此端点将返回尚未标记为先前导出的系统日志事件的完整列表。有关此端点的更多信息可以找到 开始。可以过滤这些结果以查找特定的传输 描述符，如 ‘MOVED OUT/IN’, ‘PALLET MOVED OUT/IN’ 以及 ‘PALLET TRANSFER OUT/IN’.
可以下载此类 JSON 文件的示例 开始.
5.3. CSV – 导入
请注意，对于 CSV 导入，我们通常只使用 ‘TransferLine’ 端点，允许我们通过使用单个 csv 导入来生成转账及其行项目。
标题/列定义文件名： “transferLine.csvh”
完成的头文件应放置在： “<installdir>\SG Control Center\gateway\import\column_defs”
导入 CSV 文件名： “transferLine-datetime.csv”
用于导入的 CSV 应放置在： “<installdir>\SG Control Center\gateway\import”
头文件：
头文件通常会在 CSV 集成之前由 SG Systems 编译，但我们可以在下面看到一个可用于传输的基本示例：
有关我们如何构建这些文件的更多信息，请参阅 主集成页面。 可以下载此示例头文件 开始.
CSV 导入文件：
然后，我们可以使用标头中定义的数据点顺序来构建导入文件。 SG Systems 可以为此提供一个模板文件，列出每列的数据点，以便在填充列表时使事情变得更加清晰。 请注意，控制中心可以忽略第一行，因此在提交导入时可以将其保留在文件中。
在这里我们可以看到，我们的目标是创建与使用 JSON 方法创建的类似的传输。可以下载此示例导入文件 开始.
导入完成后，我们可以看到此传输以及所需的行项目已添加到控制中心。请注意，如果 ‘Created Date’ 导入中不包含数据，放置的日期将参考今天的日期。
5.4. CSV – 导出
当希望通过此方法导出传输信息时，这将构成 ‘SystemLog’ 出口。 我们可以看到这个端点的类定义 开始.
标题/列定义文件名： “SystemLog.csvh”
完成的头文件应放置在： “<installdir>\SG Control Center\gateway\export\order”
导出 CSV 文件名： “SystemLog-datetime.csv”
用于导出的 CSV 将在以下位置生成： “<installdir>\SG Control Center\gateway\export”
该端点可用于通过遍历从中链接出来的可用数据点来提取各种数据。
标题：
我们可以使用数据点，例如 ‘user’, ‘timestamp’ 以及 ‘quantity’ 在这个上面 ‘System Log’ 水平，但随后我们可以遍历到 ‘TransferLine’ 类以添加字段，例如转账时请求的参考号和商品，以及 ‘Stock’ 类来检索信息，例如项目移出/移入的位置。
在非常基本的层面上，我们处理传输的系统日志头部分可能如下所示：
可以下载此示例头文件 开始.
有了这个标题，我们还应该确保我们已选择导出 ‘System Logs’ 在控制中心网关的导出选项卡中。
在我们的标头就位并启用导出后（不要忘记重新启动控制中心以应用网关中所做的任何更改！），我们随后将获得此传输的返回文件（以及任何其他以前未导出的传输），如下所示这：
