大宗商品

V5 Traceability 和客户 ERP 系统之间的商品（成分/包装/原材料/SKU）集成允许将商品详细信息（例如成本、单位、默认到期时间等）发送到 V5 Traceability。

1. 控制中心布局
2. 接口链接
3. 集成模板
4. 商品领域指南
   1. 主键
   2. 必填字段
   3. 首选字段
   4. 附加字段
5. 研究方法
   1. JSON – 导入
   2. JSON – 导出
   3. CSV – 导入
   4. CSV – 导出

就我们如何将商品与我们所看到的联系起来而言 控制中心，我们可以看到这里只有一个面板可以填充，即主商品窗口。

 

使用 V5 网关，我们可以使用单个端点轻松填充此处的数据。

要了解有关这些数据库类定义的更多信息，请参阅以下链接：

Commodities

集成模板为 Commodities 可以下载 开始.

主键是 V5 API 中每个表的唯一标识符。 为了 Commodities， 这是：

code – 每个商品的唯一识别码。

SG 在控制中心填充有效商品行所需的其他字段包括：

units.code – 商品默认库存计量单位。

type – 商品类型（成分 (0)、配方 (1) 或包装 (2)）。

recordStock – 该商品的使用情况是否应通过V5可追溯性进行跟踪（不记录（0）或记录（1））。

首选字段用于添加针对相关商品的更多信息，虽然不是必需的，但在 V5 Traceability 中添加功能时非常有用。

description – 商品的描述。

bulkUnit ——由数百家创建、维护和提供物联网(IoT)全球开放标准的公司所组成的 散装单元 商品的名称（例如“袋子”或“盒子”）。

bulkQuantity – 商品的默认计量单位（units.code）的数量进入上面的散装单位（例如“20”，为bulkUnit输入“袋”，默认单位“磅”表示1袋）此商品有20磅）。

还可以包含其他字段，例如：

cost – 商品的默认成本（每单位）。

defExpiryDays – 此商品类型的库存项目将被设置为自收到后过期的默认天数

gtin – 商品的 GTIN。

鉴于我们对此对象类仅使用单个端点，因此我们可以使用“商品”端点进行 JSON 和 CSV 导入和导出。 我们现在可以看看下面的内容。

Commodity:

‘Commodity’ 导入端点/URI –

http://host:port/V5-API/api/integrate/import/commodity

端点描述

对于此示例导入​​，我们将使用 ‘Commodity’ 端点，并为单个商品构建基本导入文件，这可能看起来像这样：

可以下载此示例 JSON 文件 开始.

我们可以在这里看到一个使用与以下内容相关的嵌套类的示例 ‘Commodity’ 端点。 在这种情况下，我们已经包含了缩进的 ‘units’ 以及 ‘bulkUnit’ 数据点，使我们能够定义商品的默认计量单位及其批量单位。 由于这两者都利用了 ‘WeightUnit’ 类中，我们可以使用 V5 API 手册通过以下路径引导我们找到这些数据点：

我们可以使用类似的寻路方法构建其余所需的数据点来遍历其他类，例如 ‘Location’ or ‘Container’ 按要求。

如果我们要导入上面的示例文件，我们将在控制中心看到我们的商品已导入。

在接收V5 API返回的商品相关文件方面，如果我们查看下面的方法摘要 IntegrationExport 类，我们这里有 2 个不同的选项：

Commodity:

导出端点/URI –

http://host:port/V5-API/api/integrate/export/commodity/{code}

端点描述

该端点将导出一个 JSON 文件，其中包含特定商品的所有相关信息。 如果我们使用刚刚导入的商品运行此请求，我们将得到一个如下所示的文件：

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

Commodities:

导出端点/URI –

http://host:port/V5-API/api/integrate/export/commodites/{all}

端点描述

该端点将导出一个 JSON 文件，其中包含系统中所有商品的所有相关信息的列表，具体取决于 {all} 场地。 如果这是 ‘true’ 那么我们将拉动所有商品，而如果 ‘false’ 那么我们只会得到新商品的回报（即不是的商品） 标记为已导出).

如果我们运行这个请求 true ，我们将得到一个如下所示的文件：

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

标题/列定义文件名： “commodity.csvh”

完成的头文件应放置在： “<installdir>\SG Control Center\gateway\import\column_defs”

导入 CSV 文件名： “commodity-datetime.csv”

用于导入的 CSV 应放置在： “<installdir>\SG Control Center\gateway\import”

头文件：

头文件通常会在 CSV 集成之前由 SG Systems 编译，但我们可以在下面看到一个可用于商品的基本示例：

有关我们如何构建这些文件的更多信息，请参阅 主集成页面。 可以下载此示例头文件 开始.

CSV 导入文件：

然后，我们可以使用标头中定义的数据点顺序来构建导入文件。 SG Systems 可以为此提供一个模板文件，列出每列的数据点，以便在填充列表时使事情变得更加清晰。 请注意，控制中心可以忽略第一行，因此在提交导入时可以将其保留在文件中。

使用上面标题的 csv 导入文件示例可能如下所示：

可以下载此示例导入​​文件 开始.

导入完成后，我们可以看到这些商品已经添加到控制中心了。

当使用这种方法导出商品时，我们将使用与导入相同的类定义，我们可以找到 开始.

标题/列定义文件名： “commodity.csvh”

完成的头文件应放置在： “<installdir>\SG Control Center\gateway\export\order”

导出 CSV 文件名： “Commodity-datetime.csv”

用于导出的 CSV 将在以下位置生成： “<installdir>\SG Control Center\gateway\export”

还需要在控制中心的网关部分启用此导出。 我们这里可以选择只导出 ‘Ingredients’ （成分/包装）或配方，或两者兼而有之。 这里我们只看导出 ‘Ingredients’ :

头文件：

从这里开始，构建我们的导出头文件以适应我们想要从系统返回的信息将是一个简单的情况。

我们可以采用与构建导入标头非常相似的方式来构建它：

可以下载此示例头文件 开始.

CSV 导出文件：

有了上面的标头，我们将收到最近导入的返回 csv，如下所示：

可以下载此示例导出文件 开始.