销售订单
您的 V5 集成指南！
V5 Traceability 和客户 ERP 系统之间销售订单 (SO) 的集成允许将订单详细信息、订单行项目和计划信息发送到 V5 Traceability。 在这种情况下，V5还可以充当数据主站，并将系统内创建的订单发送到ERP。
然后可以通过 V5 WMS 软件接收这些订单，然后将拣选和运输的数量、位置以及集装箱/托盘分配等信息发送回 ERP。
有关 V5 Traceability 中的销售订单模块如何工作的更多信息，请参阅我们的模块指南 开始.
目录
1. 控制中心布局
就我们如何联系而言 ‘Sales Orders’ 和 ‘Sales Order Lines’ 在控制中心中，我们可以看到顶部面板用于销售订单，其中可以导入客户、订单和交货日期、外部参考号等。
然后，我们可以在下部面板中添加销售订单行，保存与订单行项目的商品、数量和成本相关的数据。
使用 V5 网关，我们可以轻松地单独或一起填充两个面板。
右下面板保存与处理 SO 时从何处挑选 SO 上的项目有关的数据。 该数据将构成我们可以从 V5 网关接收回来的导出数据的一部分。
2.API链接
3. 集成模板
可以下载销售订单的集成模板 开始.
4. 销售订单字段指南
4.1. 主键
主键是 V5 API 中每个表的唯一标识符。 为了 SalesOrders， 这是：
salesOrder.orderNumber – SO 编号。
对于 SalesOrderLines，主键是 或:
salesOrder.orderNumber + commodity.code – SO 编号以及要订购的商品
or
lineID – 对于高级用途，同一商品可能出现在多行中，您可以指定行 ID 作为唯一标识符，而不是订单号和商品代码。 如果订单上有超过 1 行相同商品，则需要此信息。
4.2. 必填字段
SG 需要填充有效的其他字段 ‘SalesOrderLine’ 控制中心有：
quantity – 所售商品/产品的数量。
4.3. 首选字段
首选字段用于向销售订单添加更多数据，虽然不是必需的，但在 V5 Traceability 中的功能方面非常有用。如果使用 ‘SalesOrderLine’ 理想情况下我们会添加端点：
lineID – 如果上面没有用作主键，则应包含该字段。
commodity.code – 如果上面未用作主键，则应包含此字段。
salesOrder.orderNumber – 如果上面未用作主键，则应包含此字段。
salesOrder.customer.code – 用于识别客户的唯一代码。
salesOrder.placedDate – 下订单的日期。
salesOrder.deliveryDate – 订单的预计交货日期。
请注意，对于最后 4 个点，我们将遍历到 ‘SalesOrder’ 班级来自 ‘SalesOrderLine’。如果我们使用 ‘SalesOrder’ 我们可以简单地删除类 ‘salesOrder’ 从上述 4 个条目中。
4.4. 附加字段
还可以包括其他字段，例如，for ‘SalesOrderLine’:
salesOrder.referenceNumber – 与 SO 相关的任何附加注释/参考文献。
5。 方法论
鉴于其性质 ‘SalesOrder’ 和 ‘SalesOrderLine’，我们可以选择通过几种不同的方式导入和管理数据：
- 我们可以使用 ‘SalesOrder’ 端点导入销售订单，然后，正如我们将在下面看到的，遍历到 ‘SalesOrderLine’ 类，然后将组件行项目全部包含在一个文件中。这是导入整个订单的最合乎逻辑的方式，因为它只需要一组标题信息，然后是后续的行项目。请注意，这也是我们可以用来修改销售订单的标头信息的唯一端点。
- 我们可以使用 ‘SalesOrderLine’ 创建订单后，可以通过端点修改或添加线路。这仍然可以用于导入整个订单，但效率较低，因为每个订单行项目都需要包含对销售订单标题（例如订单号）的嵌套引用。如上所述，此端点不能用于更改订单标题信息（订单号/交货日期等）。
5.1. JSON – 导入
销售订单：
‘SalesOrder’ 导入端点/URI –
http://host:port/V5-API/api/integrate/import/sales
对于此示例导入，我们将使用 ‘SalesOrder’ 端点，并构造一个基本的导入文件，这可能看起来像这样：
可以下载此示例 JSON 文件 开始.
我们可以明白为什么我们要使用 ‘SalesOrder’ 这种格式的端点，考虑到 JSON 文件保存嵌套数据的能力，允许我们包含缩进 ‘SalesOrderLine’ 列出，随后 ‘Commodity’ 导入中的数据点，可以通过使用 SG API 手册来确定。 例如， ‘commodity code’ 可以使用API手册中的以下路径找到数据点：
我们可以使用类似的寻路方法来构建其余所需的数据点。
销售订单行：
‘SalesOrderLine’ 导入端点/URI –
http://host:port/V5-API/api/integrate/import/sales_line
我们也可以使用 ‘SalesOrderLine’ 用于添加或编辑现有订单行的端点。我们还可以使用此端点添加销售订单，但重要的是要记住，我们只能使用 ‘SalesOrder’ URI。另请注意，每个 SO 行的 SO 信息都必须嵌套在此处。
我们可以看到一个例子 ‘SalesOrderLine’ 下面的 JSON 文件，我们将在其中添加另一个订单行来订购 ‘SO-8471’ 我们在上面创建的：
可以下载此示例 JSON 文件 开始.
然后我们可以在控制中心看到我们的订单已与我们刚刚添加的附加行一起导入。请注意，诸如放置/交货日期和参考编号之类的信息是从原始数据导入的 ‘SalesOrder’ 文件中。
5.2. JSON – 导出
在从 V5 API 接收与销售订单相关的文件方面，如果我们检查“集成导出' 服务，那么我们这里有一些不同的选择：
销售订单：
导出端点/URI –
http://host:port/V5-API/api/integrate/export/sales_orders
此端点将使用销售订单数据库类导出完整的销售订单 JSON 文件，并将包括尚未被系统标记为导出的每个销售订单。这将为每个数据点提供一个返回值 ‘SalesOrder’ 类以及包括已发货物品的任何提货信息。
可以下载此类型的示例 JSON 文件 开始.
销售订单：
导出端点/URI –
http://host:port/V5-API/api/integrate/export/sales_order/{ordernumber}
此端点将使用销售订单数据库类导出完整的销售订单 JSON 文件，但仅限于指定的订单，并且仅当该订单尚未被系统标记为导出时。如上所述，这将为每个数据点提供一个返回值 ‘SalesOrder’ 类以及包括已发货物品的任何提货信息。
我们可以在下面看到这种类型的示例导出的开始：
可以下载此示例 JSON 文件 开始.
销售订单日志：
导出端点/URI –
http://host:port/V5-API/api/integrate/export/sales_logs
此端点可用于检索与销售订单运输期间发生的事件有关的销售订单日志列表。这利用了 ‘SystemLog’ 数据类提供事务数据，例如系统描述符。端点仅为尚未标记为导出的已完成订单提供此数据。
可以下载此类型的示例 JSON 文件 开始.
销售订单日志：
导出端点/URI –
http://host:port/V5-API/api/integrate/export/sales_log/{id}
该端点的功能与上述“销售订单日志”相同，但可用于返回 V5 系统定义的特定日志编号的信息。和之前一样，这利用了 ‘SystemLog’ 数据类提供事务数据，例如系统描述符。端点仅为尚未标记为已导出的已完成订单的日志提供此数据。
我们可以在下面看到这种类型的示例导出的开始：
我们还可以利用一个 事务和日志端点 检索有关销售订单上销售的商品和产品的更多相关信息。
我们有一个 交易/通用 我们可以在这里使用端点：
5.3. CSV – 导入
请注意，对于 CSV 导入，我们通常只使用 ‘SalesOrderLine’ 端点，允许我们通过使用单个 csv 导入来生成销售订单及其行项目。
标题/列定义文件名： “salesOrderLine.csvh”
完成的头文件应放置在： “<installdir>\SG Control Center\gateway\import\column_defs”
导入 CSV 文件名： “salesOrderLine-datetime.csv”
用于导入的 CSV 应放置在： “<installdir>\SG Control Center\gateway\import”
头文件：
头文件通常会在 CSV 集成之前由 SG Systems 编译，但我们可以在下面看到可用于销售订单的基本示例：
有关我们如何构建这些文件的更多信息，请参阅 主集成页面。 可以下载此示例头文件 开始.
CSV 导入文件：
然后，我们可以使用标头中定义的数据点顺序来构建导入文件。 SG Systems 可以为此提供一个模板文件，列出每列的数据点，以便在填充列表时使事情变得更加清晰。 请注意，控制中心可以忽略第一行，因此在提交导入时可以将其保留在文件中。
在这里我们可以看到，我们的目标是创建与使用 JSON 方法创建的订单类似的订单。 可以下载此示例导入文件 开始.
导入完成后，我们可以看到该订单以及所需的行项目已添加到控制中心。请注意，如果 ‘Date Placed’ 导入中不包含数据，放置的日期将参考今天的日期。
5.4. CSV – 导出
当希望通过此方法导出销售订单信息时，这将构成 ‘SalesLog’ 出口。 我们可以看到这个端点的类定义 开始.
标题/列定义文件名： “SalesLog.csvh”
完成的头文件应放置在： “<installdir>\SG Control Center\gateway\export\order”
导出 CSV 文件名： “SalesLog-datetime.csv”
用于导出的 CSV 将在以下位置生成： “<installdir>\SG Control Center\gateway\export”
还需要在控制中心的网关部分启用此导出。这只是检查的情况 ‘Sales Order’ 框并确保应用设置并重新启动控制中心。
头文件：
我们可以使用数据点，例如 ‘user’, ‘timestamp’ 和 ‘quantity’ 在这个上面 ‘Sales Log’, 级别，但我们还可以使用“销售订单”和“销售订单行”页面进一步构建我们需要的信息，例如订单号、已售商品以及从何处挑选商品。请注意，这里的 ‘SalesOrder’ 类应该通过 ‘Line’ 类，如下例所示
在一个非常基本的层面上，我们的部分 ‘Sales Log’ 处理我们的销售订单的标头可能如下所示：
可以下载此示例头文件 开始.
CSV 导出文件：
标头就位并启用导出后，我们随后将获得该订单（以及任何其他以前未导出的订单）的返回文件，如下所示：
可以下载此示例导出文件 开始.
